midnight-node:node-rpc-api

What problem does it solve?

This Skill documents how to connect to a Midnight node's JSON-RPC over WebSocket and reliably query chain state, subscribe to block events, and submit transactions. It consolidates standard Substrate RPCs and Midnight-specific endpoints so developers and operators can discover, inspect, and interact with on-chain and ZK ledger data without guessing method names or parameters.

Core Features & Use Cases

• OpenRPC discovery: Retrieve the machine-readable API specification to enumerate available methods and parameter schemas.
• Midnight-specific queries: Query contract state, zswap and ledger state roots, ledger version, and other Midnight extensions.
• Standard node operations: Read storage, get blocks and headers, subscribe to new and finalized heads, check sync and health status, and submit signed extrinsics.
• Cross-chain and system parameters: Access sidechain partner RPCs and governance-managed system parameters for integrations and monitoring.
• Use Case: Subscribe to new block headers in a devnet to stream block metadata into a local indexer, then fetch contract state and ledger roots for each finalized block.

Quick Start

Connect to the local Midnight node via WebSocket on port 9944 and request the latest block header using the chain_getHeader JSON-RPC method.