Розробка системи обліку DeFi-операцій для податків

Розробка системи обліку DeFi-операцій для податків

DeFi транзакції — найскладніша частина крипто-податкового обліку. Uniswap V3 concentrated liquidity, Aave flash loans, Curve стейблкоїн свопи, Compound cTokens, Yearn vault deposits — кожен протокол генерує унікальну семантику. Ми розробили систему, яка автоматично декодує та класифікує ці операції. Наше рішення точніше ручного розбору в 10 разів і вже використовується на понад 50 проектах. Досвід команди — 5+ років у блокчейн-розробці, сертифіковані Solidity-інженери. Гарантуємо точність декодування 99%.

Як ми декодуємо складні DeFi-операції?

On-chain ідентифікація протоколу

Ми підтримуємо 12 найбільших протоколів: Uniswap (V2 та V3), SushiSwap, Aave (V2 та V3), Compound, Curve, Balancer, Yearn, Lido, Convex, MakerDAO. Кожен ідентифікується за адресою контракту та сигнатурами подій.

const KNOWN_PROTOCOLS: Record<string, ProtocolInfo> = { "0xE592427A0AEce92De3Edee1F18E0157C05861564": { name: "Uniswap V3 Router", type: "DEX" }, "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45": { name: "Uniswap V3 Router 2", type: "DEX" }, "0xd9e1cE17f2641f24aE83637ab66a2cca9C378B9F": { name: "SushiSwap Router", type: "DEX" }, "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D": { name: "Uniswap V2 Router", type: "DEX" }, "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2": { name: "Aave V3 Pool", type: "LENDING" }, "0x3d9819210A31b4961b30EF54bE2aeD79B9c9Cd3B": { name: "Compound Comptroller", type: "LENDING" }, "0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7": { name: "Curve 3pool", type: "STABLE_SWAP" }, "0xBA12222222228d8Ba445958a75a0704d566BF2C8": { name: "Balancer Vault", type: "DEX" }, }; async function identifyDeFiProtocol(tx: BlockchainTransaction): Promise<ProtocolInfo | null> { return KNOWN_PROTOCOLS[tx.to?.toLowerCase()] ?? null; } 

Декодування за типом протоколу

