Стандарт ERC-20, реализация с нуля, allowance/transferFrom, mint/burn, OpenZeppelin
ERC-20 — самый распространённый стандарт токенов в Ethereum. На нём построены USDC, DAI, UNI и тысячи других активов
ERC-20 (Ethereum Request for Comments 20) — стандарт взаимозаменяемых (fungible) токенов. "Взаимозаменяемый" означает: один токен неотличим от другого того же типа (как 1 рубль = 1 рублю). Стандарт определяет минимальный набор функций, который должен реализовать каждый токен для совместимости с биржами, кошельками и DeFi-протоколами.
Стандарт требует реализации следующих функций:
interface IERC20 {
// Общее количество токенов
function totalSupply() external view returns (uint256);
// Баланс конкретного адреса
function balanceOf(address account) external view returns (uint256);
// Прямой перевод от msg.sender к to
function transfer(address to, uint256 amount) external returns (bool);
// Сколько spender может тратить от имени owner
function allowance(address owner, address spender) external view returns (uint256);
// Разрешить spender тратить amount от имени msg.sender
function approve(address spender, uint256 amount) external returns (bool);
// Перевод от from к to, если spender (msg.sender) имеет разрешение
function transferFrom(address from, address to, uint256 amount) external returns (bool);
// Обязательные события
event Transfer(address indexed from, address indexed to, uint256 value);
event Approval(address indexed owner, address indexed spender, uint256 value);
}Напишем полный ERC-20 токен без использования библиотек — это лучший способ понять механизм изнутри:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract MyToken {
string public name;
string public symbol;
uint8 public decimals = 18; // Стандарт: 18 знаков после запятой
uint256 public totalSupply;
mapping(address => uint256) public balanceOf;
mapping(address => mapping(address => uint256)) public allowance;
event Transfer(address indexed from, address indexed to, uint256 value);
event Approval(address indexed owner, address indexed spender, uint256 value);
constructor(string memory _name, string memory _symbol, uint256 initialSupply) {
name = _name;
symbol = _symbol;
totalSupply = initialSupply * 10**decimals; // Учитываем decimals
balanceOf[msg.sender] = totalSupply;
emit Transfer(address(0), msg.sender, totalSupply);
}
function transfer(address to, uint256 amount) external returns (bool) {
require(to != address(0), "Transfer to zero address");
require(balanceOf[msg.sender] >= amount, "Insufficient balance");
balanceOf[msg.sender] -= amount;
balanceOf[to] += amount;
emit Transfer(msg.sender, to, amount);
return true;
}
function approve(address spender, uint256 amount) external returns (bool) {
require(spender != address(0), "Approve to zero address");
allowance[msg.sender][spender] = amount;
emit Approval(msg.sender, spender, amount);
return true;
}
function transferFrom(address from, address to, uint256 amount) external returns (bool) {
require(to != address(0), "Transfer to zero address");
require(balanceOf[from] >= amount, "Insufficient balance");
require(allowance[from][msg.sender] >= amount, "Insufficient allowance");
allowance[from][msg.sender] -= amount;
balanceOf[from] -= amount;
balanceOf[to] += amount;
emit Transfer(from, to, amount);
return true;
}
}Это ключевая концепция ERC-20. Она позволяет смарт-контракту управлять вашими токенами с вашего согласия — без передачи контроля над кошельком.
Сценарий: вы хотите добавить ликвидность в Uniswap.
approve(uniswap, 1000e18) — вы разрешаете Uniswap тратить 1000 ваших токеновuniswap.addLiquidity(token, 1000e18, ...) — Uniswap вызывает token.transferFrom(you, pool, 1000e18)Это двухшаговый процесс. Именно поэтому при работе с новым протоколом вы сначала видите транзакцию "Approve", а потом "Deposit" или "Swap".
Важная уязвимость: никогда не делайте approve(spender, type(uint256).max) для ненадёжных контрактов — это бессрочное разрешение на весь баланс. Многие кошельки предупреждают об этом.
Базовый ERC-20 не включает создание и уничтожение токенов — это расширения.
contract MintableBurnableToken is MyToken {
address public minter;
constructor(string memory name, string memory symbol)
MyToken(name, symbol, 0) // Начинаем с нуля
{
minter = msg.sender;
}
// Создание новых токенов (инфляция)
function mint(address to, uint256 amount) external {
require(msg.sender == minter, "Not minter");
require(to != address(0), "Mint to zero address");
totalSupply += amount;
balanceOf[to] += amount;
emit Transfer(address(0), to, amount); // Mint = transfer from zero
}
// Уничтожение токенов (дефляция)
function burn(uint256 amount) external {
require(balanceOf[msg.sender] >= amount, "Insufficient balance");
balanceOf[msg.sender] -= amount;
totalSupply -= amount;
emit Transfer(msg.sender, address(0), amount); // Burn = transfer to zero
}
}Конвенция: mint эмитирует Transfer(address(0), to, amount), burn — Transfer(from, address(0), amount). Это позволяет внешним наблюдателям (The Graph, Etherscan) корректно показывать историю токена.
На практике не пишут ERC-20 с нуля — используют проверенные контракты OpenZeppelin. Они прошли аудит и содержат защиту от edge cases:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
contract GameToken is ERC20, Ownable {
constructor() ERC20("GameToken", "GAME") Ownable(msg.sender) {
_mint(msg.sender, 1_000_000 * 10**decimals());
}
function mint(address to, uint256 amount) external onlyOwner {
_mint(to, amount);
}
}OpenZeppelin также предоставляет расширения: ERC20Permit (approve через подпись без транзакции), ERC20Votes (для governance), ERC20Capped (ограничение totalSupply), ERC20Burnable.
Вопросы ещё не добавлены
Вопросы для этой подтемы ещё не добавлены.