ReaperNet
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

MethodPathWhat it doesWho can call it
POST/txSubmit one signed transactionsigned by the sender (ML-DSA-65)
POST/tx/batchSubmit many signed transactions at onceeach signed by its sender
GET/tx/:idA transaction by hash: its kind (txKind), the money it really moved (from, to, amount), who signed it, applied or refused, status, blockpublic
GET/mempoolTransactions waiting for a blockpublic

ACCOUNTS

MethodPathWhat it doesWho can call it
GET/balance/:addressBalance of an addresspublic
GET/address/:address/transactionsTransactions of an address (limit, offset): every one that moved money to or from it - a founder-signed treasury transfer toopublic

BLOCKS & PROOFS

MethodPathWhat it doesWho can call it
GET/header/:height?Block header (latest if no height)public
GET/blocks/recentLatest block headerspublic
GET/transactions/recentLatest included transactions, newest first (limit 1-100)public
GET/proof/tx/:hashInclusion proof: Merkle path to the block rootpublic
GET/consensus/dagThe block DAG and confirmationspublic
GET/consensus/block/:hashA DAG block by hashpublic
GET/consensus/attestation/:heightOperator attestations for a heightpublic
GET/consensus/participantsThe operator setpublic

CONTRACTS

MethodPathWhat it doesWho can call it
POST/easy2uz/compileCompile an Easy2uz contract (structured program or plain-English description)public
POST/evm/deployDeploy an EVM contractsigned by the deployer
POST/evm/callCall an EVM contract (state change)signed by the caller
POST/evm/viewRead an EVM contractpublic
GET/evm/code/:addrBytecode at an addresspublic
GET/evm/account/:addrEVM account state (balance, nonce)public
POST/move/viewRead a Move modulepublic
POST/wasm/viewRead a WASM contractpublic
POST/vm/viewRead a ReaperVM contract by function name or selectorpublic
POST/vm/viewsMany ReaperVM reads in one request (at most 128)public
GET/vm/contract/:addressContract details as deployedpublic
GET/vm/logsContract events (contract, topic0, fromBlock, toBlock, limit)public

CROSS-CHAIN

MethodPathWhat it doesWho can call it
POST/xchain/sendSend a cross-chain messagesigned by the sender (Ed25519 key)
GET/xchain/message-status/:idMessage statuspublic
GET/xchain/delivery-status/:idDelivery status on the target chainpublic
GET/xchain/commitment-proof/:idProof that a message was committedpublic
GET/interop/capabilitiesWhat this node can reach and howpublic
GET/interop/routeBest route to a target chainpublic
GET/interop/targetsChains you can reachpublic
GET/bridge/chainsBridged chainspublic
GET/bridge/locksBridge lockspublic
GET/bridge/lock-status/:hashStatus of one lockpublic
GET/bridge/wrapped-assetsWrapped assets and their originpublic
GET/bridge/withdrawalsWithdrawal vouchers (public audit trail)public
POST/bridge/withdrawBridge out (burn for release on the other chain)signed by the owner
POST/bridge/redeemRedeem a lock from another chainsigned by the owner
POST/bridge/confirmConfirm a lock was consumed on the destination chainthe relayer set (signed)
GET/relayer/setThe current relayer setpublic
GET/relayer/swapsOpen and settled cross-chain swapspublic

STAKING

MethodPathWhat it doesWho can call it
GET/stakingStakes, operator set, candidatespublic
POST/staking/stakeStake to join as an operatorsigned by the staker
POST/staking/unstakeLeave and unbondsigned by the staker
POST/staking/slashReport double-sign evidenceanyone (the evidence is checked)

NETWORK

MethodPathWhat it doesWho can call it
GET/healthIs the node uppublic
GET/chain/statusHeight, head, finality, state rootpublic
GET/tokenomicsSupply, mint and burn parameterspublic
GET/metricsPrometheus metricspublic
GET/metrics.jsonThe same metrics as JSONpublic
GET/security/postureSecurity settings this node runs withpublic

TESTNET ONLY

MethodPathWhat it doesWho can call it
POST/debug/faucetPractice RPN for an addressonly 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.

Make your first call.

Get the app