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

Отправка транзакций 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.

Отправка нативной монеты: передать from, to, amount и пароль или приватный ключ, Chaingateway подписывает и отправляет транзакцию в сеть, ответ содержит txid, затем читается статус транзакции POST /api/v2/{chain}/transactions from, to, amount, password или privatekey Chaingateway подписывает и отправляет всеть Ответ: txid статус 201, сообщение Succesfully createdtransaction GET /api/v2/{chain}/transactions/{txid} проверить транзакцию в сети
Те же четыре шага действуют в каждой сети, различаются только поля тела запроса.

Используйте эндпоинт нужной сети: /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"
}'

Успешный вызов отвечает статусом 201 и хешем транзакции:

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

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.

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 по транзакциям.

POST /api/v2/solana/transactions принимает from, to, amount и privatekey отправителя. Файл OpenAPI помечает все четыре поля как обязательные, режима с паролем для Solana нет. Токены SPL отправляются через POST /api/v2/solana/transactions/SPL с дополнительным полем contractaddress, в котором указан адрес mint токена.

Обычно этого не требуется: поля 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.

СтатусСообщениеПричина
401Wrong password providedpassword не подходит к адресу.
422insufficient funds for gas * price + value: ...Баланса не хватает на сумму и комиссию.
422Data validation failedПоле отсутствует или имеет неверный формат. Его имя указано в объекте errors.
422Error: The wallet passphrase entered was incorrect.Bitcoin: неверный password кошелька.

Chaingateway не хранит ваши пароли и приватные ключи незащищённых адресов. Если вы их потеряете, никто не сможет вернуть средства с адреса. Храните их в хранилище секретов, а не в клиентском коде.