> 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/mantenimiento-del-pool/actualizar-parametros.md).

# Actualizar parámetros del pool

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.

{% hint style="info" %}
No pagas el depósito de 500 ADA de nuevo. Solo pagas los fees normales de la transacción (\~0.2–0.5 ADA).
{% endhint %}

***

## 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):

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

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

### 2. Construir y enviar la transacción

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

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

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

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

### 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:

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