159 lines
5.3 KiB
Markdown
159 lines
5.3 KiB
Markdown
# AI智能体跨链支付URL
|
||
|
||
`跨链支付` `AI智能体` `区块链` `Web3` `加密货币`
|
||
|
||
# kibble-pay
|
||
|
||
为 AI 智能体钱包提供跨链支付 URL。一个函数，一个 URL，支持任意链。
|
||
|
||
## 工作原理
|
||
|
||
你的智能体需要资金——也许它运行在 Base 链上使用 USDC，但为其充值的用户持有的是 Solana 上的 SOL。这不应该成为障碍。
|
||
|
||
Kibble 为你的智能体提供一个统一的 URL。用户打开后，连接任意钱包，选择手中持有的任意代币，[LI.FI](https://li.fi) 会自动将其路由到正确链上的正确代币。目标字段已锁定，不会发送到错误地址。
|
||
|
||
支持 60+ 条链。前端无需 SDK——URL 本身就是完整的集成方案。
|
||
|
||
## URL 结构
|
||
|
||
你的智能体生成一个 URL，该 URL 即为完整的集成方案。
|
||
|
||
```
|
||
GET /pay?toChain={chainId}&toToken={tokenAddress}&toAddress={walletAddress}
|
||
```
|
||
|
||
**必填参数**
|
||
|
||
- `toChain` — 目标链 ID（例如 `8453` 代表 Base）
|
||
- `toToken` — 目标链上的代币合约地址
|
||
- `toAddress` — 智能体的钱包地址
|
||
|
||
**可选参数**
|
||
|
||
- `toAmount` — 请求的代币数量
|
||
- `agentName` — 显示给用户的名称
|
||
- `agentLogo` — 智能体品牌图片 URL
|
||
- `minAmountUSD` — 最低接受的 USD 金额
|
||
- `fromChain` — 预选来源链（必须与 `fromToken` 配对使用）
|
||
- `fromToken` — 预选来源代币（必须与 `fromChain` 配对使用）
|
||
- `fromAmount` — 以来源代币单位表示的发送数量（需要 `fromChain` + `fromToken`）
|
||
|
||
**示例**
|
||
|
||
一个运行在 Base 链上、需要在 `0x705A42EcC5dF243BF9298f1D091b89761522a796` 接收 USDC 的智能体：
|
||
|
||
```
|
||
https://kibble.sh/pay?toChain=8453&toToken=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&toAddress=0x705A42EcC5dF243BF9298f1D091b89761522a796&agentName=MyAgent&toAmount=10
|
||
```
|
||
|
||
用户打开该链接，连接钱包，从任意支持链上选择来源代币并签名。智能体钱包即可在 Base 上收到 USDC。
|
||
|
||
**支持的链**
|
||
|
||
Kibble 支持 LI.FI 所支持的所有链，目前包括 60+ 个网络，涵盖 EVM 链（以太坊、Base、Arbitrum、Optimism、Polygon 等数十条链）、Solana、Bitcoin 和 Sui。完整列表请参阅 [LI.FI 文档](https://docs.li.fi/introduction/chains)。
|
||
|
||
**支付页面工作方式**
|
||
|
||
服务器在渲染任何内容之前会验证所有参数——无效参数会重定向到带有具体原因的错误页面，有效参数则渲染双栏布局。
|
||
|
||
左侧展示智能体头部信息，包括品牌标识、目标链、请求金额和已锁定的钱包地址。右侧，LI.FI 组件处理来源选择、路由和交易签名，组件配置中已禁用目标字段，防止用户修改。
|
||
|
||
OG 元标签在服务端渲染，因此当你的智能体在 Telegram 或 Discord 中分享 Kibble 链接时，预览卡片会显示智能体名称和支付上下文，而非普通 URL。
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
npm install kibble-pay
|
||
```
|
||
|
||
## 使用方法
|
||
|
||
```typescript
|
||
import { kibble, USDC } from "kibble-pay";
|
||
|
||
const url = kibble({
|
||
toChain: 8453,
|
||
toToken: USDC[8453],
|
||
toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD68",
|
||
agentName: "TradingBot",
|
||
toAmount: 50,
|
||
});
|
||
|
||
// 将此 URL 发送给用户——他们打开后连接任意钱包，
|
||
// 选择任意来源代币，LI.FI 将一切路由到 Base USDC。
|
||
console.log(url);
|
||
|
||
// 预选来源："从以太坊发送 5 USDC 到 Base"
|
||
const directUrl = kibble({
|
||
toChain: 8453,
|
||
toToken: USDC[8453],
|
||
toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD68",
|
||
agentName: "TradingBot",
|
||
fromChain: 1,
|
||
fromToken: USDC[1],
|
||
fromAmount: 5,
|
||
});
|
||
```
|
||
|
||
## API
|
||
|
||
### `kibble(params): string`
|
||
|
||
构建一个 [Kibble](https://kibble.sh) 支付 URL。
|
||
|
||
| 参数 | 类型 | 是否必填 | 描述 |
|
||
|---|---|---|---|
|
||
| `toChain` | `number` | 是 | 目标链 ID |
|
||
| `toToken` | `string` | 是 | 目标链上的代币合约地址 |
|
||
| `toAddress` | `string` | 是 | 智能体的收款钱包地址 |
|
||
| `agentName` | `string` | 否 | 支付页面头部显示名称 |
|
||
| `toAmount` | `number \| string` | 否 | 以目标代币单位表示的固定金额 |
|
||
| `agentLogo` | `string` | 否 | 智能体头像图片 URL |
|
||
| `minAmountUSD` | `number` | 否 | 最低交易金额（USD） |
|
||
| `fromChain` | `number` | 否 | 预选来源链 ID（需与 `fromToken` 配对） |
|
||
| `fromToken` | `string` | 否 | 预选来源代币地址（需与 `fromChain` 配对） |
|
||
| `fromAmount` | `number \| string` | 否 | 以来源代币单位表示的发送数量 |
|
||
|
||
### 代币辅助工具
|
||
|
||
常用代币的预映射合约地址：
|
||
|
||
```typescript
|
||
import { USDC, USDT } from "kibble-pay";
|
||
|
||
USDC[8453] // Base USDC
|
||
USDC[42161] // Arbitrum USDC
|
||
USDT[1] // 以太坊 USDT
|
||
```
|
||
|
||
**USDC** — 以太坊 (1)、Optimism (10)、Polygon (137)、Base (8453)、Arbitrum (42161)、Avalanche (43114)、Scroll (534352)
|
||
|
||
**USDT** — 以太坊 (1)、Optimism (10)、Polygon (137)、Base (8453)、Arbitrum (42161)、Avalanche (43114)
|
||
|
||
## 教你的编程智能体使用
|
||
|
||
### Claude Code
|
||
|
||
```bash
|
||
npx skills add 0xJim/kibble
|
||
```
|
||
|
||
然后在 Claude Code 中使用 `/kibble-pay` 生成支付链接。
|
||
|
||
### 任意智能体
|
||
|
||
告诉你的 AI：
|
||
|
||
```
|
||
读取 https://kibble.sh/llms.txt 中的智能体技能文档并按照说明操作。帮我为智能体设置一个支付链接。
|
||
```
|
||
|
||
你的 AI 会处理其余一切——URL 构建、钱包参数、链选择。
|
||
|
||
## 许可证
|
||
|
||
MIT
|
||
|
||
## 作者
|
||
|
||
[Jimmy](https://x.com/0xJim) — [kibble.sh](https://kibble.sh) |