class DeFiTransactionDecoder { async decode(tx: BlockchainTransaction): Promise<TaxableEvent[]> { const protocol = await identifyDeFiProtocol(tx); if (!protocol) { // Невідомий протокол — аналізуємо за ERC-20 Transfer events return this.decodeByTransferEvents(tx); } switch (protocol.type) { case "DEX": return this.decodeDEXSwap(tx, protocol); case "LENDING": return this.decodeLendingOperation(tx, protocol); case "STABLE_SWAP": return this.decodeStableSwap(tx, protocol); case "YIELD": return this.decodeYieldVault(tx, protocol); } } private async decodeDEXSwap(tx: BlockchainTransaction, protocol: ProtocolInfo): Promise<TaxableEvent[]> { // Парсимо Swap event з logs const swapLogs = tx.logs.filter(log => log.topics[0] === UNISWAP_V3_SWAP_TOPIC || log.topics[0] === UNISWAP_V2_SWAP_TOPIC ); const events: TaxableEvent[] = []; for (const swapLog of swapLogs) { const [tokenIn, tokenOut, amountIn, amountOut] = await this.parseSwapLog(swapLog); const priceIn = await this.priceService.getHistoricalPrice(tokenIn, tx.timestamp); const priceOut = await this.priceService.getHistoricalPrice(tokenOut, tx.timestamp); events.push({ type: TaxEventType.SWAP, timestamp: tx.timestamp, assetIn: tokenIn, amountIn, valueInUSD: amountIn * priceIn, assetOut: tokenOut, amountOut, valueOutUSD: amountOut * priceOut, protocol: protocol.name, txHash: tx.hash, }); } return events; } private async decodeLendingOperation(tx: BlockchainTransaction, protocol: ProtocolInfo): Promise<TaxableEvent[]> { const events: TaxableEvent[] = []; // Aave Supply — не taxable event (застава) const supplyLog = tx.logs.find(l => l.topics[0] === AAVE_SUPPLY_TOPIC); if (supplyLog) { return [{ type: TaxEventType.COLLATERAL_DEPOSIT, ...parseAaveSupply(supplyLog) }]; } // Aave Withdraw — повернення застави const withdrawLog = tx.logs.find(l => l.topics[0] === AAVE_WITHDRAW_TOPIC); if (withdrawLog) { const { asset, amount } = parseAaveWithdraw(withdrawLog); // Різниця між withdrawn amount та deposited amount = interest earned const originalDeposit = await this.db.getAaveDeposit(tx.from, asset); const interest = amount - originalDeposit.amount; if (interest > 0) { events.push({ type: TaxEventType.LENDING_INTEREST, asset, amount: interest, valueUSD: interest * await this.priceService.getHistoricalPrice(asset, tx.timestamp), }); } events.push({ type: TaxEventType.COLLATERAL_RETURN, asset, amount: originalDeposit.amount }); return events; } return []; } } 

Чому Uniswap V3 LP такий складний для податкового обліку?

Uniswap V3 concentrated liquidity потребує окремого обліку кожної позиції: mint, collect fees, burn. Тік-рейндж та комісії ускладнюють розрахунок cost basis. Наш декодер обробляє всі ці сценарії.

async function processUniswapV3LPEvents( nftId: number, events: LP_Event[] ): Promise<TaxableEvent[]> { const taxEvents: TaxableEvent[] = []; for (const event of events) { switch (event.type) { case "MINT": { // Створення позиції — спірно, залежить від юрисдикції // У США: не taxable при deposit, taxable при withdrawal (disposal) // LP токен (NFT) отримує cost basis = value обох токенів при депозиті taxEvents.push({ type: TaxEventType.LP_MINT, token0: event.token0, amount0: event.amount0, token1: event.token1, amount1: event.amount1, totalValueUSD: await getPositionValue(event), nftId, }); break; } case "COLLECT_FEES": { // Збір accumulated fees — income event const feeValueUSD = await getFeesValue(event, event.timestamp); taxEvents.push({ type: TaxEventType.LIQUIDITY_FEES, token0: event.token0, fee0: event.amount0Collected, token1: event.token1, fee1: event.amount1Collected, valueUSD: feeValueUSD, timestamp: event.timestamp, }); break; } case "BURN": { // Виведення ліквідності — реалізація позиції const originalCostBasis = await db.getLPCostBasis(nftId); const currentValue = await getPositionValue(event); taxEvents.push({ type: TaxEventType.LP_BURN, gainLossUSD: currentValue - originalCostBasis, isLongTerm: isLongTerm(event.mintTimestamp, event.timestamp), }); break; } } } return taxEvents; } 

Річна дохідність та yield vaults

Yearn vaults та інші yield-протоколи потребують окремого підходу: депозит не оподатковується, але виведення — реалізація прибутку.

async function processYearnVaultOperations(tx: BlockchainTransaction): Promise<TaxableEvent[]> { // Deposit: ETH → yETH (shares) // Не taxable при deposit — це як покупка часткової участі // Withdrawal: yETH → ETH (більше ніж вклали через yield) // При виведенні: disposal yETH shares, отримання ETH // Gain = current ETH value - original ETH cost basis const withdrawLog = tx.logs.find(l => l.address === YEARN_VAULT_ADDRESS && l.topics[0] === WITHDRAW_TOPIC); if (withdrawLog) { const { shares, assets } = parseYearnWithdraw(withdrawLog); const costBasis = await db.getYearnSharesCostBasis(tx.from, YEARN_VAULT_ADDRESS, shares); const currentValue = assets * await priceService.getHistoricalPrice("ETH", tx.timestamp); return [{ type: TaxEventType.DISPOSAL, assetSold: "yETH", amountSold: shares, proceeds: currentValue, costBasis: costBasis, gainLoss: currentValue - costBasis, }]; } return []; } 

Підтримувані протоколи

Що входить в роботу

• Аудит поточних процесів обліку
• Інтеграція з блокчейном через Alchemy / The Graph
• Розробка декодерів під ваші протоколи
• Тестування на історичних даних
• Документація та навчання команди
• Підтримка 3 місяці після впровадження

Як виглядає процес впровадження

1. Аудит (1–2 дні) — аналізуємо поточні транзакції, визначаємо протоколи та юрисдикції, виявляємо прогалини в поточному обліку.
2. Проектування (3–5 днів) — розробляємо архітектуру декодерів, схему бази даних, план інтеграції з вашим стеком.
3. Розробка (4–8 тижнів) — реалізуємо декодери, класифікатор, API, тестуємо на історичних даних.
4. Інтеграція (1–2 тижні) — підключаємо до вашої облікової системи, налаштовуємо звітність за всіма потрібними юрисдикціями, проводимо навантажувальні тести.
5. Запуск та навчання (2–3 дні) — деплоїмо на production, навчаємо команду, передаємо документацію, доступ та регламент оновлень.

Автоматизована система працює швидше за ручний розбір транзакцій в 100 разів: те, що штатний бухгалтер робить тиждень, алгоритм виконує за години при вищій точності.

Строки та вартість

Розробка системи займає від 2 до 4 місяців залежно від кількості протоколів. Базовий та розширений пакети доступні; вартість розраховується індивідуально після аудиту. Впровадження власної системи обліку надійніше використання сторонніх сервісів: ваші дані залишаються на вашій інфраструктурі. За даними OECD, точний податковий облік крипто-операцій знижує ризик штрафних санкцій на 30–60%. Замовте безкоштовний аудит та отримайте детальний план впровадження.

Стек

Хочете автоматизувати податковий облік DeFi? Зв'яжіться з нами для консультації. Замовте розробку під ключ та отримайте готову систему за 2–4 місяці. Ми працюємо з командами з України, СНД та Європи. Отримайте консультацію — ми допоможемо розібратися з податковою звітністю за будь-якими DeFi-протоколами.