> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleros.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Arquitectura

> Compara el contrato monolítico KlerosLiquid en Ethereum con la arquitectura modular de V2 en Arbitrum, formada por KlerosCore, SortitionModule y los Dispute Kits.

Esta página trata la arquitectura de Kleros Court en ambas versiones del protocolo. Empieza con el diseño de V1, sigue con el diseño de V2 y termina con lo que cambió entre ambas.

***

## Arquitectura de V1

Court V1 se construye en torno a un único contrato, **KlerosLiquid**, desplegado en la red principal de Ethereum (y en Gnosis Chain). KlerosLiquid es monolítico: el staking de jurados, la selección aleatoria, la votación y la gestión de disputas residen en el mismo contrato.

| Componente | Responsabilidad |
| - | - |
| **KlerosLiquid** | Staking, sorteo de jurados, votación, apelaciones y ejecución de fallos en un solo contrato |
| **PolicyRegistry** | Almacenamiento de las políticas de los tribunales |
| **Token PNK Minime** | El token de staking utilizado en V1 |

Características clave:

* **Red**: red principal de Ethereum (también Gnosis Chain)
* **Estándares**: ERC-792 (arbitraje) y ERC-1497 (evidencias); las evidencias y las apelaciones las gestiona el contrato arbitrable, no el tribunal
* **Selección de jurados**: integrada en KlerosLiquid, mediante un árbol de sumas de sorteo ponderado por stake
* **Aleatoriedad**: RNG basado en blockhash
* **Votación**: commit-reveal con agregación por pluralidad
* **Tribunales**: un árbol jerárquico de subtribunales con el General Court como raíz

Para obtener más información sobre V1, consulta [Court V1](https://docs.kleros.io/es/legacy/court-v1).

***

## Arquitectura de V2

Court V2 funciona en Arbitrum y divide el contrato monolítico de V1 en componentes modulares. El resto de esta sección describe ese diseño.

### Principios de diseño

Kleros V2 se diseñó en torno a seis principios clave:

1. **Modularidad**: la lógica de resolución de disputas se separa en Dispute Kits intercambiables
2. **Compatibilidad con varios Dispute Kits**: distintos tribunales pueden usar distintos mecanismos de votación, incentivos y apelación
3. **Preparado para bifurcaciones**: el protocolo admite bifurcaciones (forks) para reducir la rentabilidad de los ataques
4. **PNK ligero**: un token ERC-20 sencillo (que sustituye al complejo token Minime de V1)
5. **Protección frente al fraude de jurados**: mecanismos para detectar y penalizar la revelación anticipada, el soborno y la formación de cárteles
6. **Protección frente al spam de evidencias**: envío de evidencias basado en depósitos en L2, donde el gas es barato

### Mapa de componentes

| Componente | Responsabilidad |
| - | - |
| **KlerosCore** | Creación de disputas, gestión de periodos, apelaciones, ejecución de fallos y recompensas de jurados |
| **DisputeKitClassic** | Votación por pluralidad, commit-reveal, incentivos de reparto igualitario y financiación asimétrica de apelaciones |
| **SortitionModule** | Selección aleatoria de jurados ponderada por stake mediante árboles de sumas |
| **DisputeTemplateRegistry** | Registro en la cadena de plantillas de preguntas y respuestas de disputas |
| **PolicyRegistry** | Almacenamiento de las políticas de los tribunales (URI de IPFS) |
| **KlerosGovernor** | Ejecución de la gobernanza en la cadena (Snapshot → transacciones) |
| **Home/Foreign Gateways** | Transmisión de disputas entre cadenas |
| **Vea Bridge** | Transporte optimista de mensajes entre cadenas |

### Visión multicadena

La arquitectura a largo plazo admite contratos arbitrables en cualquier cadena EVM:

* Los usuarios interactúan principalmente con la cadena principal (Arbitrum) para la mayoría de las operaciones
* Las evidencias pueden enviarse desde cadenas externas por comodidad
* Los Gateways y el puente Vea abstraen la complejidad de los puentes
* Cada cadena externa compatible tiene su propio despliegue de Foreign Gateway

### Sistema de Dispute Kits

Los tribunales pueden admitir varios dispute kits, lo que permite distintos:

* **Métodos de sorteo**: ponderado por PNK, basado en Proof of Humanity, etc.
* **Sistemas de votación**: pluralidad, Condorcet-IRV, etc.
* **Modelos de incentivos**: reparto igualitario, funciones ponderadas, etc.
* **Sistemas de apelación**: financiación de solo dos opciones, financiación de varias opciones, basados en stake, etc.

Actualmente, `DisputeKitClassic` (sorteo por PNK + votación por pluralidad + reparto igualitario + apelaciones con financiación de solo dos opciones) es el único kit desplegado y todos los tribunales deben admitirlo obligatoriamente.

### Modelo de seguridad

* **Criptoeconómico**: los jurados hacen staking de PNK; los votantes incoherentes pierden stake
* **Selección aleatoria**: evita la manipulación de la composición del jurado
* **Escalada de apelaciones**: coste exponencialmente creciente para sostener un ataque
* **Controles de emergencia**: pausa del Guardian + reanudación por el Governor para una respuesta rápida
* **Mecanismo de bifurcación**: defensa final: una minoría honesta puede bifurcar el protocolo

***

## Qué cambió en V2

| Aspecto | V1 (KlerosLiquid) | V2 (KlerosCore) |
| - | - | - |
| **Estructura** | Monolítica: un contrato para staking, sorteo, votación y disputas | Modular: KlerosCore, SortitionModule y DisputeKits están separados |
| **Red** | Ethereum L1 (también Gnosis Chain) | Arbitrum L2 |
| **Selección de jurados** | Integrada en KlerosLiquid | SortitionModule (contrato separado) |
| **Resolución de disputas** | Un único mecanismo integrado | DisputeKits intercambiables (Classic, Shutter, Gated, GatedShutter) |
| **Token PNK** | Token Minime | ERC-20 ligero |
| **Evidencias y apelaciones** | Las gestiona el contrato arbitrable | Las gestiona el tribunal |
| **Entre cadenas** | Una sola cadena | Multicadena mediante el puente Vea y los Gateways |
| **RNG** | Basado en blockhash | Interfaz RNG genérica con respaldo |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.