当前位置：首页 > news >正文

Wormhole SDK 使用教程：如何在 10 分钟内集成跨链功能

news 2026/5/16 21:59:04

Wormhole SDK 使用教程：如何在 10 分钟内集成跨链功能

【免费下载链接】wormholeA reference implementation for the Wormhole blockchain interoperability protocol.项目地址: https://gitcode.com/gh_mirrors/wo/wormhole

Wormhole 是一个区块链互操作性协议，允许在多个区块链之间传输任意数据。本教程将展示如何使用 Wormhole SDK 快速集成跨链功能，让你的应用轻松实现不同区块链间的资产转移和数据通信。

Wormhole 协议基础

Wormhole 协议通过在每个支持的区块链上部署智能合约，实现跨链消息传递。当用户在源链提交数据时，Wormhole 网络的守护者（Guardians）会观察并验证交易，生成 SignedVAA（Signed Verifiable Action Approval），随后目标链的智能合约可以验证并处理该消息。

图：Wormhole 协议品牌标识，代表跨链互操作性的核心功能

核心功能与应用场景

Wormhole SDK 提供了丰富的跨链功能，主要包括：

资产跨链转移：支持代币、NFT 等资产在不同区块链间转移
跨链消息传递：实现不同区块链上智能合约的通信
数据验证：通过 Guardians 网络确保跨链数据的安全性和一致性

典型应用场景

去中心化交易所的跨链交易
跨链借贷平台的资产抵押
NFT 跨链展示与交易
跨链治理投票

环境准备与安装

系统要求

Node.js v14+
npm 或 yarn 包管理器
Git

安装步骤

克隆仓库

git clone https://gitcode.com/gh_mirrors/wo/wormhole cd wormhole

安装依赖

npm install @wormhole-foundation/sdk

注意：旧版 SDK (@certusone/wormhole-sdk) 已废弃，请使用最新的@wormhole-foundation/sdk

快速开始：跨链资产转移

以下是使用 Wormhole SDK 实现跨链资产转移的基本流程：

1. 初始化 SDK

import { Wormhole } from '@wormhole-foundation/sdk'; // 初始化 Wormhole SDK const wormhole = new Wormhole({ network: 'testnet', // 或 'mainnet' rpcs: { // 配置各链的 RPC 节点 ethereum: 'https://goerli.infura.io/v3/your-api-key', solana: 'https://api.devnet.solana.com' } });

2. 跨链架构解析

Wormhole 的跨链通信基于 CCQ（Cross-Chain Query）架构，通过以下流程实现安全的数据传输：

图：Wormhole CCQ 架构示意图，展示了跨链请求从发起、验证到执行的完整流程

3. 资产转移示例（Solana → Ethereum）

发送方（Solana）

// 1. 创建转移交易 const transferTx = await wormhole.transfer({ fromChain: 'solana', toChain: 'ethereum', amount: 100, // 代币数量 tokenAddress: 'SOL_TOKEN_ADDRESS', // Solana 代币地址 recipient: 'ETH_RECIPIENT_ADDRESS', // Ethereum 接收地址 signer: solanaWallet // Solana 钱包签名者 }); // 2. 发送交易并等待确认 const txHash = await transferTx.submit(); await transferTx.confirm(); // 3. 获取 VAA (Verifiable Action Approval) const vaa = await wormhole.getVAA({ chain: 'solana', txHash: txHash });

接收方（Ethereum）

// 4. 在目标链上赎回资产 const redeemTx = await wormhole.redeem({ chain: 'ethereum', vaa: vaa, signer: ethWallet // Ethereum 钱包签名者 }); // 5. 等待赎回交易确认 await redeemTx.confirm(); console.log('资产跨链转移完成！');