Configuración de un nodo

Archivos de configuración, topología P2P y parámetros clave para relay y block producer en mainnet. Cardano-node 11.x / Conway era.

Vamos a preparar los archivos de configuración que necesita cada nodo para arrancar y conectarse a la red principal de Cardano. Tenemos dos tipos de nodo: el relay (expuesto a internet) y el block producer (aislado, solo habla con tus relays).

---

Estructura de directorios

Antes de descargar nada, creamos la estructura base:

mkdir -p $HOME/cardano/relay/config
mkdir -p $HOME/cardano/bp/config
mkdir -p $HOME/cardano/relay/db
mkdir -p $HOME/cardano/bp/db

Usamos $HOME para evitar rutas hardcodeadas. Si prefieres una ubicación distinta (por ejemplo /opt/cardano), simplemente reemplaza $HOME/cardano en todos los comandos.

---

Descargar los archivos de configuración

Los archivos oficiales de mainnet están en:

https://book.world.dev.cardano.org/environments/mainnet/

Descargamos cada archivo explícitamente:

cd $HOME/cardano/relay/config

wget https://book.world.dev.cardano.org/environments/mainnet/config.json
wget https://book.world.dev.cardano.org/environments/mainnet/byron-genesis.json
wget https://book.world.dev.cardano.org/environments/mainnet/shelley-genesis.json
wget https://book.world.dev.cardano.org/environments/mainnet/alonzo-genesis.json
wget https://book.world.dev.cardano.org/environments/mainnet/conway-genesis.json
wget https://book.world.dev.cardano.org/environments/mainnet/topology.json

Necesitamos los seis archivos. Desde el hard fork Chang, conway-genesis.json es obligatorio — el nodo no arranca sin él.

Luego copiamos los mismos archivos de génesis al BP (la topología será diferente):

cp $HOME/cardano/relay/config/*.json $HOME/cardano/bp/config/

---

Archivos de génesis

No necesitamos modificar estos archivos. Son parámetros de red firmados y el nodo los verifica al arrancar:

Archivo	Qué contiene
byron-genesis.json	Parámetros de la era Byron
shelley-genesis.json	Parámetros de Shelley (epoch length, slot duration, etc.)
alonzo-genesis.json	Parámetros de smart contracts (Plutus)
conway-genesis.json	Parámetros de gobernanza (Chang/Conway era)

---

config.json — qué necesitamos cambiar

El archivo descargado tiene más de 100 campos. No lo reemplazamos entero — abrimos el que descargamos y tocamos los campos que nos interesan:

nano $HOME/cardano/relay/config/config.json

Campos clave a revisar y ajustar

P2P habilitado (obligatorio):

"EnableP2P": true

Puerto de Prometheus (métricas para Grafana):

"hasPrometheus": ["127.0.0.1", 12798]

Puerto EKG (panel interno, útil para debug):

"hasEKG": 12789

Nivel mínimo de logs — Info es suficiente en producción:

"minSeverity": "Info"

Rotación de logs:

"rotation": {
  "rpLogLimitBytes": 5000000,
  "rpMaxAgeHours": 24,
  "rpKeepFilesNum": 10
}

Para el BP, podemos usar el mismo config.json del relay. La diferencia real está en la topología, no en la configuración del nodo.

---

Topología

Aquí es donde relay y BP tienen configuraciones completamente distintas.

Relay — P2P (formato actual)

El formato antiguo con "Producers" es legacy. Con P2P activo en mainnet, necesitamos el formato con localRoots, publicRoots y bootstrapPeers.

nano $HOME/cardano/relay/config/topology.json

RELAY — P2P

{
  "bootstrapPeers": [
    {"address": "backbone.cardano.iog.io", "port": 3501},
    {"address": "backbone.mainnet.emurgornd.com", "port": 3717}
  ],
  "localRoots": [
    {
      "accessPoints": [
        {"address": "IP-DE-TU-BP", "port": 3000}
      ],
      "advertise": false,
      "valency": 1
    }
  ],
  "publicRoots": [
    {
      "accessPoints": [
        {"address": "backbone.cardano.iog.io", "port": 3501}
      ],
      "advertise": false
    }
  ],
  "useLedgerAfterSlot": 128908821
}

Qué significa cada sección:

• bootstrapPeers — peers confiables para el arranque inicial, antes de tener el ledger sincronizado.

• localRoots — peers que siempre queremos mantener conectados (nuestro BP). advertise: false significa que no anunciamos esta dirección a la red.

• publicRoots — peers públicos para descubrimiento.

• useLedgerAfterSlot — a partir de este slot, el nodo usa el ledger para descubrir peers. Dejamos el valor por defecto.

Reemplaza IP-DE-TU-BP con la IP privada de tu block producer.

Si tienes varios relays, añade cada uno en localRoots del otro relay con advertise: true para que tu pool sea descubrible en la red.

---

Block Producer — topología simple

El BP solo necesita conectarse a sus propios relays. Sin peers públicos, sin bootstrapPeers:

BP — Topología

{
  "localRoots": [
    {
      "accessPoints": [
        {"address": "IP-DE-TU-RELAY-1", "port": 3000}
      ],
      "advertise": false,
      "valency": 1
    }
  ],
  "publicRoots": [],
  "useLedgerAfterSlot": -1
}

El BP no debe tener conexión directa a internet ni a peers públicos. Solo debe hablar con tus propios relays. Si tu BP es accesible desde fuera, estás exponiendo las claves operacionales.

---

Sincronización inicial — usa Mithril

Sincronizar el nodo desde cero puede llevar varios días. En lugar de esperar, vamos a usar Mithril para descargar un snapshot verificado criptográficamente.

⚡Bootstrap con Mithril

Mithril es el método recomendado para la sincronización inicial. Reduce el tiempo de espera de días a menos de una hora.

---

Verificar los archivos

Antes de continuar, confirmamos que tenemos todo lo necesario:

ls $HOME/cardano/relay/config/
# config.json  byron-genesis.json  shelley-genesis.json
# alonzo-genesis.json  conway-genesis.json  topology.json

ls $HOME/cardano/bp/config/
# config.json  byron-genesis.json  shelley-genesis.json
# alonzo-genesis.json  conway-genesis.json  topology.json

Con los archivos en su lugar, el siguiente paso es configurar los servicios de systemd.