Crypto Tax Exposure

A comprehensive tool for cryptocurrency tax preparation focused on Italian tax compliance. Automatically collects your transaction data from blockchains and exchanges, calculates tax obligations, and generates required Italian tax forms.

Features

• Multi-source data collection: Import transactions from blockchains and exchanges
• Automatic transaction enrichment: Historical EUR pricing for accurate valuations
• Italian tax compliance: Generates RW, RT, and RL forms according to Italian regulations
• Complete transaction history: Tracks trades, transfers, staking rewards, and airdrops
• Secure local storage: All data stored locally in DuckDB database

Quick Start

Setup

# Install dependencies
pnpm install

# Set up API keys in .env file
ETHERSCAN_API_KEY=your_etherscan_api_key
COVALENT_API_KEY=your_covalent_api_key  
HELIUS_API_KEY=your_helius_api_key

# Initialize database
pnpm db:reinit

Usage

Analyze Blockchain Addresses

# Ethereum
pnpm analyze 0xYourAddress ethereum

# Solana
pnpm analyze YourSolanaAddress solana

# Other blockchains
pnpm analyze 0xYourAddress avalanche
pnpm analyze 0xYourAddress base
pnpm analyze 0xYourAddress arbitrum

Import Exchange Data

# Bybit (requires API key and secret in .env)
BYBIT_API_KEY=your_key BYBIT_API_SECRET=your_secret pnpm analyze exchange bybit

Documentation

• Command Reference - Complete CLI usage guide
• Tax Preparation Guide - Step-by-step Italian tax compliance
• Setup Guide - Installation and configuration
• Technical Documentation - Architecture and development guides

Supported Data Sources

Blockchains

• Ethereum - ETH and ERC-20 tokens
• Avalanche C-Chain - AVAX and tokens
• Base - ETH and Base tokens
• Arbitrum - ETH and Arbitrum tokens
• Solana - SOL and SPL tokens

Exchanges

• Bybit - Spot trading, deposits, and withdrawals

Italian Tax Forms

This tool generates the following tax forms required by the Italian Revenue Agency:

• RW Form - Declaration of foreign assets and investments
• RT Form - Capital gains and losses from cryptocurrency trading
• RL Panel - Income from staking rewards, airdrops, and other crypto income

Requirements

• Node.js 18 or higher
• pnpm package manager
• API keys for blockchain explorers and exchanges (see Setup Guide)

License

MIT License - see LICENSE file for details.