Surplus Market Blueprint
The Surplus Market blueprint defines the template for a prepaid AI inference credit market. Buyers acquire discounted inference capacity through service instances. Operators make markets in credit lots, serve or back redemption, and settle fills on-chain.
Source repo: https://github.com/tangle-network/surplus
Product Shape
| Area | Source-backed behavior |
|---|---|
| Operator binary | surplus-operator for the full Tangle runner; surplus-operator-lite for HTTP-only local operation. |
| Blueprint category | inference-market |
| Default port | 9100 |
| Hosted app | https://surplus-market.pages.dev/ |
| Settlement | SurplusSettlement with attested quorum or SP1 proof boundary. |
Jobs
| ID | Job | Status |
|---|---|---|
0 | list_instrument | Implemented. |
1 | configure | Reserved placeholder. |
2 | start_making | Reserved placeholder. |
3 | stop_making | Reserved placeholder. |
4 | status | Implemented. |
30 | workflow_tick | Implemented; drives market-maker ticks. |
Operator API
| Route | Purpose |
|---|---|
POST /order | Place limit orders and emit settlement intents. |
POST /cancel | Cancel a resting order. |
POST /book | Read depth, reference price, and inventory. |
POST /mm-tick | Pull risk-gated quotes and replace operator quotes. |
POST /rfq and POST /rfq/fill | Quote and fill signed firm RFQs. |
GET /settlement/outbox | Read settleable fills. |
POST /settlement/flush | Submit fills when chain settlement is enabled. |
Read Next
| Page | Use it for |
|---|---|
| Operator Requirements | Env vars, CLOB setup, privacy mode, app env. |
| Settlement and Inference | Real inference backend, credit lots, redemption, quorum, SP1. |
| Dapp and Indexer | Dapp link-out, metadata gaps, indexed market state. |
Source Material
This page is based on the Surplus repo’s README.md, BLUEPRINT.md, blueprint.toml, deploy/blueprint-definition.toml, deploy/blueprint-metadata.json, docs/testnet-release.md, operator/src/config.rs, and operator/src/inference.rs.