SuperAPI AI 工具集

bridge-tokens

通用与其它

查看项目

更新于 10-15 20:12

技能介绍

用途:在浏览器或服务端应用中跨链桥接代币。USDC 通过 CCTP 跨链(源链 burn、目标链 mint);CCTPx 代币使用注册表别名(如 wETH、cirBTC、EURC)或注册表列出的代币 ID,二者都走同一个 kit.bridge() 调用,SDK 自动路由,无需选择协议。

主要能力:App Kit(@circle-fin/app-kit)是涵盖 bridge、swap、send 的一体化 SDK;独立 Bridge Kit(@circle-fin/bridge-kit)提供相同 bridge API 的更轻量包。桥接操作不需要 kit key。支持浏览器与服务端,客户端用浏览器钱包适配器,私钥与 Circle Wallets 凭据留在服务端。CCTPx 需 App Kit 或 Bridge Kit >=1.15.0,浏览器桥接 CCTPx 需 App Kit >=1.15.2 或 Bridge Kit >=1.15.1。

支持范围:USDC 支持所有 CCTP 链(EVM + Solana);EURC、wETH、cirBTC 及注册表代币 ID 仅限 EVM-to-EVM。别名区分大小写,代币 ID 为 bytes32 十六进制字符串。SDK 运行时拉取 CCTPx 注册表,路由不支持时抛 INPUT_UNSUPPORTED_ROUTE,不要硬编码路由列表。

使用方式:安装 App Kit 与适配器,例如 npm install @circle-fin/app-kit @circle-fin/adapter-viem-v2;初始化 new AppKit() 或 new BridgeKit()。先按决策指南确定 SDK 与钱包适配器,确认代币、金额、源/目标链与收款地址,默认测试网,主网需显式确认。CCTPx 先调用 kit.estimateBridge()(App Kit)或 kit.estimate()(Bridge Kit)报价并展示费用,再由用户显式操作执行 kit.bridge({ token, from, to, amount })。用 result.state / result.steps 跟踪,软失败用 kit.retryBridge() 或 kit.retry() 恢复,不要重跑 bridge()。链名用字符串(如 "Arc_Testnet"、"Base_Sepolia")。

限制:CCTPx 路由拒绝自定义费用、feePayment: "destination" 与 useForwarder: false;每笔 CCTPx 转账需以源链原生代币支付 relayer 费用,FAST 默认含预终局性费用,SLOW 等待源链终局性。CCTP 快速模式约 8-20 秒,标准模式约 15-19 分钟。切勿在客户端代码暴露私钥、Circle API key、entity secret 或 kit key。其他代币或链的跨链兑换应改用 swap-tokens,统一跨链余额场景应改用 use-gateway。