ERC-20 - OpenZeppelin 文档

ERC-20

ERC-20 token 合约会追踪可替换的 token：任何一个 token 与其他 token 完全相等；没有 token 具有特殊的权利或与之相关的行为。这使得 ERC-20 token 适用于交换媒介货币、投票权、质押等。

OpenZeppelin Contracts 提供了许多与 ERC20 相关的合约。在API 参考中，你可以找到关于它们的属性和用法的详细信息。

构建 ERC-20 Token 合约

使用 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，它将被分配给部署合约的地址。

就是这样! 一旦部署，我们将能够查询部署者的余额：

> 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)。

function decimals() public view virtual override returns (uint8) {
  return 16;
}

所以，如果你想使用一个具有 18 位小数的 token 合约发送 5 个 token，那么实际调用的方法将是：

transfer(recipient, 5 * (10 ** 18));

← 代币

创建供应 →

• 原文链接： docs.openzeppelin.com/co...
• 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～