getblocktime

How to Use It

// yarn add @tatumio/tatum

import { TatumSDK, Solana, Network } from '@tatumio/tatum'

const tatum = await TatumSDK.init<Solana>({ network: Network.SOLANA })

const res = await tatum.rpc.getBlockTime(5)

await tatum.destroy() // Destroy Tatum SDK - needed for stopping background jobs

Overview

The getBlockTime method returns the estimated production time of a block. Each validator in the Solana network reports their UTC time to the ledger at regular intervals by intermittently adding a timestamp to a vote for a specific block. A requested block's time is then calculated from the stake-weighted mean of these vote timestamps recorded on the ledger in a set of recent blocks.

This method is useful in understanding when a particular block was produced, which is essential for various analysis and audit purposes.

Parameters

• blockNumber (number, required): This is the number of the block for which you want to retrieve the production time. The block number is identified by its slot.

Return Object

The method returns an integer or null:

• If the production time of the block is available, the method returns the estimated production time as a Unix timestamp (seconds since the Unix epoch).
• If the production time of the block is not available, the method returns null.

JSON-RPC Request Example

{
  "jsonrpc":"2.0", "id":1,
  "method": "getBlockTime",
  "params":[5]
}

JSON-RPC Response Example

{
  "jsonrpc": "2.0",
  "result": 1574721591,
  "id": 1
}