跳到內容

完整交易生命週期

建立、簽署、廣播原生 D9 轉帳交易,並等待區塊最終確認。

前置條件: 已安裝 polkadot-api@3.3.0 並產生 d9 描述檔(參閱 RPC 驗證),以及讀取鏈上資料中的 src/amount.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();
}
}
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。