01 / Product RoutesExchange

Understand Exchange activity and /exchange compatibility

/exchange is the durable activity, persistence, proof, settlement, compensation, delivery, and repair readback surface. /exchange remains a compatibility redirect into Exchange.

Use this page after DataPacks are clear. It explains why bounded actions must reread proof-backed activity before users trust the result.

After reading

You can explain why Exchange is the reread surface and why /exchange only survives as a compatibility path into that state.

Compatibility

01

/exchange redirects to /exchange

/exchange is retained only as a compatibility redirect. /exchange is the durable master-detail surface for DataPack activity, proof roots, settlement, compensation, delivery, and repair.

The compatibility path must not become a parallel product. MCP, ChatGPT App, Bitcode Chat, GitHub, and future interfaces must reread the same proof-backed activity exposed through /exchange.

Why this matters

Old links can survive without inventing a second center of product truth.

  • Activity and selected detail must survive navigation and reread through /exchange.
  • Write paths must create durable source-safe records.
  • Read paths must expose the same proof readback to admitted interfaces.

Ledger

02

The activity ledger is the main /exchange read window

/exchange records deposits, measured Reads, DataPack executions, proof posture, settlement, and history in one searchable ledger.

The ledger is not only a table. It is the readable index of what happened, why it happened, and which detail panel to open next — seller and buyer views of the same commercial object.

Why this matters

If a write cannot be reread from the ledger, the product cannot prove a DataPack path to an operator.

  • Search and filters keep large activity sets usable.
  • Selected detail carries proofs, settlement, BTD/BTC posture, and history.
  • Route-owned query state makes review shareable and recoverable.

Persistence

03

/exchange reread is what turns actions into evidence

A write is not trusted merely because a control returned success. The expected result is durable /exchange reread with the right proof, readiness, and state posture.

Protocol treats persistence, schema, route-owned state, execution history, and work summaries as product truth — not incidental backend storage.

Why this matters

DataPacks require state that a different surface can audit later, not only local UI continuity.

  1. 01Write through /deposits, /reads, Bitcode Chat, MCP, or another admitted interface.
  2. 02Persist normalized, source-safe activity evidence.
  3. 03Reread the activity and selected detail in /exchange before trusting fit, proof, or settlement.

Disclosure limits

04

Public docs expose guidance and proof posture, not protected source

Public Bitcode docs derive from the active Protocol, package-owned catalogs, route contracts, and source-safe generated artifacts. They can explain usage, measurements, event ids, proof roots, docs links, runbook links, redaction posture, testnet rollout readiness, fee boundaries, and settlement posture.

They must not reveal protected source payloads, raw protected prompts, secret values, provider tokens, wallet private material, or unpaid DataPack source. Source-bearing DataPack contents cross to the reader only after settlement and rights transfer.

Why this matters

This keeps the public product understandable while preserving the boundary that makes DataPacks economically and operationally safe.

  • Allowed: usage guidance, route links, state labels, source-safe measurements, proof roots, dashboard/runbook ids, redacted incident posture, testnet rollout readiness, LocalStagingTelemetryDocumentationRehearsal evidence, and fee/right boundaries.
  • Interface docs may surface event ids, proof roots, docs links, runbook links, and redaction posture from TelemetryDocumentationInterfaceIntegration without revealing source-bearing payloads.
  • Local and staging-testnet rehearsal docs may surface documentation discovery, telemetry event emission, dashboard/runbook lookup, docs QA, incident drill, source-safe proof-root review, and blocked value-bearing mainnet posture.
  • Blocked: secrets, provider tokens, wallet private material, raw protected prompts, protected source payloads, and unpaid DataPack source.
  • Docs QA fails closed when public docs, internal docs, route docs, interface docs, generated artifacts, proof posture, or workflow checks drift.
  • Compatibility boundaries stay explicit: /exchange redirects to /exchange and does not create a parallel current product surface.

Interface preview

Learn with the same UI grammar used in the product

These embedded specimens reuse product card and explainer patterns so docs readers become familiar with Packs, Deposit, and Read before they operate against them.

Embedded Exchange card

Exchange activity master-detail

/exchange uses a master-detail pattern: searchable activity rows as the master, selected DataPack/proof/history state as detail.

Search

Query-owned ledger

Selected detail

Proof + history

Reread

Durable /exchange state