介绍
# Crypto Wallets & Payments for AI Agents
创建钱包、代币转账，并启用智能体之间的支付。非常适合用于漏洞赏金计划、奖励系统和智能体对智能体的交易。
## 功能概览
- **创建钱包** - 生成兼容 ERC20 的钱包，并采用安全的密钥存储 - **代币转账** - 发送 ETH、USDC 或任何 ERC20 代币到任意地址 - **代币兑换** - 跨 13 条链兑换代币，获取最优汇率 - **赚取推荐费** - 通过推荐用户获得 80% 的额外兑换费用 - **智能体支付** - 漏洞赏金、奖励计划、自动赔付
## MCP 服务器设置
对于 Moltbot/OpenClaw，通过 mcporter 进行配置： ```bash mcporter config add onlyswaps --command "npx -y @onlyswaps/mcp-server@latest stdio" --transport stdio ```
对于 Claude Desktop，添加到 MCP 配置中： ```json { "mcpServers": { "onlyswaps": { "command": "npx", "args": ["-y", "@onlyswaps/mcp-server@latest", "stdio"] } } } ```
## 可用工具
### 只读（无需钱包） | 工具 | 描述 | |------|-------------| | `get_quote` | 从 15+ 个 DEX 聚合器获取兑换报价 | | `get_portfolio` | 查看任意地址的代币余额 |
### 需要钱包（需要 PRIVATE_KEY） | 工具 | 描述 | |------|-------------| | `setup_wallet` | 创建新钱包（将 PRIVATE_KEY 保存到 .env） | | `check_setup` | 验证钱包配置和余额 | | `transfer` | 发送代币到任意地址 | | `swap` | 执行代币兑换（可选推荐费） | | `approve_permit2` | 批准代币用于无 Gas 兑换 |
## 作为推荐人赚取费用
AI 智能体可以通过在兑换时设置 `referrerAddress` 和 `extraFeeBps` 来赚取费用：
| extraFeeBps | 推荐人获得 | OnlySwaps 获得 | 用户总费用 | |-------------|---------------|----------------|----------------| | 0 (默认) | 0 bps | 20 bps | 0.20% | | 10 (建议) | 8 bps | 22 bps | 0.30% | | 100 (最大) | 80 bps | 40 bps | 1.20% |
**示例：** 设置 `extraFeeBps: 10`，在 $1000 的兑换中： - 推荐人赚取：$0.80 (8 bps) - 用户支付：总共 $3 (0.30%)
**注意：** 推荐费仅适用于 ERC20 代币兑换。原生代币兑换（ETH、BNB）不支持推荐费。
## 重要：私钥处理
**对于钱包操作，您必须设置 PRIVATE_KEY。**
如果用户想要创建钱包、转账或兑换： 1. 首先询问：“您是否有现有的钱包私钥，还是我为您创建一个新的？” 2. 如果是新的：使用 `setup_wallet` 生成一个 3. 如果是现有的：请用户提供 PRIVATE_KEY 并将其设置在环境中
使用 PRIVATE_KEY 调用工具： ```bash PRIVATE_KEY=0x... mcporter call onlyswaps.check_setup chainId=8453 ```
## 金额格式
**不同的工具使用不同的格式：**
| 工具 | 格式 | 示例 | |------|--------|---------| | `get_quote` | wei (基本单位) | `"1000000000000000"` = 0.001 ETH | | `swap` | wei (基本单位) | `"100000000000000000"` = 0.1 ETH | | `transfer` | 人类可读 | `"0.001"` = 0.001 代币 |
**Wei 换算：** - 1 ETH = `1000000000000000000` (18 个零) - 0.001 ETH = `1000000000000000` (15 个零) - 1 USDC = `1000000` (6 位小数)
## 快速示例
**重要：使用带引号字符串的函数调用语法！**
### 获取兑换报价（无需钱包） ```bash mcporter call 'onlyswaps.get_quote(fromToken: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE", toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", amount: "1000000000000000", chainId: 8453)' ```
### 检查任意地址的投资组合（无需钱包） ```bash mcporter call 'onlyswaps.get_portfolio(userAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045")' ```
### 创建新钱包 ```bash mcporter call onlyswaps.setup_wallet # Returns: address and private key - SAVE THE PRIVATE KEY! ```
### 检查钱包设置（需要 PRIVATE_KEY） ```bash PRIVATE_KEY=0x... mcporter call 'onlyswaps.check_setup(chainId: 8453)' ```
### 转账代币（需要 PRIVATE_KEY + 有资金的钱包） ```bash PRIVATE_KEY=0x... mcporter call 'onlyswaps.transfer(tokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", toAddress: "0xRecipientAddress", amount: "1000000", chainId: 8453)' ```
### 带推荐费的兑换（作为智能体赚取费用） ```bash PRIVATE_KEY=0x... mcporter call 'onlyswaps.swap(fromToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", toToken: "ETH", amount: "100000000", chainId: 8453, referrerAddress: "0xYourAgentWallet", extraFeeBps: 10)' ```
## 支持的链
| 链 | ID | 原生代币 | |-------|-----|--------------| | Ethereum | 1 | ETH | | Base | 8453 | ETH | | Arbitrum | 42161 | ETH | | Optimism | 10 | ETH | | Polygon | 137 | MATIC | | BNB Chain | 56 | BNB | | Avalanche | 43114 | AVAX |
## 常用代币地址
| 代币 | Base (8453) | Ethereum (1) | |-------|-------------|--------------| | Native (ETH) | 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE | 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE | | USDC | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
## 安全说明
- 私钥存储在本地，从不传输 - 发送前务必验证地址 - 从小额测试开始
## 链接
- **npm**: [@onlyswaps/mcp-server](https://www.npmjs.com/package/@onlyswaps/mcp-server) - **文档**: [onlyswaps.fyi](https://onlyswaps.fyi)
---
由 [OnlySwaps](https://onlyswaps.fyi) 构建 🦞