Стандарт токенов ERC20: как он работает и сколько стоит
ERC20 задаёт шесть функций и два события, которые делают токены в Ethereum взаимозаменяемыми. Как выпустить токен, оплатить газ и отправлять токены через API.
Проверил(а) Maurice Sobiera
ERC20 — это технический стандарт взаимозаменяемых токенов в Ethereum, описанный в EIP-20. Он задаёт функции, которые контракт токена должен предоставлять для перевода токенов и чтения балансов, а также два события. Поскольку у каждого контракта ERC20 одинаковый интерфейс, кошельки, биржи и API могут работать с любым токеном без специального кода.
Что такое ERC20?
Токен ERC20 — это смарт-контракт, который ведёт таблицу балансов. Стандарт фиксирует интерфейс к этой таблице:
| Функция или событие | Назначение |
|---|---|
totalSupply() | Общее количество существующих токенов |
balanceOf(owner) | Баланс одного адреса |
transfer(to, value) | Перевод токенов от вызывающего адреса на другой адрес |
approve(spender, value) | Разрешить другому адресу потратить до value токенов вызывающего |
allowance(owner, spender) | Остаток, который разрешённый адрес ещё может потратить |
transferFrom(from, to, value) | Перевод токенов от имени владельца в пределах разрешения |
Событие Transfer | Генерируется при каждом движении, включая выпуск (mint) |
Событие Approval | Генерируется при установке разрешения |
Поля name, symbol и decimals в EIP-20 необязательны, но почти каждый токен их реализует. На практике важен decimals: баланс 1000000 при 6 знаках после запятой — это 1 токен, а не миллион. Документация разработчиков Ethereum подробнее описывает интерфейс.
Как выпустить токен ERC20?
Вы пишете смарт-контракт, который реализует описанный выше интерфейс, компилируете его и развёртываете байткод в Ethereum. Веб-компилятор Remix может выполнить шаги компиляции и развёртывания. Для самого контракта большинство проектов берут поддерживаемую реализацию, например ERC20 от OpenZeppelin, а не пишут его с нуля. Существует также эталонная реализация ConsenSys. Когда транзакция развёртывания попадает в блок, токен существует, а у нового контракта есть адрес.
В чём разница между токенами ERC20 и ETH?
ETH — это нативная валюта блокчейна Ethereum, которую учитывает сам протокол. Токен ERC20 — это лишь таблица балансов внутри смарт-контракта, который работает в Ethereum Virtual Machine. Протокол ничего не знает о токене. Именно стандартный интерфейс позволяет кошелькам и биржам одинаково обрабатывать все такие контракты.
Можно ли платить газ токенами ERC20?
Нет. Газ всегда оплачивается в ETH, даже если транзакция лишь переводит токены ERC20. Адрес, на котором есть 1 000 USDT, но нет ETH, не может их отправить. Перевод токена также выполняет код контракта, поэтому он расходует больше газа, чем 21 000 единиц обычного перевода ETH. Документация по газу Ethereum объясняет, как складываются базовая комиссия и комиссия за приоритет.
Сколько стоит создать токен ERC20?
Развёртывание стоит газ, а сумма зависит от размера контракта и цены газа в тот момент. Использованный газ, умноженный на цену газа, даёт комиссию в ETH. Текущую цену можно посмотреть в трекере газа Etherscan. Минимальный контракт токена стоит дешевле в развёртывании, чем контракт с множеством дополнительных функций, потому что за каждый байт байткода платят. Если контракт пишет разработчик или агентство, попросите смету, в которой их гонорар указан отдельно от газа развёртывания. Аудит — это отдельная статья расходов и не входит в развёртывание.
Законны ли токены ERC20?
Это зависит от применения и от страны. Во многих странах владеть токеном ERC20 законно. Продажа токенов, приём их в качестве оплаты или выпуск как доли компании могут требовать лицензий, и могут применяться налоги. Когда вы продаёте токены публике, обычно действуют правила KYC и противодействия отмыванию денег. Перед запуском спросите юриста, который знает вашу юрисдикцию. Эта статья не содержит юридических консультаций.
Что такое адрес контракта?
Адрес контракта — это адрес в блокчейне, по которому находится контракт токена. Это единственный надёжный идентификатор токена. Названия и символы не уникальны: любой может развернуть другой контракт под названием «USDT» с тем же символом, и только адрес контракта отличает их друг от друга. Всегда копируйте адрес со страницы эмитента, а затем сверяйте его в обозревателе блоков, например в Etherscan.
Как отправлять токены ERC20 автоматически?
Вызывайте функцию transfer контракта из скрипта, а не через интерфейс кошелька. С REST API Chaingateway вы отправляете один запрос на перевод и не нужно запускать ноду или работать с кодированием ABI. Запрос требует адрес отправителя, получателя, адрес контракта токена и сумму. Если кошелёк отправителя создан с паролем, добавьте password. Для кошелька, ключ которого вы управляете сами, добавьте privatekey.
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc20 \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "from": "0xYourSenderAddress", "to": "0xRecipientAddress", "contractaddress": "0xTokenContractAddress", "amount": 100, "password": "your-wallet-password" }'Успешный вызов возвращает статус 201. Если у отправителя слишком мало ETH на газ, API отвечает 422 с сообщением ноды, например insufficient funds for gas * price + value. Чтобы отправить токены многим получателям, пройдите по списку и отправьте по одному запросу каждому. Вы можете сами задать gas, gasprice, maxFeePerGas и maxPriorityFeePerGas; все поля описаны в справочнике API. Токен выбирается по contractaddress, поэтому новому токену не нужна регистрация на нашей стороне.
Как прочитать баланс ERC20?
Вызовите balanceOf(address) у контракта токена или найдите адрес в обозревателе блоков. Etherscan показывает все токены, которые есть у адреса. Для платёжного потока опрос балансов нужен редко. Вебхук на принимающий адрес с адресом контракта токена в качестве фильтра отправляет вашему серверу уведомление, когда приходит перевод, поэтому депозиты можно обрабатывать без опроса. Неудачные уведомления автоматически не повторяются. Они появляются в списке неудачных уведомлений, и вы можете запросить их повторную отправку.
Какие ещё стандарты токенов существуют?
ERC721 описывает невзаимозаменяемые токены, у каждого из которых есть уникальный ID, а ERC1155 описывает контракты, которые одновременно хранят несколько типов токенов. Оба описаны как предложения по улучшению Ethereum: EIP-721 и EIP-1155.
Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API Ethereum для полного справочника по эндпоинтам.