midnight-rpc

用途：Midnight RPC 是 Midnight 节点的远程过程调用层，让 dApp、钱包、区块浏览器及后端服务通过 HTTP/HTTPS 或 WebSocket 与运行中的节点交互，遵循 JSON-RPC 标准。它支持提交交易（状态转换）、查询链上合约状态、获取辅助数据（链下值、元数据）。主要能力：核心方法包括 midnight_jsonContractState（JSON 编码的合约状态）、midnight_contractState（某区块的原始二进制合约状态）、midnight_unclaimedAmount（受益人未领取代币/奖励）、midnight_zswapChainState（合约的 ZSwap 链状态）、midnight_apiVersions（支持的 RPC API 版本）、midnight_ledgerVersion（某区块的账本版本）。多数方法接受可选的 at 区块哈希参数，省略则使用最新区块。此外还暴露 Polkadot SDK 默认方法，如 system_health、chain_getBlock、state_getStorage、rpc_methods（列出全部支持端点）。Partnerchain RPC 面向区块生产者与侧链集成，用于查询共识信号、中继最终性信息、协调跨链操作。使用方式：客户端通过 HTTP/HTTPS 或 WSS 连接节点并调用上述方法；可先调用 rpc_methods 获取节点实际支持的方法列表。限制与注意事项：并非所有 RPC 方法都适合在公开或生产节点暴露；运行出块节点时应使用 --rpc-methods Safe，避免 --rpc-external（除非确有需要），并将暴露端点限制在与运行角色匹配的范围内。部分 Midnight RPC 方法可能不在 Polkadot JS Apps 中显示，支持情况随节点版本与配置而异。应用层读取方面，许多 dApp 更倾向使用 Indexer GraphQL API。相关技能包括 midnight-onchain-logic、midnight-indexer、midnight-transactions。