Actualizar parámetros del pool

Cómo actualizar pledge, fees, márgenes, pool owner o metadata sin retirar el pool. Basta con re-registrar el certificado con los nuevos valores.

Cualquier parámetro del pool — pledge, margen, coste fijo, relays, metadata, o la lista de pool owners — se actualiza enviando un nuevo certificado de registro con los valores modificados. El pool sigue activo durante todo el proceso.

No pagas el depósito de 500 ADA de nuevo. Solo pagas los fees normales de la transacción (~0.2–0.5 ADA).

---

Casos de uso habituales

Qué quieres cambiar	Qué necesitas
Margen (%)	Nuevo cert de registro
Coste fijo	Nuevo cert de registro
Pledge (aumentar o bajar)	Nuevo cert + mover los ADA a la stake address del owner
URL o hash de metadata	Nuevo cert de registro
Relays (IP, DNS, puerto)	Nuevo cert de registro
Pool owner (stake address)	Nuevo cert de registro

---

Proceso general

El proceso es idéntico al registro inicial del pool, con los valores que quieres cambiar actualizados en el certificado.

1. Generar el nuevo certificado de registro

En la máquina air-gapped (necesitas la cold key):

cardano-cli stake-pool registration-certificate \
  --cold-verification-key-file          $HOME/cold-keys/node.vkey \
  --vrf-verification-key-file           $HOME/pool-keys/vrf.vkey \
  --pool-pledge                         <NUEVO_PLEDGE_EN_LOVELACE> \
  --pool-cost                           <NUEVO_COSTE_EN_LOVELACE> \
  --pool-margin                         <NUEVO_MARGEN> \
  --pool-reward-account-verification-key-file $HOME/keys/stake.vkey \
  --pool-owner-stake-verification-key-file    $HOME/keys/stake.vkey \
  --mainnet \
  --pool-relay-ipv4                     <IP_DEL_RELAY> \
  --pool-relay-port                     3000 \
  --metadata-url                        https://tupool.io/meta.json \
  --metadata-hash                       <HASH_DEL_META> \
  --out-file $HOME/tx/pool-update.cert

Incluye todos los parámetros, no solo los que cambian. Un certificado de registro reemplaza completamente al anterior — si omites los relays, el pool queda sin relays registrados.

2. Construir y enviar la transacción

cardano-cli transaction build \
  --mainnet \
  --tx-in <UTXO> \
  --change-address $(cat $HOME/keys/payment.addr) \
  --certificate-file $HOME/tx/pool-update.cert \
  --witness-override 3 \
  --out-file $HOME/tx/tx-update.raw

Firma con payment key, stake key y cold key:

cardano-cli transaction sign \
  --tx-body-file      $HOME/tx/tx-update.raw \
  --signing-key-file  $HOME/keys/payment.skey \
  --signing-key-file  $HOME/keys/stake.skey \
  --signing-key-file  $HOME/cold-keys/node.skey \
  --mainnet \
  --out-file $HOME/tx/tx-update.signed

cardano-cli transaction submit \
  --tx-file $HOME/tx/tx-update.signed \
  --mainnet

3. Verificar el cambio

cardano-cli query pool-state \
  --stake-pool-id <POOL_ID> \
  --mainnet

Los cambios entran en vigor al inicio de la siguiente época.

---

Casos especiales

Cambiar la metadata

Si cambias el contenido del meta.json, el hash cambia. Necesitas:

1. Actualizar el archivo en la URL pública.

2. Recalcular el hash: cardano-cli stake-pool metadata-hash --pool-metadata-file meta.json

3. Generar nuevo cert con el nuevo hash y la nueva URL si cambió.

Si cambias el contenido del archivo sin actualizar el hash en el certificado, los exploradores mostrarán error de verificación y no mostrarán los metadatos del pool.

Cambiar el pledge

Cambiar el --pool-pledge en el certificado es solo una declaración. Para que el pledge sea efectivo, la stake address del pool owner debe tener delegados al menos esa cantidad de ADA al inicio de cada época. Si el pledge declarado supera el saldo delegado, el pool no recibe recompensas ese epoch.

Añadir o quitar relays

Puedes registrar relays por IP o por DNS:

# Por IP
--pool-relay-ipv4 1.2.3.4 --pool-relay-port 3000

# Por hostname DNS
--pool-relay-port 3001 --pool-relay-host relay.tupool.io

# Varios relays: repite el flag por cada uno
--pool-relay-ipv4 1.2.3.4 --pool-relay-port 3000 \
--pool-relay-host relay.tupool.io --pool-relay-port 3001

Cambiar el pool owner

El pool owner es la stake address que recibe las recompensas del operador. Para cambiarlo, incluye la nueva --pool-owner-stake-verification-key-file en el certificado. La transacción debe ir firmada por la nueva stake key además de la cold key y la payment key.