完整交易生命週期
建立、簽署、廣播原生 D9 轉帳交易,並等待區塊最終確認。
前置條件: 已安裝 polkadot-api@3.3.0 並產生 d9 描述檔(參閱 RPC 驗證),以及讀取鏈上資料中的 src/amount.ts。
1. 建立 src/transfer.ts
Section titled “1. 建立 src/transfer.ts”import { createClient } from "polkadot-api";import { getWsProvider } from "polkadot-api/ws";import { d9, getMetadata } from "@polkadot-api/descriptors";import type { D9ConnectorAccount } from "@d9-network/dapp-connector";import { toChainAddress } from "@d9-network/dapp-connector/protocol";import { parseAmount } from "./amount";import { d9Config } from "./config";
export async function executeInjectedTransfer( account: D9ConnectorAccount, recipientAddress: string, d9AmountString: string, getCurrentAccount: () => Promise<D9ConnectorAccount | undefined>,) { if (account.transport !== "papi" || !account.txCreator) { throw new Error("此操作需要包含有效 txCreator 的注入式錢包帳戶"); } const txCreator = account.txCreator; const recipient = toChainAddress(recipientAddress); const rawValue = parseAmount(d9AmountString, 12); if (rawValue <= 0n) throw new Error("轉帳金額必須大於零");
const assertAuthority = async () => { const current = await getCurrentAccount(); if (current?.transport !== "papi" || current.address !== account.address || current.txCreator !== txCreator) { throw new Error("廣播前帳戶授權狀態已變更"); } };
const client = createClient(getWsProvider(d9Config.rpcUrl), { getMetadata }); try { const identity = await client.getChainSpecData(); if (identity.genesisHash !== d9Config.expectedGenesisHash) { throw new Error("RPC 創世雜湊與設定不相符"); } // 使用已產生的主網描述檔建立交易 const api = client.getTypedApi(d9); const tx = api.tx.Balances.transfer_keep_alive({ dest: { type: "Id", value: recipient }, value: rawValue, });
await assertAuthority(); // 由錢包完成簽署並回傳已簽署交易位元組 const signedTx = await tx.create(txCreator); // 廣播前再次核對目前帳戶授權狀態 await assertAuthority(); const result = await client.submit(signedTx); if (!result.ok) { throw new Error(`鏈上交易執行失敗: ${JSON.stringify(result.dispatchError)}`); } return result; } finally { client.destroy(); }}2. 呼叫轉帳函式
Section titled “2. 呼叫轉帳函式”const result = await executeInjectedTransfer(account, recipientAddress, "1.25", getCurrentAccount);account須為目前啟用的注入式帳戶(transport: "papi")。getCurrentAccount每次呼叫皆須即時讀取最新的已授權帳戶狀態,切勿回傳快取副本,否則無法偵測簽署期間的帳戶切換。
client.submit 會等待區塊最終確認。回傳時若 result.ok 為 true,result.block.hash 即為最終確認的區塊雜湊。
| 錯誤訊息 | 處理方式 |
|---|---|
此操作需要包含有效 txCreator 的注入式錢包帳戶 |
請在 D9 錢包內建瀏覽器中開啟頁面並透過注入式提供者連線。 |
RPC 創世雜湊與設定不相符 |
將 VITE_D9_RPC_URL 指向與 VITE_D9_GENESIS_HASH 一致的網路節點。 |
廣播前帳戶授權狀態已變更 |
使用者在簽署期間切換或中斷了帳戶,請提示使用者重新操作。 |
鏈上交易執行失敗: … |
鏈上拒絕了該筆轉帳,請查看錯誤訊息中的 dispatchError。 |
