# 账户资源管理
在链上发送交易都会消耗gas资源,除了免费的gas资源,您还可以锁定TOP兑换更多gas资源。
resource命令如下表所示。
命令 | 说明 |
---|---|
topio resource stakeForGas | 锁定TOP token兑换gas。 |
topio resource withdrawFund | 解锁兑换gas的TOP token。 |
# 锁定TOP token兑换gas
兑换gas的汇率为:
此兑换率随着系统中锁定的TOP tokens变化而变化。
一个普通账户24小时内可以获得的gas不超过200,000Tgas,大约可以发起800条交易。
一个合约账户24小时内可以获得的gas不超过10,000,000Tgas,大约可以执行4万条交易,使用4秒CPU。
账户24小时内最多可兑换的gas=24小时内可以获得的gas上限-24小时内免费gas。
请求方式
topio resource stakeForGas
请求参数
参数名称 | 是否必选 | 默认值 | 类型 | 说明 |
---|---|---|---|---|
top_num | 是 | - | Double | 兑换gas锁定的TOP token金额,单位TOP。 |
选项
选项名称 | 默认值 | 类型 | 说明 |
---|---|---|---|
-h, --help | - | - | 查看命令帮助信息。 |
返回参数
参数名称 | 类型 | 说明 |
---|---|---|
Transaction hash | String | 本次交易hash,可用于查询交易结果。 |
请求样例
锁定1000 TOP兑换gas。
topio resource stakeForGas 1000
返回样例
- 成功返回
Transaction hash: 0x16f7ba7580fd23b1c900323937b099c9e73c5d14df787c58de8f4388820ff1ba
Please use command 'topio querytx' to query transaction status later on!!!
根据交易hash,使用topio chain queryAccount
查询交易,最终共识成功,使用topio chain queryAccount
查看账户"total_gas"、"available_gas"有相应变化,则兑换gas成功。
- 失败返回
将账户余额全部锁定获取gas,返回:
Transaction hash: 0xf7d951259032e9797d91a6a7d9590a845673da03a54e54fa776c2fec85afec06
Please use command 'topio querytx' to query transaction status later on!!!
根据交易hash,使用topio chain queryAccount
查询交易,最终共识失败。
# 解锁兑换gas的TOP token
发起解锁后,需要等待24小时,并由锁定账户发起一笔交易后,解锁的金额才会到账。
解锁规则:
按照解锁的TOP占锁定TOP的比例,从账户中释放相应的gas。例如锁定1200TOP兑换了1500Tgas,解锁400TOP,占总锁定TOP的1/3,相应地,释放总gas的1/3,即500Tgas。
请求方式
topio resource withdrawFund
请求参数
参数名称 | 是否必选 | 默认值 | 类型 | 说明 |
---|---|---|---|---|
top_num | 是 | - | Double | 解锁的TOP token金额,单位TOP。 |
选项
选项名称 | 默认值 | 类型 | 说明 |
---|---|---|---|
-h, --help | - | - | 查看命令帮助信息。 |
返回参数
参数名称 | 类型 | 说明 |
---|---|---|
Transaction hash | String | 本次交易hash,可用于查询交易结果。 |
请求样例
解锁兑换gas的1000 TOP。
topio resource withdrawFund 1000
返回样例
- 成功返回
Transaction hash: 0xb83f304a26d2ffe6a3b59eb01fd5269218367481c55b4ec15d60abdc6129380d
Please use command 'topio querytx' to query transaction status later on!!!
根据交易hash,使用topio chain queryAccount
查询交易,最终共识成功,使用topio chain queryAccount
查看账户"available_gas"有相应变化,则成功解锁TOP token。
- 失败返回
同样返回交易hash和交易大小,根据交易hash,使用topio chain queryAccount
查询交易,最终共识失败,则解锁TOP token失败。