原生餘額與資產
原生代幣 D9 由 Balances 模組管理(12 位精度);USDT、Energy 與 Bandwidth 等已登記資產由 Assets 模組管理(6 位精度)。
查詢可轉出餘額
Section titled “查詢可轉出餘額”| 儲存 / 常數 | 回傳值 |
|---|---|
System::Account(account) |
帳戶餘額資料、Nonce 與參考計數 |
Balances::Holds(account) |
具名鎖定(Holds)餘額 |
Balances::Freezes(account) |
凍結(不可轉出)餘額 |
Balances::ExistentialDeposit |
存活押金:1,000,000 最小單位(0.000001 D9) |
Assets::Account(asset_id, account) |
指定資產的帳戶餘額與狀態 |
Assets::Metadata(asset_id) |
資產名稱、符號與小數位數 |
1. 轉帳原生 D9
Section titled “1. 轉帳原生 D9”| 呼叫 | 用途 |
|---|---|
Balances::transfer_keep_alive(dest, value) |
常規轉帳;若發送方剩餘餘額低於存活押金則拒絕執行。 |
Balances::transfer_allow_death(dest, value) |
允許發送方餘額低於存活押金並回收帳戶的轉帳。 |
Balances::transfer_all(dest, keep_alive) |
轉出全部可轉餘額;keep_alive 控制是否保留發送方帳戶存活。 |
value 須以最小單位傳入(金額 × 1012):
// 2.5 D9 = 2500000000000 最小單位const tx = chain.api.tx.Balances.transfer_keep_alive({ dest: { type: "Id", value: recipientAddress }, value: 2500000000000n,});2. 轉帳已登記資產(USDT)
Section titled “2. 轉帳已登記資產(USDT)”Assets::transfer(id, target, amount)Assets::transfer_keep_alive(id, target, amount)從 Assets::Metadata(id) 讀取 decimals 並將 amount 換算為最小單位。USDT 資產 ID 為 1,精度為 6 位小數:
// 10 USDT(資產 ID 1,6 位小數)const tx = chain.api.tx.Assets.transfer_keep_alive({ id: 1, target: { type: "Id", value: recipientAddress }, amount: 10000000n,});