Deviant BCH wallet — CashTokens + covenants (Katalogos v1 · chipnet)
Find a file
Local Dev d6cb311066 feat(explorer): master-password unlock + all 15 keystore addresses
Expand the chipnet Address Explorer from a hard-coded 7-wallet list to the full
15-wallet keystore, with an optional master-password gate for public deploys.

Two operating modes, chosen at boot by whether `addresses.enc.json` sits next
to the page:

1. Local / file:// — the inline WALLETS constant renders directly. Same
   frictionless behaviour as before, but the list now includes all 15 wallets
   plus per-wallet `cat` (category: operational | chipnet-test | bns | bns-infra)
   for a category-chip filter above the table.

2. Deployed — ship index.html + addresses.enc.json (spec
   chipnet-explorer-addresses/1: PBKDF2-SHA256/200k + AES-256-GCM, fresh
   16-byte salt per build). On boot the page fetches the blob, wipes the
   inline WALLETS to prevent pre-unlock leak, and shows a full-viewport lock
   overlay. Master password decrypts in-browser via SubtleCrypto — never
   transmitted, never persisted.

New signer: design/explorer/build-addresses-enc.mjs
- --master-pw prompts (or reads CHIPNET_KEYSTORE_PASSWORD env) and encrypts.
- Default source is the inline WALLETS parsed from index.html.
- --from-keystore pulls straight from Keys/chipnet-keystore.json via the
  existing scripts/lib/chipnet-keystore.mjs loader.

Crypto envelope matches the Faucet's v:3 mode (Parameters/dApp/Faucet/) and
the chipnet-keystore/2-encrypted format — same PBKDF2 params, same AES-GCM
authentication, same "fresh salt per build" discipline. Fourth consumer of
the unified master-password integration (spec:
Parameters/dApp/MASTER-KEY-INTEGRATION.md §6.1).

Verified in browser preview (Parameters/dApp/Explorer/ on port 5185):
- Overlay shows on load when addresses.enc.json is present
- Inline WALLETS wiped correctly before unlock (Σ table shows 0)
- Correct password → 15 addresses render with live balances + category chips
- All four categories surface: operational · chipnet-test · bns-infra · bns

Also gitignores both plaintext (addresses.json) and encrypted
(addresses.enc.json) address lists — same discipline as the faucet seed.

Copies design/explorer/index.html into Parameters/dApp/Explorer/index.html so
both mirrors stay identical (the parallel session's convention: design/ is the
source of truth, Parameters/ is the published copy).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-09-19 01:18:41 +02:00
.claude chore(hooks): auto-regenerate snapshots/INDEX.md on snapshot writes 2026-07-07 01:58:15 +02:00
brand brand(landing): clean URLs — wordmark → ./ + deviant_website.html now redirects 2026-08-30 00:30:29 +02:00
contracts feat(potidaea): real Katalogos Publish broadcast · TST431 registered on chipnet 2026-09-06 18:35:41 +02:00
design feat(explorer): master-password unlock + all 15 keystore addresses 2026-09-19 01:18:41 +02:00
docs docs(reorg): rename DEX_Anthemus -> Anthemus_DEX; consolidate both DEX cells + the taxonomy there 2026-07-19 22:29:08 +02:00
KnowledgeBase refactor(taxonomy): regular-form class names + DEA renamed to Direct Emission Asset 2026-09-02 00:02:53 +02:00
Parameters feat(explorer): master-password unlock + all 15 keystore addresses 2026-09-19 01:18:41 +02:00
public feat(onramp): SideShift Tier-3 in-wallet shift (ADR-0036 amendment) 2026-06-09 20:57:31 +02:00
scripts design(cross-chain): sketch atomic-swap deposit/withdrawal HTLCs 2026-09-06 12:58:45 +02:00
services feat(cross-chain): DGB-side HTLC primitives for the atomic-swap rail 2026-09-16 01:25:02 +02:00
shells feat(anthemus.dex): search + Favorites/All/Fiat tabs on the Assets panel 2026-09-16 01:28:48 +02:00
site/deviant feat(anthemus.dex): serve DEX-only kiosk at root — no wallet chrome 2026-09-16 01:02:20 +02:00
snapshots design(cross-chain): DGB rail commits to atomic-swap-primary (snapshot 0271) 2026-09-16 01:20:58 +02:00
spike chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
src feat(wallet): adjustable-fee end-to-end — Artemision + AssetDetail + updateFee 2026-09-02 08:15:40 +02:00
telegram-orderbook chore: sweep in-flight work across all domains 2026-07-29 01:14:33 +02:00
test feat(cross-chain): DGB-side HTLC primitives for the atomic-swap rail 2026-09-16 01:25:02 +02:00
wiki docs(cross-chain): handoff — snapshot 0271 + DGB HTLC primitives landed 2026-09-16 01:25:41 +02:00
.calibration-sweep.json chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
.catalytic-sweep.json chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
.env.example feat(onramp): SideShift Tier-3 in-wallet shift (ADR-0036 amendment) 2026-06-09 20:57:31 +02:00
.gitignore feat(explorer): master-password unlock + all 15 keystore addresses 2026-09-19 01:18:41 +02:00
.kac-extract.txt chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +02:00
.sim-athenae.json chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +02:00
adaptive-data.json chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
bch-history.json chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
bch-market.json chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
BCH_Token_Economy_Concept_Paper.md chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +02:00
bch_wallet_architecture.svg chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +02:00
CLAUDE.md feat(asm): Potidaea swap-relay + tally refresh to 52,998 2026-08-14 01:39:41 +02:00
deviant_technical_spec_v2.7.md chore: checkpoint in-flight work across shell, contracts, and docs 2026-07-07 02:02:05 +02:00
package-lock.json chore: sweep in-flight work across all domains 2026-07-29 01:14:33 +02:00
package.json chore: sweep in-flight work across all domains 2026-07-29 01:14:33 +02:00
project-context.md feat(asm): Potidaea swap-relay + tally refresh to 52,998 2026-08-14 01:39:41 +02:00
README.md chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +02:00
tsconfig.json chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +02:00
usdm-historical.json chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00

Deviant

BCH two-tier token economy platform. Pre-implementation. See BCH_Token_Economy_Concept_Paper.md for the full design.

Status

Bootstrap snapshot — protocol swap mechanism is the validation target.

Project map

Path Purpose
BCH_Token_Economy_Concept_Paper.md Architecture spec, all [PROPOSED] claims
CLAUDE.md Working agreement for Claude sessions
src/ TypeScript wallet + token logic
contracts/ CashScript source for Architecture A contracts
test/ Unit tests (regtest) + integration plan (chipnet, mainnet)
scripts/ Code-scan, snapshot, compile helpers
wiki/ Living docs: architecture, decisions, testing strategy, code map
snapshots/ Numbered progress snapshots

Quickstart

npm install
npm run compile:contracts   # produces artifacts from contracts/*.cash
npm run test:regtest        # runs regtest suite
npm run scan                # regenerates wiki/code-map.md
npm run snapshot            # appends a new snapshot

Build priorities (active)

  1. Protocol swap mechanism — most novel claim, needs validation first.
  2. CashScript enforcement on mainnet — not just theoretical verification.
  3. tokenId correlation across A/B tiers — edge cases expected.

See wiki/testing-strategy.md for the staged regtest → chipnet → mainnet plan.