Local protocol mode — Anvil, development executor keys, and synthetic Nitro registration are not production trust assumptions.

Architecture

System architecture

The public system model: data flow, trust boundaries, sources of truth, and failure isolation.

Component map

Authority and evidence map
Native Chain

Authorizes credit, assignment, receipts, retries, and domain-bound proofs.

Clients

Browsers, wallets, and agents submit questions and signatures.

API + PostgreSQL

Sessions, responsive reads, streams, idempotency, and mirrors.

TEE + archives

Provider execution, typed output, signed receipts, and durable evidence.

Settlement domains

Independent escrows verify proofs, move USDC, and publish results.

System components

ComponentCustomer-relevant responsibility
APICapability discovery, x402 request admission, progress streams, result reads, and evidence retrieval
Native consensusCredit observation, deterministic assignment, receipt acceptance, retries, and quorum-authorized finality
Servicers and TEE executorsProvider calls, typed-output validation, evidence creation, and signed execution receipts
Independent archivesDurable, content-addressed copies of the provider exchange and execution record
Settlement contractsUSDC custody, proof verification, replay protection, payouts, refunds, and compact result publication

Who owns which state

StateAuthorityLocal representation
Session and UI recordsPostgreSQLPrimary application state
Domain-scoped credit, reservation, assignment, receipt, retry, slashFinalized Native ChainPostgreSQL mirrors for reads/reconciliation
USDC custody and paid resultsThe selected domain's escrowObserved by validators and indexed locally per domain
Complete provider exchangesContent-addressed archivesArchive ID and hashes in signed receipt
TEE identity and PCR policyNitro attestation + Native Chain governanceCommitted teeKeyId and validator-local watcher state

PostgreSQL makes the product responsive and recoverable, but it is a mirror rather than settlement authority. Coordinator reconciliation compares local state with Native Chain and every governed settlement domain, including payment-inactive staged domains. An unavailable domain is isolated for ordinary reconciliation, but validator authority cannot advance past a governed domain that has not synchronized.

Separated failure domains

  • The API has no validator private keys and cannot fabricate quorum authorization.
  • The servicer has no validator keys and cannot assign itself arbitrary work.
  • The Nitro parent sees destinations and ciphertext but TLS terminates inside the enclave.
  • The enclave receives no chain or database credentials and cannot settle itself.
  • Archives preserve full evidence outside enclave lifetime; receipt hashes make replacement detectable.
  • Durable validator watcher cursors preserve finalized EVM observation progress across restarts.