跳到內容

使用 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 受理與入塊皆屬於待定狀態。僅當區塊完成最終確認且事件驗證通過時,交易才算執行成功。