Інтеграція Elliptic для AML-скринінгу транзакцій та гаманців

Інтеграція Elliptic для AML-скринінгу транзакцій та гаманців

Уявіть: ваш крипто-процесинг обробляє тисячі транзакцій на день. Частина проходить через cross-chain bridges (Wormhole, Stargate, LayerZero). Стандартний скринінг Chainalysis не завжди бачить indirect exposure — гроші приходять з іншого блокчейну через міст, і ризик залишається непоміченим. Один наш клієнт втратив $50 000 через пропущену DeFi-атаку: кошти надійшли через Solana-міст, і Chainalysis показав низький ризик, хоча Elliptic одразу б визначив нелегітимний пул ліквідності.

Elliptic закриває цю прогалину: глибоке покриття DeFi, нативна підтримка Solana та cross-chain tracing. Ми використовуємо Elliptic Lens API для AML перевірки криптовалют і скринінгу гаманців, налаштовуючи dual-provider compliance систему з нормалізованим risk scoring. Наші інженери мають 5+ років досвіду в блокчейні та реалізували понад 20 compliance-інтеграцій. Отримайте консультацію — розберемо ваш кейс і запропонуємо рішення.

Чому Elliptic, а не тільки Chainalysis?

Elliptic перевершує Chainalysis у трьох ключових аспектах:

• DeFi coverage — відстежує взаємодії з пулами ліквідності, AMM та протоколами стейкінгу. За нашими тестами, Elliptic знаходить на 30% більше ризикованих DeFi-адрес.
• Cross-chain tracing — бачить рух коштів через мости в 2-3 рази швидше завдяки прямому аналізу bridge-логів.
• Solana support — вбудована підтримка Solana, тоді як Chainalysis потребує додаткових модулів.

Шкала risk score у Elliptic — 0–10, у Chainalysis — 0–100. Без нормалізації рішення щодо ризиків будуть неузгодженими. Ми використовуємо перевірені функції конвертації та єдиний decision engine, який обробляє до 5000 запитів на хвилину.

Як нормалізувати risk score при dual-provider?

При одночасному використанні Elliptic та Chainalysis необхідно привести їх оцінки до єдиної шкали. Нижче — готовий код на TypeScript:

class EllipticClient {
  private readonly BASE_URL = "https://aml.elliptic.co/v2";
  
  async screenWallet(address: string, asset: string): Promise<EllipticWalletRisk> {
    const response = await this.post("/wallet/synchronous", {
      subject: {
        asset,
        type: "address",
        hash: address,
        blockchain: this.getBlockchain(asset),
      },
      type: "wallet_exposure",
      customer_reference: address,
      behaviour_classification: true,
    });
    
    return {
      riskScore: response.risk_score,
      riskBand: response.risk_band,
      exposures: response.exposures,
      entities: response.entities,
      behaviours: response.behaviours,
    };
  }
  
  async screenTransaction(txHash: string, asset: string): Promise<EllipticTxRisk> {
    return this.post("/transaction/synchronous", {
      subject: {
        asset,
        type: "transaction",
        hash: txHash,
        blockchain: this.getBlockchain(asset),
      },
      type: "indirect_exposure",
    });
  }
  
  private getBlockchain(asset: string): string {
    const map: Record<string, string> = {
      ETH: "ethereum",
      BTC: "bitcoin",
      USDT: "ethereum",
      SOL: "solana",
      BNB: "bsc",
    };
    return map[asset] || asset.toLowerCase();
  }
}

Приклад нормалізації:

function normalizeRiskScore(score: number, provider: "chainalysis" | "elliptic"): number {
  if (provider === "elliptic") return score * 10;
  return score;
}

function getRiskDecision(score: number): "allow" | "review" | "block" {
  if (score >= 70) return "block";
  if (score >= 40) return "review";
  return "allow";
}

Як Elliptic відстежує кросс-чейн транзакції?

Elliptic API повертає indirect exposure для адрес, через які пройшли кошти через міст. Наприклад, якщо ETH надходить на ваш гаманець через Wormhole, API покаже вихідну адресу на Ethereum та її risk score. Ми перевіряємо кожен bridge hop і блокуємо транзакцію, якщо score >= 70.

async function checkCrossChainExposure(
  address: string,
  inboundTxHash: string
): Promise<CrossChainRisk> {
  const walletRisk = await elliptic.screenWallet(address, "ETH");
  
  const bridgeExposures = walletRisk.exposures.indirect.filter(
    e => e.category === "bridge" && e.riskScore > 40
  );
  
  if (bridgeExposures.length > 0) {
    for (const exp of bridgeExposures) {
      const originRisk = await elliptic.screenWallet(exp.sourceAddress, exp.sourceAsset);
      if (originRisk.riskBand === "high" || originRisk.riskBand === "very_high") {
        return { hasHighRisk: true, originChain: exp.sourceBlockchain };
      }
    }
  }
  
  return { hasHighRisk: false };
}

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

Цей набір deliverables гарантує безшовний перехід та самостійне адміністрування. Отримайте консультацію — розберемо ваш кейс і запропонуємо оптимальне рішення.

Процес інтеграції: від аудиту до деплою

Інтеграція займає 1–2 тижні та складається з п'яти етапів:

1. Аналіз поточного стеку — аудит існуючих compliance-інструментів, API-квот та вимог проєкту. Оцінюємо обсяг транзакцій та кількість блокчейнів.
2. Проєктування архітектури — dual-provider схема з normalizer та decision engine. Обираємо оптимальні налаштування для вашого risk appetite.
3. Реалізація SDK — підключаємо Elliptic Lens API, налаштовуємо middleware для автоматичного скринінгу. Тестуємо на тестових гаманцях.
4. Розгортання — налаштування CI/CD, моніторинг логів, сповіщення про помилки. Гарантуємо uptime 99.9%.
5. Тестування та документація — прогін на реальних транзакціях, A/B порівняння з Chainalysis, підготовка README з архітектурою та sequence diagram.

Вартість розраховується індивідуально залежно від обсягу транзакцій та кількості підтримуваних блокчейнів. Зв'яжіться з нами — ми підготуємо точну оцінку за 1 день.

Типові помилки при інтеграції

Часто зустрічаються три проблеми. Перша — використання старої версії API: Elliptic регулярно оновлює ендпоїнти, ми завжди працюємо з останньою стабільною. Друга — забувають про behaviour_classification: без цього прапора API повертає базовий risk score без урахування поведінки адреси. Ми включаємо його за замовчуванням. Третя — ігнорують indirect exposure через bridges: це основна причина пропущених ризикованих коштів. Наш код перевіряє кожен bridge hop.

Гарантуємо стабільну роботу інтеграції, супровід та адаптацію під нові вимоги регуляторів. Отримайте консультацію — обговоримо ваш кейс.

На відміну від Chainalysis, Elliptic дозволяє напряму запитувати risk score для смарт-контрактів, що спрощує DeFi compliance. Детальніше про API читайте в офіційній документації Elliptic.

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

Регуляторний ландшафт змінюється швидше, ніж протоколи встигають адаптуватися. Якщо ваш проект працює в ЄС — 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-рішень. Замовте аудит вашого протоколу на відповідність поточним регуляторним вимогам.