Skip to content

docs: multi-chain trust tiers + scope dossier - #103

Merged
hellno merged 2 commits into
mainfrom
hellno/multichain-scope
Jun 20, 2026
Merged

docs: multi-chain trust tiers + scope dossier#103
hellno merged 2 commits into
mainfrom
hellno/multichain-scope

Conversation

@hellno

@hellno hellno commented Jun 20, 2026

Copy link
Copy Markdown
Owner

What

Two docs, no code:

  1. DESIGN.md — a new Per-chain trust tiers section + a decisions-log row. Codifies the product call: one wallet, loud honest downgrade. Mainnet stays the only Verified tier; every other chain reads NOT VERIFIED via the existing Unsynced affordance (no new badge). Tier 2 (opstack Degraded) is reserved for Spike: multi-chain verified reads via helios-opstack (Base/OP) — scope + go/no-go #77; no-native-asset chains (Tempo) are deferred until the portfolio model can represent them.
  2. docs/research/multichain-scope.md — the full scoping dossier behind the multi-chain issue set, with every file:line citation: subsystem coupling maps across all 7 crates, external research (Tempo, Arbitrum, light-client landscape, CoW/Railgun), a feature matrix, risks, phasing, and the open questions to verify before building.

Why

Scopes how Deckard adds non-Ethereum chains given that verified reads are structurally mainnet-only. Backs the issues opened from it: #97 (chain registry), #98 (Arbitrum reads+send), #99 (swap), #100 (gas), #101 (privacy), #102 (Tempo spike) — plus the existing #76 (guardrail) and #77 (opstack spike).

Notes

  • Docs only; no Cargo.toml / code changes, so the engineering DoD (clippy/tests) is N/A.
  • Corrects a premise: Tempo mainnet is 4217; 42431 is the Moderato testnet.

hellno added 2 commits June 20, 2026 14:52
Add a per-chain trust-tier model to DESIGN.md (mainnet Verified / future
opstack Degraded / raw-RPC NOT VERIFIED) and a full scoping dossier under
docs/research/. Backs issues #97-#102 (chain registry, Arbitrum, Tempo spike)
and the existing #76 guardrail / #77 opstack spike.
Cut implementation exposition (ReadStatus internals, launch-time tier
selection, eth_getBalance mechanics) that belongs in the dossier, drop
doubled-up sentences, match the surrounding terse declarative voice.
@hellno
hellno merged commit bacc8d6 into main Jun 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant