跳转到内容

RPC 与 Runtime API

查找所需的 JSON-RPC 方法或 SCALE Runtime API,并在完成RPC 验证的端点上调用。

方法 参数 返回值
system_chain [] 链名称
system_properties [] 代币精度与 SS58 地址格式
chain_getBlockHash [0] 创世区块哈希
chain_getFinalizedHead [] 最新最终确认区块哈希
state_getRuntimeVersion [] 或 [at] Runtime、交易与 Runtime API 版本
state_getMetadata [] 或 [at] SCALE 编码的 Runtime 元数据
state_getStorage [key, at?] 指定编码键对应的 SCALE 存储值
state_call [function, encodedInput, at?] SCALE 编码的 Runtime API 返回值
system_accountNextIndex [address] 下一个账户 Nonce(含当前节点待处理交易池)
payment_queryInfo [encodedExtrinsic, at?] 执行权重信息与预估手续费
  • 交易载荷或链上状态变化后须重新估算手续费;估算结果仅对该笔编码交易及当前区块有效。
  • system_accountNextIndex 仅反映所查询节点的交易池状态。并发发送多笔交易时,请在客户端自行协调 Nonce。
  1. 先调用 state_getRuntimeVersion 与 state_getMetadata,确认当前 Runtime 已导出目标 API。
  2. 使用匹配的描述文件对输入参数进行 SCALE 编码,切勿直接传入 JSON 字符串。
  3. 以 [function, encodedInput, at?] 调用 state_call。
  4. 对返回的字节进行 SCALE 解码。
state_call 函数 SCALE 输入 SCALE 输出
UserPortfolioApi_get_user_portfolio AccountId UserPortfolio<AccountId, Balance>
UserPortfolioApi_get_merchant_redemption_quote AccountId Option<MerchantRedemptionQuote<Balance>>
NodeRegistryApi_get_node_profile AccountId Option<NodeProfile<AccountId>>
NodeRegistryApi_get_all_candidate_profiles () Vec<NodeProfile<AccountId>>
返回结构 包含字段 注意事项
资产组合(Portfolio) 原生可用余额、资产余额、燃烧挖矿记录、投票权益、商户记录、推荐信息、LP 份额 原生 free 余额不等于可转账余额;详见原生余额与资产。
商户赎回报价 基础与关系积分、可赎回积分、USDT 价值、可选的预估 D9、cooldown_remaining_ms 冷却期单位为毫秒而非区块数。请区分 None、缺失 D9 预估值与零报价。链上执行时会重新校验资格与 min_d9_out;详见商户支付与积分。
节点档案 生命周期阶段、候选人与验证人状态、得票数、在线活跃度 –