JSON-RPC Methods

Every Demos node exposes a single JSON-RPC entry point at POST /. Requests are dispatched by processPayload in src/libs/network/rpcDispatch.ts; the HTTP server that hosts it lives in src/libs/network/server_rpc.ts.

Request and response shape

A request is a JSON object with a method string and a params array (validated by isRPCRequest):

{
  "method": "ping",
  "params": []
}

Every method returns an RPCResponse:

{
  "result": 200,
  "response": "pong",
  "require_reply": false,
  "extra": null
}

Field	Type	Meaning
`result`	number	Status code (HTTP-like: `200` ok, `400` bad request, `401` unauthorized, `500` error, `501` method not implemented).
`response`	any	Method payload (string, object, array, or number).
`require_reply`	boolean	Whether the caller is expected to reply (used by peer routines).
`extra`	any \| null	Optional auxiliary data (e.g. error details, block metadata).

Unknown methods return result: 501 with "Method not implemented: <method>".

The server may attach X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers to responses so SDK clients can self-throttle.

Top-level methods

These are the case branches of the processPayload switch.

Method	Description
`ping`	Liveness check. Returns `result: 200`, `response: "pong"`.
`execute`	Submit a transaction bundle (`BundleContent`) for execution via `manageExecution`.
`nativeBridge`	Process a native bridge operation via `manageNativeBridge`.
`hello_peer`	Peer handshake/introduction (`manageHelloPeer`).
`mempool`	Merge a peer’s mempool into the local mempool.
`peerlist`	Exchange/handle peer lists.
`auth`	Authentication message handling (`manageAuth`).
`nodeCall`	Dispatch a read-only sub-method from the handler registry (see below).
`login_request`	Browser login request (`handleLoginRequest`).
`login_response`	Browser login response (`handleLoginResponse`).
`consensus_routine`	Consensus protocol routine (`manageConsensusRoutines`).
`gcr_routine`	Global Chain Registry routine (`manageGCRRoutines`).
`bridge`	Cross-chain bridge routine (`manageBridges`).
`web2ProxyRequest`	Proxy a Web2 HTTP request (`handleWeb2ProxyRequest`).
`rate-limit/unblock`	SUDO. Unblock an array of IP addresses on the rate limiter.
`getCampaignData`	SUDO. Return GCR campaign data.
`awardPoints`	SUDO. Award points to accounts (`GCR.awardPoints`).
`verifyProof`	Verify a ZK identity attestation proof and check nullifier reuse.

SUDO-protected methods

The following methods are listed in PROTECTED_ENDPOINTS and require the caller’s authenticated public key to equal the node’s SUDO_PUBKEY. Unauthorized callers receive result: 401, response: "Unauthorized sender":

rate-limit/unblock
getCampaignData
awardPoints

See Protected Endpoints for how SUDO authentication is configured and enforced.

nodeCall sub-method registry

nodeCall takes a single NodeCall object in params[0] and routes it to a named handler from handlerRegistry (src/libs/network/handlers/index.ts). Handlers are read-only and grouped by domain.

{
  "method": "nodeCall",
  "params": [{ "method": "getLastBlockNumber" }]
}

Peer handlers

Source: peerHandlers.ts.

Handler	Description
`getPeerInfo`	Return this node’s peer info.
`getPeerlist`	Return the known peer list.
`getPeerlistHash`	SHA-256 hash of the peer list.
`getPeerIdentity`	This node’s public key (hex).
`getPeerTime`	Current node time (epoch ms).

Block handlers

Source: blockHandlers.ts.

Handler	Description
`getGenesisDataHash`	Hash of the genesis data.
`getPreviousHashFromBlockNumber`	Previous block hash given a block number.
`getPreviousHashFromBlockHash`	Previous block hash given a block hash.
`getBlockHeaderByNumber`	Block header by number.
`getBlockHeaderByHash`	Block header by hash.
`getLastBlockNumber`	Tip block number.
`getLastBlock`	Full tip block.
`getLastBlockHash`	Tip block hash.
`getBlockByNumber`	Full block by number.
`getBlocks`	Range/batch of blocks.
`getBlockByHash`	Full block by hash (`hash` or `blockHash`).
`getBlockTransactions`	Transactions in a block (`blockHash`).

Transaction handlers

Source: transactionHandlers.ts.

Handler	Description
`getTransactions`	Query transactions.
`getTransactionStatus`	Status of a transaction.
`getTxByHash`	Single transaction by hash.
`getTxsByHashes`	Multiple transactions by hashes.
`getAllTxs`	Deprecated; returns `{}`.
`getTransactionHistory`	History for an `address` + `type` (paginated).
`getMempool`	Current mempool contents.

Identity handlers

Source: identityHandlers.ts.

Handler	Description
`getAddressInfo`	GCR account info for an `address`.
`getAddressNonce`	Current nonce for an `address`.
`getNativeSubnetsTxs`	Native subnet transactions for a `subnetId`.
`getTweet`	Fetch tweet data by `tweetUrl`.
`getDiscordMessage`	Fetch Discord message by `discordUrl`.
`resolveUdDomain`	Resolve an Unstoppable Domains `domain`.

Validator handlers

Source: validatorHandlers.ts.

Handler	Description
`getValidatorInfo`	Validator record for an `address`.
`getValidators`	Validator set (optionally at a `blockNumber`).
`getStakedAmount`	Staked amount for a validator `address`.

Governance handlers

Source: governanceHandlers.ts.

Handler	Description
`getNetworkParameters`	Active `NetworkParameters`.
`getActiveProposals`	Open proposals (pending/approved/activating).
`getProposalVotes`	Live tally for a `proposalId`.
`getUpgradeHistory`	Proposals that reached `active`.

Storage program handlers

Source: storageProgramHandlers.ts. ACL-enforced read side.

Handler	Description
`getStorageProgram`	Read a storage program by address.
`getStorageProgramAll`	Read the program’s raw data.
`getStorageProgramFields`	List top-level field names.
`getStorageProgramFieldType`	Type of a field.
`getStorageProgramItem`	Item from an array field.
`getStorageProgramValue`	Value of a field.
`getStorageProgramsByOwner`	Programs owned by an address.
`hasStorageProgramField`	Whether a field exists.
`searchStoragePrograms`	Search programs by name.

Fork handlers

Source: forkHandlers.ts.

Handler	Description
`getNetworkInfo`	Fork-activation status (e.g. `osDenomination`) plus node version info.

TLSNotary handlers

Source: tlsnotaryHandlers.ts.

Handler	Description
`requestTLSNproxy`	Request a TLS attestation proxy for a `targetUrl`.
`tlsnotary.getInfo`	Notary/proxy URLs and public key.
`tlsnotary.getToken`	Look up a token by `tokenId` or `txHash`.
`tlsnotary.getTokenStats`	Aggregate token statistics.

L2PS handlers

Source: l2psHandlers.ts.

Handler	Description
`getL2PSParticipationById`	Whether this node participates in an `l2psUid`.
`getL2PSMempoolInfo`	Mempool summary for an `l2psUid`.
`getL2PSTransactions`	Executed transactions for an `l2psUid` (optionally `since_timestamp`).
`getL2PSAccountTransactions`	Signed/authenticated account history for an `l2psUid` + `address`.

Misc handlers

Source: miscHandlers.ts.

Handler	Description
`RELAY_TX`	Receive relayed transactions (DTR).
`hots`	Easter-egg/diagnostic routine.

Internal Mechanisms

Validator Lifecycle

Network Governance

Global Change Registry

Consensus Mechanism

Network Forks

L2PS Privacy Subnets

ZK Identity

Architecture

Communications Stack

API Reference

Operations

Incentives

MCP Server

Bridges

Developers Testbed

Miscellaneous

JSON-RPC Methods

JSON-RPC Methods

Request and response shape

Top-level methods

SUDO-protected methods

nodeCall sub-method registry

Peer handlers

Block handlers

Transaction handlers

Identity handlers

Validator handlers

Governance handlers

Storage program handlers

Fork handlers

TLSNotary handlers

L2PS handlers

Misc handlers

​JSON-RPC Methods

​Request and response shape

​Top-level methods

​SUDO-protected methods

​nodeCall sub-method registry

​Peer handlers

​Block handlers

​Transaction handlers

​Identity handlers

​Validator handlers

​Governance handlers

​Storage program handlers

​Fork handlers

​TLSNotary handlers

​L2PS handlers

​Misc handlers

JSON-RPC Methods

Request and response shape

Top-level methods

SUDO-protected methods

nodeCall sub-method registry

Peer handlers

Block handlers

Transaction handlers

Identity handlers

Validator handlers

Governance handlers

Storage program handlers

Fork handlers

TLSNotary handlers

L2PS handlers

Misc handlers