版本、安装与兼容性
协议版本、SDK 包、ABI、证明资源与服务 API 独立发布。接口能编译、版本号相同、测试通过和目标环境已部署是不同事实。
本文示例的适用范围
SDK 示例使用 1.3.2 接口。选择发行包时,确认它导出示例所需的方法,并提供匹配的 ABI 与证明资源;文档中的接口版本不代表所有包均已公开发布。
较早发行的 1.3.1 包不一定包含本文较新的能力。不要仅按 latest 选择版本,也不要据此推断其他语言存在对应 tag;以所选版本的导出接口与发行说明为准。
安装已核验的兼容版本
以下 shell 命令要求先把 SDK_VERSION 设置为已经确认存在、并包含所需接口的包版本,不要直接把文档版本填入。
: "${SDK_VERSION:?Set an available, compatible SDK version}"
npm install "@invisi-labs/sdk@$SDK_VERSION" "@invisi-labs/prover@$SDK_VERSION" "@invisi-labs/session@$SDK_VERSION" ethers
需要使用尚未公开发布的接口时,先取得提供该接口的受信发行包与匹配证明资源;不要依赖上面的命令自动取得未发布功能。Go 模块与 Rust crates 同样须核对实际可获得的 tag / 包。
兼容性清单
| 组件 | 固定的身份与配置 |
|---|---|
| Core | chain ID、实例地址、运行时代码身份、部署区块、ABI |
| SDK | 各语言实际版本与所需导出方法 |
| 本地 prover | Noir / BB 工具链、Core 认证目录、VK 与电路身份 |
| Provenance | 独立资源目录、可信 issuer / key 与 Source 能力 |
| Protocol RPC | API、索引的实例、原生最终性支持 |
| Broadcaster | 签名报价、执行模式、费用、定时能力与取消规则 |
| IPP / Facilitator | 消息版本、认证、支付方式与授信扩展能力 |
当前证明接口的资源要求使用 Noir / Noir JS 1.0.0 与 BB 6.0.0。Core 和 Provenance 使用独立认证资源集;二者的发布、下载与兼容性必须分别核对。资源缺失或哈希不符时停止,而不是回退到未知内容。
升级检查
先保留原部署、Store、操作日志和未完成任务的识别信息。在测试环境验证读取历史记录、恢复原操作、解析事件、生成证明和确认结果。旧部署使用其对应 ABI,不能用新事件布局直接解析历史版本。
SDK 或服务升级不会自动升级 Core 合约;服务返回的版本标签也不替代部署身份与代码检查。