Отправка транзакций ETH, BNB, TRX и BTC
Чтобы отправить нативную монету через Chaingateway, передайте отправителя, получателя, сумму и секрет для подписи в POST /api/v2/{chain}/transactions. Chaingateway подписывает транзакцию, отправляет её в сеть и возвращает идентификатор транзакции (txid). Секрет для подписи — это password кошелька для адресов, защищённых паролем, или privatekey для адресов, созданных без пароля. Руководство охватывает ETH, BNB, MATIC, TRX, BTC и SOL.
Токены вроде USDT используют другие эндпоинты, они описаны в разделе Отправка переводов токенов ERC20 и TRC20. Вам нужны API-токен и пополненный адрес, см. Быстрый старт и Создание адресов Ethereum и Tron.
Как отправить ETH, BNB или MATIC?
Заголовок раздела «Как отправить ETH, BNB или MATIC?»Используйте эндпоинт нужной сети: /ethereum, /bsc, /polygon или /arbitrum. Тело запроса для EVM-сетей содержит три обязательных поля и секрет для подписи.
| Поле | Обязательное | Значение |
|---|---|---|
from | да | Адрес отправителя, проверяется как 40 hex-символов с необязательным 0x. |
to | да | Адрес получателя, тот же формат. |
amount | да | Отправляемая сумма. |
password | одно из двух | Пароль кошелька. Обязателен, если privatekey не указан. |
privatekey | одно из двух | Приватный ключ отправителя для адресов, созданных без пароля. |
gas, gasprice, maxPriorityFeePerGas, maxFeePerGas, nonce, data | нет | Необязательные параметры транзакции. |
Сначала отправьте небольшую сумму в тестовой сети с заголовком X-Network: testnet и сверьте изменение баланса, прежде чем переводить реальные средства. Единица измерения amount определяется справочником API для эндпоинта, поэтому проверьте её там. Заголовок авторизации содержит ваш токен: Authorization: Bearer YOUR_API_TOKEN.
curl --request POST \ --url https://app.chaingateway.io/api/v2/ethereum/transactions \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --data '{ "from": "0xYourSenderAddress", "to": "0xRecipientAddress", "amount": "0.1", "password": "YourPassword"}'import requests
url = "https://app.chaingateway.io/api/v2/ethereum/transactions"payload = { "from": "0xYourSenderAddress", "to": "0xRecipientAddress", "amount": "0.1", "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())const axios = require('axios');
const url = 'https://app.chaingateway.io/api/v2/ethereum/transactions';const payload = { from: '0xYourSenderAddress', to: '0xRecipientAddress', amount: '0.1', 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); });<?phprequire 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();$response = $client->post('https://app.chaingateway.io/api/v2/ethereum/transactions', [ 'headers' => [ 'Accept' => 'application/json', 'Authorization' => 'Bearer YOUR_API_TOKEN', ], 'json' => [ 'from' => '0xYourSenderAddress', 'to' => '0xRecipientAddress', 'amount' => '0.1', 'password' => 'YourPassword' ]]);
echo $response->getBody();Успешный вызов отвечает статусом 201 и хешем транзакции:
{ "status": 201, "ok": true, "message": "Succesfully created transaction", "data": { "txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27" }}Как отправить TRX?
Заголовок раздела «Как отправить TRX?»POST /api/v2/tron/transactions принимает from, to и amount, а также password или privatekey. Адреса Tron должны соответствовать шаблону: T и 33 буквенно-цифровых символа. Отправителю нужно достаточно TRX на сумму перевода и на сетевые ресурсы, которые тратит перевод, как описывает модель ресурсов TRON.
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/transactions \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --data '{ "from": "YourSenderAddress", "to": "RecipientAddress", "amount": 1, "privatekey": "YourPrivateKey"}'Ответ имеет ту же структуру, что и ответ EVM выше, хеш транзакции лежит в data.txid. Если вы подписываете транзакции в собственном коде, POST /api/v2/tron/transactions/build возвращает неподписанную транзакцию, а POST /api/v2/tron/transactions/broadcast принимает подписанную в поле signed_transaction.
Как отправить BTC?
Заголовок раздела «Как отправить BTC?»Bitcoin отправляет средства с кошелька, а не с отдельного адреса. POST /api/v2/bitcoin/transactions требует to, amount, walletname, password и speed. Значение speed — fast, medium или slow, оно задаёт уровень комиссии. Необязательное поле subtractfee вычитает комиссию из суммы вместо того, чтобы добавлять её сверху.
curl --request POST \ --url https://app.chaingateway.io/api/v2/bitcoin/transactions \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --data '{ "to": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq", "amount": 0.0001, "walletname": "mywallet", "password": "YourWalletPassword", "speed": "medium", "subtractfee": false}'Адреса Bitcoin проверяются по шаблону (bc1|tb1|[13]) и 25–39 следующих символов, он принимает форматы mainnet и testnet. Входы, выходы и комиссии объясняет руководство разработчика Bitcoin по транзакциям.
Как отправить SOL?
Заголовок раздела «Как отправить SOL?»POST /api/v2/solana/transactions принимает from, to, amount и privatekey отправителя. Файл OpenAPI помечает все четыре поля как обязательные, режима с паролем для Solana нет. Токены SPL отправляются через POST /api/v2/solana/transactions/SPL с дополнительным полем contractaddress, в котором указан адрес mint токена.
Как задать gas и комиссии в EVM-сетях?
Заголовок раздела «Как задать gas и комиссии в EVM-сетях?»Обычно этого не требуется: поля gas, gasprice, maxPriorityFeePerGas и maxFeePerGas необязательны. Чтобы задать их самостоятельно, прочитайте текущую цену через GET /api/v2/ethereum/gasprice. В data вернётся значение вроде {"gasPrice":"12.28"}. Два поля max соответствуют параметрам комиссии из EIP-1559. Документация Ethereum по транзакциям перечисляет все поля транзакции, включая nonce.
Как проверить, что транзакция прошла?
Заголовок раздела «Как проверить, что транзакция прошла?»Используйте txid из ответа. GET /api/v2/ethereum/transactions/{txid} возвращает транзакцию, а GET /api/v2/ethereum/transactions/{txid}/decoded возвращает её с декодированными входными данными. Если узел не знает хеш транзакции, ответ приходит со статусом 422 и сообщением transaction not found. Чтобы получать уведомление о поступлении средств, создайте вебхук вместо опроса.
Какие ошибки можно ожидать?
Заголовок раздела «Какие ошибки можно ожидать?»Ошибки используют ту же обёртку, что и успешные вызовы, только ok равен false.
| Статус | Сообщение | Причина |
|---|---|---|
| 401 | Wrong password provided | password не подходит к адресу. |
| 422 | insufficient funds for gas * price + value: ... | Баланса не хватает на сумму и комиссию. |
| 422 | Data validation failed | Поле отсутствует или имеет неверный формат. Его имя указано в объекте errors. |
| 422 | Error: The wallet passphrase entered was incorrect. | Bitcoin: неверный password кошелька. |
Важная информация
Заголовок раздела «Важная информация»Chaingateway не хранит ваши пароли и приватные ключи незащищённых адресов. Если вы их потеряете, никто не сможет вернуть средства с адреса. Храните их в хранилище секретов, а не в клиентском коде.