跳转到内容

使用 Runtime Pallets

通过已配置的 RPC 端点读取链上存储与 Runtime API,并使用与当前 Runtime 匹配的元数据和描述文件构建交易。即使调用存在于元数据中,执行时仍可能因权限校验、账户限制或业务前置条件而失败。

任务 指南
查询余额,转账 D9 或已登记资产 原生余额与资产
登记多签账户并收集阈值批准 多签账户
进行 D9/USDT 兑换或管理 LP 份额 AMM 兑换与流动性
向商户支付、订阅服务或赎回积分 商户支付与积分
查询推荐关系、燃烧 D9、提取奖励或委托投票 推荐绑定、燃烧挖矿与投票

以下指南使用 Rust 侧的调用名称与参数签名。切勿手动传入 origin 参数——它由链上执行框架自动注入。实际 JavaScript/TypeScript 方法名与枚举结构请以生成的描述文件为准。

  1. 验证创世哈希并加载匹配的 Runtime 元数据,将相互关联的查询固定在同一最终确认区块。
  2. 检查余额、锁定状态与前置条件,估算手续费,并设置明确的滑点下限。
  3. 在唤起钱包确认前,向用户清晰展示发送账户、接收方、资产类型、金额、滑点上限与预估手续费。
  4. 按 交易与最终确认 流程完成签名与广播。
  5. 等待区块最终确认并解析对应事件。

保存交易哈希(Extrinsic Hash)、最终确认区块哈希与 Extrinsic 索引,使用对应区块的元数据解码 ApplyExtrinsic(index) 阶段下的 System::Events:

事件 处理方式
System::ExtrinsicSuccess 外层交易执行成功。
System::ExtrinsicFailed 使用对应元数据解码 DispatchError。手续费仍可能被扣除,状态回滚规则取决于具体调用。
Multisig::MultisigExecuted 检查其 result 字段,确认内部多签调用本身也执行成功。
Utility 批处理事件 逐项检查完成或中断事件;批处理可能部分成功后再失败。
D9Merchant::AutoRedemptionDeferred 可选的自动赎回已延后,请单独核对支付流程中的其余事件。

钱包签名、RPC 受理与入块均属于待定状态。仅当区块完成最终确认且事件校验通过时,交易才算执行成功。