RPC 查询、分页与同步
本页使用服务概览中的部署绑定与 URL 配置。所有方法只读取所选链,没有跨链回退。
请求与数值编码
POST 到 /v1/chains/{chainId},发送 Content-Type: application/json。参数必须为位置数组;无参数方法使用 []。使用非空字符串或数字 id 匹配响应。
{"jsonrpc":"2.0","id":"status-1","method":"invisi_getStatus","params":[]}
地址为 20 字节 0x hex,哈希、承诺、根和 nullifier 为完整 32 字节 hex;不能用缩写整数。块号和树索引参数是 JSON 整数,链 ID 是十进制字符串。ABI uint256/uint64 事件值、结算操作中的整数使用十进制字符串。需要时使用保持整数精度的 JSON 解析器,避免 JavaScript Number 截断 uint64。
方法选择
表中参数为 params 的内容。range 的完整形状见下一节。
| 方法 | 参数 | 用途 |
|---|---|---|
invisi_getVersion / invisi_getDeployment / invisi_getStatus | [] | 版本、部署、索引与原生最终性 |
invisi_getBlock | [number] | 完整已索引区块批次,未索引时 null |
invisi_getEvents | [range] | 已解码协议事件 |
invisi_getRoots | [treeId] | 物理树根,最多 10,000 个,无游标 |
invisi_getMembership | [treeId,leafIndex,root] | 包含 anchor 和 16 个 siblings 的成员路径 |
invisi_getNote | [commitment,atBlock] | 普通 Note 和路径,或 null |
invisi_getNoteUpdates | [range] | 普通 Note 输出,返回 {blockHash,notes} |
invisi_getTransactionNoteUpdates | [transactionHash] | 某笔交易的普通 Note 输出及可用性 |
invisi_isNoteSpent | [nullifier,atBlock] | 普通 Note 消费状态 |
invisi_getCreditState | [commitment,atBlock] | Credit 状态和路径,或 null |
invisi_getCreditTransitions | [range] | Credit 转换事件 |
invisi_getTransactionCreditUpdates | [transactionHash] | 单笔交易的 states 与 transitions |
invisi_isCreditConsumed | [nullifier,atBlock] | Credit 状态消费标记 |
invisi_getCreditAllocation | [owner,token,atBlock] | 下一原始授信 shard / slot |
invisi_getCreditRevocationBitmap | [owner,token,shard,word,atBlock] | 原始授信撤销位图,shard 为正十进制字符串 |
invisi_getReceivingAddress | [ownerAddress] | 已注册查看公钥、clueKey、nonce 与区块,或 null |
invisi_getBroadcasters | [{enabled?,after?,limit?,block?}] | 固定快照的服务发现 |
invisi_getSettlementOperations / invisi_getProtocolTransactions | [{limit,fromBlock?,toBlock?,cursor?}] | 规范逻辑操作分页 |
invisi_getTransactionOperations | [transactionHash] | 单笔交易的操作与状态 |
invisi_readChainState | [{kind,...}] | 受限链读取网关 |
旧的 invisi_getUpdates、invisi_getTransactionUpdates、invisi_detectOutputs、invisi_isSpent 已移除。不要向服务发送 detection key。
按块同步与重组
range 为 {fromBlock:100,toBlock:110,blockHash:"完整的区块110哈希"};起止均包含,结束哈希必须匹配已索引 toBlock。先取得可信结束锚点,读取区间,完成本地处理后原子保存区块号、哈希及恢复进度。
单次最多 10,000 个区块,范围响应最多 8 MiB。事件数达到 10,000 会保守拒绝;Note 输出超过 10,000 会拒绝。超限返回错误而不静默截断。缩小区间;此接口没有范围续传游标。重新校验锚点失败时丢弃孤块派生数据,从仍可信的锚点恢复。
结算操作分页
以下只读续接示例需要 POSIX shell、curl,及完整链路由变量 PROTOCOL_RPC_URL。它读取当前索引快照下最多 20 个逻辑操作。
: "${PROTOCOL_RPC_URL:?Set the full trusted chain RPC URL}"
curl --fail-with-body -sS "$PROTOCOL_RPC_URL" \
-H 'Content-Type: application/json' \
--data '{"jsonrpc":"2.0","id":3,"method":"invisi_getSettlementOperations","params":[{"limit":20}]}'
返回 operations、snapshot、indexedHead 和可选 nextCursor。limit 必须为 1–100。后续传原样 cursor 和 limit,省略 fromBlock/toBlock;即使空页也必须继续,直到 nextCursor 缺失。每页有 16 区块、256 个相关回执的工作预算,因此页数不能由 limit 推算。
操作按 Note/Credit 分开提供输出及 nullifier。funding 是公开 gross 出资,不能直接当作收款净额;私密输出金额可缺失。invisi_getProtocolTransactions 也是逻辑操作页,展示交易行时按 txHash 分组。存在 unsupportedReason 的操作不能当成已认可结算;无 traces 无法完整发现所有间接回滚调用。
注册资料与网关
Broadcaster 分页 limit 默认为 100,最大 100。下一页将 next 原样作为 after,同时带上上页顶层 block 及相同 enabled 过滤器。记录的 block 是该记录最后更新时间,顶层 block 才是分页快照。注册和 enabled 不代表健康、信誉或支持任意 token。
invisi_readChainState 支持受限的 header、code、call、transaction、receipt 查询。只允许固定 Protocol/Registry 读取、指定 Protocol 模拟和受限 ERC20 方法;它既不提交交易,也不提供独立节点认证。使用匹配 SDK 的 TrustedProvider 适配器,勿将此接口当作任意 eth_call 转发器。