跳到主要内容

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 转发器。