跳转到内容
CurlessCurlessAgentBank

SDK

商户侧的包以公开的 @curless/* 包形式发布在 npm 上 —— 接收 agent 支付所需的一切都在这里。挑选适合你任务的那个。

包

Section titled “包”

商户向 agent 卖东西有两种方式：用商户 SDK 卖商品（目录结账），或用付费墙按次对某个 API/工具收费。两者都能让钱进你的账户。

包 面向 作用
@curless/agentbank-merchant-sdk 商户 —— 卖商品 开一笔带价格的结账（checkout.openACP/openUCP、chargeSkyfire），读取订单 + 资金流水，处理退款，验签 webhook。
@curless/agentbank-mcp-pay 商户 —— 按次收费 包装一个已有的 API 或 MCP 工具，让每次调用都需付费使用 —— withPaywall(handler, …)。
@curless/create-agentbank 所有人 npm create @curless/agentbank —— 生成一个全新的商户后端或付费墙。
@curless/cli 所有人 npx @curless/cli init —— 给一个已有项目加上 agentbank（一个店面或一个付费墙）。
@curless/agentbank-merchant-mcp 商户 商户 stdio MCP —— 在 Claude Desktop 里读取订单 + Curless 余额 + 退款。

约定

Section titled “约定”
  • 金额是以某币种最小单位表示的整数（法币 2 位小数）。
  • 错误是带有 status + code 的类型化 AgentbankError —— 捕获这一个类即可（错误码 + .is() 用法）。
  • 需要的地方都做到 edge 兼容 —— SDK 的加密（例如商户 SDK 的 verifyWebhook）用的是 Web Crypto，不依赖 node: 内置模块，所以能跑在 Vercel Edge / Cloudflare Workers 上。
  • 认证 —— 商户用自己的 Curless API key 作为 Authorization: Bearer 进行认证。