Стандарт токенов ERC721: как работают NFT
Что определяет стандарт ERC721, как работают владение, разрешения и переводы, чем он отличается от ERC20 и как отправлять токены ERC721 через API.
Проверил(а) Maurice Sobiera
ERC721 — это стандарт Ethereum для невзаимозаменяемых токенов (NFT). Он определяет общий интерфейс, который реализует смарт-контракт. Благодаря ему каждый токен имеет уникальный ID, ровно одного владельца и одинаковый набор функций для переводов и разрешений. Кошельки, маркетплейсы и API могут затем одинаково работать с любым контрактом ERC721.
Что определяет стандарт ERC721?
Стандарт описан в EIP-721. Совместимый контракт должен реализовывать интерфейс ERC721 и интерфейс ERC165, который позволяет другим контрактам спросить, поддерживает ли контракт нужный интерфейс. ID интерфейса ERC721 — 0x80ac58cd.
Интерфейс содержит три события и восемь функций (safeTransferFrom существует в двух вариантах):
| Элемент | Тип | Назначение |
|---|---|---|
Transfer | событие | Генерируется при каждом изменении владельца токена, включая чеканку и сжигание |
Approval | событие | Генерируется при изменении одобренного адреса для одного токена |
ApprovalForAll | событие | Генерируется, когда владелец включает или отключает оператора для всех своих токенов |
balanceOf(owner) | функция | Количество токенов, которыми владеет адрес |
ownerOf(tokenId) | функция | Адрес, которому принадлежит один токен |
safeTransferFrom(from, to, tokenId) | функция | Переводит токен и проверяет, что принимающий контракт может с ним работать |
transferFrom(from, to, tokenId) | функция | Переводит токен без этой проверки |
approve(to, tokenId) | функция | Позволяет одному адресу перемещать один конкретный токен |
setApprovalForAll(operator, approved) | функция | Позволяет оператору перемещать все токены вызывающего |
getApproved(tokenId) | функция | Возвращает одобренный адрес для одного токена |
isApprovedForAll(owner, operator) | функция | Показывает, одобрен ли оператор для владельца |
У safeTransferFrom есть второй вариант с дополнительным аргументом data. Если получатель — смарт-контракт, оба варианта вызывают у него onERC721Received и откатываются, если контракт не возвращает ожидаемое значение. Это защищает токены от отправки в контракты, которые не смогут перевести их дальше. У transferFrom такой проверки нет, и EIP-721 указывает, что вызывающий сам отвечает за подтверждение того, что получатель способен работать с NFT.
Существуют два необязательных расширения. Расширение метаданных добавляет name(), symbol() и tokenURI(tokenId), где URI обычно указывает на JSON-файл с названием, описанием и изображением. Расширение перечисления добавляет totalSupply() и функции для перечисления токенов по индексу.
Как создать токен ERC721?
Вы пишете смарт-контракт, который реализует интерфейс, компилируете его и развёртываете байткод в блокчейне Ethereum. Большинство команд начинают с поддерживаемой библиотеки, а не пишут функции вручную. Документация OpenZeppelin по ERC721 описывает поддерживаемую реализацию, а веб-среда Remix IDE может скомпилировать и развернуть её без локальных инструментов.
Развёртывание возвращает адрес контракта. Сначала протестируйте контракт в тестовой сети, а затем разворачивайте его в mainnet.
Что такое адрес контракта и почему он важен?
Адрес контракта — единственный надёжный идентификатор коллекции токенов ERC721. Названия и символы не уникальны: любой может развернуть контракт, который называется так же, как существующая коллекция. Токен полностью определяется парой «адрес контракта и ID токена».
Когда вы интегрируете токен ERC721, всегда сохраняйте оба значения. Два разных контракта могут иметь каждый по токену с ID 1.
В чём разница между ERC721 и ERC20?
Токены ERC20 взаимозаменяемы: каждая единица равна любой другой, а контракт хранит только баланс на каждый адрес. Токены ERC721 невзаимозаменяемы: у каждого ID токена свой владелец и свои метаданные. EIP-721 создавался на основе модели ERC20, и в нём отсутствие учёта по отдельным активам названо причиной, по которой ERC20 не подходит для NFT.
Практические различия для интеграции небольшие, но их легко пропустить:
- Переводы ERC20 принимают сумму, переводы ERC721 принимают ID токена.
balanceOfв контракте ERC721 считает токены, а не стоимость.- В ERC721 есть разрешения на отдельные токены в дополнение к разрешениям операторам.
Более длинное сравнение с ERC1155, который может хранить взаимозаменяемые и невзаимозаменяемые токены в одном контракте, читайте в статьях ERC-721 против ERC-1155 и Стандарты токенов. Наше объяснение ERC20 — в статье Стандарт токенов ERC20.
Можно ли платить комиссии за газ токенами ERC721?
Нет. Газ в Ethereum всегда оплачивается в ETH, даже если транзакция переносит только токен ERC721. На адресе отправителя должно быть достаточно ETH, чтобы покрыть газ. Комиссия равна использованному газу, умноженному на цену газа. Текущую цену можно посмотреть в трекере газа Etherscan, а ethereum.org объясняет, как рассчитывается комиссия.
Сколько стоит создание токена ERC721?
Развёртывание контракта требует газа, и сумма зависит от размера развёртываемого контракта. Чеканка каждого токена требует дополнительного газа, который оплачивает либо владелец контракта, либо пользователь, который чеканит, в зависимости от того, как написан контракт. Оцените развёртывание в тестовой сети через eth_estimateGas, прежде чем разворачивать в mainnet, а затем умножьте результат на текущую цену газа.
Легальны ли токены ERC721?
Сам стандарт токенов — это только техническая спецификация. Регулируется ли использование, зависит от того, что представляет токен и где находятся стороны. Продажа токенов, приём их как оплаты или предложение как долей компании могут повлечь обязанности по лицензированию, налогам, KYC (Know Your Customer) или AML (Anti Money Laundering). Прежде чем запускать бизнес-модель на их основе, проконсультируйтесь с юристом, который знает вашу юрисдикцию.
Как отправлять токены ERC721 автоматически?
Вы можете отправлять токены ERC721 скриптом через REST API Chaingateway, а не через кошелёк для каждого перевода. Эндпоинт — POST /api/v2/ethereum/transactions/erc721. Он принимает адрес отправителя, адрес контракта, получателя и ID токена. Газ вы оплачиваете в ETH с адреса отправителя. Аналогичные эндпоинты есть для Polygon и Arbitrum (erc721) и для BNB Smart Chain (bep721).
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc721 \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -H "X-Network: testnet" \ -d '{ "from": "0xSenderAddress", "contractaddress": "0xYourErc721ContractAddress", "to": "0xReceiverAddress", "tokenId": 1, "password": "wallet-password" }'Обязательные поля: from, contractaddress, to и tokenId. Вместо password можно передать privatekey. Необязательные поля, например gas, gasprice, maxFeePerGas, maxPriorityFeePerGas и nonce, позволяют управлять комиссией и порядком транзакций. Успешный вызов возвращает HTTP 201 с ID транзакции в data.txid. Заголовок X-Network: testnet позволяет сначала опробовать вызов в тестовой сети. Параметры запроса перечислены в справочнике API.
Пошаговый обзор проверки владения, подписи и подтверждения см. в статье Перевод NFT через API.
Есть ли другие стандарты токенов?
Да. ERC20 охватывает взаимозаменяемые токены, а ERC-1155 — это стандарт мультитокенов, который может управлять взаимозаменяемыми и невзаимозаменяемыми токенами в одном контракте. В других сетях аналоги называются иначе, например TRC-20 в TRON и SPL в Solana.
Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API Ethereum для полного справочника по эндпоинтам.