CIP-103 合规性CLI

对钱包运行 CIP-103 兼容套件,并导出可选签名的 CTRF 报告. 试验病例存在于 符合度 dApp; 钱包自动化的勾钩 批准数量 @canton-network/core-provider-conformance。 。 。 .

快速启动

需要节点24或更新.

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

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 所有选项.

{
    "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) (中文(简体) ). 见 核心提供者与遵守 为何 钱包答案 window编号 :webhook 互动.
• run.extension: 用于装入的无包装扩展的路径.

已签署的报告

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

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

发展

见 docs/CONTRIBUTING.md 环境设置.

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