> 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/metadatos-en-explorers.md).

# Metadata y presencia en explorers

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:

```json
{
  "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:

```bash
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](https://cips.cardano.org/cip/CIP-0006):

```json
{
  "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`:

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

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

***

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

```bash
# 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](https://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](https://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:

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