state_getRuntimeVersion

Description#

Returns the runtime API versioning information for the current block. Use this to decide when to refresh metadata, regenerate type bundles, or deploy runtime-dependent logic.

Parameters#

Position	Type	Description
0 (optional)	string	Block hash to query. Defaults to the latest block when omitted.

Returns#

Field	Type	Description
`specName`	string	Runtime name (e.g., `astar`)
`implName`	string	Implementation identifier
`specVersion`	number	Runtime spec version
`implVersion`	number	Implementation version
`transactionVersion`	number	Extrinsic format version
`apis`	array	Supported runtime APIs and versions

Request Example#

{
  "jsonrpc": "2.0",
  "method": "state_getRuntimeVersion",
  "params": [],
  "id": 1
}

Response Example#

Captured 2025-10-03

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "specName": "astar",
    "implName": "astar",
    "authoringVersion": 1,
    "specVersion": 1700,
    "implVersion": 0,
    "transactionVersion": 3,
    "apis": [
      ["0xdf6acb689907609b", 5],
      ["0x37e397fc7c91f5e4", 2],
      "… truncated …"
    ]
  }
}

Code Examples#

cURL
Python
JavaScript

curl https://api-astar.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getRuntimeVersion",
    "params": [],
    "id": 1
  }'

from substrateinterface import SubstrateInterface

substrate = SubstrateInterface(url = "https://api-astar.n.dwellir.com/YOUR_API_KEY", ss58_format=5)
version = substrate.get_runtime_version()
print(version['specVersion'], version['transactionVersion'])

const api = await ApiPromise.create({ provider: new WsProvider('wss://api-astar.n.dwellir.com/YOUR_API_KEY') });
const runtime = await api.rpc.state.getRuntimeVersion();
console.log(`spec=${runtime.specVersion} tx=${runtime.transactionVersion}`);