Bank 预编译合约参考

摘要

Stable SDK 中的 x/bank 模块仅提供基本的代币管理功能。 你可以不受限制地向任何账户转移任何代币，但无法委托其他账户来转移你的代币。 出于这些原因，bank 预编译合约在 Stable SDK 现有的 x/bank 模块基础上提供了额外的授权和委托功能。

目录

1. 概念
2. 配置
3. 方法
4. 事件

概念

该预编译合约提供 ERC-20 标准方法——例如用于转账的 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
  }

这一额外的验证流程保证了调用该预编译合约的代币合约是经过授权的。

要在 x/precompile 模块白名单中注册代币合约地址及其 denom，你必须提交一个治理提案。

配置

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

合约地址

• 0x0000000000000000000000000000000000001003 用于 STABLE（治理代币）

方法

mint

铸造请求数量的新代币并转移到该账户。 要铸造的代币数量必须大于零。

当代币成功铸造并转移到账户时，将发出 PrecompiledBankMint 事件。

注意：

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

输入

输出

burn

从账户中销毁请求数量的代币。 要销毁的代币数量必须大于零。

当代币成功销毁时，将发出 PrecompiledBankBurn 事件。

注意：

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

输入

输出

transfer

将请求数量的代币从发送方转移给接收方。 代币必须被设置为可发送。要转移的代币数量必须大于零。

当代币成功转移时，将发出 PrecompiledBankTransfer 事件。

输入

输出

transferFrom

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

当代币成功转移时，将发出 PrecompiledBankTransfer 事件。

输入

输出

multiTransfer

将代币从单个账户转移到多个账户。 代币必须被设置为可发送。 转移给每个接收方的代币数量必须大于零。

当代币成功转移时，将为每个接收方发出 PrecompiledBankTransfer 事件。

输入

输出

approve

授权支出方从所有者的账户转移代币。 要授权的代币数量必须大于零。

当授权成功设置时，将发出 PrecompiledBankApproval 事件。

输入

输出

revoke

撤销支出方从所有者转移代币的授权。

当授权成功撤销时，将发出 PrecompiledBankRevoke 事件。

输入

输出

balanceOf

返回账户中的代币余额。

输入

输出

totalSupply

返回代币的总供应量。

输入

无

输出

allowance

返回支出方仍被允许从所有者处提取的代币数量。

输入

输出

事件

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

PrecompiledBankMint

PrecompiledBankBurn

PrecompiledBankTransfer

PrecompiledBankApproval

PrecompiledBankRevoke