Отправка переводов токенов ERC20 и TRC20
Чтобы отправить токен ERC20, BEP20 или TRC20 через Chaingateway, передайте отправителя, получателя, сумму и адрес контракта токена на токен-эндпоинт сети вместе с паролем кошелька или приватным ключом. Перевод токена — это вызов смарт-контракта, поэтому отправителю также нужна нативная монета сети для оплаты комиссии: ETH, BNB, MATIC или TRX. Ответ возвращает хеш транзакции.
О получении API-токена см. Быстрый старт. В Ethereum, BNB Smart Chain и Polygon отправляющий адрес должен быть создан через API Chaingateway или импортирован в него. Иначе шаг подписи завершится ошибкой. Как создать адрес, показывает раздел Создание адресов Ethereum и Tron.
Какой эндпоинт отправляет токен в какой сети?
Заголовок раздела «Какой эндпоинт отправляет токен в какой сети?»У каждой сети свой токен-эндпоинт, названный по стандарту токена. Тело запроса одинаково во всех EVM-сетях.
| Блокчейн | Маршрут API | Стандарт |
|---|---|---|
| Ethereum | /api/v2/ethereum/transactions/erc20 | ERC-20 |
| Binance Smart Chain | /api/v2/bsc/transactions/bep20 | BEP20 |
| Polygon | /api/v2/polygon/transactions/erc20 | ERC-20 |
| Arbitrum | /api/v2/arbitrum/transactions/erc20 | ERC-20 |
| Tron | /api/v2/tron/transactions/trc20 | TRC20 |
| Solana | /api/v2/solana/transactions/SPL | SPL |
Чтобы выполнить запрос в тестовой сети, добавьте заголовок X-Network: testnet. Список testnet-сетей приведён в разделе Поддерживаемые блокчейн-сети и testnet’ы. У Bitcoin токен-эндпоинта нет.
Как отправить токен ERC20 или BEP20?
Заголовок раздела «Как отправить токен ERC20 или BEP20?»Передайте следующие поля на маршрут вашей сети. В примере отправляется токен 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" }'const axios = require('axios');
const url = 'https://app.chaingateway.io/api/v2/ethereum/transactions/erc20';const payload = { from: '0xYourSenderAddress', to: '0xRecipientAddress', amount: 100, contractaddress: '0xTokenContractAddress', password: 'YourPassword'};const headers = { 'Accept': 'application/json', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'};
axios.post(url, payload, { headers }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error.response?.data ?? error); });import requests
url = "https://app.chaingateway.io/api/v2/ethereum/transactions/erc20"payload = { "from": "0xYourSenderAddress", "to": "0xRecipientAddress", "amount": 100, "contractaddress": "0xTokenContractAddress", "password": "YourPassword"}headers = { 'Accept': 'application/json', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'}
response = requests.post(url, json=payload, headers=headers)print(response.json())<?phprequire 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();$response = $client->post('https://app.chaingateway.io/api/v2/ethereum/transactions/erc20', [ 'headers' => [ 'Accept' => 'application/json', 'Authorization' => 'Bearer YOUR_API_TOKEN', ], 'json' => [ 'from' => '0xYourSenderAddress', 'to' => '0xRecipientAddress', 'amount' => 100, 'contractaddress' => '0xTokenContractAddress', 'password' => 'YourPassword' ]]);
echo $response->getBody();Код возвращает хеш транзакции:
{ "status": 201, "ok": true, "message": "Succesfully created", "data": { "txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27" }}Как отправить токен TRC20?
Заголовок раздела «Как отправить токен TRC20?»Запрос 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?
Заголовок раздела «Как отправить NFT?»Переводы 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.
Источники
Заголовок раздела «Источники»- EIP-20: Token Standard определяет
transferиbalanceOfдля токенов ERC-20. - TRC20 protocol interface в документации разработчиков TRON.
- Gas and fees в документации разработчиков Ethereum.