Gemma41 / Onchain-Accounting

# Onchain-Accounting
Privacy-first, self-hosted crypto accounting app with zero cloud data sharing. Aggregates exchange, wallet and multi-chain history, calculates FIFO/LIFO/HIFO cost basis, realized/unrealized PnL and capital gains, tracks staking/airdrop income, and exports tax-ready CSV/PDF/JSON reports. Encrypted SQLite. Python, cross-platform.
---
# Onchain Accounting
**Self-Hosted Crypto Accounting — Cost Basis, PnL & Tax Reports**
---
*Privacy-first crypto accounting that never phones home. Cost basis, PnL and tax-ready capital gains reports from CSV, exchange APIs and on-chain history — everything computed and stored on your machine, encrypted at rest.*
Features · Cost Basis Methods · Import Pipeline · Getting Started · Configuration · Usage · FAQ
---
## Features
### Accounting Engine
| Feature | Status |
|---------|--------|
| FIFO / LIFO / HIFO Cost Basis | ✅ |
| Method Comparison Report | ✅ |
| Short / Long-Term Split (365d) | ✅ |
| Fee-Inclusive Basis | ✅ |
| Realized & Unrealized PnL | ✅ |
| Receipt-Date Income Valuation | ✅ |
| Staking / Airdrop / Interest Income | ✅ |
| Open Lot Inspection | ✅ |
### Data & Privacy
| Feature | Status |
|---------|--------|
| CSV Import (any exchange format) | ✅ |
| Exchange API Sync (read-only) | ✅ |
| On-Chain History (6+ chains) | ✅ |
| Duplicate Detection | ✅ |
| Historical Price Engine | ✅ |
| Tax-Ready CSV / PDF / JSON | ✅ |
| Encrypted Local SQLite | ✅ |
| Zero Cloud / Zero Telemetry | ✅ |
---
## Cost Basis Methods
Every disposal is matched against acquisition lots. The method you choose changes which lots are sold first — and therefore your taxable gain:
| Method | Sells first | When it helps |
|--------|-------------|---------------|
| **FIFO** | Oldest lots | Default in most jurisdictions; maximizes long-term treatment in bull markets |
| **LIFO** | Newest lots | Defers gains when recent buys sit close to current price |
| **HIFO** | Highest-cost lots | Minimizes immediate gains by disposing the most expensive lots first |
The Tax Report runs **all three methods over the same lot history** so you can see the liability impact before committing:
 [code] 
Income events (staking, airdrops, interest) are valued at the fiat rate on the receipt date — and that valuation becomes the asset's cost basis going forward.
---
## Import Pipeline
 [code] 
- **CSV** — drop any exchange export into `./imports`; the normalizer maps column dialects automatically
- **Exchange APIs** — read-only keys for Binance, Coinbase and Kraken pull fills, deposits and withdrawals
- **On-chain** — wallet history sync across Ethereum, BNB Chain, Polygon, Arbitrum, Base and Bitcoin
- **Dedup** — the same transfer seen from an exchange API and on-chain is merged, never double-counted
---
## Getting Started
### Prerequisites
- **Python** 3.10 or higher
- **pip** (latest recommended)
- CSV exports from your exchanges, or read-only API keys
- No account, no cloud signup, no telemetry — ever
### Installation
**Windows:**
 [code]