本文介绍了 ERC-20 token 的概念和使用场景,例如作为交易媒介、投票权和 staking。通过 OpenZeppelin Contracts 可以轻松创建 ERC-20 token 合约,并以一个游戏中的 Gold (GLD) 代币为例,展示了如何构建、部署和转账 ERC-20 token,还讨论了 decimals 字段在处理小数方面的作用。
ERC-20 token 合约会追踪可替换的 token:任何一个 token 与其他 token 完全相等;没有 token 具有特殊的权利或与之相关的行为。这使得 ERC-20 token 适用于交换媒介货币、投票权、质押等。
OpenZeppelin Contracts 提供了许多与 ERC20 相关的合约。在API 参考中,你可以找到关于它们的属性和用法的详细信息。
使用 Contracts,我们可以轻松创建我们自己的 ERC-20 token 合约,它将被用来追踪 Gold(GLD),这是一种假想游戏中的内部货币。
以下是我们的 GLD token 可能的样子。
// contracts/GLDToken.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
contract GLDToken is ERC20 {
constructor(uint256 initialSupply) ERC20("Gold", "GLD") {
_mint(msg.sender, initialSupply);
}
}
我们的合约通常通过继承来使用,在这里我们重用 ERC20 用于基本标准实现以及 name、symbol 和 decimals 可选扩展。此外,我们正在创建一个 initialSupply 的 token,它将被分配给部署合约的地址。
| 有关 ERC-20 供应机制的更完整讨论,请参阅创建 ERC-20 供应。 |
就是这样! 一旦部署,我们将能够查询部署者的余额:
> GLDToken.balanceOf(deployerAddress)
1000000000000000000000
我们也可以将这些 token 转移 到其他账户:
> GLDToken.transfer(otherAddress, 300000000000000000000)
> GLDToken.balanceOf(otherAddress)
300000000000000000000
> GLDToken.balanceOf(deployerAddress)
700000000000000000000
decimals 的说明通常,你可能希望能够将你的 token 分成任意数量:例如,如果你拥有 5 GLD,你可能想发送 1.5 GLD 给一个朋友,并保留 3.5 GLD 给自己。不幸的是,Solidity 和 EVM 不支持此行为:只能使用整数(整个)数字,这会带来问题。你可以发送 1 或 2 个 token,但不能发送 1.5 个。
为了解决这个问题,ERC20 提供了一个 decimals 字段,用于指定 token 有多少位小数。为了能够转移 1.5 GLD,decimals 必须至少为 1,因为该数字有一位小数。
这该如何实现?实际上非常简单:token 合约可以使用更大的整数值,因此 50 的余额将表示 5 GLD,15 的转移将对应于发送 1.5 GLD,依此类推。
重要的是要理解 decimals 仅用于显示目的。合约内的所有运算仍然在整数上执行,并且必须由不同的用户界面(钱包、交易所等)根据 decimals 调整显示的值。每个账户的 token 总供应量和余额未在 GLD 中指定:你需要除以 10 ** decimals 才能获得实际的 GLD 金额。
你可能想要使用 18 的 decimals 值,就像 Ether 和大多数正在使用的 ERC-20 token 合约一样,除非你有非常特别的理由不这样做。在铸造 token 或转移它们时,你实际上将发送数字 num GLD * (10 ** decimals)。
默认情况下,ERC20 对 decimals 使用 18 的值。要使用不同的值,你需要覆盖合约中的 decimals() 函数。 |
function decimals() public view virtual override returns (uint8) {
return 16;
}
所以,如果你想使用一个具有 18 位小数的 token 合约发送 5 个 token,那么实际调用的方法将是:
transfer(recipient, 5 * (10 ** 18));
- 原文链接: docs.openzeppelin.com/co...
- 登链社区 AI 助手,为大家转译优秀英文文章,如有翻译不通的地方,还请包涵~
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!