01 / Product RoutesCompatibility

Understand /exchange compatibility and /packs

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

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

After reading

You can explain why /exchange survives only as compatibility and why rereadable /packs state is central to Bitcode.

Compatibility

01

/exchange redirects to /packs

/exchange is retained only as a compatibility redirect. /packs is the durable master-detail surface for AssetPack 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 /packs.

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 /packs.
  • 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 /packs read window

/packs records deposits, measured Reads, AssetPack 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 an AssetPack 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

/packs reread is what turns actions into evidence

A write is not trusted merely because a control returned success. The expected result is durable /packs 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

AssetPacks 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 /packs 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 AssetPack source. Source-bearing AssetPack 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 AssetPacks 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 AssetPack 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 /packs 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 Packs card

Packs activity master-detail

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

Search

Query-owned ledger

Selected detail

Proof + history

Reread

Durable /packs state