Documentation

Home

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

Getting Started

To make the `daybook` command available globally:

Configuration

daybook stores its configuration at `~/.daybook/config.json`. Created by `daybook init`, validated by zod on load.

CLI Reference

Create the config file and SQLite database.

Coinbase API Setup

daybook supports two Coinbase ingestion paths:

Architecture

daybook is a pnpm-workspace monorepo with five packages:

Source Adapters

Source adapters live in `packages/sources/`. Each adapter has one job: produce `RawEvent[]` from its source. Adapters do not classify intent — that's the classifier's job.

Classifier Rules

The classifier lives in `packages/classifier/`. It transforms `RawEvent[]` into `LedgerEntry[]` using an 8-rule chain. Rules run in order — the first rule that claims an event wins.

Tax Engine

The tax engine lives in `packages/tax/`. It computes cost basis, gain/loss, and produces tax-ready CSV output from classified ledger entries.

Pricing

The pricing module lives in `packages/tax/src/pricing/`. It resolves USD prices for assets at specific timestamps using a priority chain of providers.