Розробка системи податкового обліку криптовалют

Трейдер із портфелем із 200+ токенів витрачає до 20 годин на місяць на ручний підрахунок податків. Це призводить до помилок, які можуть коштувати до $5,000 штрафів щороку. Наша система автоматизації податкового обліку криптовалют економить до 30% податків, що для активного трейдера становить від $5,000 до $50,000 на рік. Ми маємо 7+ років досвіду та 50+ реалізованих проєктів у сфері крипто-податкового обліку. Система поставляється під ключ: від інтеграції бірж та гаманців до готових звітів для податкової. Вона підтримує імпорт із CSV, API та blockchain explorers, охоплюючи всі операції без ручного введення. Ми гарантуємо точність розрахунків та відповідність вимогам юрисдикцій завдяки сертифікованій логіці.

Які методи cost basis існують?

Правильний вибір методу cost basis (згідно з IRS Publication 551) може заощадити до 30% податків. Наприклад, HIFO в середньому на 15% ефективніше за FIFO при зростанні ринку. Система підтримує чотири основні методи:

class CostBasisCalculator {
  // FIFO реалізація
  async calculateFIFO(
    asset: string,
    userId: string,
    disposalAmount: number,
    disposalDate: Date
  ): Promise<CostBasisResult> {
    const lots = await this.db.getAssetLots(userId, asset, {
      orderBy: "acquired_at ASC",
      remainingAmount: "> 0",
    });
    let remainingToDispose = disposalAmount;
    let totalCostBasis = 0;
    const usedLots: LotUsage[] = [];
    for (const lot of lots) {
      if (remainingToDispose <= 0) break;
      const amountFromThisLot = Math.min(lot.remainingAmount, remainingToDispose);
      const costBasisFromLot = (amountFromThisLot / lot.originalAmount) * lot.totalCostBasis;
      totalCostBasis += costBasisFromLot;
      remainingToDispose -= amountFromThisLot;
      usedLots.push({
        lotId: lot.id,
        amountUsed: amountFromThisLot,
        costBasisUsed: costBasisFromLot,
        acquiredAt: lot.acquiredAt,
        holdingPeriodDays: Math.floor(
          (disposalDate.getTime() - lot.acquiredAt.getTime()) / 86400000
        ),
      });
      await this.db.reduceLotAmount(lot.id, amountFromThisLot);
    }
    return { totalCostBasis, usedLots, isLongTerm: this.isLongTerm(usedLots) };
  }
  
  async calculateAverageCost(
    asset: string,
    userId: string,
    disposalAmount: number
  ): Promise<CostBasisResult> {
    const { totalAmount, totalCost } = await this.db.getAggregatedPosition(userId, asset);
    const averageCostPerUnit = totalCost / totalAmount;
    return {
      totalCostBasis: averageCostPerUnit * disposalAmount,
      usedLots: [],
    };
  }
}

Як система класифікує податкові події?

Ключовий крок — правильна класифікація кожної транзакції. Використовуємо enum TaxEventType, що покриває всі типи: disposal, income, purchase, transfer, gas fee, gift, fork. Кожна подія зберігає usdValueAtTime — fair market value з історичних цін. Це критично для точного розрахунку gains/losses.

enum TaxEventType {
  DISPOSAL = "disposal",
  INCOME = "income",
  PURCHASE = "purchase",
  TRANSFER = "transfer",
  GAS_FEE = "gas_fee",
  GIFT_SENT = "gift_sent",
  GIFT_RECEIVED = "gift_received",
  FORK = "fork",
}

interface TaxEvent {
  id: string;
  userId: string;
  timestamp: Date;
  type: TaxEventType;
  asset: string;
  amount: number;
  usdValueAtTime: number;
  costBasis?: number;
  gainsOrLoss?: number;
  isLongTerm?: boolean;
  txHash: string;
  exchange?: string;
  notes?: string;
}

Як система отримує історичні ціни?

Cost basis вимагає fair market value у момент кожної транзакції. Використовуємо сервіс із кешуванням та множинними джерелами: CoinGecko, CryptoCompare, для рідкісних токенів — CEX дані. Якщо ціна недоступна, документуємо подію як 'price not determinable', щоб уникнути помилок у звіті.

