# @agenticprimitives/payments 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/payments/

版本：0\.0\.0-alpha\.42
npm 元数据更新时间：2026-10-26T11:49:51.294Z
中文译文更新时间：2026-11-06T05:51:12.424Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agenticprimitives/payments
原文对照：https://npmcn.com/package/%40agenticprimitives/payments/?lang=original
项目主页：https://agenticprimitives.dev/
源码仓库：https://github.com/agentictrustlabs/agenticprimitives

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：235 kB，88 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：viem ^2\.52\.2
- 首次发布：2026-06-11T05:00:05.772Z
- 最新版本发布：2026-10-26T11:49:46.366Z
- 近 30 天下载量：4644（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 40 个）

## 中文简介

支付任务 + 上下文 + 任务约束 + 打开/关闭模式歧视. 三道W1铁路(x402,钱包,被担保-使用). 根据ADR-0023, 付款回扣被确认为验资登记.

## 安装

```sh
npm install @agenticprimitives/payments
```

也可以使用：`pnpm add @agenticprimitives/payments`、`yarn add @agenticprimitives/payments`、`bun add @agenticprimitives/payments`

## README

# @ agenticprimitives/ 支付

> 部分 **[代理先导](https://agenticprimitives.dev/)** ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. [开发者工具包](https://github.com/agentictrustlabs/agentic-primitives) • 妇女 [所有软件包](https://agenticprimitives.dev/developers)

> **现况:STUB** (Wave 0.5 of the W1执行浪潮). 今天的原始和无常卫士舰艇;EIP-712任务签注和三道W1铁路在波6中着陆 [w1 执行波计划](https://npmcn.com/package/docs/architecture/w1-implementation-wave-plan.md)最近,有一个自我审计者标出该软件包的文档,称其为过量([新的PMT - (英语) 1个](https://npmcn.com/package/docs/audits/findings.yaml)); 这个 README 是写到实际表面的.

机器支付款到了. x402使HTTP-本土的按需付费成为真实;Google的AP2定义了代理启动支出的任务. 无论是船舶还是无人驾驶的船舶,都属于机器付款的范围 _不变_ 授权、保管和审计基础 管理代理人的其他一切 "这名代理商可能为了这一任务在这条铁路上花费了最高的金额,直到星期五——由智能账户签字,捆绑在它所支付的工作上,收到一个证明登记簿"是代理经济实际需要的组合,它只有在付款是一层系统而非螺栓式铁路时才存在.

这个包裹是该基底设计的支付片段——脊椎层9b `PaymentMandate` ——全取出,现为脚手架,起落于执行波.

部分 [代理原始产品](https://npmcn.com/package/README.md) ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.

## 今天的什么战舰

被打的原始人和纯粹的无常的守卫——没有签名,没有执行,没有金钱动作:

-   **`PaymentMandate` 类型** - 付款人、收款人、赠款人、铁路, `AmountPolicy` (准确/范围/公式), `maxRedemptions`,有效性窗口, `mode`,可选 `delegationRef` 将任务与授权它的代表团联系起来.
-   **`ContextBinding` + 键 `assertContextBindingValid`** ——PMT-3.1执行:每项任务必须至少遵守一项意图/协议/任务/文物/HTTP资源。 无上下文花.
-   **`MandateConstraints`** ——AP2对接的集合范围:相加盖,赎回频率窗口,类别允许/拒绝,地圈.
-   **开放/封闭模式歧视+ `assertClosedMandateInvariants`** ——PMT-INV-14被执行:结束(最后收费)任务总是一发.
-   **`computeMandateId`** ——定型克卡克-256任务身份凌驾于支付者+非ce+铁路+链.
-   **`PaymentRailExecutor` 接口 + `registerRail` 编号 : `getRail`** ——每条铁路(目前和今后,包括保留下来的保密家庭)的延长站.

## 第六波中哪些土地(设计,未发运)

EIP-712打入数据构建器,SA签名和ERC-1271验证(没有原始EOA签名-PMT-INV-12), `redeemPaymentMandate`,和三道W1铁路: `rails/wallet` (通过UserOp进行SA-to-SA传输), `rails/x402` (每名HTTP-本地人员) [x402.org (英语)](https://www.x402.org/) + 参考主持人) `rails/sponsored-userop` (付费主赞助,无价值移动). 加号 `PaymentReceipt` - 在证明书登记册上申明的不可撤销、不可撤销的证书 [ADR-0023 (英语)](https://npmcn.com/package/docs/architecture/decisions/0023-attestation-registry-eas-aligned-bilateral-consent.md)所以每个救赎都留下头等证据 保密铁道(Aztec-style,Zcash-style,ZK Paymasters)是一个保留的W2分模块家族.

## 标题/市场背景

-   **x402 (韩语)** 证明HTTP-内燃机支付;它是我们三个W1铁路之一,而不是竞争对手.
-   **Google AP2 (英语)** 界定代理人开支的授权语义; `MandateConstraints` 是有意的AP2相通 所以底片会说新兴语言.
-   空档期为: x402 和 AP2 授权 a _付款_既非基于有监管政策、可撤销的委托链条以及背后的审计线索。 授权范围的机器付款——授权参考代表团、代表团参考智能特工,每一个步骤都收到——是这一层的组合.

**权威规格 :** [第243类——付款](https://npmcn.com/package/specs/243-payments.md) (见 [`spec.md`](https://npmcn.com/package/%40agenticprimitives/payments/spec.md)) (中文(简体) ). 拥有脊椎第9b层;有界地表 `CLAUDE.md` 财务报告和审定财务报表 `capability.manifest.json`。 。 。 .

## 构建

```bash
pnpm --filter @agenticprimitives/payments typecheck
pnpm --filter @agenticprimitives/payments test
pnpm --filter @agenticprimitives/payments build
```

## 状态——诚实版

苏布。 这里没有任何东西今天签下或结清一笔付款;将铁路和EIP-712表面视为具体承诺。 审计发现,这一包的文档曾再次提出过索赔([新的PMT - (英语) 1个](https://npmcn.com/package/docs/audits/findings.yaml)透明度是关键所在。 波浪顺序 : [w1-执行-波-计划.md](https://npmcn.com/package/docs/architecture/w1-implementation-wave-plan.md)。 。 。 .

## 常见问题

### @agenticprimitives/payments 是什么？

支付任务 \+ 上下文 \+ 任务约束 \+ 打开/关闭模式歧视\. 三道W1铁路\(x402,钱包,被担保-使用\)\. 根据ADR-0023, 付款回扣被确认为验资登记\.

### 如何安装 @agenticprimitives/payments？

在项目目录运行 npm install @agenticprimitives/payments，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：viem（^2\.52\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agenticprimitives/payments 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agenticprimitives/payments 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @agenticprimitives/payments 可以商用吗？

@agenticprimitives/payments 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agenticprimitives/payments 的下载量有多少？

根据 npm 官方下载统计，@agenticprimitives/payments 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,644 次，日均约 155 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agenticprimitives/payments 还在维护吗？

最新版本 0\.0\.0-alpha\.42 发布于 2026/10/26（12 天前）；至今共发布 40 个版本，其中过去 12 个月发布了 40 个；首次发布于 2026/06/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。