Returns the block for the given selector, or null if unknown. The standard Ethereum fields are extended with timestampMillisPart, proposer, interopMessageRoot, ethereumUpdate, validatorSetRoot, nextValidatorSetRoot, and optional subblockMetadataRoot. Full timestamp in milliseconds = timestamp * 1000 + timestampMillisPart.
Standard Ethereum block plus the Metal header fields described below, or null.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Metal Developer Docs","colors":{"primary":"#101010","light":"#FFFFFF","dark":"#101010"},"logo":{"light":"https://mintcdn.com/nexus-ed339086/8NETQ7EroQCQNtZt/logo/light.svg?fit=max\u0026auto=format\u0026n=8NETQ7EroQCQNtZt\u0026q=85\u0026s=8014698736b169612a6590ce69d58883","dark":"https://mintcdn.com/nexus-ed339086/8NETQ7EroQCQNtZt/logo/dark.svg?fit=max\u0026auto=format\u0026n=8NETQ7EroQCQNtZt\u0026q=85\u0026s=5a46b40554cde2b544365ab3757ac675","href":"https://metalntwx.com"},"favicon":"https://mintcdn.com/nexus-ed339086/CdWwGT0bcT9zD-Uw/favicon.svg?fit=max\u0026auto=format\u0026n=CdWwGT0bcT9zD-Uw\u0026q=85\u0026s=f35321352c5de28978c9d79e5631a2f1","api":{"playground":{"proxy":false},"examples":{"prefill":true}},"navbar":{"links":[{"href":"https://metalntwx.com","label":"Website"}]},"footer":{"socials":{}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nexus-ed339086","hasAudioNarration":false,"actualSubdomain":"nexus-ed339086","customDomains":["docs.metalntwx.com"],"gitSource":{"type":"github","owner":"mx56db","repo":"metal","deployBranch":"main","contentDirectory":"docs/external-developers","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aebbbfaadab846ec705ccf3","collectionId":"43f0fced-43b0-4426-b139-006c89aba297","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aebbbfaadab846ec705ccf3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aebbbfaadab846ec705ccf3","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Blockchain","count":110},{"language":"default","tag":"Reference","count":33},{"language":"default","tag":"JSON-RPC","count":27},{"language":"default","tag":"Build","count":26},{"language":"default","tag":"Learn","count":17},{"language":"default","tag":"Agents","count":13},{"language":"default","tag":"Start","count":11},{"language":"default","tag":"Interoperability","count":8},{"language":"default","tag":"Network fundamentals","count":8},{"language":"default","tag":"MIP410","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/json-rpc/blocks/get-a-block-by-number","slug":"/reference/json-rpc/blocks/get-a-block-by-number","pageMetadata":{"title":"Get a block by number","description":"Returns the block for the given selector, or `null` if unknown. The standard Ethereum fields are extended with `timestampMillisPart`, `proposer`, `interopMessageRoot`, `ethereumUpdate`, `validatorSetRoot`, `nextValidatorSetRoot`, and optional `subblockMetadataRoot`. Full timestamp in milliseconds = `timestamp * 1000 + timestampMillisPart`.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBlockByNumber","href":"/reference/json-rpc/blocks/get-a-block-by-number","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns the block for the given selector, or \", _jsx(_components.code, {\n children: \"null\"\n }), \" if unknown. The standard Ethereum fields are extended with \", _jsx(_components.code, {\n children: \"timestampMillisPart\"\n }), \", \", _jsx(_components.code, {\n children: \"proposer\"\n }), \", \", _jsx(_components.code, {\n children: \"interopMessageRoot\"\n }), \", \", _jsx(_components.code, {\n children: \"ethereumUpdate\"\n }), \", \", _jsx(_components.code, {\n children: \"validatorSetRoot\"\n }), \", \", _jsx(_components.code, {\n children: \"nextValidatorSetRoot\"\n }), \", and optional \", _jsx(_components.code, {\n children: \"subblockMetadataRoot\"\n }), \". Full timestamp in milliseconds = \", _jsx(_components.code, {\n children: \"timestamp * 1000 + timestampMillisPart\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a block by number","description":"Returns the block for the given selector, or `null` if unknown. The standard Ethereum fields are extended with `timestampMillisPart`, `proposer`, `interopMessageRoot`, `ethereumUpdate`, `validatorSetRoot`, `nextValidatorSetRoot`, and optional `subblockMetadataRoot`. Full timestamp in milliseconds = `timestamp * 1000 + timestampMillisPart`.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBlockByNumber","href":"/reference/json-rpc/blocks/get-a-block-by-number","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"eth_getBlockByNumber","tags":["Blocks"],"summary":"Get a block by number","description":"Returns the block for the given selector, or `null` if unknown. The standard Ethereum fields are extended with `timestampMillisPart`, `proposer`, `interopMessageRoot`, `ethereumUpdate`, `validatorSetRoot`, `nextValidatorSetRoot`, and optional `subblockMetadataRoot`. Full timestamp in milliseconds = `timestamp * 1000 + timestampMillisPart`.","requestBody":"675167d7-2fac-4573-a644-b21022690071","responses":{"200":"a2c46db2-0e6b-48da-b5f2-ca49016f440e"},"method":"post","type":"path","servers":["caef7baf-3d86-41dc-8f71-87640e73c748","37d41364-2f26-4bb6-a72b-675139ae51eb"],"security":[],"path":"/eth_getBlockByNumber","baseUrlOptions":["https://rpc-testnet.metalntwx.com/v1/{endpointId}","https://rpc-devnet.metalntwx.com"],"title":"Get a block by number","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.jsonrpc":"2.0","body.id":1,"body.method":"eth_getBlockByNumber"}],"disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"],"default":"2.0","description":"JSON-RPC protocol version. Always `2.0`.","isRequired":true,"uniqueKey":"jsonrpc","typeLabel":"enum\u003cstring>"},"id":{"type":"integer","default":1,"description":"Request identifier echoed back in the response.","isRequired":true,"uniqueKey":"id","typeLabel":"integer"},"method":{"type":"string","enum":["eth_getBlockByNumber"],"default":"eth_getBlockByNumber","description":"JSON-RPC method name.","isRequired":true,"uniqueKey":"method","typeLabel":"enum\u003cstring>"},"params":{"type":"object","_tupleOriginal":true,"properties":{"[0]":{"type":"string","default":"latest","description":"Block selector: `\"latest\"`, `\"pending\"`, `\"safe\"`, `\"finalized\"`, `\"earliest\"`, or a hex block number such as `\"0x1cf741\"`.","uniqueKey":"params.[0]","typeLabel":"string"},"[1]":{"type":"boolean","default":false,"description":"`true` to embed full transaction objects, `false` for hashes only.","uniqueKey":"params.[1]","typeLabel":"boolean"}},"description":"`[blockSelector, fullTransactions]`.","isRequired":true,"uniqueKey":"params","typeLabel":"tuple"}},"uniqueKey":"","typeLabel":"object"},"example":{"jsonrpc":"2.0","id":1,"method":"eth_getBlockByNumber","params":["latest",false]},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":1,"method":"eth_getBlockByNumber","params":["latest",false]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"a2c46db2-0e6b-48da-b5f2-ca49016f440e":{"description":"JSON-RPC 2.0 response. Errors are reported in-band via an `error` object with `code` and `message` in place of `result`.","content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","enum":["2.0"],"uniqueKey":"jsonrpc","typeLabel":"enum\u003cstring>"},"id":{"type":"integer","uniqueKey":"id","typeLabel":"integer"},"result":{"oneOf":[{"type":"object","description":"Standard Ethereum block plus the Metal header fields described below, or `null`.","properties":{"hash":{"oneOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Hash of the complete Metal header; null for a pending block.","uniqueKey":"result.oneOf.0.hash.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^0x[0-9a-fA-F]*$","description":"Hash of the complete Metal header; null for a pending block.","uniqueKey":"result.oneOf.0.hash.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.oneOf.0.hash","typeLabel":"string | null"},"parentHash":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Hash of the parent Metal block.","uniqueKey":"result.oneOf.0.parentHash","typeLabel":"string"},"sha3Uncles":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Hash of the empty ommers list; Metal has no ommers.","uniqueKey":"result.oneOf.0.sha3Uncles","typeLabel":"string"},"miner":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"20-byte EVM fee recipient; distinct from the BLS proposer.","uniqueKey":"result.oneOf.0.miner","typeLabel":"string"},"stateRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"32-byte root of the resulting EVM state.","uniqueKey":"result.oneOf.0.stateRoot","typeLabel":"string"},"transactionsRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"32-byte root of the block transactions.","uniqueKey":"result.oneOf.0.transactionsRoot","typeLabel":"string"},"receiptsRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"32-byte root of the transaction receipts.","uniqueKey":"result.oneOf.0.receiptsRoot","typeLabel":"string"},"logsBloom":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"256-byte bloom filter for logs in this block.","uniqueKey":"result.oneOf.0.logsBloom","typeLabel":"string"},"extraData":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Execution-header extra data.","uniqueKey":"result.oneOf.0.extraData","typeLabel":"string"},"mixHash":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Execution-header mix hash.","uniqueKey":"result.oneOf.0.mixHash","typeLabel":"string"},"nonce":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"8-byte execution-header nonce.","uniqueKey":"result.oneOf.0.nonce","typeLabel":"string"},"withdrawalsRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Withdrawals root when present in the active execution-header revision.","uniqueKey":"result.oneOf.0.withdrawalsRoot","typeLabel":"string"},"parentBeaconBlockRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Execution-header beacon-root field; Metal does not use Ethereum Beacon consensus for its own finality.","uniqueKey":"result.oneOf.0.parentBeaconBlockRoot","typeLabel":"string"},"requestsHash":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Execution requests hash when present in the active execution-header revision.","uniqueKey":"result.oneOf.0.requestsHash","typeLabel":"string"},"number":{"oneOf":[{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Block height; null for a pending block.","uniqueKey":"result.oneOf.0.number.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Block height; null for a pending block.","uniqueKey":"result.oneOf.0.number.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.oneOf.0.number","typeLabel":"string | null"},"difficulty":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Execution-header difficulty; zero on Metal.","uniqueKey":"result.oneOf.0.difficulty","typeLabel":"string"},"gasLimit":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Maximum execution gas for this block.","uniqueKey":"result.oneOf.0.gasLimit","typeLabel":"string"},"gasUsed":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Execution gas consumed by included transactions.","uniqueKey":"result.oneOf.0.gasUsed","typeLabel":"string"},"timestamp":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Unix time in whole seconds. Combine with timestampMillisPart for milliseconds.","uniqueKey":"result.oneOf.0.timestamp","typeLabel":"string"},"size":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"RLP-encoded block size in bytes.","uniqueKey":"result.oneOf.0.size","typeLabel":"string"},"baseFeePerGas":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Execution base fee; zero on Metal.","uniqueKey":"result.oneOf.0.baseFeePerGas","typeLabel":"string"},"blobGasUsed":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Blob gas consumed by this block.","uniqueKey":"result.oneOf.0.blobGasUsed","typeLabel":"string"},"excessBlobGas":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Execution-header excess blob gas.","uniqueKey":"result.oneOf.0.excessBlobGas","typeLabel":"string"},"transactions":{"type":"array","description":"Transaction hashes when fullTransactions is false; complete transaction objects when true.","items":{"oneOf":[{"type":"string","description":"32-byte transaction hash.","pattern":"^0x[0-9a-fA-F]*$","uniqueKey":"result.oneOf.0.transactions.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","description":"Transaction object, or `null` if unknown.","uniqueKey":"result.oneOf.0.transactions.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"result.oneOf.0.transactions.items.[INDEX]","typeLabel":"string | object"},"uniqueKey":"result.oneOf.0.transactions","typeLabel":"(string | object)[]"},"uncles":{"type":"array","maxItems":0,"items":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Ommer hash.","uniqueKey":"result.oneOf.0.uncles.items.[INDEX]","typeLabel":"string"},"description":"Empty; Metal has no ommers.","uniqueKey":"result.oneOf.0.uncles","typeLabel":"string[]"},"withdrawals":{"type":"array","description":"Execution-header withdrawals when present.","items":{"type":"object","properties":{"index":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Withdrawal index.","uniqueKey":"result.oneOf.0.withdrawals.items.[INDEX].index","typeLabel":"string"},"validatorIndex":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Validator index.","uniqueKey":"result.oneOf.0.withdrawals.items.[INDEX].validatorIndex","typeLabel":"string"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Recipient address.","uniqueKey":"result.oneOf.0.withdrawals.items.[INDEX].address","typeLabel":"string"},"amount":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Withdrawal amount.","uniqueKey":"result.oneOf.0.withdrawals.items.[INDEX].amount","typeLabel":"string"}},"uniqueKey":"result.oneOf.0.withdrawals.items.[INDEX]","typeLabel":"object"},"uniqueKey":"result.oneOf.0.withdrawals","typeLabel":"object[]"},"timestampMillisPart":{"type":"string","description":"Hex quantity from `0x0` to `0x3e7`. Full timestamp in milliseconds is `timestamp * 1000 + timestampMillisPart`.","uniqueKey":"result.oneOf.0.timestampMillisPart","typeLabel":"string"},"proposer":{"type":"string","description":"48-byte compressed BLS public key of the proposing validator, as 0x-prefixed hex. All zeros at genesis; distinct from the EVM fee recipient.","uniqueKey":"result.oneOf.0.proposer","typeLabel":"string"},"interopMessageRoot":{"type":"string","description":"32-byte cumulative interop outbox commitment as 0x-prefixed hex; zero before any message has been sent.","uniqueKey":"result.oneOf.0.interopMessageRoot","typeLabel":"string"},"ethereumUpdate":{"type":"string","description":"0x-prefixed bytes containing an Ethereum consensus operation kind byte followed by its raw SSZ witness; `0x` when absent.","uniqueKey":"result.oneOf.0.ethereumUpdate","typeLabel":"string"},"validatorSetRoot":{"type":"string","description":"32-byte root of the validator set for this block's epoch, as 0x-prefixed hex. Zero at genesis.","uniqueKey":"result.oneOf.0.validatorSetRoot","typeLabel":"string"},"nextValidatorSetRoot":{"type":"string","description":"32-byte root of the next epoch's validator set, as 0x-prefixed hex. Equals `validatorSetRoot` while the set is unchanged; zero at genesis.","uniqueKey":"result.oneOf.0.nextValidatorSetRoot","typeLabel":"string"},"subblockMetadataRoot":{"type":"string","description":"Optional 32-byte root of ordered subblock metadata, as 0x-prefixed hex. Omitted when absent.","uniqueKey":"result.oneOf.0.subblockMetadataRoot","typeLabel":"string"}},"uniqueKey":"result.oneOf.0","typeLabel":"object"},{"type":"null","description":"Standard Ethereum block plus the Metal header fields described below, or `null`.","properties":{"hash":{"oneOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Hash of the complete Metal header; null for a pending block."},{"type":"null","pattern":"^0x[0-9a-fA-F]*$","description":"Hash of the complete Metal header; null for a pending block."}]},"parentHash":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Hash of the parent Metal block."},"sha3Uncles":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Hash of the empty ommers list; Metal has no ommers."},"miner":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"20-byte EVM fee recipient; distinct from the BLS proposer."},"stateRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"32-byte root of the resulting EVM state."},"transactionsRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"32-byte root of the block transactions."},"receiptsRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"32-byte root of the transaction receipts."},"logsBloom":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"256-byte bloom filter for logs in this block."},"extraData":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Execution-header extra data."},"mixHash":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Execution-header mix hash."},"nonce":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"8-byte execution-header nonce."},"withdrawalsRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Withdrawals root when present in the active execution-header revision."},"parentBeaconBlockRoot":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Execution-header beacon-root field; Metal does not use Ethereum Beacon consensus for its own finality."},"requestsHash":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Execution requests hash when present in the active execution-header revision."},"number":{"oneOf":[{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Block height; null for a pending block."},{"type":"null","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Block height; null for a pending block."}]},"difficulty":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Execution-header difficulty; zero on Metal."},"gasLimit":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Maximum execution gas for this block."},"gasUsed":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Execution gas consumed by included transactions."},"timestamp":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Unix time in whole seconds. Combine with timestampMillisPart for milliseconds."},"size":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"RLP-encoded block size in bytes."},"baseFeePerGas":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Execution base fee; zero on Metal."},"blobGasUsed":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Blob gas consumed by this block."},"excessBlobGas":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Execution-header excess blob gas."},"transactions":{"type":"array","description":"Transaction hashes when fullTransactions is false; complete transaction objects when true.","items":{"oneOf":[{"type":"string","description":"32-byte transaction hash.","pattern":"^0x[0-9a-fA-F]*$"},{"type":"object","description":"Transaction object, or `null` if unknown."}]}},"uncles":{"type":"array","maxItems":0,"items":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Ommer hash."},"description":"Empty; Metal has no ommers."},"withdrawals":{"type":"array","description":"Execution-header withdrawals when present.","items":{"type":"object","properties":{"index":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Withdrawal index."},"validatorIndex":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Validator index."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Recipient address."},"amount":{"type":"string","pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","description":"Withdrawal amount."}}}},"timestampMillisPart":{"type":"string","description":"Hex quantity from `0x0` to `0x3e7`. Full timestamp in milliseconds is `timestamp * 1000 + timestampMillisPart`."},"proposer":{"type":"string","description":"48-byte compressed BLS public key of the proposing validator, as 0x-prefixed hex. All zeros at genesis; distinct from the EVM fee recipient."},"interopMessageRoot":{"type":"string","description":"32-byte cumulative interop outbox commitment as 0x-prefixed hex; zero before any message has been sent."},"ethereumUpdate":{"type":"string","description":"0x-prefixed bytes containing an Ethereum consensus operation kind byte followed by its raw SSZ witness; `0x` when absent."},"validatorSetRoot":{"type":"string","description":"32-byte root of the validator set for this block's epoch, as 0x-prefixed hex. Zero at genesis."},"nextValidatorSetRoot":{"type":"string","description":"32-byte root of the next epoch's validator set, as 0x-prefixed hex. Equals `validatorSetRoot` while the set is unchanged; zero at genesis."},"subblockMetadataRoot":{"type":"string","description":"Optional 32-byte root of ordered subblock metadata, as 0x-prefixed hex. Omitted when absent."}},"uniqueKey":"result.oneOf.1","typeLabel":"null"}],"uniqueKey":"result","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"jsonrpc":"2.0","id":1,"result":{"hash":"0xd4ddea8815732fae7af5b907c5d3db50475ed180510e8035789640fb144b1722","number":"0x1cf6b4","timestamp":"0x6a87ac45","timestampMillisPart":"0x9f","proposer":"0x8f59f57db707e439c261f878e88170c6848d8a3493b272c21308d879068e67da19efde55f5bf4c2eb61439232e3cae76","interopMessageRoot":"0x0000000000000000000000000000000000000000000000000000000000000000","ethereumUpdate":"0x","validatorSetRoot":"0x1111111111111111111111111111111111111111111111111111111111111111","nextValidatorSetRoot":"0x1111111111111111111111111111111111111111111111111111111111111111","gasUsed":"0x0","gasLimit":"0x1dcd6500","transactions":[]}},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":1,"result":{"hash":"0xd4ddea8815732fae7af5b907c5d3db50475ed180510e8035789640fb144b1722","number":"0x1cf6b4","timestamp":"0x6a87ac45","timestampMillisPart":"0x9f","proposer":"0x8f59f57db707e439c261f878e88170c6848d8a3493b272c21308d879068e67da19efde55f5bf4c2eb61439232e3cae76","interopMessageRoot":"0x0000000000000000000000000000000000000000000000000000000000000000","ethereumUpdate":"0x","validatorSetRoot":"0x1111111111111111111111111111111111111111111111111111111111111111","nextValidatorSetRoot":"0x1111111111111111111111111111111111111111111111111111111111111111","gasUsed":"0x0","gasLimit":"0x1dcd6500","transactions":[]}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"caef7baf-3d86-41dc-8f71-87640e73c748":{"url":"https://rpc-testnet.metalntwx.com/v1/{endpointId}","variables":{"endpointId":{"default":"YOUR_ENDPOINT_ID","description":"Your endpoint ID from the Metal console. It is a credential, so keep it private. Paste it once, and the playground remembers it in this browser."}},"description":"Testnet"},"37d41364-2f26-4bb6-a72b-675139ae51eb":{"url":"https://rpc-devnet.metalntwx.com","description":"Devnet"}}},"originalFileLocation":"reference/json-rpc/json-rpc.json"},"subdomain":"nexus-ed339086","siteName":"Metal Developer Docs","title":"Get a block by number - Metal Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T08:24:07.477Z","originalFileLocation":"reference/json-rpc/blocks/get-a-block-by-number.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns the block for the given selector, or null if unknown. The standard Ethereum fields are extended with timestampMillisPart, proposer, interopMessageRoot, ethereumUpdate, validatorSetRoot, nextValidatorSetRoot, and optional subblockMetadataRoot. Full timestamp in milliseconds = timestamp * 1000 + timestampMillisPart.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Metal Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a block by number - Metal Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the block for the given selector, or null if unknown. The standard Ethereum fields are extended with timestampMillisPart, proposer, interopMessageRoot, ethereumUpdate, validatorSetRoot, nextValidatorSetRoot, and optional subblockMetadataRoot. Full timestamp in milliseconds = timestamp * 1000 + timestampMillisPart.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Metal Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nexus-ed339086.mintlify.site/_mintlify/api/og/v2?division=Blocks\u0026amp;title=Get+a+block+by+number\u0026amp;description=Returns+the+block+for+the+given+selector%2C+or+%60null%60+if+unknown.+The+standard+Ethereum+fields+are+extended+with+%60timestampMillisPart%60%2C+%60proposer%60%2C+%60interopMessag\u0026amp;theme=391fcc429c2f0a56224a63fc\u0026amp;signature=488a4a360e1c55c58cdc1384e1f959a95300b1a22b3adae28deae6ecb485322e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a block by number - Metal Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the block for the given selector, or null if unknown. The standard Ethereum fields are extended with timestampMillisPart, proposer, interopMessageRoot, ethereumUpdate, validatorSetRoot, nextValidatorSetRoot, and optional subblockMetadataRoot. Full timestamp in milliseconds = timestamp * 1000 + timestampMillisPart.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nexus-ed339086.mintlify.site/_mintlify/api/og/v2?division=Blocks\u0026amp;title=Get+a+block+by+number\u0026amp;description=Returns+the+block+for+the+given+selector%2C+or+%60null%60+if+unknown.+The+standard+Ethereum+fields+are+extended+with+%60timestampMillisPart%60%2C+%60proposer%60%2C+%60interopMessag\u0026amp;theme=391fcc429c2f0a56224a63fc\u0026amp;signature=488a4a360e1c55c58cdc1384e1f959a95300b1a22b3adae28deae6ecb485322e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Metal Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#101010\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/json-rpc/blocks/get-a-block-by-number.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.metalntwx.com/#organization\",\"name\":\"Metal Developer Docs\",\"url\":\"https://docs.metalntwx.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nexus-ed339086/8NETQ7EroQCQNtZt/logo/light.svg?fit=max\u0026auto=format\u0026n=8NETQ7EroQCQNtZt\u0026q=85\u0026s=8014698736b169612a6590ce69d58883\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.metalntwx.com#website\",\"name\":\"Metal Developer Docs\",\"url\":\"https://docs.metalntwx.com\",\"publisher\":{\"@id\":\"https://docs.metalntwx.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number#webpage\",\"url\":\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number\",\"name\":\"Get a block by number\",\"description\":\"Returns the block for the given selector, or null if unknown. The standard Ethereum fields are extended with timestampMillisPart, proposer, interopMessageRoot, ethereumUpdate, validatorSetRoot, nextValidatorSetRoot, and optional subblockMetadataRoot. Full timestamp in milliseconds = timestamp * 1000 + timestampMillisPart.\",\"dateModified\":\"2026-10-22T08:24:07.477Z\",\"isPartOf\":{\"@id\":\"https://docs.metalntwx.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Metal Developer Docs\",\"item\":\"https://docs.metalntwx.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a block by number\",\"item\":\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number#apireference\",\"headline\":\"Get a block by number\",\"name\":\"Get a block by number\",\"description\":\"Returns the block for the given selector, or null if unknown. The standard Ethereum fields are extended with timestampMillisPart, proposer, interopMessageRoot, ethereumUpdate, validatorSetRoot, nextValidatorSetRoot, and optional subblockMetadataRoot. Full timestamp in milliseconds = timestamp * 1000 + timestampMillisPart.\",\"url\":\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number\",\"mainEntityOfPage\":{\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/blocks/get-a-block-by-number#webpage\"},\"dateModified\":\"2026-10-22T08:24:07.477Z\",\"publisher\":{\"@id\":\"https://docs.metalntwx.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.metalntwx.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Metal Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Metal Developer Docs","nav":{"global":null,"products":[{"product":"Blockchain","description":"Chain, asset standards, SDKs, and integration guides","tabs":[{"tab":"Start","pages":[{"title":"Start","href":"/start/introduction"}]},{"tab":"Build","pages":[{"title":"Build","href":"/build/prepare/design-a-payment-integration"}]},{"tab":"Learn","pages":[{"title":"Learn","href":"/learn/architecture"}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/reference/contract-addresses"}]},{"tab":"JSON-RPC","groups":[{"group":"Getting started","pages":[{"title":"Metal JSON-RPC","icon":"rectangle-api","href":"/reference/json-rpc/overview"}]},{"group":"Chain","pages":[{"title":"Get the chain ID","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_chainId","href":"/reference/json-rpc/chain/get-the-chain-id"},{"title":"Get the latest block number","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_blockNumber","href":"/reference/json-rpc/chain/get-the-latest-block-number"}]},{"group":"Consensus","pages":[{"title":"Get consensus status","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /consensus_status","href":"/reference/json-rpc/consensus/get-consensus-status"},{"title":"Get a finality certificate","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getFinalityCertificate","href":"/reference/json-rpc/consensus/get-a-finality-certificate"},{"title":"Get node build info","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_nodeInfo","href":"/reference/json-rpc/consensus/get-node-build-info"},{"title":"Get gas-token display metadata","description":"Returns wallet display metadata for the chain's default MIP20 gas token. This is display metadata only — it does not create a native asset, and transactions must still set `value` to `0`.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_nativeCurrency","href":"/reference/json-rpc/consensus/get-gas-token-display-metadata"}]},{"group":"Blocks","pages":[{"title":"Get a block by number","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBlockByNumber","href":"/reference/json-rpc/blocks/get-a-block-by-number"},{"title":"Get a block by hash","description":"Returns the block for the given hash, or `null` if unknown. The standard Ethereum fields are extended with `timestampMillisPart`, `proposer`, `interopMessageRoot`, `ethereumUpdate`, `validatorSetRoot`, `nextValidatorSetRoot`, and optional `subblockMetadataRoot`. Full timestamp in milliseconds = `timestamp * 1000 + timestampMillisPart`.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBlockByHash","href":"/reference/json-rpc/blocks/get-a-block-by-hash"},{"title":"Get retained blob sidecars","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getBlobSidecars","href":"/reference/json-rpc/blocks/get-retained-blob-sidecars"}]},{"group":"State","pages":[{"title":"Get gas-token balance","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBalance","href":"/reference/json-rpc/state/get-gas-token-balance"},{"title":"Get account nonce","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getTransactionCount","href":"/reference/json-rpc/state/get-account-nonce"},{"title":"Get contract code","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getCode","href":"/reference/json-rpc/state/get-contract-code"},{"title":"Get a storage slot","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getStorageAt","href":"/reference/json-rpc/state/get-a-storage-slot"},{"title":"Get account and storage proofs","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getProof","href":"/reference/json-rpc/state/get-account-and-storage-proofs"},{"title":"Call a contract (read-only)","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_call","href":"/reference/json-rpc/state/call-a-contract-read-only"}]},{"group":"Gas","pages":[{"title":"Estimate gas","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_estimateGas","href":"/reference/json-rpc/gas/estimate-gas"},{"title":"Get the gas price","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_gasPrice","href":"/reference/json-rpc/gas/get-the-gas-price"},{"title":"Get the max priority fee","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_maxPriorityFeePerGas","href":"/reference/json-rpc/gas/get-the-max-priority-fee"},{"title":"Get fee history","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_feeHistory","href":"/reference/json-rpc/gas/get-fee-history"}]},{"group":"Transactions","pages":[{"title":"Submit a raw transaction","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_sendRawTransaction","href":"/reference/json-rpc/transactions/submit-a-raw-transaction"},{"title":"Get a transaction by hash","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getTransactionByHash","href":"/reference/json-rpc/transactions/get-a-transaction-by-hash"},{"title":"Get a transaction receipt","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getTransactionReceipt","href":"/reference/json-rpc/transactions/get-a-transaction-receipt"}]},{"group":"Logs","pages":[{"title":"Query event logs","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getLogs","href":"/reference/json-rpc/logs/query-event-logs"}]},{"group":"MIP20","pages":[{"title":"List pending MIP20 transactions","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_pendingMip20Transactions","href":"/reference/json-rpc/mip20/list-pending-mip20-transactions"},{"title":"Get MIP20 gas for a transaction","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getMip20GasByTransactionHash","href":"/reference/json-rpc/mip20/get-mip20-gas-for-a-transaction"},{"title":"Get MIP20 gas for a block","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getMip20GasByBlock","href":"/reference/json-rpc/mip20/get-mip20-gas-for-a-block"}]}]}]},{"product":"Agents","description":"Agents paying and getting paid over x402","pages":[{"title":"Agents","href":"/agents/quickstart"}]}]},"basePath":"","title":"Get a block by number - Metal Developer Docs","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","Page-CxAy5y67.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","clsx-C5EfhVm0.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CJ9Oly2E.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Mk6P3qvh.js"]}