io.nem.symbol.sdk.openapi.vertx.api

Class BlockRoutesApiImpl

java.lang.Object

io.nem.symbol.sdk.openapi.vertx.api.BlockRoutesApiImpl

All Implemented Interfaces:

BlockRoutesApi

@Generated(value="org.openapitools.codegen.languages.JavaClientCodegen",
           date="2020-03-11T19:40:23.988-03:00[America/Argentina/Buenos_Aires]")
public class BlockRoutesApiImpl
extends java.lang.Object
implements BlockRoutesApi

Constructor Summary

Constructors

Constructor and Description
BlockRoutesApiImpl()
BlockRoutesApiImpl(ApiClient apiClient)

Method Summary

Modifier and Type	Method and Description
ApiClient	getApiClient()
void	getBlockByHeight(java.math.BigInteger height, io.vertx.core.Handler<io.vertx.core.AsyncResult<BlockInfoDTO>> resultHandler) Get block information Gets a block from the chain that has the given height.
void	getBlocksByHeightWithLimit(java.math.BigInteger height, java.lang.Integer limit, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.util.List<BlockInfoDTO>>> resultHandler) Get blocks information Gets up to limit number of blocks after given block height.
void	getBlockTransactions(java.math.BigInteger height, java.lang.Integer pageSize, java.lang.String id, java.lang.String ordering, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.util.List<TransactionInfoDTO>>> resultHandler) Get transactions from a block Returns an array of transactions included in a block for a given block height.
void	getMerkleTransaction(java.math.BigInteger height, java.lang.String hash, io.vertx.core.Handler<io.vertx.core.AsyncResult<MerkleProofInfoDTO>> resultHandler) Get the merkle path for a given a transaction and block Returns the merkle path for a transaction included in a block.
void	setApiClient(ApiClient apiClient)

Methods inherited from class java.lang.Object

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

Constructor Detail

BlockRoutesApiImpl

public BlockRoutesApiImpl()

BlockRoutesApiImpl

public BlockRoutesApiImpl(ApiClient apiClient)

Method Detail

getApiClient

public ApiClient getApiClient()

setApiClient

public void setApiClient(ApiClient apiClient)

getBlockByHeight

public void getBlockByHeight(java.math.BigInteger height,
                             io.vertx.core.Handler<io.vertx.core.AsyncResult<BlockInfoDTO>> resultHandler)

Get block information Gets a block from the chain that has the given height.

Specified by:

getBlockByHeight in interface BlockRoutesApi

Parameters:

height - Block height. (required)

resultHandler - Asynchronous result handler

getBlockTransactions

public void getBlockTransactions(java.math.BigInteger height,
                                 java.lang.Integer pageSize,
                                 java.lang.String id,
                                 java.lang.String ordering,
                                 io.vertx.core.Handler<io.vertx.core.AsyncResult<java.util.List<TransactionInfoDTO>>> resultHandler)

Get transactions from a block Returns an array of transactions included in a block for a given block height.

Specified by:

getBlockTransactions in interface BlockRoutesApi

Parameters:

height - Block height. (required)

pageSize - Number of transactions to return for each request. (optional, default to 10)

id - Transaction identifier up to which transactions are returned. (optional)

ordering - Ordering criteria: * -id - Descending order by id. * id - Ascending order by id. (optional, default to "-id")

resultHandler - Asynchronous result handler

getBlocksByHeightWithLimit

public void getBlocksByHeightWithLimit(java.math.BigInteger height,
                                       java.lang.Integer limit,
                                       io.vertx.core.Handler<io.vertx.core.AsyncResult<java.util.List<BlockInfoDTO>>> resultHandler)

Get blocks information Gets up to limit number of blocks after given block height.

Specified by:

getBlocksByHeightWithLimit in interface BlockRoutesApi

Parameters:

height - Block height. (required)

limit - Number of elements to be returned. The limit should be greater than or equal to \"db.pageSizeMin\" and not higher than \"db.pageSizeMax\". The settings are adjustable via the configuration file (rest/resources/rest.json) per REST instance. (required)

resultHandler - Asynchronous result handler

getMerkleTransaction

public void getMerkleTransaction(java.math.BigInteger height,
                                 java.lang.String hash,
                                 io.vertx.core.Handler<io.vertx.core.AsyncResult<MerkleProofInfoDTO>> resultHandler)

Get the merkle path for a given a transaction and block Returns the merkle path for a transaction included in 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.transactionsHash) to verify if the transaction was included in the block.

Specified by:

getMerkleTransaction in interface BlockRoutesApi

Parameters:

height - Block height. (required)

hash - Transaction hash. (required)

resultHandler - Asynchronous result handler