Saltearse al contenido

Enviar tokens ERC20 y TRC20

Para enviar un token ERC20, BEP20 o TRC20 con Chaingateway, se envían el remitente, el destinatario, el importe y la dirección del contrato del token al endpoint de tokens de la cadena, junto con la contraseña de la wallet o la clave privada. Una transferencia de tokens es una llamada a un smart contract, así que el remitente también necesita la moneda nativa de la cadena para pagar la comisión: ETH, BNB, MATIC o TRX. La respuesta devuelve el hash de la transacción.

Para el token de API, consulte el Inicio rápido. En Ethereum, BNB Smart Chain y Polygon, la dirección de envío debe haberse creado con la API de Chaingateway o importado en ella. De lo contrario, falla el paso de firma. Crear direcciones muestra cómo crear una.

Transferencia de tokens: se comprueba el saldo del token, se verifica que el remitente tiene moneda nativa para la comisión, se envía la transferencia con la dirección del contrato y se lee el hash de la transacción GET/api/v2/{chain}/balances/{address}/erc20/{contract} ¿tiene el remitente tokens suficientes? El remitente tiene moneda nativa para lacomisión ETH, BNB, MATIC o TRX POST /api/v2/{chain}/transactions/erc20 from, to, amount, contractaddress, password oprivatekey Respuesta: txid estado 201
La comprobación del saldo y la de la comisión van antes de la transferencia.

¿Qué endpoint envía un token en cada cadena?

Sección titulada «¿Qué endpoint envía un token en cada cadena?»

Cada cadena tiene su propio endpoint de tokens, con el nombre del estándar del token. El cuerpo es el mismo en todas las cadenas EVM.

BlockchainRuta de la APIEstándar
Ethereum/api/v2/ethereum/transactions/erc20ERC-20
Binance Smart Chain/api/v2/bsc/transactions/bep20BEP20
Polygon/api/v2/polygon/transactions/erc20ERC-20
Arbitrum/api/v2/arbitrum/transactions/erc20ERC-20
Tron/api/v2/tron/transactions/trc20TRC20
Solana/api/v2/solana/transactions/SPLSPL

Para ejecutar la solicitud en una red de pruebas, añada la cabecera X-Network: testnet. Las redes de pruebas se listan en Redes compatibles. Bitcoin no tiene endpoint de tokens.

Envíe los campos siguientes a la ruta de su cadena. El ejemplo envía un token ERC20 en Ethereum.

  • from: la dirección del remitente.
  • to: la dirección del destinatario.
  • amount: la cantidad de tokens que se envía.
  • contractaddress: la dirección del contrato del token.
  • password: la contraseña de la wallet, obligatoria cuando no hay privatekey.
  • privatekey: la clave privada del remitente, para direcciones creadas sin contraseña.

gas, gasprice, maxPriorityFeePerGas, maxFeePerGas y nonce son opcionales.

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

El código devuelve el hash de la transacción:

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

La solicitud TRC20 funciona casi igual que la ERC20. La ruta es /api/v2/tron/transactions/trc20, las direcciones son direcciones de Tron y se firma con password o privatekey. El archivo OpenAPI marca from, to, contractaddress y amount como obligatorios. El ejemplo usa la clave privada de una dirección creada sin contraseña.

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

Crear transacciones de tokens TRC20 recorre todo el flujo TRC20, incluida la lectura del contrato y los endpoints de firma propia.

¿Cómo compruebo el saldo de un token antes de enviar?

Sección titulada «¿Cómo compruebo el saldo de un token antes de enviar?»

Consulte primero el saldo, para no enviar una transacción que va a fallar. En las cadenas EVM, GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} devuelve el saldo de un token. GET /api/v2/ethereum/balances/{address}/erc20 lista los saldos de tokens de una wallet. En BNB Smart Chain el segmento es bep20, y en Tron es GET /api/v2/tron/balances/{address}/trc20/{contract_address}. GET /api/v2/ethereum/erc20/{contract_address} devuelve la información del contrato de un token.

¿Por qué falla la transferencia de mi token?

Sección titulada «¿Por qué falla la transferencia de mi token?»

La mayoría de los fallos tienen una de tres causas, y cada una devuelve un mensaje distinto.

  • Una contraseña incorrecta devuelve el estado 401 con Wrong password provided.
  • Un campo ausente o mal formado devuelve el estado 422 con Data validation failed y el nombre del campo en errors.
  • Un remitente sin moneda nativa suficiente devuelve el estado 422 con el mensaje del nodo, por ejemplo insufficient funds for gas * price + value. En Tron, el equivalente es balance is not sufficient.

La última causa sorprende a quien solo tiene tokens: la comisión se paga en ETH, BNB, MATIC o TRX, nunca en el token. Lea la documentación de gas de Ethereum para el modelo de comisiones en las cadenas EVM y el modelo de recursos de TRON para energy y bandwidth. Si sus direcciones de TRON tienen tokens pero no TRX, Patrocinar comisiones TRC20 lista las opciones.

Las transferencias de NFT usan los endpoints ERC721, por ejemplo POST /api/v2/ethereum/transactions/erc721. El cuerpo tiene los mismos campos de firma que arriba, pero en lugar de amount recibe tokenId, el identificador del NFT. from, contractaddress, to y tokenId son obligatorios. GET /api/v2/ethereum/nfts/{contract_address}/owner/{token_id} devuelve el propietario actual, y .../uri/{token_id} devuelve la URI del token. El estándar está definido en EIP-721.