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.
¿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.
| Blockchain | Ruta de la API | Estándar |
|---|---|---|
| Ethereum | /api/v2/ethereum/transactions/erc20 | ERC-20 |
| Binance Smart Chain | /api/v2/bsc/transactions/bep20 | BEP20 |
| Polygon | /api/v2/polygon/transactions/erc20 | ERC-20 |
| Arbitrum | /api/v2/arbitrum/transactions/erc20 | ERC-20 |
| Tron | /api/v2/tron/transactions/trc20 | TRC20 |
| Solana | /api/v2/solana/transactions/SPL | SPL |
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.
¿Cómo envío un token ERC20 o BEP20?
Sección titulada «¿Cómo envío un token ERC20 o BEP20?»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 hayprivatekey.privatekey: la clave privada del remitente, para direcciones creadas sin contraseña.
gas, gasprice, maxPriorityFeePerGas, maxFeePerGas y nonce son opcionales.
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" }'const axios = require('axios');
const url = 'https://app.chaingateway.io/api/v2/ethereum/transactions/erc20';const payload = { from: '0xYourSenderAddress', to: '0xRecipientAddress', amount: 100, contractaddress: '0xTokenContractAddress', 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); });import requests
url = "https://app.chaingateway.io/api/v2/ethereum/transactions/erc20"payload = { "from": "0xYourSenderAddress", "to": "0xRecipientAddress", "amount": 100, "contractaddress": "0xTokenContractAddress", "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())<?phprequire 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();$response = $client->post('https://app.chaingateway.io/api/v2/ethereum/transactions/erc20', [ 'headers' => [ 'Accept' => 'application/json', 'Authorization' => 'Bearer YOUR_API_TOKEN', ], 'json' => [ 'from' => '0xYourSenderAddress', 'to' => '0xRecipientAddress', 'amount' => 100, 'contractaddress' => '0xTokenContractAddress', 'password' => 'YourPassword' ]]);
echo $response->getBody();El código devuelve el hash de la transacción:
{ "status": 201, "ok": true, "message": "Succesfully created", "data": { "txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27" }}¿Cómo envío un token TRC20?
Sección titulada «¿Cómo envío un token TRC20?»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.
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 failedy el nombre del campo enerrors. - 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 esbalance 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.
¿Cómo envío un NFT?
Sección titulada «¿Cómo envío un NFT?»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.
Fuentes
Sección titulada «Fuentes»- EIP-20: Token Standard define
transferybalanceOfpara los tokens ERC-20. - TRC20 protocol interface en la documentación para desarrolladores de TRON.
- Gas and fees en la documentación para desarrolladores de Ethereum.