跳转到内容

原生余额与资产

原生代币 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,
});