# Usufra

STATUS: Monad testnet. The live product is Unsloth Qwen3 8B Mini as a
CONSUMPTION_BALANCE: 10,000 tokens per certificate, $0.25 each (1,000
certificates = 10,000,000 tokens). Buy, transfer, authorize, reserve, chat,
and settle execute on-chain as a delegated agent wallet (0xB). There is no
demo session. Dummy GPU windows and Gemma/Llama/Hermes pool cards are not
listed.

## Read this before spending

- Sign up in the Usufra UI. Create a delegated agent wallet on /agents, allocate
  USDC and MON from your primary wallet (0xA) onto 0xB, copy the agentToken.
  MCP spends 0xB only. Never delegate 0xA.
- Quotes are live book prices. Re-quote before buying; do not cache a price
  across a decision.
- qty is certificate count. Qwen Mini: qty=1 is 10,000 tokens ($0.25 book
  USDC); qty=100 is 1M tokens at $25. Usage is a second payment: 1 µUSDC per
  token in escrow USDC (qty=1 escrows $0.01 max; unused refunds). urs_portfolio
  usdc is book; escrowUsdc is the meter. Reserve qty=50 (500,000 tokens). Settle
  burns ceil(used/10000) and returns unused whole certificates; transfer those
  to split a bag. urs_authorize_agent if the other wallet should not take
  custody.
- urs_chat maxTokens defaults to 1500. Qwen3 thinking: 400 often returns
  empty content and still bills.
- Buying is atomic. Payment and ownership move together.
- You can trade with funds 0xB holds. If you run out of USDC or MON, stop.

## MCP

Endpoint: https://usufra-gateway.onrender.com/mcp  (streamable HTTP)

The /agents page mints an agentToken and a copy-paste install block. Add the
server with header x-usufra-agent-token. Then call the tools. Do not ask the
human to execute buys.

  {"mcpServers":{"usufra":{"type":"http","url":"https://usufra-gateway.onrender.com/mcp"}}}

Loop:
  urs_search_rights -> urs_quote -> urs_buy -> urs_reserve_usage -> urs_chat -> urs_settle_usage

Tools:
  urs_search_rights         live Mini rights with disclosure and book
  urs_right_timing          four customer times (read-only, not a grant)
  urs_quote                 live askId + total
  urs_buy                   fill that ask as 0xB
  urs_reserve_usage         escrow a session-sized slice
  urs_chat                  holder chat through this venue's Mini
  urs_settle_usage          settle with the Mini receipt
  urs_transfer              send certificate qty (not tokens) to another 0xB
  urs_authorize_agent       bounded draw, owner keeps custody
  urs_portfolio             book USDC vs escrow USDC (two tokens)

## HTTP

Base: https://usufra-gateway.onrender.com

  GET  /urs/v1/rights
  GET  /urs/v1/rights/:termsHash/timing  four customer times (read-only)
  GET  /urs/v1/inference              venue inference (node only; no Mini URL)
  GET  /provider/v1/legacy            Mini URL serving retired
  GET  /provider/v1/routing/:tokenId  PROVIDER_NODE vs NONE
  POST /provider/v1/device/start      node enrollment (no Render env)
  POST /provider/v1/device/approve    Privy Bearer
  POST /provider/v1/device/poll
  POST /provider/v1/device/rotate-key node or Privy (new token once)
  POST /provider/v1/device/revoke     Privy only; node token cannot revoke
  GET  /provider/v1/earnings          provider payable records (Privy)
  POST /provider/v1/nodes/:id/attestor  Privy; on-chain setAttestor
  MCP urs_provider_*                  Privy; hidden on agent-token MCP
  GET  /urs/v1/agents/setup
  POST /urs/v1/agents/token           Privy Bearer + agentAddress
  POST /urs/v1/actions/buy
  POST /urs/v1/actions/reserve-usage
  POST /urs/v1/actions/chat
  POST /urs/v1/actions/settle-usage
  GET  /urs/v1/usage/live
  GET  /urs/v1/portfolio?address=

Spend routes take agentToken (body or x-usufra-agent-token).

## Infrastructure

  Settlement      Monad testnet, chain 10143
  Instrument      ERC-1155 consumption atoms
  Mini            Unsloth Qwen3 8B, model:unsloth/qwen3-8b@v1

## More

Human documentation: https://usufra.com/docs