Documentation Index
Fetch the complete documentation index at: https://docs.stable.xyz/llms.txt
Use this file to discover all available pages before exploring further.
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
}
x/precompile 模块的白名单中。
合约地址和gas费用已预定义。
合约地址
0x0000000000000000000000000000000000001003 STABLE (用于治理代币)
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 | 授权的代币数量 |
