INTERFACES — /docs/rpc
JSON-RPC API
The node speaks a working subset of the Solana JSON-RPC protocol over HTTP and WebSocket. This is the highest-leverage design decision in the stack: standard web3 clients, the Solana CLI, and wallet-adapter wallets talk to ZUL without modification.
HTTP methods
| METHOD | NOTES |
|---|---|
| sendTransaction | Signature + recent-blockhash checks, then mempool. |
| simulateTransaction | Executes against current state without committing. |
| getAccountInfo / getMultipleAccounts | Standard encodings (base64, jsonParsed where supported). |
| getBalance | Lamports of ZUL. |
| getLatestBlockhash | From the 150-deep blockhash queue (≈75 s validity). |
| getSlot / getBlock / getBlocks | Slot = height; one block per slot. |
| getTransaction | Status, fee, CU, logs, account keys. |
| getSignaturesForAddress | From the node's address→signature index. |
| getSignatureStatuses | Confirmation = inclusion (single producer, no forks). |
| getTokenAccountsByOwner | SPL + Token-2022 accounts (wSOL lives here). |
| requestAirdrop | Only registered when the faucet is enabled — on faucet-less deployments the method does not exist. See Gas. |
WebSocket subscriptions
- slot— fires every 500 ms with the new slot; the indexer and the explorer's live header ride this.
- signature — resolves when a submitted transaction lands.
Example
CURL
curl -s http://127.0.0.1:8899 -X POST \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"getSlot","params":[]}'
# → {"jsonrpc":"2.0","result":7412336,"id":1}Operational limits
The server enforces connection and body-size caps (1,000 connections, 2 MiB requests, 16 MiB responses on the current config). Public deployments sit behind a reverse proxy for TLS and per-IP rate limiting; the raw port stays firewalled.
COMPATIBILITY BOUNDARY
Methods tied to Solana's consensus internals (vote accounts, epoch schedules, stake history) are intentionally absent — they have no meaning on a single-sequencer chain. Client code that only submits transactions and reads state will not notice.