catalog/repos/0xjim--kibble.md

5.3 KiB
Raw 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

作者

Jimmykibble.sh