【免费下载链接】swapper-toolkit
DeFi toolkit for AI agents and coding assistants — deposit funds, execute trades, and manage crypto wallets. Works with Claude Code, Cursor, Windsurf, OpenClaw, CrewAI, AutoGPT, and other AI agent frameworks.
swapper-toolkit 是一款面向 AI Agent 的 DeFi 跨链存款工具包，基于 Chainlink CCIP 协议，打通法币入金、加密转账与跨链桥接，能把资金一键桥接至 60 多条公链。本文带你完成一次完整的跨链存款实战。
一、swapper-toolkit 是什么？AI Agent 的存款工具包
swapper-toolkit 是 Swapper Finance 为 AI 编程助手打造技能包（skill pack）：装上之后，AI Agent 就能帮你完成存款、跨链桥接，以及未来的代币交换与钱包管理。它兼容 Claude Code、Cursor、Windsurf、GitHub Copilot、CrewAI、AutoGPT 等主流框架。
三个核心特点，对新手很关键：
- 🔗 存款即桥接：支持卡支付（Mastercard / Visa / Apple Pay / Google Pay）、加密转账、跨链桥接三种入金方式，资金直接落到目标链、目标钱包或 DeFi 协议；
- ✅ 用户确认制：技能本身不执行交易，只生成一条存款 deeplink，所有交易都由你在浏览器中确认后才执行；
- 🛡️ 不碰私钥：全程不存储、不访问私钥，手续费与风险在确认前明确展示。
产品定位说明见仓库根目录的 CLAUDE.md，存款技能的完整定义在 skills/swapper-deposit/SKILL.md。
二、一行命令安装 swapper-toolkit
在终端执行：
npx skills add swapperfinance/swapper-toolkit
如果想阅读源码或二次开发，也可以克隆仓库：
git clone https://gitcode.com/gh_mirrors/sw/swapper-toolkit
技能包元数据定义在 package.json 的 claude-code 字段中，声明了当前可用的技能 skills/swapper-deposit。
三、跨链存款实战：把 USDC 桥接到 Base 链
以最常见的场景为例——"往 Base 链的钱包里存 100 USDC"。Agent 只需收集 3 个必填参数（参数表见 skills/swapper-deposit/SKILL.md）：
| 参数 | 说明 | 示例 |
|---|---|---|
depositWalletAddress | 接收存款的钱包地址 | 0x2A018F...c28A |
dstChainId | 目标链 ID | 8453（Base） |
dstTokenAddr | 目标代币合约地址 | Base 上的 USDC 合约地址 |
💡 存原生币（ETH、POL、BNB 等 gas 代币）时，
dstTokenAddr填全零地址0x0000000000000000000000000000000000000000。
参数齐了之后，技能会按固定模板拼出存款 deeplink（模板见 skills/swapper-deposit/SKILL.md）：
https://deposit.swapper.finance?integratorId=***&dstChainId=8453&dstTokenAddr=0x833589fC...&depositWalletAddress=0x2A018F...&utm_source=swapper-deposit&extendedView=true
其中 integratorId 是固定的集成方 ID，Agent 不会向你索要。
接下来 Agent 会在聊天中完整打印这条链接，再用浏览器打开（macOS 用 open、Linux 用 xdg-open、Windows 用 start）。你在页面里核对三件事，确认即完成跨链存款：
- 代币是否正确（比如 USDC）；
- 钱包地址是否是你自己的地址；
- 目标链是否选对（Base / Arbitrum / Polygon…）。
除了主动发起，技能还支持推理中途触发：比如 Agent 发现部署合约前钱包里没有 ETH，会主动生成存款链接让你先充值，再恢复原来的任务（交互示例见 skills/swapper-deposit/SKILL.md）。
四、Chainlink CCIP：资金能桥接到哪 60 多条链？
跨链能力来自底层三大基础设施（见 skills/swapper-deposit/SKILL.md）：
| 组件 | 作用 |
|---|---|
| Chainlink CCIP | 跨链互操作协议，安全地把转账路由到 60+ 条区块链 |
| Chainlink CRE | 端到端编排合规、支付授权、兑换与结算，形成一条可验证的完整流程 |
| Mastercard | 全球卡支付通道，覆盖 170+ 国家 |
也就是说，"法币 → 加密 → 跨链"整条链路在一条 deeplink 里完成。技能当前明确支持的目标链及 Chain ID 速查：
| 链 | Chain ID |
|---|---|
| Ethereum | 1 |
| Base | 8453 |
| Arbitrum | 42161 |
| Optimism | 10 |
| Polygon | 137 |
| BNB Chain | 56 |
| Avalanche | 43114 |
| HyperEVM | 999 |
| Solana | solana |
| Fast | fast |
完整表格见 CLAUDE.md。
五、新手安全确认清单 🛡️
跨链存款涉及真实资金，按仓库写死的安全规则（CLAUDE.md）过一遍：
- 每笔交易都需要你显式确认，绝不自动批准；
- 确认前会展示手续费、滑点与风险；
- 私钥全程不落地，Agent 无权访问；
- deeplink 会完整展示，方便你手动核对或复制。
只要坚持"先核对代币与地址、再点确认"，跨链存款的风险就基本可控。
六、开发者进阶：把跨链存款流程嵌入你的应用
如果你正在做 Web3 应用，可以直接嵌入 Swapper 存款组件：
npm i @swapper-finance/deposit-sdk
SDK 提供 openSwapperModal（弹窗）与 SwapperIframe（嵌入容器）两种用法，也支持原始 iframe 嵌入。关键参数同样是 integratorId、dstChainId、dstTokenAddr、depositWalletAddress，完整代码示例见 skills/swapper-deposit/SKILL.md。
小结
- swapper-toolkit 让 AI Agent 具备"存款 + 跨链桥接"能力，一行命令即可安装；
- 跨链存款的核心是 3 个参数 + 1 条 deeplink，Chainlink CCIP 负责把资金安全送达 60+ 条链；
- 用户确认制 + 不碰私钥，是它敢让 Agent 碰钱的底气。
试着对你的 Agent 说"往 Base 链的钱包里存 100 USDC"，体验一次完整的跨链存款吧。
【免费下载链接】swapper-toolkit
DeFi toolkit for AI agents and coding assistants — deposit funds, execute trades, and manage crypto wallets. Works with Claude Code, Cursor, Windsurf, OpenClaw, CrewAI, AutoGPT, and other AI agent frameworks.
转载自 CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/gitblog_00713/article/details/169066858
