Tasks — cryptocurrency

Every checkbox MUST reflect work actually done in this change.

1. Spec authoring

1.1 Read openspec/AGENTS.md §0, §0a, §0b, §0c, §6a, §7, §13, §14 end-to-end
1.2 Read ../suaveplan/packages/finance/cryptocurrency/src/ — all 8 implementation files + 7 test files
1.3 Read ../suaveplan/enterprise/cryptocurrency.md in full
1.4 Read openspec/archive/2026-05-16-add-seed/ as the closest precedent (universal-tier, error-coded migration)
1.5 Draft proposal.md with parity checklist, source mapping, affected dependents
1.6 Draft design.md covering layout, error-code map, EIP-55 algorithm preservation, LoggerLike injection, tier purity
1.7 Draft specs/cryptocurrency/spec.md in OpenSpec ### Requirement: / #### Scenario: form
1.8 Every requirement carries a **Verified by:** line naming concrete planned it(...) titles

2.1 Create packages/finance/cryptocurrency/ mirroring the database/seed layout
2.2 Write package.json v0.0.0, "sideEffects": false, subpath exports for the 11 modules listed in design.md §2
2.3 Wire deps: @suaveplan/error: workspace:^, @suaveplan/types: workspace:^, tslib: catalog:build
2.4 Wire devDeps: @suaveplan/testing: workspace:^, @vitest/coverage-istanbul: catalog:testing, typescript: catalog:, vite: catalog:build, vite-plugin-dts: catalog:build, vitest: catalog:testing, @types/node: catalog:
2.5 Write tsconfig.json, tsconfig.lib.json extending the repo base
2.6 Write vite.config.ts (preserveModules build for every subpath export)
2.7 Write vitest.config.ts (Istanbul, 100/100/100/100 thresholds, forks pool)
2.8 Write tests/setup/polyfills.ts (empty — universal-tier needs no polyfills)
2.9 Write README.md (≥ 200 words, required sections per CLAUDE.md docs gate)

3.1 src/types/crypto.types.ts — every public type from upstream preserved verbatim
3.2 src/types/crypto.types.md — co-located doc per docs-coverage gate

4.1 src/error-codes/error-codes.ts — defineCodes("CRYPTOCURRENCY", [5 codes]) registry, CryptocurrencyError extends SuaveplanError<CryptocurrencyErrorCode> with chainId? / currency? / unit? discriminants
4.2 src/error-codes/error-codes.test.ts — every code reachable via CryptocurrencyError construction; cause-chain preservation verified
4.3 src/error-codes/error-codes.md
4.4 src/error-codes/index.ts — explicit named re-exports

5.1 src/address/validator.ts — validateAddress, validateAddressForChain, validateTxHash, internal positional EIP-55 checksum (preserve upstream behaviour bit-for-bit)
5.2 src/address/validator.test.ts — port every upstream test case + tier-purity assertion
5.3 src/address/validator.md
5.4 src/address/index.ts — explicit named re-exports

6.1 src/chains/chain-data.ts — CHAINS: Record<ChainId, ChainInfo> with 15 entries (preserve upstream verbatim)
6.2 src/chains/chain-data.test.ts — assert 15 entries, EVM-id correctness
6.3 src/chains/chain-data.md
6.4 src/chains/registry.ts — synchronous getters
6.5 src/chains/registry.test.ts — port upstream test cases
6.6 src/chains/registry.md
6.7 src/chains/chain-registry.ts — MemoryChainRegistry + ChainRegistry; throws → CryptocurrencyError({ code: CRYPTOCURRENCY.UNKNOWN_CHAIN, chainId }); constructor gains optional LoggerLike; emits chain.registered / chain.lookup.miss events
6.8 src/chains/chain-registry.test.ts — port upstream tests; add UNKNOWN_CHAIN rejection test; add LoggerLike recording test; add tier-purity assertion
6.9 src/chains/chain-registry.md
6.10 src/chains/index.ts — explicit named re-exports

8.1 src/tokens/token-data.ts — preserve upstream COMMON_TOKENS verbatim
8.2 src/tokens/token-data.test.ts — assert 8 tokens present + shape invariants
8.3 src/tokens/token-data.md
8.4 src/tokens/token-registry.ts — preserve TokenRegistry + formatTokenBalance
8.5 src/tokens/token-registry.test.ts — port upstream cases
8.6 src/tokens/token-registry.md
8.7 src/tokens/index.ts — explicit named re-exports

10.1 src/units/converter.ts — preserve upstream conversion logic; replace plain throw new Error(...) with CryptocurrencyError({ code: CRYPTOCURRENCY.UNKNOWN_CURRENCY | UNKNOWN_UNIT })
10.2 src/units/converter.test.ts — port upstream cases + error-code assertions + tier-purity assertion
10.3 src/units/converter.md
10.4 src/units/index.ts — explicit named re-exports

11.1 src/index.ts — explicit named re-export of every symbol listed in design.md §2 (no export *)
11.2 tests/exports.test.ts — assert every advertised subpath export resolves at runtime

12.1 bunx turbo lint --filter=@suaveplan/cryptocurrency green; zero biome suppressions
12.2 bunx turbo typecheck --filter=@suaveplan/cryptocurrency green
12.3 bunx turbo test --filter=@suaveplan/cryptocurrency green; zero .skip / .only / it.todo
12.4 bunx turbo test:coverage --filter=@suaveplan/cryptocurrency green at 100/100/100/100 (Istanbul)
12.5 bun scripts/openspec-conformance.ts @suaveplan/cryptocurrency — exit 0
12.6 bunx turbo build --filter=@suaveplan/cryptocurrency green
12.7 grep -rnE "from ['\"](vitest|bun:test)['\"]" packages/finance/cryptocurrency/src/ → zero matches (rule §11 / §7)
12.8 Feature-barrel export * scan — zero matches outside exempt forms (rule §6a)
12.9 grep -rnE "from ['\"](node:|bun:|fs|path|stream|net|http|crypto)['\"]" packages/finance/cryptocurrency/src/ → zero matches (tier purity)
12.10 Banned-pattern scan zero matches (@deprecated, TODO, FIXME, ts-ignore, ts-expect-error, .skip, .only, any, console.log)
12.11 Every ### Requirement in specs/cryptocurrency/spec.md checked off against the implementation
12.12 bun scripts/folder-reorg/generate-manifest.ts run; MANIFEST.md includes @suaveplan/cryptocurrency
12.13 STATUS.md @suaveplan/cryptocurrency row flipped from – to ✅
12.14 SUMMARY.md updated with per-package paragraph

13.1 Fold specs/cryptocurrency/spec.md into openspec/specs/cryptocurrency/spec.md (canonical file created here for the first time)
13.2 Move openspec/changes/add-cryptocurrency/ to openspec/archive/2026-05-17-add-cryptocurrency/