mc-skills/catalog

Fork 0

mc-skills c8e8049202 catalog: 更新 2026-04-06 19:01

2026-04-06 19:01:37 +08:00

5.3 KiB

Raw Permalink Blame History

AI智能体跨链支付URL

跨链支付 AI智能体 区块链 Web3 加密货币

kibble-pay

为 AI 智能体钱包提供跨链支付 URL。一个函数，一个 URL，支持任意链。

工作原理

你的智能体需要资金——也许它运行在 Base 链上使用 USDC，但为其充值的用户持有的是 Solana 上的 SOL。这不应该成为障碍。

Kibble 为你的智能体提供一个统一的 URL。用户打开后，连接任意钱包，选择手中持有的任意代币，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 文档。

支付页面工作方式

服务器在渲染任何内容之前会验证所有参数——无效参数会重定向到带有具体原因的错误页面，有效参数则渲染双栏布局。

左侧展示智能体头部信息，包括品牌标识、目标链、请求金额和已锁定的钱包地址。右侧，LI.FI 组件处理来源选择、路由和交易签名，组件配置中已禁用目标字段，防止用户修改。

OG 元标签在服务端渲染，因此当你的智能体在 Telegram 或 Discord 中分享 Kibble 链接时，预览卡片会显示智能体名称和支付上下文，而非普通 URL。

安装

npm install kibble-pay

使用方法

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 支付 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`	否	以来源代币单位表示的发送数量

代币辅助工具

常用代币的预映射合约地址：

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

npx skills add 0xJim/kibble

然后在 Claude Code 中使用 /kibble-pay 生成支付链接。

任意智能体

告诉你的 AI：

读取 https://kibble.sh/llms.txt 中的智能体技能文档并按照说明操作。帮我为智能体设置一个支付链接。

你的 AI 会处理其余一切——URL 构建、钱包参数、链选择。

许可证

MIT

作者

Jimmy — kibble.sh

5.3 KiB Raw Permalink Blame History Unescape Escape