Chio/Docs

Agentic Economy: Overview

From implicit trust to a settled machine economy. The Guard Platform keeps a single agent inside a single organization honest. The Agentic Economy is what happens when honest agents need to contract with each other across organizations, get paid, post collateral, buy coverage, and settle debts. This section maps the primitives, crates, and protocols that make that work.

Reading Paths by Role

Six common entry points. Each one names the pages to read in order and what each one gives you.

I'm integrating chio for procurement (backend dev)

  1. Quickstart: a 15-minute runnable example that gets a kernel signing receipts against a tool server.
  2. Worked Example: a 9-station walkthrough of the cross-org transaction shape.
  3. Manifests: the provider side, signing keys and pricing block.
  4. Pricing: the buyer side, how quotes attach to a governed intent.
  5. Bilateral Receipts: cross-org receipts and the shared governed-intent hash.

I operate the chio economy in production (SRE / platform)

  1. Operating an Economy: config patterns, runtime knobs, and indexer cursors.
  2. Failure Recovery: what to expect when oracles, peers, or rails misbehave.
  3. Reconciliation: the cost-cycle math (pre-charge, settle, true-up).
  4. Regulatory APIs: audit-export surface for compliance review.
  5. Observability: metrics, traces, and alerting on the kernel.

I'm auditing or compliance

  1. Compliance Certificates: the auditor artifact, signed and pinned to a passport.
  2. Regulatory APIs: the read-only export surface for receipts.
  3. Bilateral Receipts: cross-org evidence with two kernel signatures.
  4. Portable Reputation: federated trust with explicit attenuation.

I work in finance / treasury

  1. Pricing: the cost model, quotes, and how charges are bound.
  2. Reconciliation: quoted versus charged, and how the delta clears.
  3. Settlement Rails: rails comparison (EVM, Solana, CCIP, x402).
  4. On-Chain Settlement: the Web3 path with escrow and dual-sign release.

I work in insurance / risk

  1. Underwriting: risk taxonomy and decision outcomes.
  2. Credit Facilities: bonds, capital book, and exposure ledger.
  3. Liability Market: coverage classes and pricing-authority envelopes.
  4. Claims: the lifecycle from filing through dispute path.

I'm building on the economy stack (contributor / extension author)

  1. The Economic Stack: the crate map, with deps and trust boundaries.
  2. Worked Example: how the pieces fit together in one transaction.
  3. Manifests: signing operations and key rotation.
  4. Reputation: deterministic local scoring against a corpus.

Four Stages

The Chio thesis is a sequence, not a feature list. Each stage builds on the artifacts produced by the previous one.

StagePostureWhat changes
01 TodayActions fire into the voidAgents call tools without identity, budgets, or proof. Every invocation is an implicit promise the infrastructure cannot keep.
02 The KernelA single, fail-closed mediatorChio validates capabilities and runs the guard pipeline before any tool is invoked. No valid capability, no action.
03 The ReceiptCryptographic evidence, every timeSigned, Merkle-committed receipts for every allow, deny, cancel, and incomplete: audit trail, billing ledger, and compliance record in one artifact.
04 The EconomyPortable trust across organizationsAgent passports, federated policies, and settlement primitives. Machines contract with machines, and prove what happened.

Stages 1 and 2 are covered by the Guard Platform section. Stage 3 is covered by Economics and billing exports. Stage 4, the cross-org commercial surface, is what this section documents end to end.


Scope of This Section

The Agentic Economy section sits above the Guard Platform. It assumes you already have a kernel that issues receipts and enforces local policy. What it adds:

  • Portable identity: every agent is a did:chio identifier (the Ed25519 public key in hex), backed by a passport bundle of W3C Verifiable Credentials.
  • Federated capabilities: two operators can recognize each other's artifacts under stated boundaries, without a shared identity provider.
  • Signed manifests: tool servers publish what they expose, what it costs, and what permissions they need, signed with their server keypair.
  • Credit and bonds: agents and operators can post collateral and draw against facilities, with an exposure ledger and a capital book that trace back to receipts.
  • Insurance and claims: a liability market for quoting, binding, paying premiums, filing claims, and adjudicating outcomes.
  • Settlement: payment rails for moving value once a receipt has fired, including EVM, Solana, CCIP cross-chain, and x402-style HTTP payments.
  • Operations: regulator and counterparty visibility into the same artifact stream.

Difference from Economics

The Economics page documents the single-org budget primitives: MonetaryAmount, three-tier budgets, the pre-charge and reconcile cycle, and FinancialReceiptMetadata. The Agentic Economy section uses those primitives as building blocks. It covers what happens when the buyer and the seller live on opposite sides of an organizational trust boundary.

Glossary

Definitions used across the section. Each term maps to a chio type or protocol artifact. Where multiple types share a name, the table names the primary one.

