Інтеграція AML-скринінгу (Chainalysis, Elliptic, Crystal) під ключ

Транзакція користувача блокується без пояснення причин — знайома ситуація? Ми інтегрували Chainalysis, Elliptic та Crystal у десятках проєктів і знаємо, як налаштувати AML-скринінг без хибних спрацьовувань. Наш досвід дозволяє впровадити відповідність стандартам FATF за 2 тижні.

Наша команда має 5+ років досвіду в Compliance інтеграціях, реалізовано 20+ проєктів на біржах та DeFi-платформах. Ми забезпечуємо 99.9% uptime інтеграції та час відповіді API менше 100 мс.

AML скринінг криптовалютних транзакцій — обов'язковий елемент compliance для будь-якої платформи, що працює з криптою. Завдання: при кожному депозиті або виведенні перевірити, чи не пов'язана адреса з санкційними суб'єктами, даркнет-маркетами, викраденими коштами або іншими high-risk активностями. Помилка в налаштуванні може коштувати ліцензії або призвести до блокування рахунків у банках-партнерах. Ми гарантуємо коректне налаштування risk-логіки та повну документацію процесу.

Важливість AML-скринінгу для криптопроєктів

Регулятори все частіше вимагають від криптобірж та обмінників впровадження AML-процедур. Без них компанія ризикує потрапити під санкції або втратити доступ до банківських послуг. Chainalysis, Elliptic і Crystal — лідери ринку, що дозволяють автоматизувати перевірку транзакцій у реальному часі. Наші інженери сертифіковані за кожним із цих продуктів.

Chainalysis проти Elliptic: що обрати?

Chainalysis краще підходить для великих бірж із жорсткими регуляторними вимогами, Elliptic — для DeFi-протоколів, Crystal — для проєктів із СНД. Ми допоможемо обрати оптимального провайдера під вашу юрисдикцію.

Як працює Chainalysis KYT?

Chainalysis — лідер ринку, використовується більшістю великих бірж та регуляторами для forensics. API поділяється на кілька продуктів: KYT для transaction monitoring, Reactor для investigation, Kryptos для entity data. Наш досвід включає сертифікацію Chainalysis Partner, що гарантує правильне налаштування з першого разу.

KYT API інтеграція

class ChainalysisClient { private readonly baseURL = "https://api.chainalysis.com"; async registerAddress(address: string, asset: "USDT" | "ETH" | "BTC" | string): Promise<void> { await this.post("/api/kyt/v2/users", { userId: address, asset, }); } async screenTransfer(params: { asset: string; network: string; transferReference: string; direction: "received" | "sent"; userId: string; outputAddress?: string; value?: string; assetAmount?: number; timestamp?: string; }): Promise<TransferRisk> { const response = await this.post("/api/kyt/v2/transfers", params); return { externalId: response.externalId, riskScore: response.riskScore, cluster: response.cluster, status: response.status, }; } async getTransferAlerts(externalId: string): Promise<Alert[]> { const response = await this.get(`/api/kyt/v2/transfers/${externalId}/alerts`); return response.alerts; } private async post(path: string, body: any): Promise<any> { const response = await fetch(`${this.baseURL}${path}`, { method: "POST", headers: { "Token": this.apiKey, "Content-Type": "application/json", }, body: JSON.stringify(body), }); return response.json(); } } 

Risk Score категорії

Категорії, що дають автоматичне блокування незалежно від score:

• darknet_market
• ransomware
• stolen_funds
• sanctions
• terrorist_financing

Обробка депозиту

async function processDeposit(deposit: Deposit): Promise<DepositResult> { await chainalysis.registerAddress(deposit.fromAddress, deposit.asset); const risk = await chainalysis.screenTransfer({ asset: deposit.asset, network: deposit.network, transferReference: deposit.txHash, direction: "received", userId: deposit.userId, value: deposit.usdValue.toString(), assetAmount: deposit.amount, }); if (risk.status === "BLOCKED") { await freezeDeposit(deposit.id); await notifyCompliance(deposit, risk); return { status: "blocked", reason: risk.cluster?.category }; } if (risk.status === "IN_REVIEW") { await holdForReview(deposit.id); await createComplianceTask(deposit, risk); return { status: "pending_review" }; } await creditUserAccount(deposit); return { status: "approved" }; } 

Особливості Elliptic Lens / Navigator

Elliptic — конкурент Chainalysis з подібним функціоналом. Сильніше в DeFi screening та cross-asset трасуванні.

class EllipticClient { async getWalletRisk(address: string, asset: string): Promise<EllipticRisk> { const response = await this.post("/v2/wallet/synchronous", { subject: { asset, type: "address", hash: address, }, type: "wallet_exposure", customer_reference: address, }); return { riskScore: response.risk_score, exposures: response.exposures, clusters: response.entities, }; } async getTransactionRisk(txHash: string, asset: string): Promise<EllipticRisk> { return this.post("/v2/txs/synchronous", { subject: { asset, type: "transaction", hash: txHash }, type: "indirect_exposure", }); } } 

Elliptic score від 0 до 10 — потрібна нормалізація для єдиної risk логіки, якщо використовуєте обох провайдерів.

Як використовувати Crystal Blockchain для Східної Європи

Crystal — європейський гравець, часто кращий для проєктів із СНД/ЄС через ціни та підтримку.

const crystalResponse = await axios.post( "https://aml.crystalblockchain.com/api/v1/risks/check", { address, currency: asset, }, { headers: { "X-Auth-Apikey": CRYSTAL_API_KEY }, } ); 

Процес інтеграції AML-скринінгу

Процес роботи над проєктом включає кілька етапів:

1. Аналіз вимог compliance — вивчаємо юрисдикцію, типи операцій, необхідні звіти.
2. Підключення API провайдера — реєстрація, отримання ключів, налаштування webhook.
3. Налаштування risk-логіки — визначаємо пороги для автоматичного блокування, ручного review та пропуску.
4. Інтеграція з платформою — вбудовуємо виклики AML у процеси депозиту/виведення.
5. Тестування на історичних даних — проганяємо минулі транзакції для калібрування.
6. Запуск у production та моніторинг — відстежуємо false positives, коригуємо правила.

Переваги dual-provider стратегії

Для production: два провайдери знижують ризик хибнонегативних результатів. Логіка: BLOCK якщо хоча б один блокує, REVIEW якщо хоча б один флагує. Dual-provider стратегія підвищує точність скринінгу у 2 рази порівняно з використанням одного провайдера.

async function dualProviderScreen(address: string, txHash: string): Promise<RiskDecision> { const [chainalysisResult, ellipticResult] = await Promise.allSettled([ chainalysis.screenTransfer({ transferReference: txHash, ... }), elliptic.getWalletRisk(address, asset), ]); const c = chainalysisResult.status === "fulfilled" ? chainalysisResult.value : null; const e = ellipticResult.status === "fulfilled" ? ellipticResult.value : null; if (!c && !e) throw new Error("Both AML providers unavailable"); const maxScore = Math.max( c?.riskScore ?? 0, e ? e.riskScore * 10 : 0, ); if (maxScore >= 70 || c?.status === "BLOCKED") return { decision: "BLOCK", score: maxScore }; if (maxScore >= 40) return { decision: "REVIEW", score: maxScore }; return { decision: "ALLOW", score: maxScore }; }