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_idenpropspara limitarte a una red concreta - Los elementos en
ClearingRequestedsiguen 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 porregistryAddress 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.Esquema de los elementos
Flujo de trabajo
- Un proveedor de datos publica un paquete NPM que exporta una función que devuelve
Array<{address, chainId, tag, ...}> - Envía el paquete al registro ATQ mediante Curate
- Los consumidores clonan todos los paquetes registrados, los ejecutan y combinan los resultados en un conjunto de datos de etiquetas de direcciones unificado
- 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:- Ve a curate.kleros.io y selecciona el registro
- Revisa la política del registro (enlazada desde la página del registro)
- Envía tu elemento y paga el depósito
- Espera a que venza el periodo de impugnación (normalmente de 3 a 7 días)
- Crea un paquete NPM que exporte una función asíncrona que devuelva un array de objetos
{address, chainId, tag} - Publícalo en NPM
- 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.