mirror of
https://github.com/Qortal/qortal.git
synced 2025-03-30 09:05:52 +00:00
5526f9a7f0
Now using ATv2 dated 20181101172102 ATData now uses byte[] creatorPublicKey instead of String creator. TransactionData now has hashCode() and equals() methods, which is needed for new Transaction Comparator, used to sort transactions within a block, AT-first, then timestamp, then signature. AT-Transactions generate their own signatures using SHA2-256 of serialized data. Arbitrary Transactions try to clean up their files when orphaned. Deploy AT Transactions now check creation bytes (even for old v1 ATs). Deprecated Transaction.getBlock() as it doesn't seem used and would be better to simply have getHeight() rather than a method that 'knows too much' about Blocks/BlockData. Corresponding TransactionRepository.getBlockDataFromSignature() also deprecated. Loads more comments. Tidied up some SQL: mainly correcting case, moving PRIMARY KEY clauses to end of CREATE TABLE, removing unnecessary columns from indexes. Added "type" column to TransactionCreatorIndex so users can find their transactions and optionally filter by type. In BlockTransactions table, transaction_signature is now UNIQUE as a transaction cannot be included in more than one block. Various AT-related HSQLDB table and index changes. ArbitraryTransactions transformer fixed to always return a list of payments, even if empty. (Previously could return null which broke things). Added simplistic block generator. NOTE: unit tests broken due to pending upgrade to JUnit 5
117 lines
3.2 KiB
Java
117 lines
3.2 KiB
Java
package repository;
|
|
|
|
import java.util.List;
|
|
|
|
import data.block.BlockData;
|
|
import data.block.BlockTransactionData;
|
|
import data.transaction.TransactionData;
|
|
|
|
public interface BlockRepository {
|
|
|
|
/**
|
|
* Returns BlockData from repository using block signature.
|
|
*
|
|
* @param signature
|
|
* @return block data, or null if not found in blockchain.
|
|
* @throws DataException
|
|
*/
|
|
public BlockData fromSignature(byte[] signature) throws DataException;
|
|
|
|
/**
|
|
* Returns BlockData from repository using block reference.
|
|
*
|
|
* @param reference
|
|
* @return block data, or null if not found in blockchain.
|
|
* @throws DataException
|
|
*/
|
|
public BlockData fromReference(byte[] reference) throws DataException;
|
|
|
|
/**
|
|
* Returns BlockData from repository using block height.
|
|
*
|
|
* @param height
|
|
* @return block data, or null if not found in blockchain.
|
|
* @throws DataException
|
|
*/
|
|
public BlockData fromHeight(int height) throws DataException;
|
|
|
|
/**
|
|
* Return height of block in blockchain using block's signature.
|
|
*
|
|
* @param signature
|
|
* @return height, or 0 if not found in blockchain.
|
|
* @throws DataException
|
|
*/
|
|
public int getHeightFromSignature(byte[] signature) throws DataException;
|
|
|
|
/**
|
|
* Return highest block height from repository.
|
|
*
|
|
* @return height, or 0 if there are no blocks in DB (not very likely).
|
|
*/
|
|
public int getBlockchainHeight() throws DataException;
|
|
|
|
/**
|
|
* Return highest block in blockchain.
|
|
*
|
|
* @return highest block's data
|
|
* @throws DataException
|
|
*/
|
|
public BlockData getLastBlock() throws DataException;
|
|
|
|
/**
|
|
* Returns block's transactions given block's signature.
|
|
* <p>
|
|
* This is typically used by Block.getTransactions() which uses lazy-loading of transactions.
|
|
*
|
|
* @param signature
|
|
* @return list of transactions, or null if block not found in blockchain.
|
|
* @throws DataException
|
|
*/
|
|
public List<TransactionData> getTransactionsFromSignature(byte[] signature) throws DataException;
|
|
|
|
/**
|
|
* Saves block into repository.
|
|
*
|
|
* @param blockData
|
|
* @throws DataException
|
|
*/
|
|
public void save(BlockData blockData) throws DataException;
|
|
|
|
/**
|
|
* Deletes block from repository.
|
|
*
|
|
* @param blockData
|
|
* @throws DataException
|
|
*/
|
|
public void delete(BlockData blockData) throws DataException;
|
|
|
|
/**
|
|
* Saves a block-transaction mapping into the repository.
|
|
* <p>
|
|
* This essentially links a transaction to a specific block.<br>
|
|
* Transactions cannot be mapped to more than one block, so attempts will result in a DataException.
|
|
* <p>
|
|
* Note: it is the responsibility of the caller to maintain contiguous "sequence" values
|
|
* for all transactions mapped to a block.
|
|
*
|
|
* @param blockTransactionData
|
|
* @throws DataException
|
|
*/
|
|
public void save(BlockTransactionData blockTransactionData) throws DataException;
|
|
|
|
/**
|
|
* Deletes a block-transaction mapping from the repository.
|
|
* <p>
|
|
* This essentially unlinks a transaction from a specific block.
|
|
* <p>
|
|
* Note: it is the responsibility of the caller to maintain contiguous "sequence" values
|
|
* for all transactions mapped to a block.
|
|
*
|
|
* @param blockTransactionData
|
|
* @throws DataException
|
|
*/
|
|
public void delete(BlockTransactionData blockTransactionData) throws DataException;
|
|
|
|
}
|