Перейти к содержимому

Отправка переводов токенов ERC20 и TRC20

Чтобы отправить токен ERC20, BEP20 или TRC20 через Chaingateway, передайте отправителя, получателя, сумму и адрес контракта токена на токен-эндпоинт сети вместе с паролем кошелька или приватным ключом. Перевод токена — это вызов смарт-контракта, поэтому отправителю также нужна нативная монета сети для оплаты комиссии: ETH, BNB, MATIC или TRX. Ответ возвращает хеш транзакции.

О получении API-токена см. Быстрый старт. В Ethereum, BNB Smart Chain и Polygon отправляющий адрес должен быть создан через API Chaingateway или импортирован в него. Иначе шаг подписи завершится ошибкой. Как создать адрес, показывает раздел Создание адресов Ethereum и Tron.

Перевод токена: проверить баланс токена, убедиться, что у отправителя есть нативная монета для комиссии, отправить перевод с адресом контракта, прочитать хеш транзакции GET/api/v2/{chain}/balances/{address}/erc20/{contract} достаточно ли токенов у отправителя? У отправителя есть нативная монета длякомиссии ETH, BNB, MATIC или TRX POST /api/v2/{chain}/transactions/erc20 from, to, amount, contractaddress, passwordили privatekey Ответ: txid статус 201
Проверка баланса и проверка комиссии идут до перевода.

Какой эндпоинт отправляет токен в какой сети?

Заголовок раздела «Какой эндпоинт отправляет токен в какой сети?»

У каждой сети свой токен-эндпоинт, названный по стандарту токена. Тело запроса одинаково во всех EVM-сетях.

БлокчейнМаршрут APIСтандарт
Ethereum/api/v2/ethereum/transactions/erc20ERC-20
Binance Smart Chain/api/v2/bsc/transactions/bep20BEP20
Polygon/api/v2/polygon/transactions/erc20ERC-20
Arbitrum/api/v2/arbitrum/transactions/erc20ERC-20
Tron/api/v2/tron/transactions/trc20TRC20
Solana/api/v2/solana/transactions/SPLSPL

Чтобы выполнить запрос в тестовой сети, добавьте заголовок X-Network: testnet. Список testnet-сетей приведён в разделе Поддерживаемые блокчейн-сети и testnet’ы. У Bitcoin токен-эндпоинта нет.

Передайте следующие поля на маршрут вашей сети. В примере отправляется токен ERC20 в Ethereum.

  • from: адрес отправителя.
  • to: адрес получателя.
  • amount: количество отправляемых токенов.
  • contractaddress: адрес контракта токена.
  • password: пароль кошелька, обязателен, если privatekey не указан.
  • privatekey: приватный ключ отправителя для адресов, созданных без пароля.

Поля gas, gasprice, maxPriorityFeePerGas, maxFeePerGas и nonce необязательны.

Окно терминала
curl --request POST \
--url https://app.chaingateway.io/api/v2/ethereum/transactions/erc20 \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"from": "0xYourSenderAddress",
"to": "0xRecipientAddress",
"amount": 100,
"contractaddress": "0xTokenContractAddress",
"password": "YourPassword"
}'

Код возвращает хеш транзакции:

{
"status": 201,
"ok": true,
"message": "Succesfully created",
"data": {
"txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27"
}
}

Запрос TRC20 устроен почти так же, как запрос ERC20. Маршрут — /api/v2/tron/transactions/trc20, адреса — адреса Tron, а подписываете вы через password или privatekey. Файл OpenAPI помечает from, to, contractaddress и amount как обязательные. В примере используется приватный ключ адреса, созданного без пароля.

Окно терминала
curl --request POST \
--url https://app.chaingateway.io/api/v2/tron/transactions/trc20 \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"from": "TYourSenderAddress",
"to": "TRecipientAddress",
"amount": 100,
"contractaddress": "TTokenContractAddress",
"privatekey": "YourPrivateKey"
}'

Раздел Создание транзакций с токенами TRC20 на TRON проводит через весь процесс TRC20, включая чтение контракта и эндпоинты для самостоятельной подписи.

Как проверить баланс токена перед отправкой?

Заголовок раздела «Как проверить баланс токена перед отправкой?»

Сначала прочитайте баланс, чтобы не отправлять транзакцию, которая завершится ошибкой. В EVM-сетях GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} возвращает баланс одного токена. GET /api/v2/ethereum/balances/{address}/erc20 выводит список балансов токенов кошелька. В BNB Smart Chain сегмент называется bep20, а в Tron используется GET /api/v2/tron/balances/{address}/trc20/{contract_address}. GET /api/v2/ethereum/erc20/{contract_address} возвращает информацию о контракте токена.

Почему перевод токена завершается ошибкой?

Заголовок раздела «Почему перевод токена завершается ошибкой?»

Большинство сбоев вызваны одной из трёх причин, и у каждой своё сообщение.

  • Неверный пароль возвращает статус 401 и Wrong password provided.
  • Отсутствующее или неверно оформленное поле возвращает статус 422 и Data validation failed с именем поля в errors.
  • Отправитель без достаточного количества нативной монеты получает статус 422 и сообщение узла, например insufficient funds for gas * price + value. В Tron эквивалент — balance is not sufficient.

Последняя причина удивляет тех, у кого есть только токены: комиссия оплачивается в ETH, BNB, MATIC или TRX, но никогда не в токене. Модель комиссий в EVM-сетях описана в документации Ethereum по gas, а energy и bandwidth — в модели ресурсов TRON. Если на ваших адресах TRON есть токены, но нет TRX, варианты перечислены в разделе Спонсирование комиссий TRC20: TronFuel и Paymaster.

Переводы NFT используют эндпоинты ERC721, например POST /api/v2/ethereum/transactions/erc721. Тело содержит те же поля подписи, что и выше, но вместо amount принимает tokenId, идентификатор NFT. Поля from, contractaddress, to и tokenId обязательны. GET /api/v2/ethereum/nfts/{contract_address}/owner/{token_id} возвращает текущего владельца, а .../uri/{token_id} возвращает URI токена. Стандарт определён в EIP-721.