Розробка системи класифікації крипто-транзакцій (trade, income, airdrop, staking reward)

Розробка системи класифікації крипто-транзакцій

Правильна класифікація транзакцій — фундамент коректного податкового обліку. Trade, income, airdrop, staking reward — кожен тип має різну податкову обробку в кожній юрисдикції. Автоматична класифікація зменшує ручну роботу на 80-90% для більшості користувачів.

Ієрархія класифікації

enum TaxCategory {
  // Капітальні події
  BUY = "buy",
  SELL = "sell",
  SWAP = "swap",
  NFT_MINT = "nft_mint",
  NFT_SALE = "nft_sale",
  
  // Доходи
  STAKING_REWARD = "staking_reward",
  MINING_REWARD = "mining_reward",
  LENDING_INTEREST = "lending_interest",
  AIRDROP = "airdrop",
  REFERRAL = "referral",
  
  // Не облагаються
  TRANSFER = "transfer",
  COLLATERAL_DEPOSIT = "collateral",
  WRAPPED_TOKEN_MINT = "wrap",
  LP_DEPOSIT = "lp_deposit",
  
  UNCLASSIFIED = "unclassified",
}

Механізм класифікації

class TransactionClassifier {
  async classify(tx: UnifiedTransaction, userContext: UserContext): Promise<ClassificationResult> {
    const rules = this.getRulesForContext(userContext);
    
    for (const rule of rules) {
      const result = await rule.apply(tx, userContext);
      if (result.matched) {
        return {
          category: result.category,
          confidence: result.confidence,
          ruleId: rule.id,
        };
      }
    }
    
    return {
      category: TaxCategory.UNCLASSIFIED,
      confidence: 0,
      requiresManualReview: true,
    };
  }
}

Система класифікації з rules engine та ML fallback — 2-4 тижні розробки.