跳到主要内容

版本、安装与兼容性

协议版本、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 / 包。

兼容性清单​

组件固定的身份与配置
Corechain ID、实例地址、运行时代码身份、部署区块、ABI
SDK各语言实际版本与所需导出方法
本地 proverNoir / BB 工具链、Core 认证目录、VK 与电路身份
Provenance独立资源目录、可信 issuer / key 与 Source 能力
Protocol RPCAPI、索引的实例、原生最终性支持
Broadcaster签名报价、执行模式、费用、定时能力与取消规则
IPP / Facilitator消息版本、认证、支付方式与授信扩展能力

当前证明接口的资源要求使用 Noir / Noir JS 1.0.0 与 BB 6.0.0。Core 和 Provenance 使用独立认证资源集;二者的发布、下载与兼容性必须分别核对。资源缺失或哈希不符时停止,而不是回退到未知内容。

升级检查​

先保留原部署、Store、操作日志和未完成任务的识别信息。在测试环境验证读取历史记录、恢复原操作、解析事件、生成证明和确认结果。旧部署使用其对应 ABI,不能用新事件布局直接解析历史版本。

SDK 或服务升级不会自动升级 Core 合约;服务返回的版本标签也不替代部署身份与代码检查。