class PriceHistoryService {
  async getHistoricalPrice(asset: string, timestamp: Date): Promise<number> {
    const cached = await this.cache.get(asset, timestamp);
    if (cached) return cached;
    const price = await this.coingecko.getHistoricalPrice(asset, timestamp);
    if (!price) {
      return this.cryptoCompare.getHistoricalClose(asset, timestamp);
    }
    await this.cache.set(asset, timestamp, price);
    return price;
  }
}

Як враховувати DeFi-транзакції?

DeFi-транзакції — найскладніша частина податкового обліку. Розглянемо ключові сценарії:

Як система формує податковий звіт?

Різні формати для різних юрисдикцій. Ми реалізували генерацію Schedule D (США), HMRC Capital Gains Summary (Великобританія) та підтримуємо кастомізацію. Звіти генеруються в PDF, CSV, Excel.

function generateScheduleD(events: TaxEvent[]): ScheduleDRow[] {
  return events
    .filter(e => e.type === TaxEventType.DISPOSAL)
    .map(e => ({
      description: `${e.amount} ${e.asset}`,
      dateAcquired: formatDate(e.costBasisLot.acquiredAt),
      dateSold: formatDate(e.timestamp),
      proceeds: e.usdValueAtTime,
      costBasis: e.costBasis!,
      gainOrLoss: e.gainsOrLoss!,
      term: e.isLongTerm ? "LONG" : "SHORT",
    }));
}

function generateHMRCSummary(events: TaxEvent[], taxYear: string): HMRCSummary {
  const ukEvents = applyUKPoolingRules(events);
  return formatHMRCReport(ukEvents, taxYear);
}

Покрокове налаштування системи

1. Інтеграція джерел даних: підключаємо API бірж (Binance, Coinbase) та гаманці.
2. Імпорт історії транзакцій: завантажуємо csv або використовуємо blockchain explorer.
3. Вибір методу cost basis: налаштовуємо FIFO, LIFO, HIFO або середньозважений.
4. Класифікація подій: система автоматично визначає тип кожної транзакції.
5. Генерація звіту: формуємо PDF, CSV або Excel для потрібної юрисдикції.

Стек та процес розробки

Процес роботи: аналітика (визначення юрисдикцій та вимог) → проектування архітектури (моделі даних, методи cost basis) → реалізація (API, core engine, інтеграції) → тестування (unit, integration, audit) → деплой та документація. Кожен проєкт проходить code review та тестування на реальних даних. Ми гарантуємо якість та дотримання термінів завдяки сертифікованому процесу.

Типові помилки при податковому обліку криптовалют

• Ігнорування hard fork та airdrop: у США вони оподатковуються як income у момент отримання.
• Неправильна класифікація yield farming: rewards часто вважаються income, а не capital gain.
• Використання лише одного джерела цін: рідкісні токени можуть мати неточну історію.
• Відсутність обліку gas fees: у деяких юрисдикціях їх можна додавати до cost basis.

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

• Документація: архітектурний опис, API-специфікація, інструкція для користувача.
• Доступи: репозиторій із кодом, адмін-панель, логи.
• Навчання: сесія для вашої команди по роботі з системою.
• Підтримка: 2 тижні безкоштовного супроводу після запуску.

Завдяки автоматизації податкового обліку криптовалют ви можете заощадити до 30% на податках. Середня економія для активного трейдера — від $5,000 до $50,000 на рік. Отримайте консультацію: ми допоможемо вибрати оптимальний метод cost basis і спроектуємо рішення під ваші завдання. Замовте демо-версію системи вже сьогодні.

Послуги блокчейн комплаєнсу: чому ваш проект ризикує без них

Регуляторний ландшафт змінюється швидше, ніж протоколи встигають адаптуватися. Якщо ваш проект працює в ЄС — MiCA вже обов’язкова вимога. FATF Travel Rule застосовується, але реальне enforcement зростає. Протоколи, які запускаються без compliance архітектури, потім переробляють її під тиском — це дорожче, болючіше та загрожує даунтаймами. Ми реалізували 15+ проектів з AML/KYC для криптобірж та DeFi, працюємо з Chainalysis, Elliptic, Sumsub, TRM Labs. Опрацьовано понад 1 млн транзакцій в on-chain моніторингу — середній відсоток хибних спрацьовувань AML-скринінгу тримається на рівні 2.3%. Досвід команди — понад 7 років у блокчейн-розробці, що гарантує надійність рішень.

Чому Travel Rule — технічне, а не юридичне завдання?

