> For the complete documentation index, see [llms.txt](https://es-kb.topopool.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://es-kb.topopool.com/novedades/migrar-pledge-hw.md).

# Migrar pledge a Ledger Nano

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.

{% hint style="danger" %}
Nunca introduzcas la frase semilla de tu hardware wallet en ningún ordenador. Si alguien te pide que lo hagas por cualquier motivo, es un intento de robo. La frase semilla solo existe en papel, en un lugar seguro.
{% endhint %}

***

## 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](https://github.com/vacuumlabs/cardano-hw-cli/releases). 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:

```bash
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
```

{% hint style="info" %}
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.
{% endhint %}

### 2. Construir las direcciones

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

```bash
cardano-cli stake-address build \
  --stake-verification-key-file hw-stake.vkey \
  --mainnet \
  --out-file hw-stake.addr

cardano-cli address build \
  --payment-verification-key-file hw-payment.vkey \
  --stake-verification-key-file   hw-stake.vkey \
  --mainnet \
  --out-file hw-payment.addr
```

### 3. Registrar la stake address

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

```bash
cardano-cli stake-address registration-certificate \
  --stake-verification-key-file hw-stake.vkey \
  --key-reg-deposit-amt 2000000 \
  --out-file hw-stake-reg.cert
```

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.

{% hint style="warning" %}
Hasta que la transacción de re-registro sea confirmada y la delegación de la nueva dirección esté activa, el pledge puede aparecer como insatisfecho en los exploradores. Es temporal.
{% endhint %}

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.