跳到內容

原生餘額與資產

原生代幣 D9 由 Balances 模組管理(12 位精度);USDT、Energy 與 Bandwidth 等已登記資產由 Assets 模組管理(6 位精度)。

儲存 / 常數 回傳值
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) 資產名稱、符號與小數位數
呼叫 用途
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,
});
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,
});