Мы интегрируем Wormhole для кросс-чейн передачи токенов и данных — от простого bridge UI до сложных custom messaging протоколов. За плечами нашей команды 30+ проектов на стыке EVM и Solana. Типичная задача: перевести USDC из Ethereum в Arbitrum без лишних комиссий и задержек. Или отправить произвольный сигнал из Solana в BNB Chain для синхронизации состояния. Wormhole решает эту задачу, но требует понимания Guardian-сети и VAA.
Как Wormhole обеспечивает доверие между цепями?
Wormhole использует сеть из 19 Guardian валидаторов. Каждый Guardian наблюдает события на исходной цепи и подписывает VAA (Verified Action Approval) — доказательство того, что событие произошло. Для принятия VAA необходимо 13 из 19 подписей. Это компромисс между безопасностью и скоростью: компрометация 13 Guardian нод даёт полный контроль над протоколом. Понимание этого trade-off критично при выборе метода интеграции.
Архитектура протокола
Source Chain Wormhole Guardians Target Chain
│ │ │
│ publishMessage(payload) │ │
│ → Core Bridge Contract │ │
│ emits LogMessagePublished │ │
│ observe event │
│ sign VAA │
│ (19 guardians, │
│ 13-of-19 threshold) │
│ │ VAA signed │
│ │ ──────────────────────────► │
│ receiveMessage(VAA)
│ verify Guardian sigs
│ execute payload
Быстрый старт с Wormhole Connect
Для добавления bridge UI в приложение используем Wormhole Connect компонент. Не нужно писать смарт-контракты:
npm install @wormhole-foundation/wormhole-connect
import WormholeConnect from '@wormhole-foundation/wormhole-connect'
export default function BridgePage() {
return (
<WormholeConnect
config={{
network: 'Mainnet',
chains: ['Ethereum', 'Solana', 'Arbitrum', 'Base', 'BNB'],
tokens: ['ETH', 'USDC', 'USDT', 'WBTC'],
rpcs: {
Ethereum: 'https://eth-mainnet.g.alchemy.com/v2/...',
Solana: 'https://api.mainnet-beta.solana.com',
},
ui: {
title: 'Bridge',
defaultInputs: {
fromChain: 'Ethereum',
toChain: 'Arbitrum',
tokenKey: 'ETH',
}
}
}}
/>
)
}
Connect поддерживает несколько протоколов маршрутизации: Token Bridge (lock-and-mint), CCTP (Circle's native USDC bridge, no wrapped tokens), порталы ликвидности. Автоматически выбирает оптимальный маршрут.
Программная интеграция через Wormhole SDK
Для кастомных cross-chain workflows используем TypeScript SDK (wormhole-sdk v3).
import { wormhole } from '@wormhole-foundation/sdk'
import { EvmPlatform } from '@wormhole-foundation/sdk-evm'
import { SolanaPlatform } from '@wormhole-foundation/sdk-solana'
const wh = await wormhole('Mainnet', [EvmPlatform, SolanaPlatform])
// Получаем chain contexts
const srcChain = wh.getChain('Ethereum')
const dstChain = wh.getChain('Solana')
// Token Bridge transfer
const tb = await srcChain.getTokenBridge()
const transferTxs = tb.transfer(
senderAddress,
{ chain: 'Solana', address: recipientAddress },
'native', // ETH
1_000_000_000_000_000_000n // 1 ETH в wei
)
// Отправляем транзакцию на Source chain
for await (const tx of transferTxs) {
await signer.sendTransaction(tx.transaction)
}
// Ждём VAA (обычно 15 минут для Ethereum finality)
const [txid] = await srcChain.sendWait(transferTxs, signer)
const vaa = await wh.getVaa(txid, 'TokenBridge:Transfer', 60_000)
// Redeem на Target chain
const redeemTxs = dstChain.getTokenBridge().redeem(recipientAddress, vaa)
for await (const tx of redeemTxs) {
await solanaSigner.sendTransaction(tx.transaction)
}
Почему CCTP быстрее Token Bridge?
CCTP (Circle's Cross-Chain Transfer Protocol) через Wormhole сжигает USDC на исходной цепи и минтит нативный USDC на целевой, без wrapped токенов. Время перевода: ~2 минуты против 15–20 минут для Token Bridge. Поддерживаемые цепи: Ethereum, Arbitrum, Base, Optimism, Avalanche, Polygon. Для USDC transfers CCTP всегда предпочтительнее.
Custom messaging: cross-chain приложения
Wormhole — не только bridge для токенов, но и general-purpose messaging. Контракт отправитель публикует произвольный payload, а контракт получатель верифицирует VAA и исполняет логику.
// Source chain: отправка сообщения
interface IWormhole {
function publishMessage(
uint32 nonce,
bytes memory payload,
uint8 consistencyLevel
) external payable returns (uint64 sequence);
}
contract CrossChainApp {
IWormhole wormhole;
function sendMessage(bytes memory payload) external payable {
uint64 sequence = wormhole.publishMessage{value: msg.value}(0, payload, 1);
emit MessageSent(sequence);
}
}
// Target chain: получение VAA
contract CrossChainReceiver {
IWormhole wormhole;
mapping(bytes32 => bool) processedVAAs;
function receiveMessage(bytes memory encodedVAA) external {
(IWormhole.VM memory vm, bool valid, string memory reason) =
wormhole.parseAndVerifyVM(encodedVAA);
require(valid, reason);
require(!processedVAAs[vm.hash], "Already processed");
processedVAAs[vm.hash] = true;
_processPayload(vm.payload);
}
}
Wormhole Queries: cross-chain data без транзакций
Wormhole Queries — on-demand чтение on-chain данных с другой цепи без отправки транзакций. Guardian ноды делают RPC запросы и возвращают подписанный ответ. Применение: проверить баланс/стейкинг пользователя на Ethereum прямо из контракта на Solana. Без oracle, без bridge транзакции.
Инструменты разработки и мониторинг
Wormholescan (wormholescan.io) — explorer для VAA и транзакций. Незаменим для отладки: по txHash исходной цепи найти VAA, проверить статус Guardian подписей. Testnet: Wormhole поддерживает testnets всех цепей. Ethereum Sepolia → Solana Devnet — стандартный тестовый маршрут.
| Компонент | Инструмент |
|---|---|
| SDK | @wormhole-foundation/sdk v3 |
| UI компонент | @wormhole-foundation/wormhole-connect |
| Explorer | wormholescan.io |
| VAA мониторинг | Wormhole Guardian API |
| Relayer | Wormhole Standard Relayer / кастомный |
| Тесты | Foundry + wormhole-solidity-sdk |
Что входит в работу и процесс
- Анализ маршрутов: определяем, какие цепи и токены нужны, выбираем Token Bridge / CCTP / custom messaging. (2-3 дня)
- Проектирование архитектуры: схема взаимодействия контрактов, выбор relayer.
- Разработка смарт-контрактов: Solidity/Anchor контракты с обработкой VAA и защитой от повторного использования. (2-4 недели)
- Интеграция SDK/UI: подключение Wormhole Connect или кастомного frontend. (3-5 дней)
- Тестирование на testnet: проверка edge cases (VAA expiry, reorg, double-spend).
- Документация: описание конфигурации и инструкции для поддержки.
- Деплой и мониторинг: настройка мониторинга Guardian подписей через Wormholescan.
Типичные ошибки при интеграции
- Неправильная настройка consistencyLevel (использование instant вместо finalized на Ethereum).
- Отсутствие защиты от повторного использования VAA (processedVAAs).
- Не учтены задержки финализации (15 минут для Ethereum, 200 slots для Solana).
Сравнение методов передачи
| Параметр | Token Bridge | CCTP | Custom Messaging |
|---|---|---|---|
| Активы | Любые токены | Только USDC (нативно) | Любые данные |
| Безопасность | Wrapped токены | Нативный USDC | Зависит от реализации |
| Скорость | 15-20 мин | ~2 мин | Зависит от consistency |
| Гибкость | Только transfer | Только USDC | Любые payload |
Наша команда — 5+ лет на рынке, 30+ успешных кросс-чейн интеграций. Получите консультацию по вашему проекту: напишите нам, мы оценим сложность и предложим архитектуру.