用途
bolthub-sdk 是 bolthub 已发布 SDK 包的源代码仓库。bolthub 定位为智能体与工具之间商业交易的支付层：开发者可以对自己的 MCP 工具和 API 按调用次数向智能体收费，资金通过比特币闪电网络（L402）直接结算到开发者自己的钱包，bolthub 本身不处于资金流转路径中。
该仓库是这一支付体系的开源一侧，包含工具支付 SDK、支付客户端、MCP 服务器、命令行工具（CLI）以及来源验证中间件。
主要能力与包结构
仓库覆盖所有公开发布的 bolthub.ai 包：npm 的 @bolthub/* 作用域，以及 PyPI 的 bolthub / bolthub-verify 包。
- packages/shared 为内部包，从不发布；它出现在此仓库是因为 @bolthub/mcp 会将其打包进去。
- 合并说明（2026-07）：@bolthub/agent 已并入 @bolthub/pay（≥0.4.0）；@bolthub/mcp-registry 与 @bolthub/mcp-bridge 已并入 @bolthub/mcp。旧名称在 npm 上已弃用并指向此处。
与 bolthub 平台的关系
bolthub 平台（网关、API、Web 应用）位于私有 monorepo 中。上述 SDK 包在那里开发，并同步到本仓库；本仓库是发布来源：发布在此打标签，由 CI 构建并发布，附带 npm provenance，因此 npm 上的内容可验证地由这份公开源码构建而来。
使用方式
- 每个 TypeScript 包在其目录下通过
bun run build构建；@bolthub/pay 必须先于打包它的包构建。 - 已发布的 dist/ 产物由 Bun 从本源码构建，附带内嵌源码的 source map，因此 tarball 本身可读。
- 关于信任模型（哪些部分会接触钱包凭据、哪些不会）以及漏洞报告方式，参见 SECURITY.md。
适用场景
适用于希望为 MCP 工具或 API 按调用收费、并通过闪电网络直接收款到钱包的开发者，以及需要支付客户端、MCP 服务器、CLI 或来源验证中间件的集成场景。
限制与注意事项
- 本仓库是生成式镜像：PR 不会被直接合并。被接受的改动会先应用到 monorepo（并注明贡献者），再随下一次发布同步出来。提交 PR 前请先阅读 CONTRIBUTING.md。
- 仓库欢迎 issue 和 PR，但合并流程如上所述。
- 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。
