Home

daybook

Self-hosted crypto wallet auditing and tax reporting CLI tool.

daybook pulls transactions from Coinbase, Kraken, and EVM wallets (Ethereum, Polygon), normalizes them into a single ledger, classifies events, computes cost basis, flags wash-sale candidates, and exports a tax-ready CSV.

Current version: v1.1 — 205 tests passing across 15 test files.

Quick Links

• Getting Started — install, configure, and run your first export
• CLI Reference — all commands, flags, and options
• Architecture — monorepo structure, package dependencies, data flow
• Source Adapters — Coinbase CSV, Kraken CSV, EVM chains
• Classifier Rules — the 7-rule classification chain
• Tax Engine — cost basis methods, wash sale flagging, CSV export
• Pricing — how USD prices are resolved
• Configuration — config file format and environment variables

What's New in v1.1

• Kraken CSV adapter — import Kraken "Export Ledger" CSV files
• Events list Ink upgrade — structured table output with --type, --source, --account filters
• Failed transaction gas tracking — capture gas from reverted EVM transactions via Etherscan
• Classify dry-run — preview classifier changes without writing to the database
• Interactive unclassified review — override unclassified events inline after classification
• Incremental sync — --from <date|block> to skip already-ingested history
• Specific ID lot selection — hand-pick lots for tax-loss harvesting with interactive picker or JSON replay
• Wash sale flagging — informational flags on loss disposals with acquisitions within ±30 days

Supported Sources

Source	Method	Status
Coinbase	CSV import	✅ v1
Kraken	CSV import	✅ v1.1
Ethereum	Alchemy API	✅ v1
Polygon	Alchemy API	✅ v1
Etherscan (failed tx)	Etherscan API	✅ v1.1

Cost Basis Methods

Method	Description	Status
FIFO	First in, first out (IRS default)	✅ v1
HIFO	Highest cost, first out (tax minimizer)	✅ v1
Specific ID	User picks lots manually	✅ v1.1