Back to all work
— Project 10
Fintech · Tax

TaxMyCrypto

Self-hosted crypto tax engine

A local, self-hosted crypto tax engine built around one question: can I trust the numbers before they land on Form 8949? It ingests exchange CSVs and on-chain history, reconciles prices and balances across independent sources, computes capital gains under FIFO / LIFO / HIFO, detects wash sales under IRC §1091, flags scam tokens, and exports IRS Form 8949, Schedule D, and an accountant-friendly summary as real PDFs. It runs on your laptop against a SQLite database, so wallet history never leaves the machine.

Role
Solo Engineer
Period
2026
Status
Production
SvelteKitTypeScriptSQLite + Drizzledecimal.js6 price oraclesSolana RPC
— Chapter 01
System shape

How the system fits together.

Click any block to read about it
Fig. 01 — TaxMyCrypto architecture
— Chapter 02
Decisions and outcomes

The calls that shaped it.

  1. 01

    Prices reconciled, not trusted

    Queries CoinGecko, CoinMarketCap, and CryptoCompare in parallel, takes the median, and only marks a price verified when two sources agree within 2% — falling through a six-channel chain (CoinPaprika → Birdeye → DexScreener → on-chain → implied), each source stored as its own auditable row.

  2. 02

    Balances checked two ways

    One ledger is recomputed from the raw transaction stream, a second summed from tax-lot remainders, reconciled per wallet+asset to 1e-8 — any drift surfaces as a data-integrity issue, so cost basis can never quietly disagree with what moved on-chain.

  3. 03

    Cost basis you can defend

    A decimal.js FIFO/LIFO/HIFO lot matcher plus full IRC §1091 wash-sale detection, a 13-check cross-validation gauntlet, and Form 8949 / Schedule D filled against the real 2025 IRS PDF templates via pdf-lib.

  4. 04

    Internal transfers stay off the ledger

    Three-pass transfer matching — same-chain tx_hash, cross-chain bridge (wrapped↔native within 1% / 2h), and hashless Coinbase-CSV ↔ on-chain — preserves the original cost basis instead of opening a phantom disposal.

  5. 05

    On-chain scam defense

    An algorithmic scorer weighs ten signals; an investigator then goes on-chain — Blockscout deployer profiling (serial-scammer detection), Solana RPC mint/freeze authority, Token-2022 honeypot extensions — and flagged tokens are dropped before the 8949 is computed.

— Aside
The interesting work isn't the stack. It's the boundaries.
— Chapter 03
How it runs

What it runs on.

App
SvelteKit 5 · TypeScriptSQLite · Drizzledecimal.jspdf-libVitest
Chains
EVM · Solana · BTC · XRP · CosmosHelius · Solana RPCBlockscout