getBlock RPC Method

Parameters #

Result #

The result field will be an object with the following fields:

• <null> - if specified block is not confirmed
• <object> - if block is confirmed, an object with the following fields:
  • blockhash: <string> - the blockhash of this block, as base-58 encoded string
  • previousBlockhash: <string> - the blockhash of this block's parent, as base-58 encoded string; if the parent block is not available due to ledger cleanup, this field will return "11111111111111111111111111111111"
  • parentSlot: <u64> - the slot index of this block's parent
  • transactions: <array> - present if "full" transaction details are requested; an array of JSON objects containing:
    • transaction: <object|[string,encoding]> - Transaction object, either in JSON format or encoded binary data, depending on encoding parameter
    • meta: <object> - transaction status metadata object, containing null or:
      • err: <object|null> - Error if transaction failed, null if transaction succeeded. TransactionError definitions
      • fee: <u64> - fee this transaction was charged, as u64 integer
      • preBalances: <array> - array of u64 account balances from before the transaction was processed
      • postBalances: <array> - array of u64 account balances after the transaction was processed
      • innerInstructions: <array|null> - List of inner instructions or null if inner instruction recording was not enabled during this transaction
      • preTokenBalances: <array|undefined> - List of token balances from before the transaction was processed or omitted if token balance recording was not yet enabled during this transaction
      • postTokenBalances: <array|undefined> - List of token balances from after the transaction was processed or omitted if token balance recording was not yet enabled during this transaction
      • logMessages: <array|null> - array of string log messages or null if log message recording was not enabled during this transaction
      • rewards: <array|null> - transaction-level rewards, populated if rewards are requested; an array of JSON objects containing:
        • pubkey: <string> - The public key, as base-58 encoded string, of the account that received the reward
        • lamports: <i64>- number of reward lamports credited or debited by the account, as a i64
        • postBalance: <u64> - account balance in lamports after the reward was applied
        • rewardType: <string|undefined> - type of reward: "fee", "rent", "voting", "staking"
        • commission: <u8|undefined> - vote account commission when the reward was credited, only present for voting and staking rewards
      • DEPRECATED: status: <object> - Transaction status
        • "Ok": <null> - Transaction was successful
        • "Err": <ERR> - Transaction failed with TransactionError
      • loadedAddresses: <object|undefined> - Transaction addresses loaded from address lookup tables. Undefined if maxSupportedTransactionVersion is not set in request params, or if jsonParsed encoding is set in request params.
        • writable: <array[string]> - Ordered list of base-58 encoded addresses for writable loaded accounts
        • readonly: <array[string]> - Ordered list of base-58 encoded addresses for readonly loaded accounts
      • returnData: <object|undefined> - the most-recent return data generated by an instruction in the transaction, with the following fields:
        • programId: <string> - the program that generated the return data, as base-58 encoded Pubkey
        • data: <[string, encoding]> - the return data itself, as base-64 encoded binary data
      • computeUnitsConsumed: <u64|undefined> - number of compute units consumed by the transaction
    • version: <"legacy"|number|undefined> - Transaction version. Undefined if maxSupportedTransactionVersion is not set in request params.
  • signatures: <array> - present if "signatures" are requested for transaction details; an array of signatures strings, corresponding to the transaction order in the block
  • rewards: <array|undefined> - block-level rewards, present if rewards are requested; an array of JSON objects containing:
    • pubkey: <string> - The public key, as base-58 encoded string, of the account that received the reward
    • lamports: <i64>- number of reward lamports credited or debited by the account, as a i64
    • postBalance: <u64> - account balance in lamports after the reward was applied
    • rewardType: <string|undefined> - type of reward: "fee", "rent", "voting", "staking"
    • commission: <u8|undefined> - vote account commission when the reward was credited, only present for voting and staking rewards
  • blockTime: <i64|null> - estimated production time, as Unix timestamp (seconds since the Unix epoch). null if not available
  • blockHeight: <u64|null> - the number of blocks beneath this block