JSN HTTP API
This is the JSN HTTP API, separate from Joltzu JSON-RPC. Public service availability remains unconfirmed. The request templates require a confirmed deployment with the expected chain and contract addresses.
| Environment | API origin | Status |
|---|---|---|
| Joltzu testnet | https://jsn.testnet.joltzu.com | Proposed documentation host; availability unverified |
| Joltzu mainnet | https://jsn.joltzu.com | Proposed documentation host; availability unverified |
The public names are planning placeholders authored for these docs. No contract address, bearer token or public service is implied.
Read the service identity
# Set JSN_API_URL to the confirmed deployment's API origin, without a trailing slash.
curl "${JSN_API_URL:?Set the confirmed JSN API origin}/health"
curl "${JSN_API_URL}/v1/network"
curl "${JSN_API_URL}/v1/signet?cursor=0&limit=100"
/v1/network returns chainId, coordinator and signet. It is service configuration, not proof of canonical chain identity. Verify it against your deployment and RPC.
Routes
| Method / route | Authorization | Purpose |
|---|---|---|
GET /health, GET /v1/network | Public | Health and configured identity |
POST /v1/signet | Valid maker signature | Store an envelope |
GET /v1/signet, GET /v1/signet/:id | Public | Paginated envelopes / one record |
GET /v1/signet/:id/chain-status | Public | Announced/revoked status |
POST /v1/signet/:id/announce | submit | Queue sponsored publication |
POST /v1/jobs | submit | Enqueue an already indexed on-chain request |
GET /v1/workers, GET /v1/jobs/:id | read | Worker/queue status |
GET /v1/requests/:id | read | On-chain coordinator request status |
POST /v1/jobs/:id/retry | submit | Retry a corrected failed job |
POST /v1/agents/analyze, POST /v1/agents/proposals | agent | Analyze observations / record proposal |
GET /v1/agents/proposals/:id | read | Review exact proposal and digest |
POST /v1/agents/proposals/:id/reject | council | Reject an unexecuted proposal |
POST /v1/agents/proposals/:id/execute | council plus valid quorum | Explicitly execute the reviewed action |
Send Authorization: Bearer TOKEN with a deployment-issued credential for privileged routes. Observer, submitter, agent and council scopes are distinct. Request bodies/responses are JSON; failures return { "error": "..." }. SigNet responses disable caching so proxies do not serve expired envelopes.
On-chain requests still require on-chain payment and authorization. /v1/jobs does not create a paid request. An API council token cannot replace the council signatures. Subscription plan state is read from its contract/events, not a /v1/subscriptions endpoint.
See SigNet for the publication and verification flow. Public signing-schema and SDK release details remain TBD.