Saltearse al contenido

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.

Envío de una moneda nativa: se envían from, to, amount y la contraseña o clave privada, Chaingateway firma y difunde la transacción, la respuesta devuelve el txid y después se consulta el estado de la transacción POST /api/v2/{chain}/transactions from, to, amount, password o privatekey Chaingateway firma y difunde Respuesta: txid estado 201, mensaje Succesfully createdtransaction GET /api/v2/{chain}/transactions/{txid} comprobar la transacción en la cadena
Los mismos cuatro pasos valen para todas las cadenas; solo cambian los campos del cuerpo.

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.

CampoObligatorioSignificado
fromsíDirección del remitente, validada como 40 caracteres hexadecimales con un 0x opcional.
tosíDirección del destinatario, con el mismo formato.
amountsíEl importe que se envía.
passworduno de los dosContraseña de la wallet. Obligatoria cuando no hay privatekey.
privatekeyuno de los dosClave privada del remitente, para direcciones creadas sin contraseña.
gas, gasprice, maxPriorityFeePerGas, maxFeePerGas, nonce, datanoAjustes 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.

Ventana de terminal
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"
}'

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"
}
}

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.

Ventana de terminal
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.

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.

Ventana de terminal
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.

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.

Los errores usan el mismo sobre que las llamadas correctas, con ok en false.

EstadoMensajeCausa
401Wrong password providedEl password no corresponde a la dirección.
422insufficient funds for gas * price + value: ...El saldo no cubre el importe más la comisión.
422Data validation failedFalta un campo o tiene un formato incorrecto. El objeto errors lo nombra.
422Error: The wallet passphrase entered was incorrect.Bitcoin: el password de la wallet es incorrecto.

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.