Protocol RPC
Protocol RPC 将公开链上事件索引为应用可查询的协议状态:普通 Note 输出、Credit 状态、树根、成员路径、注册资料和结算操作。它不接收交易,不持有钱包密钥,也不替应用解密或生成花费证明。
在系统中的位置
| 组件 | 负责的工作 |
|---|---|
| Chain RPC | EVM 区块、回执、合约读取与原生 safe/finalized 标签 |
| Protocol RPC | 按指定 Core 部署索引、组织和分页查询公开数据 |
| SDK / 钱包 | 本地检测、解密、重算承诺、授权、证明及私密库存 |
| Broadcaster | 可选的报价、验证和交易代发 |
Protocol RPC 不是通用 EVM 转发器。没有 eth_*、钱包签名、交易提交、WebSocket 或订阅接口。受限的 invisi_readChainState 仅提供允许的链读取,不授予任意 EVM 调用能力。
先绑定部署,再读取状态
API 路径版本 v1、Protocol 版本 1 和服务软件版本是不同概念。应用必须从可信配置取得 chain ID、Core 实例地址、运行时代码哈希及部署起始区块,随后与 invisi_getDeployment 对照。发现响应只列出当前活动路由,不能证明服务可信或索引已同步。
以下只读示例需要 POSIX shell 和 curl。先在环境中设置 PROTOCOL_RPC_BASE_URL 为运营者提供的服务根 URL(不含 /v1),CHAIN_ID 为规范十进制正整数。远程服务使用 HTTPS;示例不会提供或假定生产部署。
: "${PROTOCOL_RPC_BASE_URL:?Set the trusted service root URL}"
: "${CHAIN_ID:?Set the expected decimal chain ID}"
PROTOCOL_RPC_BASE_URL="${PROTOCOL_RPC_BASE_URL%/}"
PROTOCOL_RPC_URL="$PROTOCOL_RPC_BASE_URL/v1/chains/$CHAIN_ID"
curl --fail-with-body -sS "$PROTOCOL_RPC_BASE_URL/v1"
curl --fail-with-body -sS "$PROTOCOL_RPC_URL" \
-H 'Content-Type: application/json' \
--data '{"jsonrpc":"2.0","id":1,"method":"invisi_getDeployment","params":[]}'
curl --fail-with-body -sS "$PROTOCOL_RPC_URL" \
-H 'Content-Type: application/json' \
--data '{"jsonrpc":"2.0","id":2,"method":"invisi_getStatus","params":[]}'
检查 JSON-RPC error,即使 HTTP 为 200。对照部署后,分别记录 indexedHead 和 finality;索引头不等于最终确认头。尚无索引检查点时 indexedHead 可为 null,部署和版本查询仍可使用。
两种明确的信任选择
独立验证路径中,客户端通过独立 Chain RPC 认证规范区块与根,验证成员路径,并将输出与本地私密材料对应。RPC 的成员路径本身不证明你有花费权,也不证明输出未消费。
受信确认路径使用 invisi_getNote(commitment, {finality:"finalized"}) 或 safe。服务验证链上回执、规范区块、路径和根,返回 confirmed/pending 证据。应用此时明确依赖所选 Protocol RPC 及其上游;这不是独立轻客户端验证。受限链读取网关同样需要明确接受该信任。
两条路径都要求本地绑定预期承诺与业务订单,防止重复核销。null、未观察到输出和索引落后都不证明付款不存在。
普通 Note 与 Credit 不混用
普通 Note 表示资金输出;Credit 表示扣款授权状态。创建 Credit 通常不注入本金,扣款后产生新的 Credit 状态及一张普通收款 Note。Credit 消费标记和撤销位图是两个独立事实:未消费的状态仍可能已撤销。
恢复时本地解密公开密文并重算承诺。Credit 的日/月用量使用规范转换区块的 UTC 时间戳,不能使用浏览器本地日期。