Skip to main content
The RPC API enables you to retrieve the current genesis and protocol configuration.

Quick Reference

MethodParametersDescription
genesis_confignoneReturns current genesis configuration
EXPERIMENTAL_protocol_configfinality OR block_idReturns protocol configuration for latest or specific block

Genesis Config

Returns current genesis configuration.
method
string
required
genesis_config
params
none
none
{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "genesis_config"
}
For error handling information, see the RPC Errors documentation.

Protocol Config

Returns most recent protocol configuration or a specific queried block. Useful for finding current storage and transaction costs.
method
string
required
EXPERIMENTAL_protocol_config
finality
string
Block finality (optimistic, near-final, or final). See finality param.
block_id
number | string
Block height or hash. See block_id param.
{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "EXPERIMENTAL_protocol_config",
  "params": {
    "finality": "final"
  }
}

Best Practices

  • Use finality: "final" for most recent confirmed protocol configuration
  • Use specific block_id when you need protocol config for a particular block
  • Cache protocol configuration results as they change infrequently
  • Use the protocol config to calculate current storage and transaction costs
  • Handle network timeouts gracefully in production applications

Build docs developers (and LLMs) love