Skip to content

docs: backfill normative SPEC.md — pure-RPC-consumer contract (#44/#41)#1

Merged
MichaelTaylor3d merged 1 commit into
masterfrom
docs/spec-pure-rpc-consumer-44
Jul 4, 2026
Merged

docs: backfill normative SPEC.md — pure-RPC-consumer contract (#44/#41)#1
MichaelTaylor3d merged 1 commit into
masterfrom
docs/spec-pure-rpc-consumer-44

Conversation

@MichaelTaylor3d

Copy link
Copy Markdown

Backfills the DIG Browser's missing SPEC.md — item ungoogled-software#5 of super-repo ungoogled-software#44 (the SoC re-arch, per the ungoogled-software#41 ruling).

Normative pure-RPC-consumer contract:

  • chia:///dig:// resolution + on-chain root pinning
  • the §5.3 node-resolution ladder (explicit custom endpoint > dig.local > localhost:8080 > rpc.dig.net), with dig/node/dig_source_resolution.mjs as the single source of truth mirrored by the native loader
  • trustless client-side verify+decrypt via the ONE shared digstore dig_client wasm (byte-identical to hub/extension/SDK) — no bespoke native crypto
  • window.chia CHIP-0002 wallet, Shields (per-resource proof ledger), dig://control
  • the custom-node setting (§4.3)
  • explicit non-goals: no in-process node, no P2P, no content cache / cache-config chrome, no second read-crypto copy

Agrees with SYSTEM.md (Roles — serving vs consuming) + docs.dig.net. A §10 transition note tracks the remaining ungoogled-software#44 code deltas (in-process-node removal, crypto single-source, cache-UI removal, custom-node setting) — those are the C++/patch changes that ship gated on installer ungoogled-software#40 + a buildable release (ungoogled-software#26), per the issue checkpoint.

Docs-only; no code/build change. dig-browser is grandfathered (§3.6a).

…led-software#44/ungoogled-software#41)

The DIG Browser had no SPEC.md. Add the normative pure-RPC-consumer contract per
the ungoogled-software#41 separation-of-concerns ruling + super ungoogled-software#44: chia://\/dig:// resolution, the
§5.3 node-resolution ladder (explicit > dig.local > localhost:8080 > rpc.dig.net)
with the shared dig/node/dig_source_resolution.mjs as the single source of truth,
trustless client-side verify+decrypt via the ONE shared digstore dig_client wasm,
window.chia CHIP-0002 wallet, Shields + dig://control surfaces, the custom-node
setting, and the explicit non-goals (no in-process node / P2P / cache UI / bespoke
native crypto). Agrees with SYSTEM.md Roles + docs.dig.net. A §10 transition note
tracks the remaining ungoogled-software#44 code deltas (in-process-node removal, crypto single-
source, cache-UI removal, custom-node setting).
@MichaelTaylor3d MichaelTaylor3d merged commit fbf55fc into master Jul 4, 2026
1 check passed
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