§ Developers · /developers/rpc

JSON-RPC reference.

A small surface of methods, designed to be implementable on a phone. Subscriptions over WebSocket for live updates. Pre-launch, public endpoints return specification placeholders.

§ 01 / Methods

Methods.

Stable across the launch phase. Additions require a hard fork; removals do not happen.

Method	Params	Returns	Notes
adamant_blockHeight	[]	u64	Current finalised block height.
adamant_getBlock	[height: u64]	Block	Full block by height. Includes proposer, tx list, encryption-regime split.
adamant_getTransaction	[hash: H256]	Tx	Transaction metadata. Body is opaque if shielded.
adamant_getAddress	[addr: Address]	AddressView	Public state of a transparent address; opaque view for shielded.
adamant_disclose	[viewKey: VK, scope: Scope]	Disclosure	Decrypt a slice of history under a view key.
adamant_getValidators	[]	Validator[]	Active set with bond, uptime, slashing record.
adamant_getMempool	[]	Mempool	Pending tx count by encryption regime, oldest age.
adamant_getBurns	[from: u64, to: u64]	BurnMint[]	Burn-to-mint events with source-chain tx hashes.
adamant_getGenesisNft	[slot: u8]	GenesisNft	Cohort slot record: marker (immovable), NFT owner (tradeable).
adamant_estimateFee	[tx: TxDraft]	FeeQuote	Fee estimate with dimension breakdown.
adamant_subscribe	[topic: Topic]	SubId	WebSocket subscription. Topics: blocks, mempool, validators, burns.
adamant_chainSpec	[]	ChainSpec	Chain ID, security tier, primitives, current epoch.

§ 02 / Example

Request & response.

curl -X POST https://rpc.adamantprotocol.com \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "adamant_blockHeight",
    "params": []
  }'

# response (live):
{ "jsonrpc": "2.0", "id": 1, "result": 184217 }

# response (pre-launch):
{ "jsonrpc": "2.0", "id": 1, "result": null,
  "meta": { "phase": "specification" } }

§ 03 / WebSocket

Subscriptions.

// Subscribe to new finalised blocks
ws.send(JSON.stringify({
  jsonrpc: "2.0", id: 1,
  method: "adamant_subscribe",
  params: ["blocks"]
}));

// Topics: "blocks" | "mempool" | "validators" | "burns"

§ 04 / Endpoints

Public RPC endpoints.

Community-operated. Use as load-balanced fallbacks; for high-throughput integrations, run your own service node.

URL	Region	Operator	Notes
—	—	—	pre-launch

Rate limits: 100 RPS per IP, 10 subscriptions per connection. Production traffic should run a local Service Node — see /developers/run-a-node.