# @canton-network/tool-conformance-cli 中文文档

规范地址：https://npmcn.com/package/%40canton-network/tool-conformance-cli/

版本：1\.2\.0
npm 元数据更新时间：2026-10-12T15:44:21.504Z
中文译文更新时间：2026-11-09T06:42:25.587Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40canton-network/tool-conformance-cli
原文对照：https://npmcn.com/package/%40canton-network/tool-conformance-cli/?lang=original
项目主页：https://github.com/canton-network/wallet/tree/main/tools/conformance-cli#readme
源码仓库：https://github.com/canton-network/wallet

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

- 包体积（解压后）：55.9 kB，21 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2026-09-30T15:06:39.226Z
- 最新版本发布：2026-10-12T15:44:21.313Z
- 近 30 天下载量：4640（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

用于CIP-103相容的CLI和Playwright吊带dApp

## 安装

```sh
npm install @canton-network/tool-conformance-cli
```

也可以使用：`pnpm add @canton-network/tool-conformance-cli`、`yarn add @canton-network/tool-conformance-cli`、`bun add @canton-network/tool-conformance-cli`

## README

# CIP-103 合规性CLI

对钱包运行 CIP-103 兼容套件,并导出可选签名的 CTRF 报告. 试验病例存在于 [符合度 dApp](https://npmcn.com/package/%40canton-network/conformance-dapp/README.md); 钱包自动化的勾钩 批准数量 [`@canton-network/core-provider-conformance`](https://npmcn.com/package/core/provider-conformance/README.md)。 。 。 .

## 快速启动

需要节点24或更新.

```sh
npm install @canton-network/tool-conformance-cli
npx conformance-cli serve
```

打开已打印的 URL( 默认) `http://127.0.0.1:8082`,选择提供者 包装并选择 **运行套件**。默认情况下,您必须执行每个 在钱包中请求动作,然后选择 **已完成的行动**下载 运行完成后报告.

使用一次性测试钱包和证书. 核准交易案件 建立真正的平合同, 所以分类账必须 `#canton-builtin-admin-workflow-ping:Canton.Internal.Ping:Ping` 可用.

## 无头/ CI

```sh
npx playwright install chromium
npx conformance-cli run --config conformance.config.json
```

失败或不完整 以代码 1 退出 。 见 `npx conformance-cli --help` 页:1 所有命令( e)`serve`, (中文(简体) ), `run`, (中文(简体) ), `sign`, (中文(简体) ), `verify`) (中文(简体) ).

## 配置

所有命令都读取通过的一个可选 JSON 配置文件 `--config`,有一个 每个命令。 从配置文件目录中解析相对路径 . 这个 `run.suite` 区域使用与浏览器应用程序配置相同的格式 编辑器; 见 `ConfigSchema` 内 [`src/config.ts`](https://npmcn.com/package/%40canton-network/conformance-dapp/src/config.ts) 所有选项.

```json
{
    "run": {
        "suite": {
            "provider": {
                "type": "remote",
                "url": "http://localhost:3030/api/v0/dapp"
            },
            "wrapper": { "type": "manual" },
            "disabledTests": []
        },
        "headed": true,
        "out": "./result.json",
        "signingKey": "./tester.pem"
    }
}
```

-   `provider.type`数字 : `picker` (交互式SDK钱包拾取器), `remote` (单位:千美元)`url`, (中文(简体) ), 或者说 `extension` (单位:千美元)`target`) (中文(简体) ). 使用 `remote` 或者说 `extension` 用于无人看管的运行.
-   `wrapper.type`数字 : `manual` (所需经费) `run.headed: true`, (中文(简体) ), `window`,或 `webhook` (单位:千美元)`url`) (中文(简体) ). 见 [核心提供者与遵守](https://npmcn.com/package/core/provider-conformance/README.md) 为何 钱包答案 `window`编号 :`webhook` 互动.
-   `run.extension`: 用于装入的无包装扩展的路径.

## 已签署的报告

报告可以使用 Ed25519 密钥文件签名 (`run.signingKey` 或 `sign` 命令)或带钱包(**用钱包签名** ),并与 `verify`。签名是脱开的:报告从未修改,另加一个 `<report>.sig` JSON文件带有算法,SHA-256报告摘要 文件、 十六进制摘要字符串上的签名和可选的签名元数据.

带有诊断材料下载的报告不在签名范围之内,可能 包含敏感数据.

## 发展

见 [`docs/CONTRIBUTING.md`](https://npmcn.com/package/docs/CONTRIBUTING.md) 环境设置.

```sh
pnpm exec nx run @canton-network/tool-conformance-cli:build
pnpm exec nx run @canton-network/tool-conformance-cli:test
```

## 常见问题

### @canton-network/tool-conformance-cli 是什么？

用于CIP-103相容的CLI和Playwright吊带dApp

### 如何安装 @canton-network/tool-conformance-cli？

在项目目录运行 npm install @canton-network/tool-conformance-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 conformance-cli，可以用 npx conformance-cli 直接运行。

### @canton-network/tool-conformance-cli 支持 TypeScript 吗？

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

### @canton-network/tool-conformance-cli 支持 ESM 还是 CommonJS？

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

### @canton-network/tool-conformance-cli 可以商用吗？

@canton-network/tool-conformance-cli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @canton-network/tool-conformance-cli 的下载量有多少？

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

### @canton-network/tool-conformance-cli 还在维护吗？

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