Constitutional infrastructure & tools for AI agents

01What this is

UBOS runs small, sharp services that AI agents can call and pay for autonomously. You don't create an account — your agent simply calls an endpoint, and if it has no balance it gets back an HTTP 402 Payment Required telling it exactly where to send a few cents of USDC. It pays, the balance credits within seconds, and the call goes through. That whole handshake is the emerging x402 agent-payment standard — and here it runs on code and a wallet we own outright.

Two principles make it different:

Deterministic The Governor's verdict is computed by rules and a cited constitutional library — no language model decides the answer, so it can't be talked out of a "no." Sovereign Our own engine, our own wallet, our own corpus, self-hosted on our own machine. Nothing rented that can be switched off.

02The services

More services slot in as new product modules on the same metered spine — constitutional law lookup, grounded knowledge over a private corpus, and grant/funding scans are on the roadmap.

03How payment works (the x402 loop)

1. Call the service. Your agent POSTs to /store/serve. With no balance, it gets HTTP 402 with the price and the receiving wallet.
2. Pay. Send USDC on Solana to that wallet, and put your api_key (any string you choose) in the transaction memo.
3. Auto-credit. Our verifier watches the wallet and credits your key's balance within ~15 seconds. No confirmation step, no dashboard.
4. Call again. The same request now returns 200 with the result, and your balance is debited the per-call price. Top up any time; balance never expires.

USDC mint (Solana): EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. The memo is your account — keep it consistent to reuse a balance.

04Quickstart

Base URL: https://api.welcome-to-ubos.com/store

1 · See the catalog (free)

# list products + prices
curl https://api.welcome-to-ubos.com/store/products

2 · Call the Governor (returns 402 until funded)

curl -X POST https://api.welcome-to-ubos.com/store/serve \
  -H 'Content-Type: application/json' \
  -d '{"api_key":"my-agent-001","product":"governor",
       "payload":{"action":"delete all production backups without consent"}}'

→ While unfunded you get 402 with pay_to. After paying, the same call returns:

{"status":200,"product":"governor",
 "result":{"safety":"UNSAFE","verdict":"MISALIGNED",
   "citation":"Site Reliability Engineering (Google SRE): irreversible,
               destructive actions require backup, rollback, and consent.",
   "hard_fail":"destructive_action_without_safeguard"},
 "charged_usdc":0.005,"balance_usdc":0.045}

3 · Call the Hot Vessel

curl -X POST https://api.welcome-to-ubos.com/store/serve \
  -H 'Content-Type: application/json' \
  -d '{"api_key":"my-agent-001","product":"hotvessel",
       "payload":{"prompt":"Summarise the CAP theorem in one sentence."}}'

4 · Check your balance

curl "https://api.welcome-to-ubos.com/store/balance?key=my-agent-001"

05API reference

Method & path	Does
GET /store/products	List products, prices, descriptions. Free.
GET /store/balance?key=…	Current USDC balance for an api_key. Free.
GET /store/health	Liveness + product list. Free.
POST /store/serve	Run a product. Body: {api_key, product, payload}. Returns 200 + result (debited), or 402 if the balance is short.

Verdict meanings (Governor)

safety	verdict	meaning
SAFE	ALIGNED	No conflict found with the constitution.
CAUTION	WARNING	Relevant principles to weigh; proceed deliberately.
UNSAFE	MISALIGNED	Bright-line violation; do not proceed.

06Who it's for