node_modules/
dist/
*.log
.env
.env.local
.DS_Store
coverage/
.regtest-data/
wiki/code-map.md

# Chipnet/testnet4 dev wallet — generated by scripts/chipnet-setup.mjs.
# Holds a WIF private key for a testnet-only address. Never commit; never
# fund with real BCH.
.chipnet-keys.json
.chipnet-keys-*.json

# DigiByte MAINNET operator vault key — generated by scripts/onboard-dgb-mainnet-real.mjs.
# Holds a WIF private key for a P2WPKH address that custodies real DGB. NEVER commit.
.dgb-vault-keys.json
# Auto-generated chipnet dev-wallet bundle the shell imports (plaintext WIFs).
shells/app/src/devWallets.ts
.chipnet-tokens.json
.chipnet-vulnerable-tokens.json
.chipnet-asm-token.json
.chipnet-asm2-token.json
.chipnet-cap-token.json
.chipnet-t001-token.json
.chipnet-mut-state.json
.chipnet-whitelist-test.json
.chipnet-escalating-test.json
.chipnet-escalating-50pc-test.json
.chipnet-bonding-swap-test.json
.chipnet-escalating-source-swap-test.json
.chipnet-swap-remainder-test.json
.chipnet-denomination-fee-test.json
.chipnet-redeem-safety-test.json
.registry-tokens.json


.deviant/
.chipnet-escrow-test.json
.chipnet-escrow-fee-test.json
.chipnet-escrow-fee-irregular-test.json
.chipnet-escrow-flat-test.json
.chipnet-che-escrow-test.json
.chipnet-che-perside-test.json
.external/

# Catch-all for ALL generated chipnet artifacts & dev key files (keys-e/f/g,
# tote/CLOB/oracle/metals/dra/clob test outputs, etc.). Superset of the
# per-file entries above — these are testnet-only, regenerated by scripts,
# and may hold WIF private keys. Never commit.
.chipnet-*.json
# Chipnet test-state JSONs (moved by scripts/migrate-chipnet-tests.mjs).
ChipnetTests/

# Third-party design template screenshots (Figma/Behance kits) downloaded for
# the CosmoGenesis comparison round — reference-only, not project assets.
templates/

# KnowledgeBase RAW media dump — ~9.6 GB of source video/audio (Bitcoin docs,
# crypto vids, raw research). NEVER commit: git is for code/text, not GB-scale
# media. Files stay on disk (covered by the local folder backup), just untracked.
# Both casings, since Windows is case-insensitive.
KnowledgeBase/RAW/
Knowledgebase/RAW/

# Claude session transcript dumps (multi-MB JSONL) — logs, not source, and a
# secret-prone surface. Kept on disk, never committed. Both legacy root location
# and the FIATm-scoped subfolder are excluded.
transcripts/
Parameters/ASM_Native/FIATm/transcripts/

# Cross-chain (Build B) testnet dev keys — Tron Nile / Ethereum Sepolia.
# Hold raw private keys for testnet-only source-chain wallets. Never commit;
# never fund with mainnet value.
.tron-*.json
.sepolia-*.json
.eth-*.json
# BTC signet HTLC-swap testnet keys (T4 — BTC↔BCH atomic swap). Testnet-only.
.btc-*.json

# T6 ephemeral demo state (channel handle, routing run-state). Regenerated; not secrets.
.t6-*.json

# Local key store — chipnet (and any future test/mainnet) WIFs, address notes,
# device assignments. NEVER commit. Files here mirror the per-wallet
# `.chipnet-keys-*.json` at repo root but in a single human-readable place.
# Two locations covered: the legacy Parameters/Keys/ path and the current
# repo-root Keys/ path that holds `chipnet-keystore.json` and any per-wallet
# key files still present.
Parameters/Keys/
Keys/

# Testnet Faucet Hub — the index.html is public/address-agnostic and committed.
# Only the local dev SEED (pre-fills the watchlist with the project's testnet
# dev-wallet addresses) stays out of git, like the keystore.
Parameters/dApp/Faucet/faucet-seed.js
Parameters/dApp/Faucet/faucet-seed.enc.json
Parameters/dApp/Faucet/_public-test/

# Chipnet Address Explorer — index.html and build-addresses-enc.mjs are committed.
# The encrypted (or plaintext) address list, however, is per-user data and stays
# out of git — same discipline as the faucet seed.
design/explorer/addresses.enc.json
design/explorer/addresses.json
Parameters/dApp/Explorer/addresses.enc.json

# Local scratch / temp files.
.tmp-*

# Claude Code machine-local config (per-user overrides + transient locks).
# Shared .claude config (settings.json, commands/, agents/) can still be tracked.
.claude/settings.local.json
.claude/launch.json
.claude/*.lock

# correspondent service runtime state (deployed vaults, controllers, quotes)
services/correspondent/.correspondent-state.json

# DigiByte mainnet key for the faucet hub DGB card (real coin — never commit).
.dgb-keys.json

# Solana devnet key for the faucet hub Solana card (gitignored).
.sol-keys.json

# XRPL + Stellar testnet keys for the faucet hub (gitignored).
.xrpl-keys.json
.stellar-keys.json

# Anthemus relay runtime state (order/trade cache — chain state is the source of truth).
services/anthemus-relay/.anthemus-relay-state.json
.chipnet-keys-anthemus-platform.json

# Deploy bundles emitted by scripts/bundle-surfaces.mjs
build/

# Root-level test/session state files written by scripts/*.mjs. These carry
# per-run addresses/tx hashes/oracle keys and must not enter the repo — treat
# them the same as the .chipnet-keys-* files above. Add new ones by name.
.sol-vault-keys.json
.football-tote-state.json
.tote-platform-state.json
.redeem-roundtrip-state.json
.eurc-onboard-state.json

# One-off HTML reports emitted by chart scripts.
.usdm-historical-chart.html

# MS Office lock/autosave files (`~$foo.docx`) — leaked when a doc is open.
~$*

# Katalogos dev oracle key (chipnet-only)
.chipnet-katalogos-oracle.json

# APK release artifacts + phone screenshots — ephemeral build outputs
shells/app/downloads/
