# 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)