Metadata y presencia en explorers

Cómo asegurarse de que tu pool aparece correctamente en Cardanoscan, PoolTool, AdaPools y wallets. Metadata estándar, extended metadata y verificación.

Que tu pool aparezca bien en los exploradores y wallets no es automático — depende de que los metadatos estén bien formados, en una URL estable y con el hash correcto registrado en cadena.

---

El archivo meta.json

Es el único archivo de metadata que va referenciado directamente en el certificado de registro del pool. Tiene un tamaño máximo de 512 bytes y debe cumplir exactamente con el esquema:

{
  "name": "TOPO",
  "description": "Cardano stake pool operated by TOPO Labs.",
  "ticker": "TOPO",
  "homepage": "https://topopool.com"
}

Reglas estrictas:

• ticker: 3–5 caracteres, solo mayúsculas y números, sin espacios ni símbolos

• name: máximo 50 caracteres

• description: máximo 255 caracteres

• homepage: URL válida con HTTPS

Calcula el hash después de cualquier modificación:

cardano-cli stake-pool metadata-hash --pool-metadata-file meta.json

Si el hash no coincide con el registrado en cadena, todos los exploradores mostrarán error y ocultarán la metadata del pool.

---

Extended metadata (meta-extra.json)

Los metadatos extendidos no están limitados a 512 bytes ni referenciados directamente en cadena. Los exploradores los buscan en una URL convencional. El estándar más adoptado es el de CIP-0006:

{
  "info": {
    "url_png_icon_64x64": "https://topopool.com/icon.png",
    "url_png_logo": "https://topopool.com/logo.png",
    "location": "AR",
    "countryCode": "AR",
    "social": {
      "twitter_handle": "topopool",
      "telegram_handle": "topopool",
      "github_handle": "avilsmeier",
      "discord_handle": ""
    },
    "about": {
      "me": "Descripción más larga del operador del pool.",
      "server": "Infraestructura dedicada en nube europea.",
      "company": "TOPO Labs"
    }
  },
  "when": "2024-01-01T00:00:00Z",
  "cip": "https://github.com/cardano-foundation/CIPs/blob/master/CIP-0006/schema.json"
}

Cómo vincular los extended metadata al pool

Añade la URL al meta.json original con el campo extended:

{
  "name": "TOPO",
  "description": "Cardano stake pool operated by TOPO Labs.",
  "ticker": "TOPO",
  "homepage": "https://topopool.com",
  "extended": "https://topopool.com/meta-extra.json"
}

Agregar el campo extended cambia el contenido del meta.json, por lo tanto cambia el hash. Necesitas recalcular el hash y re-registrar el pool con el nuevo hash.

---

Imágenes del pool

Los exploradores buscan las imágenes en las URLs que declares en el extended metadata. Requisitos habituales:

Campo	Tamaño	Formato
url_png_icon_64x64	Exactamente 64×64 px	PNG con fondo transparente
url_png_logo	Al menos 200×200 px	PNG

Sirve los archivos con Content-Type: image/png y desde HTTPS.

---

Verificar el registro en cadena

Comprueba que el hash registrado en la cadena coincide con el hash real del archivo:

# Hash del archivo actual
cardano-cli stake-pool metadata-hash --pool-metadata-file meta.json

# Hash registrado en cadena
cardano-cli query pool-state --stake-pool-id <POOL_ID> --mainnet \
  | jq '.poolParams.metadata.metadataHash'

Si son iguales, estás bien.

---

Registrar en agregadores de pools

Además de la metadata en cadena, algunos servicios usan bases de datos propias que requieren registro manual o verificación:

PoolTool

Registra tu pool en pooltool.io — requiere crear una cuenta y reclamar el pool. Permite añadir información adicional, alertas de bloques y estadísticas avanzadas.

AdaPools

adapools.org lee los extended metadata automáticamente. Si los metadatos no aparecen, verifica que la URL del archivo sea accesible públicamente y que el JSON sea válido.

Cardanoscan

Carga los metadatos directamente desde la cadena y la URL registrada. Si el hash no coincide, muestra un aviso de error en la página del pool.

SMASHpool

Los SMASHpool (Stake pool Metadata Aggregation Servers) son servicios que indexan y verifican la metadata de los pools. Las wallets como Daedalus, Yoroi y Lace los usan para mostrar información de los pools. Los principales:

• IOG SMASH: https://smash.cardano-mainnet.iohk.io

• CF SMASH (Cardano Foundation): disponible en varios endpoints

Si tu metadata no aparece en wallets tipo Daedalus, puede ser que el SMASH haya bloqueado tu pool por contenido inapropiado o errores repetidos de hash. Puedes verificarlo consultando directamente al SMASH:

curl https://smash.cardano-mainnet.iohk.io/api/v1/metadata/<POOL_ID>/<METADATA_HASH>

---

Checklist de metadata

✅ meta.json < 512 bytes
✅ ticker en mayúsculas, 3-5 chars
✅ URL del meta.json accesible con HTTPS
✅ Hash registrado en cadena = hash del archivo actual
✅ meta-extra.json válido y accesible
✅ Imágenes PNG en las URLs declaradas
✅ Pool reclamado en PoolTool (opcional pero recomendado)
✅ Verificar en Cardanoscan que no hay error de hash