io.nem.symbol.sdk.infrastructure.okhttp

Class BlockRepositoryOkHttpImpl

java.lang.Object

io.nem.symbol.sdk.infrastructure.okhttp.AbstractRepositoryOkHttpImpl

io.nem.symbol.sdk.infrastructure.okhttp.BlockRepositoryOkHttpImpl

All Implemented Interfaces:

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

public class BlockRepositoryOkHttpImpl
extends AbstractRepositoryOkHttpImpl
implements BlockRepository

Blockchain http repository.

Since:

1.0

Constructor Summary

Constructors

Constructor and Description
BlockRepositoryOkHttpImpl(io.nem.symbol.sdk.openapi.okhttp_gson.invoker.ApiClient apiClient)

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.nem.symbol.sdk.openapi.okhttp_gson.api.BlockRoutesApi	getClient()
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.
io.reactivex.Observable<Page<BlockInfo>>	search(BlockSearchCriteria criteria) It searches entities of a type based on a criteria.
static BlockInfo	toBlockInfo(io.nem.symbol.sdk.openapi.okhttp_gson.model.BlockInfoDTO blockInfoDTO, JsonHelper jsonHelper)

Methods inherited from class io.nem.symbol.sdk.infrastructure.okhttp.AbstractRepositoryOkHttpImpl

call, call, callList, exceptionHandling, exceptionHandling, extractStatusCodeFromException, getJsonHelper, onError, toDto, toDto, toDto, toDto, toDto, toMerkleStateInfo, toPage

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

streamer

Constructor Detail

BlockRepositoryOkHttpImpl

public BlockRepositoryOkHttpImpl(io.nem.symbol.sdk.openapi.okhttp_gson.invoker.ApiClient apiClient)

Method Detail

toBlockInfo

public static BlockInfo toBlockInfo(io.nem.symbol.sdk.openapi.okhttp_gson.model.BlockInfoDTO blockInfoDTO,
                                    JsonHelper jsonHelper)

getBlockByHeight

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

Description copied from interface: BlockRepository

Gets a BlockInfo for a given block height.

Specified by:

getBlockByHeight in interface BlockRepository

Parameters:

height - BigInteger

Returns:

Observable of BlockInfo

search

public io.reactivex.Observable<Page<BlockInfo>> search(BlockSearchCriteria criteria)

Description copied from interface: Searcher

It searches entities of a type based on a criteria.

Specified by:

search in interface Searcher<BlockInfo,BlockSearchCriteria>

Parameters:

criteria - the criteria

Returns:

a page of entities.

getMerkleTransaction

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

Description copied from interface: BlockRepository

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.

Specified by:

getMerkleTransaction in interface BlockRepository

Parameters:

height - the height.

hash - the expected hash.

Returns:

Observable of MerkleProofInfo

getMerkleReceipts

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

Description copied from interface: BlockRepository

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.

Specified by:

getMerkleReceipts in interface BlockRepository

Parameters:

height - Block height. (required)

hash - Receipt hash. (required)

Returns:

Observable of MerkleProofInfo

getClient

public io.nem.symbol.sdk.openapi.okhttp_gson.api.BlockRoutesApi getClient()