← Блог
10 мин чтения
|
Опубликовано
|
Обновлено

Функции NFT и estimateGas: релиз 2021 года

Что добавил релиз ноября 2021 года: getNFTOwner, getNFTURI, sendNFT и estimateGas, а также как сегодня работают отправка NFT и запросы газа в API v2.

Главы
C
Chaingateway Team
Эксперты по блокчейну

Проверил(а) Maurice Sobiera

Функции NFT в Chaingateway читают владельца и URI метаданных токена ERC-721, BEP-721 или TRC-721 и отправляют токен на другой адрес. Релиз ноября 2021 года добавил getNFTOwner, getNFTURI и sendNFT для Ethereum, Tron и BSC. Также добавлен estimateGas для Ethereum и BSC, который возвращает оценку газа для транзакции, не отправляя её.

Что такое NFT?

Невзаимозаменяемый токен (NFT) — это токен, у каждой единицы которого есть собственный идентификатор токена. Впервые стандарт был закреплён в Ethereum как ERC-721. Токены ERC-20 взаимозаменяемы: любая единица идентична любой другой. Токен ERC-721 устроен иначе: у каждого ID токена может быть свой владелец и свои метаданные.

Стандарт описан в EIP-721. Он задаёт ownerOf(tokenId), который возвращает владельца, и safeTransferFrom для перемещения токена. Необязательное расширение метаданных добавляет tokenURI(tokenId), который возвращает ссылку на метаданные токена. BEP-721 в BNB Smart Chain и TRC-721 в Tron следуют той же модели.

EIP-721 стандартизирует безопасную функцию перевода safeTransferFrom и небезопасную transferFrom. При transferFrom вызывающая сторона должна убедиться, что принимающий адрес умеет работать с NFT. Стандарт предупреждает, что иначе токен может быть безвозвратно утерян. Проверяйте получателя, прежде чем отправлять токен на адрес контракта. Более подробное введение — в статье о стандарте токенов ERC721.

Какие функции NFT добавил релиз 2021 года?

Релиз добавил три функции для NFT. Все три были доступны в API для Ethereum, Tron и Binance Smart Chain.

ФункцияЧто делаетПараметры
getNFTOwnerВозвращает адрес владельца одного NFTID токена, адрес контракта токена
getNFTURIВозвращает URI одного NFTТо же, что у getNFTOwner
sendNFTОтправляет NFT на другой адресАдрес отправителя, адрес назначения, адрес контракта, ID токена

Эти названия описывают функции так, как их объявили в 2021 году. Точное использование определялось документацией того времени.

Можно ли с Chaingateway минтить NFT?

В этом релизе отдельной функции минта не было. Минтить всё же можно: закодируйте вызов контракта самостоятельно и отправьте его как обычную транзакцию с закодированными данными.

Это соответствует стандарту, поскольку EIP-721 не определяет минт. В спецификации сказано, что создание и уничтожение NFT в неё не входят и что контракт может реализовать их иначе. Поэтому механика минта отличается от контракта к контракту. В 2021 году команда написала, что у неё нет тестовой среды для функции минта, и попросила владельцев контрактов ERC-721, BEP-721 или TRC-721 помочь её протестировать.

Что делает estimateGas?

estimateGas возвращает количество газа, которое, по расчётам, потребуется транзакции, до её отправки. Для Ethereum и BSC он принимает те же параметры, что и обычная транзакция, кроме пароля. Функцию добавили, потому что многие пользователи просили более простой способ рассчитать комиссии за газ.

В основе лежит метод eth_estimateGas интерфейса Ethereum JSON-RPC. Согласно документации разработчиков Ethereum, он выдаёт оценку, не добавляя транзакцию в блокчейн. Та же страница предупреждает, что оценка может заметно превышать газ, который транзакция реально использует. Относитесь к результату как к верхней границе для лимита газа, а не как к итоговой стоимости. Простой перевод эфира, например, расходует 21000 газа, что на той же странице показано как 0x5208.

Что можно использовать сегодня?

Названия функций выше взяты из API поколения 2021 года. Текущая публичная спецификация OpenAPI (версия 2.1.0) устроена иначе, поэтому в этом разделе перечислено, что она содержит по состоянию на 5 ноября 2026 года.

ЗадачаEndpoint в спецификации v2
Отправить токен ERC-721 в EthereumPOST /api/v2/ethereum/transactions/erc721
Отправить токен BEP-721 в BSCPOST /api/v2/bsc/transactions/bep721
Отправить токен TRC-721 в TronPOST /api/v2/tron/transactions/trc721
Отправить токен ERC-721 в Polygon или ArbitrumPOST /api/v2/polygon/transactions/erc721, POST /api/v2/arbitrum/transactions/erc721
Получить текущую цену газаGET /api/v2/ethereum/gasprice, тот же путь под bsc, polygon и arbitrum

Спецификация не перечисляет отдельных endpoint-ов getNFTOwner, getNFTURI или estimateGas. Чтобы узнать владельца или URI, вызовите ownerOf или tokenURI у контракта токена через любой endpoint JSON-RPC. Для оценки газа так же используйте eth_estimateGas. Расчёт описан в статье о том, как оценивать комиссии за газ.

Запрос на отправку в Ethereum требует from, contractaddress, to и tokenId. Поле password обязательно, если вы не передаёте privatekey. Поля газа, например gas, gasprice или maxFeePerGas, необязательны.

Terminal window
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc721 \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"contractaddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"to": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"tokenId": 1,
"password": "your-wallet-password"
}'

Успешный вызов возвращает статус 201 и хеш транзакции в data.txid. Неверный пароль кошелька возвращает 401. Кошелёк без достаточного баланса для оплаты газа возвращает 422, например с сообщением «insufficient funds for gas * price + value». Адреса выше — примеры из спецификации. Полное пошаговое руководство — в статье о переводе NFT через API.

Хотите обсудить новые функции?

Отзывы приветствуются в группе Chaingateway в Telegram.

Как мы пишем эти статьи

Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API блокчейна для полного справочника по эндпоинтам.

C
Chaingateway Team
Эксперты по блокчейну

Команда Chaingateway стремится упростить интеграцию блокчейна для разработчиков по всему миру.