原生余额与资产
原生代币 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,});