Интеграция с Fireblocks: безопасное хранение и DeFi

Интеграция с Fireblocks

Одна утечка приватного ключа — и миллионы долларов заблокированы. Или сотрудник с доступом к горячему кошельку выводит активы без согласования. Именно для таких сценариев существует Fireblocks — институциональная платформа custody с разделением ключей по протоколу MPC-CMP. Мы сертифицированы как партнёры Fireblocks, реализовали более 50 проектов и обработали свыше 100 000 транзакций без единого инцидента. На практике это означает, что ваши криптовалюты защищены на уровне крупнейших банков, а compliance-отдел получает полный контроль над каждым выводом средств.

Как работает MPC-CMP и почему это безопасно?

Ключ разделён между серверами Fireblocks, клиентским мобильным приложением и (опционально) независимой третьей стороной. Для подписи нужны минимум 2 из 3 участников. Компрометация одного — не компрометация ключа. Это элиминирует риск инсайдерской атаки или утечки seed-фразы. Протокол MPC обеспечивает математическую гарантию: даже при взломе одного узла злоумышленник не восстановит ключ.

Policy Engine. Правила для каждого типа транзакций: whitelist адресов, лимиты, требование двойного одобрения, time-based правила. Транзакция, нарушающая политику, автоматически блокируется. На практике это предотвращает до 99% мошеннических операций. Один из наших клиентов, управляющий хедж-фондом, благодаря этой настройке предотвратил попытку вывода $2 млн на подозрительный адрес.

Vaults и Wallets. Vault — логическая группа. Внутри vault — wallets для разных активов. Один vault = один клиент, или один торговый счёт, или одна стратегия. Мы рекомендуем создавать отдельный vault для каждой бизнес-единицы. Это позволяет изолировать риски и упрощает аудит.

Интеграция API Fireblocks

Мы подключаем Fireblocks SDK к вашему бэкенду за 3 этапа: генерация API-ключа, создание vault account и настройка транзакций. Код ниже — базовая схема, которую мы адаптируем под вашу бизнес-логику.

import { FireblocksSDK, PeerType, TransactionOperation } from "fireblocks-sdk"; const fireblocks = new FireblocksSDK( privateKey, // RSA private key для API аутентификации apiKey, // API key из Fireblocks Console "https://api.fireblocks.io" ); // Создание vault account const vault = await fireblocks.createVaultAccount("Client_123"); // Создание кошелька внутри vault const wallet = await fireblocks.createVaultAsset(vault.id, "ETH"); console.log(`Deposit address: ${wallet.address}`); // Отправка транзакции const txResponse = await fireblocks.createTransaction({ assetId: "ETH", source: { type: PeerType.VAULT_ACCOUNT, id: vault.id, }, destination: { type: PeerType.ONE_TIME_ADDRESS, oneTimeAddress: { address: "0xRecipient" }, }, amount: "0.5", note: "Payment to client", }); // Ожидание завершения (транзакция проходит через Policy Engine и MPC подпись) const txInfo = await fireblocks.getTransactionById(txResponse.id); 

Как настроить вебхуки для мониторинга транзакций?

Fireblocks уведомляет о статусах транзакций через webhooks. Важно: вебхуки подписаны RSA — нужно верифицировать подпись, иначе злоумышленник может имитировать события. Мы реализуем проверку в 4 строки:

import { FireblocksWebhookHandler } from "fireblocks-sdk"; app.post("/fireblocks/webhook", express.raw({ type: "*/*" }), async (req, res) => { const webhookHandler = new FireblocksWebhookHandler(publicKey); try { const isValid = webhookHandler.validateSignature( req.rawBody, req.headers["fireblocks-signature"] as string ); if (!isValid) { return res.status(401).send("Invalid signature"); } const event = JSON.parse(req.body.toString()); switch (event.type) { case "TRANSACTION_STATUS_UPDATED": await handleTxStatusUpdate(event.data); break; case "VAULT_ACCOUNT_ADDED": await handleNewVault(event.data); break; } res.status(200).send("OK"); } catch (err) { res.status(500).send("Error"); } }); 

Как подключить DeFi через Web3 Provider?

Для смарт-контрактов используем Fireblocks Web3 Provider. Он транслирует стандартные Web3-вызовы в подпись через Fireblocks API. Пример интеграции с любым протоколом:

import { FireblocksWeb3Provider, ChainId } from "@fireblocks/fireblocks-web3-provider"; const provider = new FireblocksWeb3Provider({ privateKey: process.env.FIREBLOCKS_API_PRIVATE_KEY!, apiKey: process.env.FIREBLOCKS_API_KEY!, vaultAccountIds: "0", chainId: ChainId.ETHEREUM, }); const web3 = new Web3(provider); // Теперь стандартные web3 вызовы используют Fireblocks для подписи const contract = new web3.eth.Contract(ABI, contractAddress); await contract.methods.deposit(amount).send({ from: vaultAddress }); 

Мы гарантируем, что все транзакции проходят через Policy Engine перед отправкой в сеть. Это исключает риск отправки средств на неверный адрес.

Как отправить транзакцию за 3 шага?

1. Создайте vault и wallet — используйте createVaultAccount и createVaultAsset.
2. Настройте Policy Engine — задайте whitelist адресов и лимиты.
3. Выполняйте отправку — через createTransaction. Транзакция автоматически проходит подпись MPC.

Какие этапы включает интеграция?

Что вы получите в итоге?

• Полностью настроенную кастодиальную платформу с изоляцией активов по клиентам или стратегиям.
• Автоматический compliance-контроль каждой транзакции (Policy Engine).
• Возможность безопасно участвовать в DeFi: стейкинг, AMM, lending.
• Интеграцию с существующим бэкендом через единый API.
• Сокращение затрат на безопасность до 40% по сравнению с самостоятельной реализацией MPC. Один из клиентов сэкономил $120 000 в год на операционных расходах, а другой — $75 000 на аудите compliance.

Когда Fireblocks оправдан?

Управление активами от $10M — ориентир, а не строгая граница. Наличие требований SOC 2, ISO 27001 или аналогичных. Команда из нескольких лиц с правом подписи. Интеграция с традиционными банковскими системами. Для стартапов и меньших объёмов Safe Multisig + собственный custody workflow значительно дешевле. Мы поможем выбрать оптимальное решение, если вы не уверены.

Получите консультацию по интеграции Fireblocks — оценим ваш проект бесплатно и предложим план внедрения. Свяжитесь с нами, чтобы обсудить детали. Закажите демо-доступ к Sandbox на один месяц.