io.nem.symbol.sdk.api

Interface BlockRepository

All Superinterfaces:

Searcher<BlockInfo,BlockSearchCriteria>, SearcherRepository<BlockInfo,BlockSearchCriteria>

All Known Implementing Classes:

BlockRepositoryOkHttpImpl, BlockRepositoryVertxImpl

public interface BlockRepository
extends SearcherRepository<BlockInfo,BlockSearchCriteria>

Blockchain interface repository

Since:

1.0

Method Summary

Modifier and Type	Method and Description
io.reactivex.Observable<BlockInfo>	getBlockByHeight(java.math.BigInteger height) Gets a BlockInfo for a given block height.
io.reactivex.Observable<MerkleProofInfo>	getMerkleReceipts(java.math.BigInteger height, java.lang.String hash) Get the merkle path for a given a receipt statement hash and block Returns the merkle path for a receipt statement or resolution linked to a block.
io.reactivex.Observable<MerkleProofInfo>	getMerkleTransaction(java.math.BigInteger height, java.lang.String hash) Get the merkle path for a given a transaction and block Returns the merkle path for a [transaction](https://nemtech.github.io/concepts/transaction.html) included in a block.

Methods inherited from interface io.nem.symbol.sdk.api.SearcherRepository

streamer

Methods inherited from interface io.nem.symbol.sdk.api.Searcher

search

Method Detail

getBlockByHeight

io.reactivex.Observable<BlockInfo> getBlockByHeight(java.math.BigInteger height)

Gets a BlockInfo for a given block height.

Parameters:

height - BigInteger

Returns:

Observable of BlockInfo

getMerkleTransaction

io.reactivex.Observable<MerkleProofInfo> getMerkleTransaction(java.math.BigInteger height,
                                                              java.lang.String hash)

Get the merkle path for a given a transaction and block Returns the merkle path for a [transaction](https://nemtech.github.io/concepts/transaction.html) included in a block. The path is the complementary data needed to calculate the merkle root. A client can compare if the calculated root equals the one recorded in the block header, verifying that the transaction was included in the block.

Parameters:

height - the height.

hash - the expected hash.

Returns:

Observable of MerkleProofInfo

getMerkleReceipts

io.reactivex.Observable<MerkleProofInfo> getMerkleReceipts(java.math.BigInteger height,
                                                           java.lang.String hash)

Get the merkle path for a given a receipt statement hash and block Returns the merkle path for a receipt statement or resolution linked to a block. The merkle path is the minimum number of nodes needed to calculate the merkle root. Steps to calculate the merkle root: 1. proofHash = hash (leaf). 2. Concatenate proofHash with the first unprocessed item from the merklePath list as follows: * a) If item.position == left -> proofHash = sha_256(item.hash + proofHash). * b) If item.position == right -> proofHash = sha_256(proofHash+ item.hash). 3. Repeat 2. for every item in the merklePath list. 4. Compare if the calculated proofHash equals the one recorded in the block header (block.receiptsHash) to verify if the statement was linked with the block.

Parameters:

height - Block height. (required)

hash - Receipt hash. (required)

Returns:

Observable of MerkleProofInfo