Wallets Tron protegidos con contraseña por API
Cree wallets Tron con contraseña para que la API nunca devuelva la clave privada. Cómo crear, enviar, exportar y cambiar la contraseña de una dirección.
Revisado por Maurice Sobiera
Un wallet Tron protegido con contraseña es una dirección que se crea mediante la API de Chaingateway con el parámetro password. La clave privada se cifra con esa contraseña y no se devuelve en la respuesta. Para enviar desde la dirección, se pasa la contraseña en lugar de la clave. Chaingateway no guarda la contraseña, así que una contraseña perdida no se puede recuperar.
¿Qué cambió con los wallets protegidos con contraseña?
Hasta el 18 de febrero de 2025, las direcciones Tron creadas mediante la API devolvían la clave privada en la respuesta. Eso sirve para direcciones temporales, pero deja la clave en sus registros, en su base de datos y en cada sistema que toca la respuesta. Los wallets protegidos con contraseña son la alternativa. La documentación de gestión de wallets los recomienda y describe la clave como cifrada con su contraseña y con los propios mecanismos de cifrado de Chaingateway. La variante sin protección sigue existiendo: si omite password, recibe la clave privada directamente y debe guardarla usted mismo.
¿Cómo se crea un wallet Tron protegido con contraseña?
Envíe una solicitud POST a /api/v2/tron/addresses con un password:
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/addresses \ --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "password": "your_secure_password" }'La respuesta contiene la nueva dirección en data. No contiene la clave privada. Use una contraseña larga y aleatoria de un gestor de contraseñas. La hoja de referencia de autenticación de OWASP considera débiles las contraseñas de menos de 15 caracteres cuando no las protege un segundo factor, y la contraseña de un wallet no tiene ninguno. Guárdela en su gestor de secretos, porque la misma contraseña se necesita en cada solicitud posterior sobre esta dirección.
¿Cómo se envía desde un wallet protegido con contraseña?
Pase el campo password en lugar de privatekey. Una transferencia de TRX necesita from, to, amount y password:
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/transactions \ --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "from": "TSenderAddress", "to": "TDestinationAddress", "amount": 100, "password": "your_secure_password"}'El mismo campo password funciona en POST /api/v2/tron/transactions/trc20, .../trc721 y .../trc10. Las transferencias TRC20 también necesitan un contractaddress. Una transferencia TRC20 desde una dirección sin TRX ni Energy en stake falla con estado 422, como explica el tutorial de TronFuel y Paymaster. El Paymaster de Chaingateway está obsoleto, y TronFuel es la forma recomendada de cubrir la comisión.
¿Cómo se exporta la clave, se cambia la contraseña o se importa una clave?
Tres endpoints más completan el ciclo de vida del wallet. Cada uno recibe la dirección en la ruta:
| Tarea | Solicitud | Cuerpo |
|---|---|---|
| Exportar la clave privada | POST /api/v2/tron/addresses/export/{address} | password |
| Cambiar la contraseña | POST /api/v2/tron/addresses/{address} | old_password, new_password |
| Importar una clave existente | POST /api/v2/tron/addresses/import | address, privatekey, password |
La importación sirve para pasar una dirección existente y sin protección a una protegida con contraseña. Tras la importación, envíe desde la dirección con la contraseña y deje de pasar la clave. Borre la clave de su propio almacenamiento cuando haya verificado una transferencia de prueba en testnet. La exportación es la salida de emergencia: le permite abandonar el servicio con su clave, y requiere la contraseña.
¿Cuáles son los límites de la protección con contraseña?
Una cuenta Tron está controlada por su clave privada, como indica la documentación de Tron, así que es la clave lo que debe proteger. La contraseña protege la clave en reposo. No protege un servidor comprometido que ya conoce la contraseña, y no ayuda si la contraseña se pierde. Según la documentación, Chaingateway no puede restaurar un wallet cuya contraseña se haya perdido. Haga una copia de seguridad de la contraseña y pruebe la exportación una vez antes de mover fondos reales. Mantenga los saldos grandes en un wallet cuya clave tenga usted mismo, y use los wallets de la API como wallets calientes con saldos limitados.
Antes de mover fondos reales, ejecute esta lista de comprobación:
- Cree un wallet en testnet y envíe una transferencia pequeña con la contraseña.
- Exporte la clave privada una vez y confirme que corresponde a la dirección.
- Cambie la contraseña y confirme que un envío con la contraseña antigua falla y que uno con la nueva funciona.
- Guarde la contraseña en su gestor de secretos y elimínela del historial de la shell y de los registros.
Empiece por testnet. Añada el encabezado X-Network: testnet a cada solicitud anterior, cree un wallet en Nile y repita crear, enviar, exportar y cambiar la contraseña. La página de redes compatibles enumera las redes de prueba, y la documentación de redes de Tron explica Nile y Shasta.
¿Qué preguntas surgen con más frecuencia?
¿Funciona un wallet con contraseña en otras cadenas?
Sí. La documentación de gestión de wallets describe el parámetro password para /api/v2/{blockchain}/addresses, y el archivo OpenAPI enumera los endpoints de direcciones con el mismo patrón para Ethereum, BNB Smart Chain, Polygon y Arbitrum.
¿Puede Chaingateway restablecer una contraseña perdida?
No. La documentación indica que Chaingateway no puede restaurar la clave privada de un wallet cuya contraseña se ha perdido. Exporte la clave una vez y guárdela en su propia bóveda.
¿Necesitan los webhooks la contraseña del wallet?
No. Un webhook vigila una dirección y solo necesita la dirección, una URL y un filtro. La contraseña se necesita para firmar transacciones, exportar la clave y cambiar la contraseña.
¿Puedo combinar wallets con contraseña y wallets sin protección?
Sí. Cada dirección se crea con o sin contraseña. En una solicitud, envíe password o privatekey, como describe el archivo OpenAPI para los endpoints de transacciones.
Cómo escribimos estos artículos
¿Listo para construirlo tú mismo? Obtenga su clave de API — prueba de 7 días, sin tarjeta — o consulte API de Tron para la referencia completa de los endpoints.