gaspersic/solana
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update getBlockTime rpc docs (#7688)

Browse Source
This commit is contained in:
Tyera Eulberg
2020-01-06 00:00:20 -07:00
committed by GitHub
parent e75a64a8a2
commit 9ce142606c
1 changed files with 11 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
book/src/api-reference/jsonrpc-api.md
View File

@ -213,9 +213,17 @@ curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1, "m
### getBlockTime ### getBlockTime
Returns the estimated production time of a block. Validators report their UTC Returns the estimated production time of a block.
time to the ledger on a regular interval. A block's time is calculated as an
offset from the median value of the most recent validator time report. Each validator reports their UTC time to the ledger on a regular interval by
intermittently adding a timestamp to a Vote for a particular block. A requested
block's time is calculated from the stake-weighted mean of the Vote timestamps
in a set of recent blocks recorded on the ledger.
Nodes that are booting from snapshot or limiting ledger size (by purging old
slots) will return null timestamps for blocks below their lowest root +
`TIMESTAMP_SLOT_RANGE`. Users interested in having this historical data must
query a node that is built from genesis and retains the entire ledger.
#### Parameters: #### Parameters: