For the complete documentation index, see llms.txt. This page is also available as Markdown.

Migrar pledge a Ledger Nano

Cómo migrar el pledge de un stake pool a una hardware wallet (Ledger/Trezor) usando cardano-hw-cli. Guía actualizada para Conway era.

Usar una hardware wallet para custodiar las claves de pledge añade una capa de seguridad significativa. El proceso implica exportar las claves de verificación del dispositivo, construir las direcciones correspondientes y re-registrar el pool con el nuevo pledge.


Requisitos previos

  • Hardware wallet (Ledger o Trezor) con la aplicación Cardano instalada. Instala siempre la última versión disponible desde el gestor oficial del dispositivo (Ledger Live o Trezor Suite).

  • cardano-hw-cli: descarga la última versión disponible en los releases de GitHub. No uses versiones antiguas; los comandos y el formato de salida cambian entre versiones.

  • cardano-cli instalado y funcionando.


Flujo general

1. Exportar las claves de verificación del hardware wallet

Conecta el dispositivo y, con la aplicación Cardano abierta en el dispositivo, exporta las claves de verificación de pago y stake. El comando exacto puede variar según la versión de cardano-hw-cli; consulta el README del release que hayas descargado:

cardano-hw-cli address key-gen \
  --path 1852H/1815H/0H/0/0 \
  --verification-key-file hw-payment.vkey \
  --hw-signing-file hw-payment.hwsfile

cardano-hw-cli address key-gen \
  --path 1852H/1815H/0H/2/0 \
  --verification-key-file hw-stake.vkey \
  --hw-signing-file hw-stake.hwsfile

Los flags y la sintaxis exacta dependen de la versión instalada. Revisa cardano-hw-cli --help o la documentación del release antes de ejecutar.

2. Construir las direcciones

Con las claves de verificación exportadas, construye la dirección de pago y la dirección de stake:

3. Registrar la stake address

Si la stake address del hardware wallet no está registrada en cadena, necesitas registrarla antes de usarla como pledge:

Incluye este certificado en una transacción y fírmala con cardano-hw-cli. La firma con hardware wallet requiere que el dispositivo esté conectado y que apruebes la transacción en pantalla del dispositivo.

4. Re-registrar el pool con el nuevo pledge

Genera un nuevo certificado de registro del pool apuntando a la nueva stake address como pledge y envía la transacción. Este paso requiere la cold key del pool (máquina air-gapped) y la firma del hardware wallet para la parte de stake.

El flujo completo de firma con hardware wallet para transacciones de certificados está documentado en el repositorio de cardano-hw-cli. Dado que los detalles cambian entre versiones, consulta siempre la documentación del release que estés usando.

Última actualización