TermDefinitionPrimary type
PassportUnsigned bundle of independently signed credentials carried by an agent across organizations.chio_credentials::AgentPassport
CredentialA canonically JSON-signed claim about an agent (identity, reputation, certification) that anyone can verify with the issuer's public key.chio_credentials::*Credential
CapabilityA signed token granting a subject the right to invoke specific tools, with optional budgets and constraints.chio_core::capability::CapabilityToken
MandateA policy-level constraint a principal places on a delegated capability (max amount, autonomy tier, governed-intent bindings).GovernedTransactionIntent
ReceiptSigned record of a tool invocation: action, decision, evidence, content hashes. The unit of audit and billing.chio_core::receipt::ChioReceipt
LedgerAggregated view of receipts and decisions filtered by capability, tool, agent, or time window.ExposureLedgerReport
FacilityA pre-approved credit line an operator extends to an agent or counterparty, drawn against during execution.CreditFacilityArtifact
BondPosted collateral that backs higher-risk delegated execution. Released, impaired, or expired through lifecycle events.CreditBondArtifact
ScorecardDeterministic rating computed from a local corpus of receipts, capability lineage, and budget records.CreditScorecardReport / LocalReputationScorecard
PremiumThe price quoted for binding a liability coverage to a governed action.UnderwritingPremiumQuote
ClaimA request for payout against a bound coverage, with evidence references and an adjudication outcome.LiabilityClaimPackageArtifact
SettlementMovement of value across a payment rail to clear a charge that a receipt has authorized.SettlementCommitment
ExposureOutstanding committed cost a capability or facility represents at a point in time.ExposureLedgerSummary
FederationBilateral agreement between two operators to recognize each other's artifacts under explicit policy boundaries.FederationActivationExchangeArtifact
UnderwritingPre-action risk classification that produces a decision outcome (admit, deny, require remediation) and a premium quote.UnderwritingDecisionArtifact
AttenuationMonotonic narrowing applied to a delegated capability: tighter budgets, fewer tools, shorter expiry.capability::Attenuation
ReputationBehavior signal computed from receipts: boundary pressure, resource stewardship, reliability, incident history.LocalReputationScorecard

One source of truth

Every term in the table resolves to a struct or enum in the chio crates. When prose and code disagree, the source wins. Use the type names in the right-hand column as search anchors.

The Cross-Org Shape

A single procurement transaction, in plain terms, looks like this:

  1. A buyer agent presents a passport and a capability with a budget.
  2. A provider publishes a signed manifest declaring its tools and pricing.
  3. The buyer assembles a GovernedTransactionIntent binding a MeteredBillingQuote from the provider to its action.
  4. The buyer's kernel pre-charges the budget. Both kernels run their guard pipelines.
  5. The tool runs. Both kernels co-sign receipts that share a governed intent hash.
  6. Reconciliation: actual cost is compared to the pre-charge. Settlement dispatches over the configured rail.
  7. Reputation, exposure, and capital book updates land. The audit trail is the same artifact a regulator can ingest.

Step 4 is where the Guard Platform ends and the Economy begins. Steps 5 through 7 are what this section is about. The Worked Example page traces every step against actual code.


The Five Themes

The section is organized into five themes plus an operations track. Each links to its own pages.

Reputation and Identity

How an agent says who it is, what it has done, and what others think of it. Passports (bundle format and verification), Reputation (deterministic local scoring), Scorecards (credit and reputation reports), Portable Reputation (crossing operator boundaries with attenuation), Compliance Certificates (signed certifications attached to passports and decisions).

Federation

How two operators can transact without a shared root of trust. Bilateral Federation (activation exchange, peer pinning, anti-eclipse policy) and Bilateral Receipts (co-signed evidence shared between two kernels). For the single-org primitives, see Federation Overview.

Marketplace

How buyers find services, evaluate them, and bind their pricing. Manifests (signed tool declarations with pricing and SLA hints), Pricing (flat, per-invocation, per-unit, hybrid), Discovery (listings, search, admissibility filtering).

Credit, Insurance, and Risk

How exposure is sized, priced, and covered. Underwriting (risk classification and decision outcomes), Credit Facilities (pre-approved credit lines and bonds), Liability Market (quoting, binding, pricing authority), Claims (evidence packages, adjudication, payouts).

Settlement

How cleared charges actually move value. Settlement Rails (EVM, Solana, CCIP, x402, Circle nanopayments, ERC-4337), On-chain Settlement (escrow dispatch, dual-sign release, watchdog jobs), Reconciliation (pre-charge versus actual cost, settlement state).

Operations

How operators and regulators see the system. Regulatory APIs (the same receipt stream, projected for compliance review) and Operating (runtime status, indexer cursors, alerts, recovery records).


How to Read This Section

Three good entry points depending on what you are after.

  • If you want the architecture: read The Economic Stack first, then pick a theme.
  • If you want to see it move: read Worked Example and follow links into the primitives it touches.
  • If you have a use case: jump straight to the relevant theme. Each page links back to the types and adjacent primitives.

The TCB has not moved

The Agentic Economy adds value on top of the kernel. It does not change what is in the trusted computing base. Federation, underwriting, settlement, and reputation are operator-replaceable. The kernel that signs receipts is not.
reading-order.txt
# A reasonable order if you read top to bottom:
overview                  # you are here
stack                     # crates and their relationships
worked-example            # one transaction, end to end
manifests / pricing       # the seller side
passports / reputation    # the buyer side
bilateral-federation      # the cross-org plumbing
underwriting              # risk and premium
credit-facilities         # lines of credit and bonds
liability-market / claims # coverage and payouts
settlement-rails          # how value moves
reconciliation            # closing the loop
regulatory-apis           # what auditors see
operating                 # runtime knobs

What This Section Is Not

Not a kernel tutorial: see the Quickstart and the Guard Platform. Not the single-org budget reference: see Economics. Not a replacement for the formal proofs: the Lean 4 model in formal/ is the authoritative source for monotonic attenuation and related properties. Not a roadmap: crates and pages described here exist in the source today.

Agentic Economy: Overview · Chio Docs