Crypto Tax Calculator

# Crypto Tax Calculator 📊

A comprehensive cryptocurrency tax calculation engine. Import your trades, select your jurisdiction, and generate professional tax reports.

## Workflow Overview

```
[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]
     ↓              ↓                  ↓                    ↓                   ↓                    ↓
  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV
  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report
```

## Step 1: Prepare Your Data

Your CSV must have these columns (order doesn't matter):

| Column | Required | Format | Example |
|--------|----------|--------|---------|
| date | ✅ | YYYY-MM-DD HH:MM:SS | 2024-03-15 14:30:00 |
| type | ✅ | buy/sell/swap/transfer | buy |
| asset | ✅ | Symbol | BTC |
| amount | ✅ | Decimal number | 0.5 |
| price_usd | ✅ | USD value per unit | 65000.00 |
| fee_usd | ❌ | Fee in USD | 2.50 |
| exchange | ❌ | Exchange name | Binance |
| tx_hash | ❌ | Transaction hash | 0xabc... |

## Step 2: Choose Your Method

```bash
# FIFO — First In, First Out (most common, required in some jurisdictions)
bash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US

# LIFO — Last In, First Out (can minimize taxes in rising markets)
bash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US

# Average Cost — Weighted average (required in UK, simpler calculation)
bash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK
```

## Step 3: Select Jurisdiction

### 🇺🇸 United States
- Short-term gains (<1 year): Taxed as ordinary income (10%-37%)
- Long-term gains (>1 year): 0%, 15%, or 20%
- Wash sale rules: Currently not enforced for crypto (may change)
- Form 8949 generation supported

### 🇬🇧 United Kingdom
- Capital Gains Tax: 10% (basic) / 20%...