Deviant BCH wallet — CashTokens + covenants (Katalogos v1 · chipnet)
Find a file
Local Dev adfd3f39e0 feat(katalogos): ship shared registry v1 on chipnet — oracle-priced $1 in DEA
Two-tier registration per ADR-0055: your own list stays free (ADR-0008),
inscribing into the shared Katalogos writes on-chain state and costs
$1-worth of DEA, oracle-priced (ADR-0052 pattern), covenant-enforced.
Entries are immutable per-entry NFTs whose commitment IS the target
category id; a shared minting NFT is the state UTXO.

The registry is version-aware from day one (KATALOGOS_VERSIONS in the
shell config). Re-pricing or switching to the paymaster fallback = one
config line; discovery reads across every known version; old entries
stay valid forever.

Shipped:
  contracts/KatalogosRegistryV1.cash             — covenant (7/7 regtest)
  src/wallet/katalogos.ts                        — planner + discovery (11/11 unit)
  shells/app/src/core/katalogos.ts               — shell publisher + version list
  shells/app/src/core/katalogos-oracle-dev.ts    — chipnet dev oracle for signing
  shells/app/src/components/TokenImportModal.tsx — Publish button on success screen
  shells/app/src/asm-core/AsmCore.tsx            — picker reads shared list
  scripts/chipnet-katalogos-register.mjs         — deploy + register end-to-end

Live on chipnet: registry at
bchtest:rwm0e4rnq0htx97g3sllrgld652w7ztxlnqlx7820kd3mhklk6v8vmtth22xs,
CHE + ATD inscribed. Full deploy record in ChipnetTests/.chipnet-katalogos.json.

Amends ADR-0048: featured discovery is paid; unlisted assets stay swappable
at the protocol layer (paste-a-category). "Never the right to swap" invariant
preserved — the ASM covenant consults no registry.

Not yet built: paymaster fallback (v2, designed only), Katalogos second-tab
paste-address lookup, mainnet oracle wiring (dev key baked for chipnet only).
Full record: wiki/decisions.md ADR-0055 amendment, snapshot 0248.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-31 01:02:29 +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(katalogos): ship shared registry v1 on chipnet — oracle-priced $1 in DEA 2026-08-31 01:02:29 +02:00
design fix(agora): brand link points at own index.html, not Potidaea's 2026-08-30 09:58:05 +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 @ 2026-08-14 02:00:43 +02:00
Parameters docs: enforce project-wide "bits" (not "sats") in copy 2026-08-30 18:45:28 +02:00
public feat(onramp): SideShift Tier-3 in-wallet shift (ADR-0036 amendment) 2026-06-09 20:57:31 +02:00
scripts feat(katalogos): ship shared registry v1 on chipnet — oracle-priced $1 in DEA 2026-08-31 01:02:29 +02:00
services chore: sweep in-flight work across all domains 2026-07-29 01:14:33 +02:00
shells feat(katalogos): ship shared registry v1 on chipnet — oracle-priced $1 in DEA 2026-08-31 01:02:29 +02:00
site/deviant site(anthemus): meta description matches the canonical one-liner too 2026-08-30 10:43:01 +02:00
snapshots feat(katalogos): ship shared registry v1 on chipnet — oracle-priced $1 in DEA 2026-08-31 01:02:29 +02:00
spike chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
src feat(katalogos): ship shared registry v1 on chipnet — oracle-priced $1 in DEA 2026-08-31 01:02:29 +02:00
telegram-orderbook chore: sweep in-flight work across all domains 2026-07-29 01:14:33 +02:00
test feat(katalogos): ship shared registry v1 on chipnet — oracle-priced $1 in DEA 2026-08-31 01:02:29 +02:00
wiki feat(katalogos): ship shared registry v1 on chipnet — oracle-priced $1 in DEA 2026-08-31 01:02:29 +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(katalogos): ship shared registry v1 on chipnet — oracle-priced $1 in DEA 2026-08-31 01:02:29 +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.