Saltar al contenido principal
Kleros mantiene cuatro registros de curación en producción construidos sobre Curate V2. Cada registro cura un tipo de datos concreto, y Kleros Court resuelve las entradas disputadas. En conjunto forman la capa de datos principal que usan las billeteras, los exploradores de bloques y las listas de tokens para mostrar metadatos fiables sobre contratos y tokens.

Address Tags Registry

El Address Tags Registry asigna a un par (address, chain) una etiqueta descriptiva breve. Es la fuente principal de las etiquetas de “¿qué es este contrato?” que se muestran en billeteras y exploradores.

Esquema de los elementos

Cada elemento registrado codifica las siguientes columnas:

Acceso mediante subgraph

El registro lo indexa un subgraph alojado en Envio (despliegue privado). Patrón de consulta:
  • Las direcciones deben estar en minúsculas en los filtros where
  • Filtra por chain_id en props para limitarte a una red concreta
  • Los elementos en ClearingRequested siguen activos: inclúyelos en las consultas de “etiquetas activas”

Reglas de resolución

  • Una etiqueta por dirección y cadena. Un segundo registro para el mismo par (address, chainId) provoca un conflicto; se prefiere el elemento curado con más stake.
  • Conflicto entre ATQ y ATR: si una dirección tiene una etiqueta tanto del metarregistro ATQ como del Address Tags Registry, tiene prioridad la entrada del ATR (se cura e impugna individualmente).

Tokens Registry

El Tokens Registry cura los metadatos de los tokens ERC-20. Es la fuente de las listas de tokens que mantiene Kleros y que usan Uniswap, MetaMask, Ledger y otros.

Esquema de los elementos

Acceso mediante subgraph

El mismo patrón de subgraph alojado en Envio que el ATR. Consulta por registryAddress para el contrato del registro de Tokens.

Lista de tokens generada

El registro de Tokens genera en tiempo de compilación un JSON estándar de Token List. Los consumidores obtienen el archivo estático en lugar de consultar directamente el subgraph:

CDN Registry (Contract Domain Names)

El CDN Registry asigna direcciones de contratos a dominios web. Ofrece una búsqueda inversa: dada la dirección de un contrato, encontrar el dominio oficial del proyecto.

Esquema de los elementos

Acceso mediante subgraph

El mismo patrón de subgraph alojado en Envio. El CDN es más pequeño que el ATR; normalmente el conjunto completo puede obtenerse en una sola consulta.

Casos de uso

  • Detección de phishing en billeteras: comprobar si el dominio que declara una dApp coincide con la entrada del CDN para el contrato al que se llama
  • Insignias de “proyecto verificado” en los exploradores de bloques
  • Resolución DNS inversa para direcciones de contratos

ATQ Registry (Address Tag Query)

El registro ATQ es un metarregistro: en lugar de curar etiquetas de direcciones individuales, cura paquetes NPM, cada uno de los cuales genera lotes de etiquetas de direcciones al ejecutarse. Esto permite generar etiquetas a gran escala (miles de direcciones) sin necesidad de envíos de curación individuales por dirección.
ATQ no se puede consultar al vuelo mediante el subgraph. Para generar etiquetas de direcciones a partir de ATQ, debes descargar y ejecutar en local cada paquete NPM registrado. No hay ninguna API que devuelva en tiempo real las etiquetas derivadas de ATQ para una dirección concreta.

Esquema de los elementos

Flujo de trabajo

  1. Un proveedor de datos publica un paquete NPM que exporta una función que devuelve Array<{address, chainId, tag, ...}>
  2. Envía el paquete al registro ATQ mediante Curate
  3. Los consumidores clonan todos los paquetes registrados, los ejecutan y combinan los resultados en un conjunto de datos de etiquetas de direcciones unificado
  4. El conjunto de datos combinado se guarda en caché y se sirve de forma estática

Modelo de datos


Modelos de datos

Modelos de datos normalizados completos de cada registro:

curate_address_tag

curate_token

curate_cdn

curate_atq_package


Consumidores

Los siguientes productos y servicios consumen datos de los registros de Kleros: Los consumidores suelen obtener una exportación estática generada previamente (archivo JSON) en lugar de consultar el subgraph en tiempo de ejecución, para no exponer claves de API en el código del lado del cliente.

Arquitectura

Nivel 1: contexto del sistema

Nivel 2: vista de contenedores


Limitaciones conocidas


Añadir datos a un registro

Para aportar etiquetas de direcciones, tokens o nombres de dominio:
  1. Ve a curate.kleros.io y selecciona el registro
  2. Revisa la política del registro (enlazada desde la página del registro)
  3. Envía tu elemento y paga el depósito
  4. Espera a que venza el periodo de impugnación (normalmente de 3 a 7 días)
Para los envíos masivos mediante ATQ:
  1. Crea un paquete NPM que exporte una función asíncrona que devuelva un array de objetos {address, chainId, tag}
  2. Publícalo en NPM
  3. Regístralo en el registro ATQ de Curate
Contacta con el equipo de Kleros por Discord o en [email protected] si necesitas las direcciones de los contratos de los registros, los endpoints de los subgraphs de Envio o ayuda con los envíos masivos a ATQ.