--- title: getBlock description: >- Returns a confirmed block for a slot, including block metadata and transaction data in the requested encoding. url: /docs/rpc/http/getblock type: reference hideTableOfContents: true --- Returns a confirmed block for a slot, including block metadata and transaction data in the requested encoding. [`get_block`](https://github.com/anza-xyz/agave/blob/v3.1.8/rpc/src/rpc.rs#L1285) ```jsonc !!request curl { "jsonrpc": "2.0", "id": 1, "method": "getBlock", "params": [ // !hover slot number 378967388, // !hover(1:7) config { // !hover commitment "commitment": "finalized", // !hover encoding "encoding": "json", // !hover transactionDetails "transactionDetails": "full", // !hover maxSupportedTransactionVersion "maxSupportedTransactionVersion": 0, // !hover rewards "rewards": true } ] } ``` ```ts !!request title="Kit" import { createSolanaRpc } from "@solana/kit"; const rpc_url = "https://api.devnet.solana.com"; const rpc = createSolanaRpc(rpc_url); // !hover slot number const slot_number = BigInt(377261141); let block = await rpc .getBlock( slot_number, // !hover(1:7) config { // !hover commitment commitment: "finalized", // !hover encoding encoding: "json", // !hover transactionDetails transactionDetails: "full", // !hover maxSupportedTransactionVersion maxSupportedTransactionVersion: 0, // !hover rewards rewards: true } ) .send(); console.log("block:", block); ``` ```ts !!request title="web3.js" import { Connection, clusterApiUrl } from "@solana/web3.js"; const connection = new Connection(clusterApiUrl("devnet"), "confirmed"); // !hover slot number const slot_number = 377261141; const block = await connection.getBlock( slot_number, // !hover(1:6) config { // !hover commitment commitment: "finalized", // !hover transactionDetails transactionDetails: "full", // !hover maxSupportedTransactionVersion maxSupportedTransactionVersion: 0, // !hover rewards rewards: true } ); console.log("block:", block); ``` ```rs !!request title="Rust" use anyhow::Result; use solana_client::nonblocking::rpc_client::RpcClient; use solana_commitment_config::CommitmentConfig; use solana_transaction_status_client_types::{TransactionDetails, UiTransactionEncoding}; #[tokio::main] async fn main() -> Result<()> { let client = RpcClient::new_with_commitment( String::from("https://api.devnet.solana.com"), CommitmentConfig::confirmed(), ); // !hover slot number let slot_number = 377261141; // !hover(1:7) config let config = solana_client::rpc_config::RpcBlockConfig { // !hover encoding encoding: UiTransactionEncoding::Json.into(), // !hover transactionDetails transaction_details: TransactionDetails::Full.into(), // !hover rewards rewards: None, // !hover commitment commitment: CommitmentConfig::finalized().into(), // !hover maxSupportedTransactionVersion max_supported_transaction_version: Some(0), }; let block = client.get_block_with_config(slot_number, config).await?; println!("Block: {:#?}", block); Ok(()) } ``` ### !params #### !! slot number !type u64 !required Slot number. #### !! config !type string | object !optional Configuration object. For backwards compatibility, this parameter also accepts a bare encoding string, but prefer the object form. Passing a bare encoding string as the second positional parameter is deprecated. Use the configuration object instead. When this parameter is an object, it may contain the following fields: ##### !! commitment !type string !values confirmed finalized !default finalized Solana RPC uses the following commitment levels: | Value | Description | | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `processed` | Return data from the highest slot this node has processed on the fork it currently considers best. This is the newest view, but it can still change if the cluster switches forks. | | `confirmed` | Return data from the highest slot that at least two-thirds of active stake has directly voted to confirm. This is more stable than `processed`, but it is still a weaker guarantee than `finalized`. | | `finalized` | Return data from the highest slot that the cluster recognizes as finalized. In practice, this means the slot has reached maximum vote lockout in validators' vote towers and is recognized by at least two-thirds of active stake. This is the strongest commitment level. | This method does not accept `processed`. ##### !! encoding !type string !values binary base58 base64 json jsonParsed !default json Encoding format for each returned transaction. | Encoding | Transaction format | Notes | | ------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `json` | JSON object | Default. Returns parsed transaction with `message` and `signatures` | | `jsonParsed` | JSON object | Uses program-specific parsers for `transaction.message.instructions`. Falls back to standard JSON fields (`accounts`, `data`, `programIdIndex`) if no parser found | | `base64` | `[data, "base64"]` | Base64 encoded binary transaction | | `base58` | `[data, "base58"]` | Slow | | `binary` | `[data, "base58"]` | ⚠️ Deprecated. Legacy alias for `base58`, retained for backwards compatibility | For `jsonParsed`, instruction entries use one of two stable outer shapes: `{program, programId, parsed, stackHeight}` when the RPC node can parse the instruction, or `{programId, accounts, data, stackHeight}` when it falls back to a partially decoded form. The nested `parsed` payload remains program-specific. If you use the deprecated shorthand encoding form, pass one of these encoding strings directly. For the shared JSON structures used by `json` and `jsonParsed` responses, see [Transactions](/docs/rpc/json-structures#transactions), [Parsed Accounts](/docs/rpc/json-structures#parsed-accounts), [Inner Instructions](/docs/rpc/json-structures#inner-instructions), and [Address Table Lookups](/docs/rpc/json-structures#address-table-lookups). ##### !! transactionDetails !type string !values full accounts signatures none !default full Level of transaction detail to return. - If `accounts` is requested, the response still includes `transactions`, but each `transactions[].transaction` object only contains `signatures` and an annotated `accountKeys` list. - In `accounts` mode, `transactions[].meta` is limited to `fee`, `err`, `status`, `preBalances`, `postBalances`, `preTokenBalances`, `postTokenBalances`, and `rewards`. - If `signatures` is requested, the response omits `transactions` and returns only the `signatures` array for the block. - If `none` is requested, the response omits both `transactions` and `signatures`. ##### !! maxSupportedTransactionVersion !type number !values 0 Currently, the only valid value for this parameter is `0`. Setting it to `0` allows you to fetch all transactions, including both Versioned and legacy transactions. This parameter determines the maximum transaction version that will be returned in the response. If you request a transaction with a higher version than this value, an error will be returned. If you omit this parameter, only legacy transactions will be returned—any block containing a versioned transaction will result in an error. ##### !! rewards !type bool !values true false !default true Whether to populate the rewards array. If parameter not provided, the default includes rewards. ### !!result ```jsonc !response { "jsonrpc": "2.0", // !hover(1:53) result "result": { // !hover blockHeight "blockHeight": 428, // !hover blockTime "blockTime": null, // !hover blockhash "blockhash": "3Eq21vXNB5s86c62bVuUfTeaMif1N2kUqRPBmGRJhyTA", // !hover parentSlot "parentSlot": 429, // !hover previousBlockhash "previousBlockhash": "mfcyqEXB3DnHXki6KjjmZck6YjmZLvpAByy2fj4nh6B", // !hover rewards "rewards": [], // !hover numRewardPartitions "numRewardPartitions": null, // !hover(1:45) transactions "transactions": [ { // !collapse(1:13) collapsed "meta": { "err": null, "fee": 5000, "innerInstructions": [], "logMessages": [], "postBalances": [499998932500, 26858640, 1, 1, 1], "postTokenBalances": [], "preBalances": [499998937500, 26858640, 1, 1, 1], "preTokenBalances": [], "rewards": null, "status": { "Ok": null } }, // !collapse(1:26) collapsed "transaction": { "message": { "accountKeys": [ "3UVYmECPPMZSCqWKfENfuoTv51fTDTWicX9xmBD2euKe", "AjozzgE83A3x1sHNUR64hfH7zaEBWeMaFuAN9kQgujrc", "SysvarS1otHashes111111111111111111111111111", "SysvarC1ock11111111111111111111111111111111", "Vote111111111111111111111111111111111111111" ], "header": { "numReadonlySignedAccounts": 0, "numReadonlyUnsignedAccounts": 3, "numRequiredSignatures": 1 }, "instructions": [ { "accounts": [1, 2, 3, 0], "data": "37u9WtQpcm6ULa3WRQHmj49EPs4if7o9f1jSRVZpm2dvihR9C8jY4NqEwXUbLwx15HBSNcP1", "programIdIndex": 4 } ], "recentBlockhash": "mfcyqEXB3DnHXki6KjjmZck6YjmZLvpAByy2fj4nh6B" }, // !hover(1:3) signatures "signatures": [ "2nBhEBYYvfaAe16UMNqRHre4YNSskvuYgx3M6E4JP1oDYvZEJHvoPzyUidNgNX5r9sTyN1J9UxtbCXy2rqYcuyuv" ] } } ] }, "id": 1 } ``` !type object | null If specified block is not confirmed result will be `null`. Otherwise, an object containing: This top-level response uses the shared [Confirmed Blocks](/docs/rpc/json-structures#confirmed-blocks) structure. ##### !! blockHeight !type u64 | null The number of blocks beneath this block. ##### !! blockTime !type i64 | null Estimated production time, as Unix timestamp (seconds since the Unix epoch). `null` if not available. ##### !! blockhash !type string The blockhash of this block, as base-58 encoded string ##### !! parentSlot !type u64 The slot index of this block's parent ##### !! previousBlockhash !type 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" ##### !! transactions !type array Present if `transactionDetails` is `"full"` or `"accounts"`; an array of JSON objects containing: | Field | Type | Description | | ------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `transaction` | `object \| string \| [string, encoding]` | Encoded transaction payload. For `transactionDetails: "full"`, this uses the shared [Encoded Transaction Responses](/docs/rpc/json-structures#encoded-transaction-responses) structure. For `transactionDetails: "accounts"`, this uses [Accounts Only Transaction Responses](/docs/rpc/json-structures#accounts-only-transaction-responses). | | `meta` | `object \| null` | Transaction status metadata, or `null` if metadata is unavailable. For `transactionDetails: "full"`, this uses [Transaction Status Metadata](/docs/rpc/json-structures#transaction-status-metadata). For `transactionDetails: "accounts"`, current Solana RPC responses return a simplified subset of that structure. | | `version` | `"legacy" \| number` | Transaction version. This field is omitted if `maxSupportedTransactionVersion` is not set in the request params. | **`transactions[].transaction` fields when `transactionDetails` is `"accounts"`** | Field | Type | Description | | ------------- | ------- | ------------------------------------------------------------------------------------------------------- | | `signatures` | `array` | Transaction signatures in wire order. | | `accountKeys` | `array` | Objects containing the listed `pubkey`, `signer`, and `writable` metadata for each transaction account. | **`transactions[].transaction.accountKeys[]` fields when `transactionDetails` is `"accounts"`** | Field | Type | Description | | ---------- | ---------------- | ------------------------------------------------------------------------------------- | | `pubkey` | `string` | Account address, as a base-58 encoded string. | | `signer` | `bool` | Whether this account signed the transaction. | | `writable` | `bool` | Whether the transaction marks this account writable. | | `source` | `string \| null` | Source of the account key. When present, the value is `transaction` or `lookupTable`. | **`transactions[].meta` fields when `transactionDetails` is `"accounts"`** | Field | Type | Description | | ------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------- | | `err` | `object \| string \| null` | Transaction error. `null` indicates success. | | `status` | `object` | Deprecated status object that mirrors `err`. It is `"Ok": ` for success or `"Err": ` for failure. | | `fee` | `u64` | Fee charged for the transaction, in lamports. | | `preBalances` | `array` | Lamport balances before execution, indexed to `transaction.accountKeys`. | | `postBalances` | `array` | Lamport balances after execution, indexed to `transaction.accountKeys`. | | `preTokenBalances` | `array \| null` | Token balances before execution. Each element uses [Token Balances](/docs/rpc/json-structures#token-balances). | | `postTokenBalances` | `array \| null` | Token balances after execution. Each element uses [Token Balances](/docs/rpc/json-structures#token-balances). | | `rewards` | `array \| null` | Rewards applied while processing the transaction. Each element uses [Rewards](/docs/rpc/json-structures#rewards). | **`transactions[].meta.err` object form** | Field | Type | Description | | --------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `` | `array \| object \| string \| null` | Transaction error variant payload. Most variants serialize as strings. `InstructionError` serializes as `[instructionIndex, instructionError]`. | **`token balance` fields** | Field | Type | Description | | --------------- | -------- | ----------------------------------------------------------------------------------------------------- | | `accountIndex` | `u8` | Index into the transaction account list for the token account whose balance is reported. | | `mint` | `string` | Token mint pubkey, as a base-58 encoded string. | | `uiTokenAmount` | `object` | Token amount object with raw and decimal-scaled representations. | | `owner` | `string` | Token account owner pubkey, when the validator recorded it. This field may be omitted. | | `programId` | `string` | SPL Token program pubkey for this account, when the validator recorded it. This field may be omitted. | **`token balance.uiTokenAmount` fields** | Field | Type | Description | | ---------------- | ---------------- | ------------------------------------------------------------------------------------------ | | `uiAmount` | `number \| null` | Decimal-scaled amount as a floating-point number. Deprecated in favor of `uiAmountString`. | | `decimals` | `u8` | Number of decimal places configured on the mint. | | `amount` | `string` | Raw token amount, as a base-10 integer string. | | `uiAmountString` | `string` | Decimal-scaled amount as a string. | ##### !! signatures !type array Present if "signatures" transaction details are requested; an array of signature strings, corresponding to the transaction order in the block. ##### !! rewards !type array Present if rewards are requested; an array of reward objects with the following fields: This field uses the shared [Rewards](/docs/rpc/json-structures#rewards) structure. | Field | Type | Description | | ------------- | ---------------- | ----------------------------------------------------------------------------------------------- | | `pubkey` | `string` | Rewarded account pubkey, as a base-58 encoded string. | | `lamports` | `i64` | Lamports credited or debited by this reward entry. | | `postBalance` | `u64` | Account balance after the reward was applied. | | `rewardType` | `string \| null` | Reward category. When present, the value is `fee`, `rent`, `voting`, or `staking`. | | `commission` | `u8 \| null` | Vote-account commission at the time of the reward. Present only for voting and staking rewards. | ##### !! numRewardPartitions !type u64 | null The number of reward partitions for this block if using partitioned rewards, or `null`.