NODE API REFERENCE
Every node speaks plain HTTP.
Any ReaperNet node answers the same JSON API. Reads are public. Anything that moves money or changes state carries the sender's own signature, so the node needs no API keys.
terminal
$ curl $NODE/balance/usrrn1q8…f3a2 { "address": "usrrn1q8…f3a2", "balance": "…" } $ curl $NODE/proof/tx/0x9a1c… { "root": "0x…", "path": [ … ], "verified": true }
54
endpoints listed here
JSON
request and response bodies
128
reads at most per /vm/views call
ML-DSA-65
signatures on transactions
ENDPOINTS BY GROUP
Read freely. Sign to change.
TRANSACTIONS
| Method | Path | What it does | Who can call it |
|---|---|---|---|
| POST | /tx | Submit one signed transaction | signed by the sender (ML-DSA-65) |
| POST | /tx/batch | Submit many signed transactions at once | each signed by its sender |
| GET | /tx/:id | A transaction by hash: its kind (txKind), the money it really moved (from, to, amount), who signed it, applied or refused, status, block | public |
| GET | /mempool | Transactions waiting for a block | public |
ACCOUNTS
| Method | Path | What it does | Who can call it |
|---|---|---|---|
| GET | /balance/:address | Balance of an address | public |
| GET | /address/:address/transactions | Transactions of an address (limit, offset): every one that moved money to or from it - a founder-signed treasury transfer too | public |
BLOCKS & PROOFS
| Method | Path | What it does | Who can call it |
|---|---|---|---|
| GET | /header/:height? | Block header (latest if no height) | public |
| GET | /blocks/recent | Latest block headers | public |
| GET | /transactions/recent | Latest included transactions, newest first (limit 1-100) | public |
| GET | /proof/tx/:hash | Inclusion proof: Merkle path to the block root | public |
| GET | /consensus/dag | The block DAG and confirmations | public |
| GET | /consensus/block/:hash | A DAG block by hash | public |
| GET | /consensus/attestation/:height | Operator attestations for a height | public |
| GET | /consensus/participants | The operator set | public |
CONTRACTS
| Method | Path | What it does | Who can call it |
|---|---|---|---|
| POST | /easy2uz/compile | Compile an Easy2uz contract (structured program or plain-English description) | public |
| POST | /evm/deploy | Deploy an EVM contract | signed by the deployer |
| POST | /evm/call | Call an EVM contract (state change) | signed by the caller |
| POST | /evm/view | Read an EVM contract | public |
| GET | /evm/code/:addr | Bytecode at an address | public |
| GET | /evm/account/:addr | EVM account state (balance, nonce) | public |
| POST | /move/view | Read a Move module | public |
| POST | /wasm/view | Read a WASM contract | public |
| POST | /vm/view | Read a ReaperVM contract by function name or selector | public |
| POST | /vm/views | Many ReaperVM reads in one request (at most 128) | public |
| GET | /vm/contract/:address | Contract details as deployed | public |
| GET | /vm/logs | Contract events (contract, topic0, fromBlock, toBlock, limit) | public |
CROSS-CHAIN
| Method | Path | What it does | Who can call it |
|---|---|---|---|
| POST | /xchain/send | Send a cross-chain message | signed by the sender (Ed25519 key) |
| GET | /xchain/message-status/:id | Message status | public |
| GET | /xchain/delivery-status/:id | Delivery status on the target chain | public |
| GET | /xchain/commitment-proof/:id | Proof that a message was committed | public |
| GET | /interop/capabilities | What this node can reach and how | public |
| GET | /interop/route | Best route to a target chain | public |
| GET | /interop/targets | Chains you can reach | public |
| GET | /bridge/chains | Bridged chains | public |
| GET | /bridge/locks | Bridge locks | public |
| GET | /bridge/lock-status/:hash | Status of one lock | public |
| GET | /bridge/wrapped-assets | Wrapped assets and their origin | public |
| GET | /bridge/withdrawals | Withdrawal vouchers (public audit trail) | public |
| POST | /bridge/withdraw | Bridge out (burn for release on the other chain) | signed by the owner |
| POST | /bridge/redeem | Redeem a lock from another chain | signed by the owner |
| POST | /bridge/confirm | Confirm a lock was consumed on the destination chain | the relayer set (signed) |
| GET | /relayer/set | The current relayer set | public |
| GET | /relayer/swaps | Open and settled cross-chain swaps | public |
STAKING
| Method | Path | What it does | Who can call it |
|---|---|---|---|
| GET | /staking | Stakes, operator set, candidates | public |
| POST | /staking/stake | Stake to join as an operator | signed by the staker |
| POST | /staking/unstake | Leave and unbond | signed by the staker |
| POST | /staking/slash | Report double-sign evidence | anyone (the evidence is checked) |
NETWORK
| Method | Path | What it does | Who can call it |
|---|---|---|---|
| GET | /health | Is the node up | public |
| GET | /chain/status | Height, head, finality, state root | public |
| GET | /tokenomics | Supply, mint and burn parameters | public |
| GET | /metrics | Prometheus metrics | public |
| GET | /metrics.json | The same metrics as JSON | public |
| GET | /security/posture | Security settings this node runs with | public |
TESTNET ONLY
| Method | Path | What it does | Who can call it |
|---|---|---|---|
| POST | /debug/faucet | Practice RPN for an address | only when REAPER_FAUCET_ENABLED=true, operator token when set; never on mainnet |
Operator-only routes under /admin (treasury, governance, genesis) need a governance signature and are not listed. Paths come from the node source; request and response bodies are described next to each route in the node code until the full schema is published.