arc_getCertificate - Arc

arc_getCertificate. Returns the Malachite BFT consensus commit certificate for a given block height.

arc_getCertificate - arc [Value: 20CU]
Returns the Malachite BFT consensus commit certificate for a block height, including the round, the block hash, and the validator signatures that committed it
Use cases

Use cases

  • Confirm finality for a cross-chain bridge or exchange crediting a deposit
  • Let a relayer verify validator quorum itself instead of waiting out a confirmation count
  • Audit which validators signed a given block and in which consensus round
Constraints

Constraints

  • Part of Arc's custom arc_* namespace, not the standard Ethereum JSON-RPC surface
  • height must be 1 or greater
  • rpc_modules does not list arc, since the namespace is registered outside the standard module registry; the method still works
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl https://arc-testnet.drpc.org \
-X POST \
-H "Content-Type: application/json" \
-d '{"method":"arc_getCertificate",
    "params":[55000000],
    "id":1,
    "jsonrpc":"2.0"}'
Copy
Response
200
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "height": 55000000,
    "round": 0,
    "block_hash": "0x9a9ecf9348af3c128d63dcb4555b4586b9e9a503c67220029602a93aed14c76e",
    "signatures": [
      {
        "address": "0x2012459eddb529fcd8429ba73006a6340ff05232",
        "signature": "P3GaOsv6kJE9IyJtaBBjFvebQtAEttCGKalkwbk9VeVy7GxK1l3S/GhATET24iKbyY8SDmwvVMQjPaDOCz+nAQ=="
      },
      {
        "address": "0x66a99d2834cf369d900de5da88ad2944ccb12e70",
        "signature": "+UX4HW+dJaI0nAKB+3Ah3g6iR31jAYx62wFbufrNE7zttMYYaz6NBtXNX8Zc3kDaEWEO2T+IldaD927I865FCw=="
      }
    ]
  }
}
Copy

Request params

idinteger
jsonrpcstring
methodstring
Parametersarray
array
heightinteger
The block height to get the commit certificate for. Must be 1 or greater.

Response

200
The commit certificate for the requested block height

Response params

object
idinteger
jsonrpcstring
resultobject
The commit certificate.
object
heightinteger
The block height the certificate commits.
roundinteger
The consensus round in which the block was committed. 0 means the first round.
block_hashstring
The hash of the committed block.
signaturesarray_of_objects
The validator signatures that form the commit.
object
addressstring
The validator's address.
signaturestring
The validator's base64-encoded signature.
Arc Namespacearc_getVersion