Returns the retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns null when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.
Finality certificate and parsed verification fields, 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/consensus/get-a-finality-certificate","slug":"/reference/json-rpc/consensus/get-a-finality-certificate","pageMetadata":{"title":"Get a finality certificate","description":"Returns the retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns `null` when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getFinalityCertificate","href":"/reference/json-rpc/consensus/get-a-finality-certificate","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 retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns \", _jsx(_components.code, {\n children: \"null\"\n }), \" when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.\"]\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 finality certificate","description":"Returns the retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns `null` when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getFinalityCertificate","href":"/reference/json-rpc/consensus/get-a-finality-certificate","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"metal_getFinalityCertificate","tags":["Consensus"],"summary":"Get a finality certificate","description":"Returns the retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns `null` when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.","requestBody":"b98611a4-5a0c-4c9e-95e2-6c47b5526157","responses":{"200":"7cb7cbf6-dbc2-45e8-bb0e-8f846cfb0c82"},"method":"post","type":"path","servers":["caef7baf-3d86-41dc-8f71-87640e73c748","37d41364-2f26-4bb6-a72b-675139ae51eb"],"security":[],"path":"/metal_getFinalityCertificate","baseUrlOptions":["https://rpc-testnet.metalntwx.com/v1/{endpointId}","https://rpc-devnet.metalntwx.com"],"title":"Get a finality certificate","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.jsonrpc":"2.0","body.id":1,"body.method":"metal_getFinalityCertificate"}],"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":["metal_getFinalityCertificate"],"default":"metal_getFinalityCertificate","description":"JSON-RPC method name.","isRequired":true,"uniqueKey":"method","typeLabel":"enum\u003cstring>"},"params":{"type":"object","_tupleOriginal":true,"properties":{"[0]":{"type":"string","default":"0x4f06f3c2aebd79d3e85b577ad25d0643f469cf8d7a65c5fb29f96de0c4594870","description":"Finalized block hash.","uniqueKey":"params.[0]","typeLabel":"string"}},"description":"`[blockHash]`.","isRequired":true,"uniqueKey":"params","typeLabel":"tuple"}},"uniqueKey":"","typeLabel":"object"},"example":{"jsonrpc":"2.0","id":1,"method":"metal_getFinalityCertificate","params":["0x4f06f3c2aebd79d3e85b577ad25d0643f469cf8d7a65c5fb29f96de0c4594870"]},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":1,"method":"metal_getFinalityCertificate","params":["0x4f06f3c2aebd79d3e85b577ad25d0643f469cf8d7a65c5fb29f96de0c4594870"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"7cb7cbf6-dbc2-45e8-bb0e-8f846cfb0c82":{"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":"Finality certificate and parsed verification fields, or `null`.","properties":{"blockHash":{"type":"string","description":"Hash of the finalized block.","uniqueKey":"result.oneOf.0.blockHash","typeLabel":"string"},"blockNumber":{"type":"integer","description":"Finalized block height.","uniqueKey":"result.oneOf.0.blockNumber","typeLabel":"integer"},"headerRlp":{"type":"string","description":"Full RLP-encoded block header. Its Keccak-256 hash equals `blockHash`.","uniqueKey":"result.oneOf.0.headerRlp","typeLabel":"string"},"certificate":{"type":"string","description":"Canonical encoded Simplex finalization certificate.","uniqueKey":"result.oneOf.0.certificate","typeLabel":"string"},"epoch":{"type":"integer","description":"Consensus epoch.","uniqueKey":"result.oneOf.0.epoch","typeLabel":"integer"},"view":{"type":"integer","description":"Finalizing view.","uniqueKey":"result.oneOf.0.view","typeLabel":"integer"},"parentView":{"type":"integer","description":"Parent proposal view.","uniqueKey":"result.oneOf.0.parentView","typeLabel":"integer"},"participants":{"type":"integer","description":"Validator-set size indexed by the signer bitmap.","uniqueKey":"result.oneOf.0.participants","typeLabel":"integer"},"signerCount":{"type":"integer","description":"Number of validators that signed.","uniqueKey":"result.oneOf.0.signerCount","typeLabel":"integer"},"signersBitmap":{"type":"string","description":"Canonical signer bitmap, least-significant bit first within each byte.","uniqueKey":"result.oneOf.0.signersBitmap","typeLabel":"string"},"signatureEipUncompressed":{"type":"string","description":"Aggregate G2 signature in 256-byte EIP-2537 encoding.","uniqueKey":"result.oneOf.0.signatureEipUncompressed","typeLabel":"string"},"namespace":{"type":"string","description":"Hex-encoded base consensus signing namespace.","uniqueKey":"result.oneOf.0.namespace","typeLabel":"string"}},"uniqueKey":"result.oneOf.0","typeLabel":"object"},{"type":"null","description":"Finality certificate and parsed verification fields, or `null`.","properties":{"blockHash":{"type":"string","description":"Hash of the finalized block."},"blockNumber":{"type":"integer","description":"Finalized block height."},"headerRlp":{"type":"string","description":"Full RLP-encoded block header. Its Keccak-256 hash equals `blockHash`."},"certificate":{"type":"string","description":"Canonical encoded Simplex finalization certificate."},"epoch":{"type":"integer","description":"Consensus epoch."},"view":{"type":"integer","description":"Finalizing view."},"parentView":{"type":"integer","description":"Parent proposal view."},"participants":{"type":"integer","description":"Validator-set size indexed by the signer bitmap."},"signerCount":{"type":"integer","description":"Number of validators that signed."},"signersBitmap":{"type":"string","description":"Canonical signer bitmap, least-significant bit first within each byte."},"signatureEipUncompressed":{"type":"string","description":"Aggregate G2 signature in 256-byte EIP-2537 encoding."},"namespace":{"type":"string","description":"Hex-encoded base consensus signing namespace."}},"uniqueKey":"result.oneOf.1","typeLabel":"null"}],"uniqueKey":"result","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"jsonrpc":"2.0","id":1,"result":{"blockHash":"0x4f06f3c2aebd79d3e85b577ad25d0643f469cf8d7a65c5fb29f96de0c4594870","blockNumber":4242,"headerRlp":"0xf902...","certificate":"0x002a29...","epoch":0,"view":42,"parentView":41,"participants":3,"signerCount":3,"signersBitmap":"0x07","signatureEipUncompressed":"0x0000...","namespace":"0x6d6574616c2d636f6e73656e73757301..."}},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":1,"result":{"blockHash":"0x4f06f3c2aebd79d3e85b577ad25d0643f469cf8d7a65c5fb29f96de0c4594870","blockNumber":4242,"headerRlp":"0xf902...","certificate":"0x002a29...","epoch":0,"view":42,"parentView":41,"participants":3,"signerCount":3,"signersBitmap":"0x07","signatureEipUncompressed":"0x0000...","namespace":"0x6d6574616c2d636f6e73656e73757301..."}}}},"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 finality certificate - Metal Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T08:24:07.443Z","originalFileLocation":"reference/json-rpc/consensus/get-a-finality-certificate.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 retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns null when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.\">\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 finality certificate - Metal Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns null when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.\">\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/consensus/get-a-finality-certificate\">\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=Consensus\u0026amp;title=Get+a+finality+certificate\u0026amp;description=Returns+the+retained+Simplex+finality+certificate+and+block-header+preimage+for+a+finalized+block+hash.+Nodes+retain+recent+certificates%2C+with+a+default+limit+o\u0026amp;theme=391fcc429c2f0a56224a63fc\u0026amp;signature=ee2c6bbdcc61e40e4b8a4ac3fdf61354bf24bcf66f1ac3f8494e7f1fd90bd3b3\">\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 finality certificate - Metal Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns null when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nexus-ed339086.mintlify.site/_mintlify/api/og/v2?division=Consensus\u0026amp;title=Get+a+finality+certificate\u0026amp;description=Returns+the+retained+Simplex+finality+certificate+and+block-header+preimage+for+a+finalized+block+hash.+Nodes+retain+recent+certificates%2C+with+a+default+limit+o\u0026amp;theme=391fcc429c2f0a56224a63fc\u0026amp;signature=ee2c6bbdcc61e40e4b8a4ac3fdf61354bf24bcf66f1ac3f8494e7f1fd90bd3b3\">\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/consensus/get-a-finality-certificate\">\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/consensus/get-a-finality-certificate.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/consensus/get-a-finality-certificate#webpage\",\"url\":\"https://docs.metalntwx.com/reference/json-rpc/consensus/get-a-finality-certificate\",\"name\":\"Get a finality certificate\",\"description\":\"Returns the retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns null when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.\",\"dateModified\":\"2026-10-22T08:24:07.443Z\",\"isPartOf\":{\"@id\":\"https://docs.metalntwx.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/consensus/get-a-finality-certificate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/consensus/get-a-finality-certificate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Consensus\",\"item\":\"https://docs.metalntwx.com/reference/json-rpc/consensus/get-consensus-status\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a finality certificate\",\"item\":\"https://docs.metalntwx.com/reference/json-rpc/consensus/get-a-finality-certificate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/consensus/get-a-finality-certificate#apireference\",\"headline\":\"Get a finality certificate\",\"name\":\"Get a finality certificate\",\"description\":\"Returns the retained Simplex finality certificate and block-header preimage for a finalized block hash. Nodes retain recent certificates, with a default limit of 100,000. Returns null when no certificate is retained or the corresponding header cannot be read, such as before finality, during local import, or after pruning.\",\"url\":\"https://docs.metalntwx.com/reference/json-rpc/consensus/get-a-finality-certificate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/consensus/get-a-finality-certificate#webpage\"},\"dateModified\":\"2026-10-22T08:24:07.443Z\",\"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","description":"Returns the current Simplex epoch, round, leader, execution head, finalized block, and this node's latest signed round. For settlement decisions, require a successful receipt, compare its block number against `finalized.number`, and check that the canonical block at that height matches `receipt.blockHash`. A transaction hash can be computed before submission and does not establish finality.","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","description":"Identifies the running node build. Include this response when reporting a node-specific compatibility or operational issue.","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","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","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 finality certificate - 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"]}