Skip to main content
POST
arc_getCertificate
Arc API method that returns the consensus commit certificate for a block height. The certificate is the Malachite BFT proof that the validator set committed the block, so it is what you check when you need finality evidence rather than the block contents. arc_getCertificate belongs to the custom arc_* namespace, which Arc adds on top of the standard Reth surface.
rpc_modules does not list arc in its response, because the namespace is registered outside the standard module registry. The method works regardless — do not use rpc_modules to decide whether it is available.

Parameters

  • height — the block height to get the commit certificate for, as an integer. Must be 1 or greater.

Response

  • height — the block height the certificate commits.
  • round — the consensus round in which the block was committed. 0 means the block was committed in the first round.
  • block_hash — the hash of the committed block.
  • signatures — the validator signatures that form the commit. Each entry has an address and a base64-encoded signature.

Error codes

  • -32602 — invalid params, returned when the height is below 1.
  • -32004 — no certificate is available for that height.
  • -32005 — the upstream consensus source is unreachable.

arc_getCertificate code examples

Use case

A cross-chain bridge or an exchange crediting deposits needs to know that a block is final, not merely present. On a BFT chain the commit certificate is that evidence: it names the validators that signed the block and the round they agreed in, so a relayer can verify the quorum itself instead of waiting out a confirmation count.

Body

application/json
id
integer
default:1
jsonrpc
string
default:2.0
method
string
default:arc_getCertificate
params
array

Response

200 - application/json

Returns the result of arc_getCertificate.

jsonrpc
string
id
integer
result
object
Last modified on August 3, 2026