walerikus 518a3ce174 chore: initial project baseline — full Deviant codebase under version control

Brings the whole project into git (previously only the on-ramp feature and
a few parallel files were tracked). Includes: wallet core (src/), CashScript
contracts/, the Capacitor shell (shells/), scripts/, tests, and the docs
corpus (wiki/, snapshots/, Parameters/, Archive/, KnowledgeBase text).

Excluded via .gitignore: node_modules/, dist/, .env (secrets), testnet WIF
key files (.chipnet-*.json, devWallets.ts), KnowledgeBase/RAW media (~9.6 GB),
transcripts/ (session logs), and machine-local config (.claude/*.local,
*.lock). Secret-scanned before commit — no credentials in the tree.

Note: src/swapMath.ts, src/swapBuilder.ts, contracts/OpenMintToken.cash are
legacy (OP_RETURN era) but still imported; committed as-is, flagged for a
separate removal once de-referenced.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-13 20:38:07 +02:00

1.3 KiB

Raw Blame History

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)

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

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