Deviant BCH wallet — CashTokens + covenants (Katalogos v1 · chipnet)
Find a file
walerikus 48cc3ea808 docs(t6): standalone T6 model explainer
Self-contained explainer of the T6 model: what it is (a BTC channel whose state record
lives on the BCH chain instead of an LN node), how it works (clerk/bailiff — BCH records,
BTC settles), the step-by-step mechanics (open / transact / cooperative close / unilateral
exit + revocation penalty), how it differs from LN (state-record location → no node, no
lost-state, permissionless watchtower, two light wallets), the trust model (penalty as a
"BTC tax"; denial > penalty on BCH-native), LN interop (HTLC-capable T6 = LN channel with a
BCH watchtower; submarine swap to fund), what's validated on real coins, and why it matters.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-25 01:52:20 +02:00
contracts feat(t6): BCH-as-LN-board + real BTC 2-of-2 channel on signet — "better LN" validated 2026-06-25 00:20:01 +02:00
design feat(crosschain): SafeERC20 refund fix + robustness suite + naming model 2026-06-23 23:05:48 +02:00
KnowledgeBase chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
Parameters docs(t6): standalone T6 model explainer 2026-06-25 01:52:20 +02:00
public feat(onramp): SideShift Tier-3 in-wallet shift (ADR-0036 amendment) 2026-06-09 20:57:31 +02:00
scripts docs(t6): record requirements vs LN + LN↔T6 interop; multi-channel scale test 2026-06-25 01:43:14 +02:00
shells chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
snapshots feat(t6): BCH-as-LN-board + real BTC 2-of-2 channel on signet — "better LN" validated 2026-06-25 00:20:01 +02:00
spike chore: checkpoint working tree — shell Tier-B retirement + accumulated WIP 2026-06-17 01:01:37 +02:00
src docs: repoint stale references to renamed FIATm design record 2026-06-17 02:10:36 +02:00
test refactor: retire legacy OP_RETURN-era swap files 2026-06-13 21:20:40 +02:00
wiki docs: repoint stale references to renamed FIATm design record 2026-06-17 02:10:36 +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 chore(crosschain): BTC-signet tooling scaffold for the real BTC leg (T4) 2026-06-24 22:28:49 +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 chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +02:00
deviant_technical_spec_v2.7.md chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +02:00
package-lock.json chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +02:00
package.json feat(chipnet): USDm/PUSD AMM + real cross-chain wrap USDt→τUSDt 2026-06-22 22:07:58 +02:00
project-context.md chore: initial project baseline — full Deviant codebase under version control 2026-06-13 20:38:07 +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.