swapper-toolkit
swapperfinance/swapper-toolkit加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
2025年的一个深夜，一位开发者正兴奋地调试他的AI Coding助手，准备让它自动完成合约部署任务。AI助理论证严谨、代码漂亮，却在关键时刻卡住了——钱包余额为零。开发者不得不手动转账、切换网络、复制地址，一通操作后AI助手才得以继续。
Swapper Finance团队正是看到了这个痛点：如果AI智能体能像人一样自己管理资金、充值钱包、执行DeFi操作，整个自动化流程就不会在「钱」这个环节断掉。于是他们推出了Swapper AI Agent Toolkit——AI智能体的支付层。
这个工具包让AI助手能够在对话中直接帮用户：用法币（信用卡、Apple Pay）购买加密货币、跨链充值钱包、执行DeFi存款。整个过程无需用户离开当前界面，也无需AI智能体接触私钥——它只负责生成支付链接，最终确认权牢牢握在用户手中。
Swapper AI Agent Toolkit不是一个独立的钱包应用，而是一套标准化的「支付指令生成器」。
它的核心逻辑非常清晰：AI智能体在理解用户意图后，调用对应的Skill文件，生成一个带有完整参数的deposit.swapper.finance深度链接（deeplink），然后在浏览器中打开Swapper托管的支付页面。用户在这个页面上完成身份验证和支付，资金最终到达目标链上的指定钱包地址。
整个过程中，AI从未接触私钥，也从未直接发起链上交易——它只是「生成链接」，真正的支付由Swapper的合规基础设施（由Chainlink CRE编排，Mastercard处理卡支付）完成。这是整个方案安全性的核心。
从仓库结构来看，这是一个极简到极致的Skill Pack：
swapper-toolkit/
├── package.json # npm元数据，声明为 skill-pack
├── CLAUDE.md # Claude Code 自动读取的项目说明
├── README.md # 用户级文档
└── skills/
└── swapper-deposit/
└── SKILL.md # Skill定义文件（被AI智能体读取）
技术选型分析：
npx skills add安装到Claude Code环境中，生态成熟，分发便捷@swapper-finance/deposit-sdk作为开发者嵌入选项，支持Iframe嵌入和Modal弹窗两种模式底层依赖（外部服务，非本地运行）：
这是目前唯一完全实现的功能模块，也是整套工具包的拳头功能。
触发场景有两种：
工作流程：
用户: "Deposit $100 USDC into Aave on Base"
AI Agent (swapper-deposit skill):
→ 分析参数：目标链=Base(8453)，代币=USDC，协议=Aave
→ 生成 deeplink:
https://deposit.swapper.finance
?integratorId=d6e438dfa14e80709b19
&dstChainId=8453
&dstTokenAddr=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
&depositWalletAddress=0x2A018F2506acaEEE2C10632514Fc5DCa9eE2c28A
&utm_source=swapper-deposit
&extendedView=true
→ 打开浏览器 → 用户确认支付 → 资金到账
支持链：Ethereum、Base、Arbitrum、Optimism、Polygon、Solana、BNB Chain、Avalanche、Fast、HyperEVM（共10条主流链）
支持方式：
跨DEX的代币兑换能力，支持同链和跨链swap。目前状态：/swapper-trade Skill文件存在但内容为空。
智能钱包创建、多链钱包设置、余额查询。目前状态：/swapper-wallet Skill文件存在但内容为空。
最大特点：不碰私钥
整个工具链的设计遵循一个严格的边界：私钥永远不离开用户的本地环境。AI智能体只生成deeplink参数，真正的交易执行在Swapper托管的前端页面完成，链上签名由用户本地钱包（MetaMask等）发起。这个模式将AI的操作权限限制在「生成链接」层面，从根本上杜绝了AI被盗用后造成资金损失的可能。
deeplink参数固化
值得注意的是，integratorId是硬编码的（d6e438dfa14e80709b19），AI智能体无法自定义这个值。这意味着Swapper平台对每个集成方有强认证，所有通过这个ID的存款操作都可追溯。这也是一种平台级的安全保护。
对于想在自有应用中集成Swapper存款能力的开发者，提供了两套方案：
SDK模式（推荐）：
import { openSwapperModal } from '@swapper-finance/deposit-sdk';
openSwapperModal({
integratorId: 'your-integrator-id',
dstChainId: '8453',
dstTokenAddr: '0x...',
depositWalletAddress: '0x...',
styles: { themeMode: 'dark' },
});
Iframe嵌入模式（适合Web应用内嵌）：
<iframe src="https://deposit.swapper.finance?integratorId=YOUR_ID..."
title="Swapper Deposits Widget"
sandbox="allow-forms allow-modals allow-popups...">
</iframe>
两种模式都需要正确的sandbox属性才能使用卡支付功能，这是出于安全考虑。
这个工具包的部署（安装）异常简单：
npx skills add swapperfinance/swapper-toolkit
这条命令将Skill Pack安装到Claude Code环境中，安装后Claude Code会自动读取CLAUDE.md和SKILL.md文件，在合适的场景下触发对应技能。
需要注意的是：这不是一个独立运行的服务，而是一个Claude Code的扩展插件。安装后依赖Claude Code环境运行，无法在没有AI智能体的情况下独立使用。
功能完成度较低：三个核心功能（Deposit/Trade/Wallet）中，只有Deposit完全实现，另外两个仍为「即将上线」状态。对于期望一站式解决方案的用户来说，目前工具包功能较为单一。
依赖外部服务：整个系统的可用性完全依赖Swapper云端服务、Chainlink节点和Mastercard支付网关。一旦Swapper停止服务，整个工具包将完全失效——这不是一个完全去中心化的方案。
仅支持AI智能体：不适用于普通用户直接在命令行使用，必须嵌入到Claude Code或其他支持的AI Agent框架中。对于非AI Agent场景完全没有用处。
跨链gas费的复杂性：跨链存款涉及源链Gas、目标链Gas、桥接手续费多层费用，用户在确认前需要仔细核对总成本。
项目年轻：仓库创建于2026年3月，仅有约一个月历史，尚未经过大规模生产环境验证。
Swapper AI Agent Toolkit的出现，反映了一个正在形成的新范式：AI智能体需要自主财务能力。
随着AI Agent从简单的对话工具向复杂的任务执行者演进，「AI持有资产」将成为刚需。无论是自动做市、自动策略执行，还是跨协议收益优化，AI都需要一种安全、可控的方式来持有和支配资产。Swapper的方案是目前该领域最成熟的实现之一。
它选择的路径——Deeplink + 云端合规基础设施——而非让AI直接操作链上钱包，是一种务实的安全折中：牺牲了部分「去中心化」纯粹性，换来了合规性和易用性。这对于企业级AI应用场景尤为重要。
| 指标 | 数值 |
|---|---|
| GitHub Stars | 800 |
| Forks | 33 |
| 创建时间 | 2026-03-23 |
| 最新更新 | 2026-04-07 |
| 开放Issues | 4 |
项目整体处于早期活跃状态，Stars增长迅速（创建约20天即达到800），但功能完善度和社区积累仍有较大提升空间。