# 账户资源管理

在链上发送交易都会消耗gas资源,除了免费的gas资源,您还可以锁定TOP兑换更多gas资源。

resource命令如下表所示。

命令 说明
topio resource stakeForGas 锁定TOP token兑换gas。
topio resource withdrawFund 解锁兑换gas的TOP token。

# 锁定TOP token兑换gas

兑换gas的汇率为:

Snap55

此兑换率随着系统中锁定的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失败。