# 转账

本章介绍如何将TOP token从一个账户发送到另外一个账户。

请求方式

topio transfer

请求参数

参数名称 是否必选 默认值 类型 说明
account_addr - String 转账目标账户地址,为普通账户或者合约账户。
top_num - Double 转账金额,单位:TOP。转账金额需>0。
note 空字符串 String 转账备注,不超过128字符。

选项

选项名称 默认值 类型 说明
-t, --tx_deposit 0.1 Double 交易保证金,最低、默认都为0.1 TOP。
-h, --help - - 查看命令帮助信息。

返回参数

参数名称 类型 说明
Transaction hash String 本次交易hash,可用于查询交易结果。

请求样例

topio transfer T800002276a7d58218ac4978733e5cca927a7d86cb7c87 20

返回样例

返回交易hash,通过topio querytxtopio chain queryAccount查询交易是否成功以及账户余额是否有相应变化从而判断转账是否成功。

  • 成功返回
Transaction hash: 0x461cd0c9abe808c4f0ab1bd4b540ea35d72d741c56c52856a3bff06678b7ce72
Please use command 'topio querytx' to query transaction status later on!!!

例如:转账账户原来有10000TOP余额,给另外一个账户转账20TOP。

发起转账命令后,使用topio chain queryAccount查询账户信息,账户余额减少20TOP。

根据交易hash,使用topio querytx查询此次交易,最终共识成功。

  • 失败返回

交易失败的情况下,同样返回交易hash。

Transaction hash: 0x9f31fb199cc710a22d83c09d08eb79488610af03a5ed362cab26339ab1aa1cf5
Please use command 'topio querytx' to query transaction status later on!!!

根据交易hash,使用topio querytx查询交易,最终共识失败,使用topio chain queryAccount查询账户,余额无变化,则转账失败。