Crear direcciones de Ethereum y Tron
Una dirección se crea con una sola solicitud: POST /api/v2/{chain}/addresses. Si el cuerpo contiene un password, Chaingateway guarda la clave privada cifrada y la respuesta devuelve solo la dirección. Sin contraseña, la respuesta contiene la clave privada. Este tutorial muestra ambas variantes para Ethereum y Tron. Las mismas solicitudes funcionan para BNB Smart Chain, Polygon y Arbitrum.
Para las llamadas siguientes necesita un token de API. En el Inicio rápido se explica cómo crearlo.
¿Cómo creo una dirección protegida con contraseña?
Sección titulada «¿Cómo creo una dirección protegida con contraseña?»Envíe el campo password en el cuerpo JSON. Para las cadenas EVM, Chaingateway crea un keystore, un formato de archivo cifrado para una clave privada que se describe en la definición Web3 Secret Storage. El keystore se cifra con su contraseña. Quien solo tenga el keystore o solo la contraseña no puede acceder a la dirección, y sus transacciones necesitan la contraseña en lugar de la clave privada.
El password es un valor que usted elige. Chaingateway no lo almacena y no puede recuperarlo. Si pierde la contraseña, pierde el acceso a la dirección, así que guárdela en un gestor de contraseñas o en un almacén de secretos.
curl --request POST \ --url https://app.chaingateway.io/api/v2/ethereum/addresses \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --data '{"password":"choose-a-strong-password"}'import requests
url = "https://app.chaingateway.io/api/v2/ethereum/addresses"payload = {"password": "choose-a-strong-password"}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/addresses';const payload = { password: 'choose-a-strong-password' };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/addresses', [ 'headers' => [ 'Accept' => 'application/json', 'Authorization' => 'Bearer YOUR_API_TOKEN', ], 'json' => ['password' => 'choose-a-strong-password']]);
echo $response->getBody();La respuesta tiene el estado 201. El archivo OpenAPI escribe la clave de la dirección como adderess:
{ "status": 201, "ok": true, "message": "Address created", "data": { "adderess": "0x7d3bC832A0860fD882FF4C2359e10268f4E5CCf8" }}¿Cómo creo una dirección sin contraseña?
Sección titulada «¿Cómo creo una dirección sin contraseña?»Omita el password. La respuesta contiene entonces la clave privada, y cada transacción desde la dirección necesita esa clave en un campo privatekey. Use este modo solo para direcciones de un solo uso, porque una clave privada que viaja en cada solicitud se filtra con facilidad. El ejemplo crea una dirección de Tron.
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/addresses \ --header 'Accept: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN'import requests
url = "https://app.chaingateway.io/api/v2/tron/addresses"headers = { 'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'}
response = requests.post(url, headers=headers)print(response.json())const axios = require('axios');
const url = 'https://app.chaingateway.io/api/v2/tron/addresses';const headers = { 'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'};
axios.post(url, {}, { 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/tron/addresses', [ 'headers' => [ 'Accept' => 'application/json', 'Authorization' => 'Bearer YOUR_API_TOKEN', ]]);
echo $response->getBody();Una dirección de Tron creada sin contraseña devuelve directamente el material de la clave:
{ "status": 201, "ok": true, "message": "Address created", "data": { "privateKey": "59f1c6200e01a2ca9471411f10198bfa63678d0e87cc2ca30f9c4a68dee78edc", "publicKey": "040fe6e677442c36f7fdd5535ba3ff1cef0110d78363420f7e24b65298990e3467aed68b9a67e1396d84753db25b32a2fa3e1fc0a673f01638e9bcfab2d8f4ceb5", "hexAddress": "41a56a6505ffbee78eb916dd44f4846874deddaebd", "address": "TR3qx91smURF3R455V1ubqtoUsZbgqikfg" }}Guarde la privateKey junto con la address en un lugar seguro. La clave de este ejemplo es un valor de muestra, así que nunca la financie. La documentación de cuentas de Tron explica cómo se relacionan la dirección base58 y la dirección hex.
¿Qué hago cuando la dirección ya existe?
Sección titulada «¿Qué hago cuando la dirección ya existe?»Consulte el saldo, financie la dirección y envíe desde ella. GET /api/v2/ethereum/balances/{address} devuelve el saldo de la dirección como cadena de texto:
{ "status": 200, "ok": true, "message": "Balance fetched", "data": "0.000000000000000000"}Una dirección nueva empieza con saldo cero. Envíele monedas desde una wallet que usted controle o, si trabaja con X-Network: testnet, desde el faucet de la red de pruebas de la cadena. GET /api/v2/ethereum/addresses lista todas las direcciones que ha creado y no ha eliminado. Si quiere recibir una notificación cuando lleguen fondos, cree un webhook para la dirección. El envío de fondos desde la dirección se explica en Crear transacciones.
Bitcoin y Solana funcionan de otra manera. En Bitcoin primero se crea una wallet con POST /api/v2/bitcoin/wallets y después se le añaden direcciones. En Solana, POST /api/v2/solana/addresses crea la dirección. Gestión de wallets describe ambos casos.
¿Qué errores puede devolver la creación de direcciones?
Sección titulada «¿Qué errores puede devolver la creación de direcciones?»Las llamadas de direcciones usan el sobre estándar con ok en false cuando fallan. Un token ausente o no válido devuelve el estado 401 con {"message":"Unauthenticated."}. Un cuerpo que no supera la validación devuelve el estado 422 con Data validation failed y los nombres de los campos en errors. Cuando se agota el límite de direcciones de su plan, la API responde con el estado 422 y Your address limit exceeded. Please upgrade your plan. El archivo OpenAPI muestra este mensaje para las wallets de Bitcoin.
DELETE /api/v2/ethereum/addresses/{address} elimina una dirección y reduce el número de direcciones que cuentan para su plan. Elimine las direcciones que ya no necesite, pero exporte antes la clave privada si la dirección aún puede contener fondos.
¿Qué formato tienen las direcciones en cada cadena?
Sección titulada «¿Qué formato tienen las direcciones en cada cadena?»Ethereum y las demás cadenas EVM usan direcciones de 20 bytes, escritas como 40 caracteres hexadecimales con el prefijo 0x. La documentación de cuentas de Ethereum describe cómo se deriva una cuenta de propiedad externa a partir de un par de claves. Las direcciones de Tron empiezan por T y tienen 34 caracteres, el formato que la API valida con el patrón T[a-zA-Z0-9]{33}. La documentación de cuentas de TRON es la referencia principal de ese formato.