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.