⚡
DeFi Tax Classifier v0.1.0
Intelligent Classification Engine for Crypto Tax & Audit Compliance

Translate Complex DeFi Transactions
Into Compliant Tax Events with One Click

Stop guessing from raw Transfer logs. Decode directly from protocol semantic anchors, isolate LP fees from principal withdrawals, and replay historical FMV prices for verifiable audit trails.

Uniswap V3
Swap / LP / Collect Decoded
Fee & Principal Separation
Burn & Collect Correlation
Historical FMV Pricing
USD Valued at Block Timestamp
Sub-millisecond Edge
Cloudflare Edge + KV Cache

⚡ Live Classification Playground

Enter an Ethereum Mainnet tx hash to call POST /v1/classify and get structured tax events

Quick Example:
0x

Core Capabilities

Purpose-Built Tax Classification for DeFi

More than decoding logs — mapping on-chain activities directly into capital gains and income reporting entities.

🎯

Semantic Anchor Decoding

Eliminate guesswork from raw ERC20 Transfers. Directly decode core Uniswap V3 events (Swap, Mint, Burn, Collect) for ground truth.

⚖️

Accurate Fee vs Principal Separation

Novel correlation between Burn and Collect events. Isolate LP fee earnings and prevent capital return from being falsely reported as taxable income.

📈

Historical Fair Market Value (FMV)

Accurately replay historical CoinGecko pricing based on exact block timestamp to evaluate notional USD amounts and fee income.

🛡️

Verifiable Audit Trails

Every classified event includes exact log indices, pool contract addresses, and pricing timestamps to withstand stringent tax scrutiny.

Supported Protocols & Roadmap

Highly extensible src/decoders/ architecture designed to plug in major DeFi protocols effortlessly

● Uniswap V3 (Ready) ⏳ Aave V3 (In Progress) ⏳ Lido Staking (Planned) ⏳ Cross-Chain Bridges

Core Capabilities

Ready-to-use REST API

Seamlessly embed into your personal portfolio, tax SaaS, or enterprise accounting stack.

POST /v1/classify
Core Classification Endpoint

Submit tx hash and chain identifier to decode structured tax events in real time.

# Request Example
curl -X POST https://your-worker.workers.dev/v1/classify \ -H "Content-Type: application/json" \ -d '{"chain": "ethereum", "tx_hash": "0x7aff2bed4d41..."}'
GET /health
Health Check

Probes service availability and KV cache status.

# Response Example
{ "ok": true, "kv": true, "ts": 1729206720000 }