Arquitectura de V1
Court V1 se construye en torno a un único contrato, KlerosLiquid, en la red principal de Ethereum y en Gnosis Chain. Es monolítico: el staking, el sorteo de jurados, la votación, las apelaciones y la ejecución de los fallos residen en un mismo contrato.
V1 utiliza los estándares ERC-792 (arbitraje) y ERC-1497 (evidencias), aleatoriedad basada en blockhash, votación por pluralidad con commit-reveal y un árbol jerárquico de subtribunales. Para ver las direcciones de los contratos de V1, consulta Direcciones de despliegue.
Visión general del sistema V2
Kleros V2 utiliza una arquitectura modular en la que contratos especializados se encargan de responsabilidades concretas:Componentes principales
KlerosCore
El orquestador. Gestiona el ciclo de vida de las disputas y coordina los módulos.Sortition Module
Se encarga de la selección de jurados mediante aleatoriedad ponderada. Conceptos clave:- Árbol de sorteo: estructura de datos que asigna el PNK en staking a una probabilidad de selección
- Fases: Staking → Generating → Drawing (evita la manipulación del RNG)
- Stakes aplazados: los cambios de stake quedan en cola hasta que termina la fase de sorteo
Dispute Kits
Mecanismos de votación modulares. El protocolo incluye DisputeKitClassic, pero admite implementaciones personalizadas.
Funciones del Classic Dispute Kit:
- Votación commit-reveal (opcional, por tribunal)
- Recompensas basadas en la coherencia (votar con la mayoría = conservar el stake)
- Financiación colectiva de las apelaciones
Como la simplificación de los contratos continuó después de la auditoría de Certora (de diciembre de 2025 a enero de 2026), la auditoría no cubre la versión final de los contratos.
Gateways (entre cadenas)
Permiten que las disputas de otras cadenas se resuelvan en Arbitrum.- El contrato arbitrable en mainnet llama al Foreign Gateway
- El mensaje pasa por el puente al Home Gateway en Arbitrum
- La disputa se resuelve en Arbitrum
- El fallo vuelve por el puente a mainnet
veashi-sdk se publicó en npm como @kleros/veashi-sdk v0.0.2 (mayo de 2026); se añadieron nuevas rutas Base ↔ Ethereum y Base ↔ Arbitrum (junio de 2026); se adoptó un enfoque de tres oráculos para VeaShi, con LayerZero y Chainlink CCIP como los dos oráculos principales y deBridge o Wormhole como tercera opción (junio de 2026); el indexador Envio HyperIndex se integró en el escáner de VeaShi (junio de 2026); y un segundo validador entró en funcionamiento (febrero de 2026).
Atlas (backend interno)
Atlas es una biblioteca de backend interna solo para los equipos de desarrollo de Kleros. No está pensada para su uso o integración por parte de la comunidad.
Biblioteca de componentes (kleros-app)
Todos los frontends de V2 utilizan una biblioteca compartida de componentes de interfaz.kleros-app v3.0.1 se publicó en junio de 2026 con diferenciación por producto en el registro y en IPFS y compatibilidad con la baja de suscripciones, y el visor de archivos se extrajo como componente compartido (junio de 2026).
Ciclo de vida de una disputa
1
Periodo de evidencias
Las partes presentan evidencias. Los jurados se sortean mediante el Sortition Module.
2
Periodo de commit (si está habilitado)
Los jurados envían compromisos de voto ocultos (hash del voto + sal).
3
Periodo de votación
Los jurados revelan sus votos. Deben coincidir con el compromiso si se usó la fase de commit.
4
Periodo de apelación
La parte perdedora puede financiar una apelación. Se sortean más jurados para la siguiente ronda.
5
Ejecución
Se redistribuyen los stakes. Los jurados coherentes reciben recompensas y los incoherentes, penalizaciones. El fallo se envía al contrato arbitrable.
Jerarquía de tribunales
Los tribunales forman un árbol. Las apelaciones pueden “saltar” a los tribunales padre cuando el número de jurados supera un umbral. Parámetros de los tribunales:minStake: PNK mínimo para hacer stakingfeeForJuror: tasa en ETH por jurado y rondajurorsForCourtJump: umbral para apelar al tribunal padretimesPerPeriod: duración de cada periodo de la disputa
Flujo de datos
Crear una disputa
Ejecutar un fallo
Modelo de seguridad
Auditorías y trabajo de seguridad
- Los contratos de Court V2 pasaron por cuatro rondas de revisión interna más una auditoría externa de Certora (consulta Dispute Kits más arriba para ver el calendario y la nota sobre la cobertura de la auditoría).
- Se realizaron auditorías de seguridad de todos los frontends de V1, V2 y PoH, con una revisión de los vectores de ataque XSS (junio de 2026).
- Se corrigieron vulnerabilidades de React (CVE-55183, CVE-55184, CVE-67779) en varias aplicaciones en un esfuerzo coordinado (diciembre de 2025).
- El programa de recompensas por errores está migrando de Hats Finance (cerrado) a plataformas alternativas.
- Kleros Skills se lanzó en skills.kleros.io: paquetes de conocimiento legibles por agentes para el protocolo (mayo de 2026). Paquetes disponibles: IPFS Upload y operaciones de Curate. Hoja de ruta: CLI, verificación de agentes ERC-8004, Escrow v1/v2 y un Arbitrable App Builder.
Direcciones clave (Arbitrum One)
Para ver las direcciones actuales, consulta los archivos de despliegue de kleros-v2.