Skip to content



An assertion that a block with blockNumber is confirmed. It also provides data to compute the block production rate in the given time range.

Supported sources: BTC, DOGE, XRP, testBTC, testDOGE, testXRP

Request body#

Field Solidity type Description
blockNumber uint64 The number of the block the request wants a confirmation of.
queryWindow uint64 The length of the period in which the block production rate is to be computed.

Response body#

Field Solidity type Description
blockTimestamp uint64 The timestamp of the block with blockNumber.
numberOfConfirmations uint64 The depth at which a block is considered confirmed depending on the chain. All attestation providers must agree on this number.
lowestQueryWindowBlockNumber uint64 The block number of the latest block that has a timestamp strictly smaller than blockTimestamp - queryWindow.
lowestQueryWindowBlockTimestamp uint64 The timestamp of the block at height lowestQueryWindowBlockNumber.

blockNumber, lowestQueryWindowBlockNumber, blockTimestamp and lowestQueryWindowBlockTimestamp can be used to compute the average block production time in the specified block range.


It is checked that the block with blockNumber is confirmed by at least numberOfConfirmations. If it is not, the request is rejected. We note a block on the tip of the chain is confirmed by 1 block. Then lowestQueryWindowBlock is determined and its number and timestamp are extracted.

Current confirmation heights consensus:

Chain chainId numberOfConfirmations timestamp
BTC 0 6 mediantime
DOGE 2 60 mediantime
XRP 3 3 close_time

Lowest Used Timestamp#

For lowestUsedTimestamp, lowestQueryWindowBlockTimestamp is used.