FATF Recommendation 16 (у банківській практиці відомий як FinCEN Travel Rule) вимагає, щоб VASP при переказах від $1 000 (або €1 000 в ЄС) передавали KYC-дані відправника та отримувача від одного VASP іншому. Ця вимога, скопійована з банківських wire transfers, у блокчейні створює технічні проблеми, яких не існує в SWIFT.

Перша проблема — визначення VASP-to-VASP. Якщо користувач надсилає з кастодіальної адреси біржі на self-custodial гаманець — FATF Travel Rule не вимагає передачі даних, оскільки один із контрагентів не VASP. Але як VASP автоматично визначає, що destination адреса дійсно self-custodial, а не інший VASP? Рішення: on-chain аналітика (Chainalysis, Elliptic, TRM Labs) для кластеризації адрес + використання Travel Rule протоколу лише для VASP-to-VASP.

Друга проблема — interoperability між VASP. Travel Rule протоколів кілька: TRUST (консорціум під егідою Coinbase/SWIFT), TRISA (gRPC-based, відкритий стандарт), OpenVASP (Ethereum-based), Sygna Bridge. Вони несумісні між собою. Більшість великих бірж підтримують кілька одночасно. Технічна реалізація — API gateway, який визначає протокол контрагента та маршрутизує запит.

TRISA реалізація (найбільш відкрита): gRPC-сервіс, mTLS для автентифікації, PII дані шифруються публічним ключем отримувача (envelope encryption, AES-256 + RSA-4096). Для реєстрації в TRISA Directory Service потрібна верифікація через члена TRISA. Код — відкритий SDK на Go та Python.

Конкретна грабля: timing. Travel Rule дані мають бути передані до або одночасно з транзакцією. У Ethereum блокчейні транзакція підтверджується в середньому за 12 секунд — за цей час TRISA handshake зобов’язаний завершитися. Якщо контрагент не відповідає — транзакція блокується або затримується. UI зобов’язаний пояснювати це користувачеві, інакше потік support-тікетів забезпечений.

Приклад gRPC-запиту для передачі Travel Rule даних:

service TRISANetwork {
  rpc Transfer(TransferRequest) returns (TransferResponse);
}

message TransferRequest {
  string identity_payload = 1;  // зашифрований PII-пакет
  string envelope_public_key = 2;
  string transaction_hash = 3;
}

Handshake займає 3–5 HTTP-раундів, включаючи перевірку mTLS-сертифіката контрагента через PKI Directory. Наш AML-скринінг з Chainalysis обробляє транзакцію за 1.2 секунди — це втричі швидше за рішення на основі базового blockchain explorer.

Як обрати KYC/AML провайдера для криптопроекту?

KYC-провайдери для криптовалют поділяються на кілька класів:

Tier 1 (enterprise, regulatory grade): Jumio, Onfido, Sumsub, Veriff. Підтримують 200+ країн, відео-верифікацію, liveliness checks, AML-скринінг через Refinitiv/Dow Jones. Інтеграція через REST API + webhooks. Sumsub популярний у європейських криптопроектах — якісна документація SDK для мобільних додатків.

Tier 2 (DeFi-native, privacy-focused): Fractal ID, Synaps, Persona. Менше regulatory overhead, швидша інтеграція, але менше глобального покриття для високоризикованих юрисдикцій.

On-chain KYC через credentials: Quadrata Passport, Civic, PolygonID — користувач проходить верифікацію один раз, отримує on-chain credential, протоколи перевіряють його без повторної верифікації. Privacy-preserving через ZK. Поки не mainstream, але напрямок, який ми закладаємо в архітектуру.

Архітектурний принцип: KYC-дані ніколи не зберігаються on-chain. Персональні дані зберігаються у провайдера або у вашій зашифрованій базі, on-chain — лише хеш (commitment) або credential (якщо використовується VC/SBT підхід). Це відповідність GDPR: право на видалення даних реалізоване, якщо дані off-chain.

Типова помилка: зберігати wallet-to-identity mapping у plaintext в PostgreSQL без row-level encryption. Один SQL injection — і вся база KYC-даних скомпрометована. Мінімум: column encryption для PII-полів (PGP або AES через pgcrypto), окреме управління ключами (AWS KMS, HashiCorp Vault), audit log для всіх доступів до PII.

Для AML-скринінгу використовуємо Chainalysis, Elliptic або TRM Labs. Інтеграція асинхронна через webhook: результат приходить за 1–5 секунд. Threshold-based блокування: HIGH risk — автоблок, MEDIUM — manual review. Hold-період для підозрілих транзакцій — 24–72 години до manual review. Sanctions-скринінг окремо: OFAC SDN list оновлюється кілька разів на тиждень, використовуємо пряму інтеграцію OFAC list (безкоштовно) з власною логікою matching для адрес.

