Stable Docs | Stable Architecture & Integration Guide

概述

Stable SDK 中的 x/bank 模块仅提供基本的代币管理功能。每个代币都可以无限制地转移到任何账户，用户无法委托其他账户代为转移其代币到其他账户。因此，bank 预编译合约在 Stable SDK 现有的 x/bank 模块基础上提供了额外的授权和委托功能。

概念

该预编译合约提供 ERC20 标准方法 - 如用于转账的 transfer 和 balanceOf，以及用于委托的 transferFrom、approve 和 allowance。这些方法可以直接调用，无需注册合约地址。然而，mint 和 burn 方法需要合约地址被列入白名单，通过 x/precompile 模块注册。

func (p *Precompile) mint(
  ctx sdk.Context,
  contract *vm.Contract,
  denom string,
  method *abi.Method,
  stateDB vm.StateDB,
  args []interface{},
) ([]byte, error) {
  // ...

  // mint method is only allowed for the registered caller contract
  if _, err := precompilecommon.CheckPermissions(ctx, p.precompileKeeper, contract.CallerAddress, CallerPermissions); err != nil {
    return nil, err
  }

额外的验证过程可以保证调用此预编译合约的代币合约是经过授权的。需要通过治理提案来注册代币合约地址及其denomination到 x/precompile 模块的白名单中。

配置

合约地址和gas费用已预定义。

合约地址

“0x0000000000000000000000000000000000001000” 用于gas代币
“0x0000000000000000000000000000000000001003” 用于治理代币

方法

`mint`

铸造请求数量的新代币并转移到账户。要铸造的代币数量必须大于零。当代币成功铸造并转移到账户时，会发出 PrecompiledBankMint 事件。注意：

禁止铸造治理代币。
调用铸造方法的合约必须在 x/precompile 模块中注册。

输入参数

名称	类型	描述
to	address	接收铸造代币的地址
amount	uint256	要铸造的代币数量

输出参数

名称	类型	描述
success	bool	如果代币成功铸造并转移到账户，则为true

`burn`

从账户中销毁请求数量的代币。要销毁的代币数量必须大于零。当代币成功销毁时，会发出 PrecompiledBankBurn 事件。注意：

禁止销毁治理代币。
调用铸造方法的合约必须在 x/precompile 模块中注册。

输入参数

名称	类型	描述
from	address	销毁代币的地址
amount	uint256	要销毁的代币数量

输出参数

名称	类型	描述
success	bool	如果代币成功销毁，则为true

`transfer`

将请求数量的代币从发送者转移给接收者。代币必须设置为可发送。要转移的代币数量必须大于零。当代币成功转移时，会发出 PrecompiledBankTransfer 事件。

输入参数

名称	类型	描述
to	address	接收代币的地址
amount	uint256	要转移的代币数量

输出参数

名称	类型	描述
success	bool	如果代币成功转移，则为true

`transferFrom`

由授权的支出者在允许额度范围内将请求数量的代币从所有者转移给接收者。代币必须设置为可发送。要转移的代币数量必须大于零并且小于或等于当前允许额度。当代币成功转移时，会发出 PrecompiledBankTransfer 事件。

输入参数

名称	类型	描述
from	address	转出代币的地址
to	address	接收代币的地址
amount	uint256	要转移的代币数量

输出参数

名称	类型	描述
success	bool	如果代币成功转移，则为true

`multiTransfer`

将代币从单个账户转移到多个账户。代币必须设置为可发送。转移给每个接收者的代币数量必须大于零。当代币成功转移时，每个接收者都会发出 PrecompiledBankTransfer 事件。

输入参数

名称	类型	描述
to	address[]	接收转移代币的地址数组
amount	uint256[]	转移给每个接收者的代币数量

输出参数

名称	类型	描述
success	bool	如果代币成功转移给每个接收者，则为true

`approve`

授权支出者从所有者账户转移代币。要授权的代币数量必须大于零。当授权成功设置时，会发出 PrecompiledBankApproval 事件。

输入参数

名称	类型	描述
spender	address	要授权的地址
value	uint256	要授权的代币数量

输出参数

名称	类型	描述
success	bool	如果授权成功设置，则为true

`revoke`

撤销支出者从所有者转移代币的授权。当授权成功撤销时，会发出 PrecompiledBankRevoke 事件。

输入参数

名称	类型	描述
spender	address	要撤销的地址

输出参数

名称	类型	描述
success	bool	如果授权成功撤销，则为true

`balanceOf`

返回账户的代币余额。

输入参数

名称	类型	描述
account	address	要获取代币余额的地址

输出参数

名称	类型	描述
balance	uint256	账户中的代币数量

`totalSupply`

返回代币的总供应量。

输入参数

无

输出参数

名称	类型	描述
totalSupply	uint256	代币的总数量

`allowance`

返回支出者仍可从所有者提取的金额。

输入参数

名称	类型	描述
owner	address	所有者的地址
spender	address	支出者的地址

输出参数

名称	类型	描述
amount	uint256	授权的代币数量

事件

所有从此预编译合约发出的事件都以 PrecompiledBank 为前缀。为了避免歧义，调用此预编译合约的代币合约应避免使用相同前缀的事件名称。

PrecompiledBankMint

名称	类型	索引	描述
from	address	Y	铸造代币的地址
to	address	Y	接收铸造代币的地址
amount	uint256	N	铸造的代币数量

PrecompiledBankBurn

名称	类型	索引	描述
from	address	Y	销毁代币的地址
to	address	Y	此方法中未使用
amount	uint256	N	销毁的代币数量

PrecompiledBankTransfer

名称	类型	索引	描述
from	address	Y	转移代币的地址
to	address	Y	接收转移代币的地址
amount	uint256	N	转移的代币数量

PrecompiledBankApproval

名称	类型	索引	描述
owner	address	Y	授权代币的地址
spender	address	Y	被授权的地址
value	uint256	N	授权的代币数量

PrecompiledBankRevoke

名称	类型	索引	描述
owner	address	Y	撤销代币授权的地址
spender	address	Y	被撤销的地址
value	uint256	N	授权的代币数量

欢迎

导言

开发者

Stable 架构

资源

​概述

​目录

​概念

​配置

​合约地址

​方法

​mint

​输入参数

​输出参数

​burn

​输入参数

​输出参数

​transfer

​输入参数

​输出参数

​transferFrom

​输入参数

​输出参数

​multiTransfer

​输入参数

​输出参数

​approve

​输入参数

​输出参数

​revoke

​输入参数

​输出参数

​balanceOf

​输入参数

​输出参数

​totalSupply

​输入参数

​输出参数

​allowance

​输入参数

​输出参数

​事件

​PrecompiledBankMint

​PrecompiledBankBurn

​PrecompiledBankTransfer

​PrecompiledBankApproval

​PrecompiledBankRevoke

概述

目录

概念

配置

合约地址

方法

`mint`

输入参数

输出参数

`burn`

输入参数

输出参数

`transfer`

输入参数

输出参数

`transferFrom`

输入参数

输出参数

`multiTransfer`

输入参数

输出参数

`approve`

输入参数

输出参数

`revoke`

输入参数

输出参数

`balanceOf`

输入参数

输出参数

`totalSupply`

输入参数

输出参数

`allowance`

输入参数

输出参数

事件

PrecompiledBankMint

PrecompiledBankBurn

PrecompiledBankTransfer

PrecompiledBankApproval

PrecompiledBankRevoke