API Reference
HTTP REST API on port 8080. Rate limited: 100 req/s sustained, 500 burst per IP.
Endpoint Groups
| Group | Prefix | Description |
|---|
| Accounts | /accounts | Balances, chains, frontiers |
| Blocks | /blocks, /pow | Submit and query blocks |
| Leases | /leases, /providers | Lease management |
| State Chain | /statechain | DAO governance |
| Directory | /directory | Account-to-peer registration |
| Chat | /chat | P2P messaging |
| Node | /node, /pending, /frontiers | Node info |
Read Endpoints
| Method | Path | Description |
|---|
| GET | /accounts | List all accounts |
| GET | /accounts/{address}/balance | Get account balances |
| GET | /accounts/{address}/chain | Get account block chain |
| GET | /accounts/{address}/keyset | Get multisig keyset |
| GET | /blocks/{hash} | Get block by hash |
| GET | /blocks/recent | Get recent blocks |
| GET | /leases | List all leases |
| GET | /leases/{hash} | Get lease by hash |
| GET | /providers | List providers |
| GET | /statechain/tip | Latest state chain block |
| GET | /statechain/blocks | Block range |
| GET | /statechain/blocks/{index} | Block by index |
| GET | /statechain/kv/{key} | Get state value |
| GET | /statechain/kv | All KV entries |
| GET | /statechain/keyset | DAO keyset |
| GET | /directory | All registrations |
| GET | /directory/{account} | Lookup registration |
| GET | /chat/messages | Get messages |
| GET | /chat/contacts | List contacts |
| GET | /chat/events | SSE message stream |
| GET | /node | Node info |
| GET | /pending | All pending sends |
| GET | /pending/{address} | Pending for account |
| GET | /frontiers | All frontiers |
| GET | /conflicts | All conflicts |
| GET | /conflicts/{account} | Conflicts for account |
| GET | /vms | List VMs |
| GET | /vms/{lease} | Get VM info |
| GET | /certificate | Provider's certificate |
| GET | /certificate/{provider} | Cached certificate |
Write Endpoints
| Method | Path | Description |
|---|
| POST | /blocks/send | Submit send block |
| POST | /blocks/receive | Submit receive block |
| POST | /blocks/claim | Submit claim block |
| POST | /blocks/lease | Submit lease block |
| POST | /blocks/lease_accept | Submit lease accept |
| POST | /blocks/lease_settle | Submit lease settle |
| POST | /blocks/multisig_open | Open multisig account |
| POST | /blocks/multisig_update | Update multisig keyset |
| POST | /pow | Compute PoW nonce |
| POST | /lease/request | Request compute resources |
| POST | /attestation/request | Request timekeeper attestation |
| POST | /statechain/blocks | Submit state chain block |
| POST | /directory/register | Register in directory |
| POST | /chat/send | Send chat message |
| POST | /vms/{lease}/exec | Execute command in VM |
| POST | /tunnel/{leaseHash}/tcp | TCP tunnel to VM |
