{"service":"Tvist API","what":"Escrow, consent, and dispute layer for AI agents. Notional credits (sandbox).","skill":"See SKILL.md. OpenAPI at /openapi.json, interactive docs at /docs.","disclaimer":"Technical demonstration only — a notional-credits sandbox, not a bank, payment institution, or law firm. Legal references cite real primary sources but are engineering-grade mappings, not legal advice; obtain qualified local counsel before relying on them in any jurisdiction.","scenarios":{"human_to_agent":{"label":"Human -> Agent","gate":"consent","pain":"an agent overspends the human's mandate on a final rail","flow":"POST /consent -> POST /pay {consent_id} (403 over budget)"},"agent_to_subagent":{"label":"Agent -> Sub-agent","gate":"delegation (attenuated)","pain":"sub-agents exceed their delegator's authority; no chain control","flow":"POST /m2m/delegate (attenuated, chains to root) -> spend via the delegation_id anywhere a consent_id works"},"agent_to_agent":{"label":"Agent <-> Agent","gate":"handshake (Nash region + escrow)","pain":"two machines with no shared jurisdiction or trust trade blind","flow":"POST /m2m/handshake (Nash region + mandate + funded escrow) -> /escrow/{id}/deliver -> /release"},"agent_to_resource":{"label":"Agent -> Resource","gate":"x402 (consent-capped, replay-safe)","pain":"pay-per-call APIs on an irrevocable rail; replay + overspend risk","flow":"GET /x402/resource/{name} (402) -> retry with signed X-PAYMENT (consent-capped, replay-safe)"}},"endpoints":{"GET /health":"liveness","GET /stats":"live service metrics (accounts, settlements, escrows, funds)","GET /disclaimer":"technical-demo / not-legal-advice disclaimer","GET /spectrum":"the four trust relationships + one-gate logic (ascii/mermaid/structured)","GET /downloads":"every downloadable deliverable (docs + pitch kit)","GET /download/{slug}":"pitch kit: brief-pdf | summary-pdf | summary-docx | deck-pptx","GET /skill.md":"agent-facing SKILL.md (inline; ?download=1 for attachment)","GET /readme.md":"service README (inline; ?download=1 for attachment)","GET /view/skill":"SKILL.md rendered as HTML for humans","GET /view/readme":"README rendered as HTML for humans","GET /regions":"list all jurisdictions and their dispute regimes","GET /regions/suggest":"suggested starting jurisdiction from ?tz= and Accept-Language (IP echoed, not geolocated)","POST /regions/recommend":"Nash-optimal region for two parties {client_prefs, agent_prefs}","GET /taxonomy":"civil/commercial-law dispute taxonomy + reason-code linkage","GET /regions/{region}/legal":"a jurisdiction's legal system, regulator, official instruments","POST /consent":"store a spend mandate {consent_id, principal, budget, merchant_allowlist?}","POST /pay":"settle within consent {ref, from_account, to_account, amount, region, consent_id?}","POST /escrow":"open+fund escrow {escrow_id, payer, payee, amount, region, condition_expected}","POST /escrow/{id}/deliver":"mark delivered {proof}","POST /escrow/{id}/release":"release iff delivered","POST /escrow/{id}/contest":"contest a funded escrow","POST /escrow/{id}/refund":"refund a contested escrow to payer","POST /recall":"recall a settled payment {ref, consent_id, current_tick?}","POST /dispute":"file a dispute {ref, region, reason_code}","POST /m2m/delegate":"agent->sub-agent mandate, attenuation enforced {delegation_id, parent_consent_id, agent, budget}","POST /m2m/handshake":"one-call agent-to-agent pact: Nash region + mandate check + auto-escrow","GET /m2m/pact/{id}":"pact + live escrow status","GET /m2m/delegation/{id}":"delegation chain to the root mandate","GET /x402/resource/{name}":"x402 paid resource: 402 challenge, pay via X-PAYMENT header","POST /x402/verify":"facilitator verify {resource, payment_header}","POST /x402/settle":"facilitator settle {resource, payment_header}","GET /accounts/{name}":"balance of a notional account","GET /escrow/{id}":"escrow status"}}