Enviar transacciones de ETH, BNB, TRX y BTC
Para enviar una moneda nativa con Chaingateway, se envían el remitente, el destinatario, el importe y un secreto de firma a POST /api/v2/{chain}/transactions. Chaingateway firma la transacción, la difunde y devuelve el identificador (txid). El secreto de firma es el password de la wallet para las direcciones protegidas con contraseña, o la privatekey para las direcciones creadas sin contraseña. Este tutorial cubre ETH, BNB, MATIC, TRX, BTC y SOL.
Los tokens como USDT usan otros endpoints, que se describen en Crear transacciones de tokens. Necesita un token de API y una dirección con fondos; consulte el Inicio rápido y Crear direcciones.
¿Cómo envío ETH, BNB o MATIC?
Sección titulada «¿Cómo envío ETH, BNB o MATIC?»Use el endpoint de la cadena: /ethereum, /bsc, /polygon o /arbitrum. El cuerpo para las cadenas EVM tiene tres campos obligatorios y un secreto de firma.
| Campo | Obligatorio | Significado |
|---|---|---|
from | sí | Dirección del remitente, validada como 40 caracteres hexadecimales con un 0x opcional. |
to | sí | Dirección del destinatario, con el mismo formato. |
amount | sí | El importe que se envía. |
password | uno de los dos | Contraseña de la wallet. Obligatoria cuando no hay privatekey. |
privatekey | uno de los dos | Clave privada del remitente, para direcciones creadas sin contraseña. |
gas, gasprice, maxPriorityFeePerGas, maxFeePerGas, nonce, data | no | Ajustes opcionales de la transacción. |
Envíe primero un importe pequeño en la red de pruebas, con la cabecera X-Network: testnet, y compare el cambio de saldo antes de mover fondos reales. La unidad de amount sigue la referencia de la API del endpoint, así que compruébela allí. La cabecera de autorización lleva su token: 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();Una llamada correcta responde con el estado 201 y el hash de la transacción:
{ "status": 201, "ok": true, "message": "Succesfully created transaction", "data": { "txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27" }}¿Cómo envío TRX?
Sección titulada «¿Cómo envío TRX?»POST /api/v2/tron/transactions recibe from, to y amount, además de password o privatekey. Las direcciones de Tron deben cumplir el patrón T seguido de 33 caracteres alfanuméricos. El remitente necesita TRX suficiente para el importe y para los recursos de red que consume la transferencia, como describe el modelo de recursos de 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"}'La respuesta tiene la misma forma que la respuesta EVM anterior, con el hash de la transacción en data.txid. Si firma las transacciones en su propio código, POST /api/v2/tron/transactions/build devuelve una transacción sin firmar y POST /api/v2/tron/transactions/broadcast acepta la firmada en el campo signed_transaction.
¿Cómo envío BTC?
Sección titulada «¿Cómo envío BTC?»Bitcoin envía desde una wallet, no desde una dirección individual. POST /api/v2/bitcoin/transactions exige to, amount, walletname, password y speed. El valor de speed es fast, medium o slow y fija el nivel de comisión. El campo opcional subtractfee descuenta la comisión del importe en lugar de añadirla encima.
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}'Las direcciones de Bitcoin se validan con el patrón (bc1|tb1|[13]) seguido de 25 a 39 caracteres, que acepta los formatos de mainnet y testnet. La guía para desarrolladores de Bitcoin sobre transacciones explica las entradas, las salidas y las comisiones.
¿Cómo envío SOL?
Sección titulada «¿Cómo envío SOL?»POST /api/v2/solana/transactions recibe from, to, amount y la privatekey del remitente. El archivo OpenAPI marca los cuatro como obligatorios y no tiene modo con contraseña para Solana. Los tokens SPL usan POST /api/v2/solana/transactions/SPL con el campo adicional contractaddress, que contiene la dirección mint del token.
¿Cómo fijo el gas y las comisiones en las cadenas EVM?
Sección titulada «¿Cómo fijo el gas y las comisiones en las cadenas EVM?»No hace falta, porque gas, gasprice, maxPriorityFeePerGas y maxFeePerGas son opcionales. Para fijarlos usted mismo, consulte el precio actual con GET /api/v2/ethereum/gasprice, que devuelve en data un valor como {"gasPrice":"12.28"}. Los dos campos max corresponden a los parámetros de comisión de EIP-1559. La documentación de Ethereum sobre transacciones lista todos los campos de una transacción, incluido nonce.
¿Cómo compruebo que la transacción se ha completado?
Sección titulada «¿Cómo compruebo que la transacción se ha completado?»Use el txid de la respuesta. GET /api/v2/ethereum/transactions/{txid} devuelve la transacción, y GET /api/v2/ethereum/transactions/{txid}/decoded la devuelve con los datos de entrada decodificados. Un hash de transacción que el nodo no conoce responde con el estado 422 y el mensaje transaction not found. Para que le avisen cuando lleguen fondos, cree un webhook en lugar de consultar la API de forma repetida.
¿Qué errores puedo esperar?
Sección titulada «¿Qué errores puedo esperar?»Los errores usan el mismo sobre que las llamadas correctas, con ok en false.
| Estado | Mensaje | Causa |
|---|---|---|
| 401 | Wrong password provided | El password no corresponde a la dirección. |
| 422 | insufficient funds for gas * price + value: ... | El saldo no cubre el importe más la comisión. |
| 422 | Data validation failed | Falta un campo o tiene un formato incorrecto. El objeto errors lo nombra. |
| 422 | Error: The wallet passphrase entered was incorrect. | Bitcoin: el password de la wallet es incorrecto. |
Información importante
Sección titulada «Información importante»Chaingateway no almacena sus contraseñas ni las claves privadas de las direcciones sin protección. Si las pierde, nadie puede recuperar los fondos de la dirección. Guarde ambas en un almacén de secretos y nunca en código del lado del cliente.