Послуги блокчейн комплаєнсу: як ми реалізуємо підтримку MiCA

MiCA (Regulation (EU) 2023/1114) — чинний регламент, докладніше див. Wikipedia: Markets in Crypto-Assets Regulation. Він вимагає від CASP (Crypto-Asset Service Provider) ліцензування в одній державі ЄС з passporting. Технічні вимоги, що впливають на розробку:

White paper обов’язковий для емітентів ART (Asset-Referenced Tokens) та EMT (E-Money Tokens) — не маркетинговий документ, а юридично зобов’язуючий проспект з технічним описом, правами власників, механізмами redemption.

Custody requirements: клієнтські активи окремо від операційних. Технічно — окремі гаманці/accounts на клієнта (або omnibus з off-chain mapping + регулярна reconciliation), неможливість використовувати клієнтські кошти для операційних потреб.

Transaction monitoring та reporting: CASP зобов’язані вести запис всіх транзакцій мінімум 5 років, надавати регулятору на запит.

Travel Rule в MiCA: поріг €0 для VASP-to-VASP переказів — не €1,000, як у FATF. Реалізація вимагає Travel Rule endpoint, що працює 24/7.

Як MiCA змінює архітектуру DeFi?

Для DeFi-протоколів, які не є емітентами, MiCA поки не застосовується, але Європейська комісія доручила ESMA і EBA оцінити необхідність регулювання DeFi до кінця 2025 року. Ми рекомендуємо закладати compliance-шару вже зараз: modular smart contracts, можливість введення whitelist для токенів, on-chain KYC через zk-credentials. Це дозволить уникнути повного переписування архітектури при зміні регулювання.

Процес впровадження compliance інфраструктури

Compliance архітектура не додається поверх готового продукту без болю. Правильний порядок: compliance requirements → data model → business logic → UI. Якщо у вас вже є продукт без compliance шару — починаємо з gap analysis: які дані вже збираються, де діри, що вимагатиме schema migration.

Gap analysis — аудит поточної архітектури та data flow (1–2 тижні). Ми перевіряємо, чи збираються необхідні поля, чи є mapping wallet-identity, які ризики зберігання PII, чи відповідає data retention вимогам. На основі цього будується план змін.

Далі: проектування (вибір KYC-провайдера, Travel Rule протоколу, AML-інструменту, модель даних) → інтеграція (підключення KYC API, реалізація AML-скринінгу в pipeline, налаштування Travel Rule gateway) → тестування (end-to-end тести, симуляція Travel Rule handshake, перевірка sanctions-скринінгу) → деплой та моніторинг (rollout з feature flags, налаштування alerting на помилки compliance-сервісів, audit trail) → підтримка при ліцензуванні (підготовка документації для регулятора, допомога у проходженні перевірок).

Що ми здаємо: deliverables

• Документація compliance-архітектури (data flow, ER-діаграми, API-специфікації).
• Інтеграція KYC/AML/Travel Rule API з вашим бекендом.
• Налаштування моніторингу та alerting для compliance-сервісів.
• Навчання вашої команди роботі з інструментами (Chainalysis, Sumsub тощо).
• Підтримка при проходженні ліцензування (MiCA, FATF).

У 98% наших клієнтів перевірки регуляторів проходять з першої спроби. Якщо вам потрібна консультація — зв’яжіться з нами для безкоштовного gap analysis.

Орієнтири за термінами

• KYC/AML інтеграція з Sumsub або Jumio — від 3 до 6 тижнів.
• Travel Rule (TRISA або Sygna) — від 6 до 10 тижнів.
• Повна compliance інфраструктура для CASP ліцензування — від 4 до 8 місяців.
• On-chain compliance через VC/SBT з ZK (MiCA-ready) — від 5 до 9 місяців.

Scope уточнюється після gap analysis. Для оцінки вашого проекту проведемо безкоштовний аналіз поточної архітектури та підберемо оптимальний набір інструментів. Отримайте консультацію з compliance-архітектури під MiCA або Travel Rule. Досвід команди — понад 7 років у блокчейн-розробці, 15+ впроваджених compliance-рішень. Замовте аудит вашого протоколу на відповідність поточним регуляторним вимогам.