ConfirmedBlockHeightExists#
Description#
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.
Verification#
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.