¿Qué es un contrato arbitrable?
Un contrato arbitrable es cualquier contrato inteligente que puede crear disputas y ejecutar los fallos de Kleros. Tu contrato implementa una interfaz arbitrable (IArbitrableV2 en Kleros V2, ERC-792 en V1), que define dos cosas:
- Cómo se crean las disputas: tu contrato decide cuándo surgen los conflictos
- Cómo se ejecutan los fallos: tu contrato ejecuta el resultado
Esta sección incluye tanto las guías de contratos arbitrables de V2 (
IArbitrableV2) como los estándares del protocolo V1, ERC-792 y ERC-1497, junto con sus referencias de integración (Aplicaciones arbitrables V1, Árbitro centralizado, Arbitrable Proxy).Cuándo usar el arbitraje de Kleros
Buen encaje
- Disputas subjetivas que pueden juzgar personas
- Transacciones de alto valor que justifican el coste
- Casos en los que la confianza es imposible
- Desacuerdos entre varias partes
Mal encaje
- Resultados totalmente objetivos y verificables en la cadena
- Microtransacciones (tasas > valor)
- Decisiones urgentes (< 1 semana)
- Disputas que requieren una ejecución en el mundo real
Decisiones de diseño clave
Antes de escribir código, decide lo siguiente:
- Opciones de fallo
Define qué pueden decidir los jurados. Patrones habituales:
La opción
0 está reservada para “Negarse a arbitrar”: los jurados la eligen cuando la disputa no es válida o no tiene respuesta.
- ¿Quién paga las tasas?
El arbitraje cuesta ETH. Tu contrato decide quién paga:
La mayoría de los productos de Kleros usan el modelo de paga el perdedor: ambas partes depositan la tasa de arbitraje por adelantado y al ganador se le reembolsa. Es el patrón que usan Escrow V2 y Curate V2.
- Desencadenantes de las disputas
¿Cuándo empieza una disputa? Desencadenantes habituales:
- Solicitud explícita: una parte llama a
raiseDispute() - Tiempo agotado: no hay respuesta dentro del plazo
- Impugnación: alguien disputa una acción pendiente
- Automático: se detectan reclamaciones contradictorias
- Presentación de evidencias
Decide cómo llegan las evidencias a los jurados:
- Eventos en la cadena: emite eventos
Evidencedesde tu contrato - Módulo separado: usa el contrato
EvidenceModule - Entre cadenas: evidencias desde una cadena externa mediante el gateway
Requisitos de la interfaz (V2)
Patrones de arquitectura
Patrón A: integración directa
Tu contrato es el arbitrable. Es el enfoque más sencillo.Patrón B: proxy/resolver
UsaDisputeResolver como intermediario. Es adecuado para la actualizabilidad.
Patrón C: entre cadenas
El contrato arbitrable está en mainnet y la resolución, en Arbitrum.Consideraciones de coste
Mentalidad de seguridad
Tu contrato debe gestionar:- Reentrada:
rule()es una llamada externa - Validación del fallo: comprueba que el fallo está dentro del rango esperado
- Fallos duplicados: evita que
rule()se llame dos veces - Cambios de tasas: el coste del arbitraje puede cambiar entre llamadas
- Confianza en el árbitro: acepta fallos solo de tu árbitro
Próximos pasos
Guía de implementación
Recorrido paso a paso con ejemplos de código completos