Saltar al contenido principal

¿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:
  1. Cómo se crean las disputas: tu contrato decide cuándo surgen los conflictos
  2. Cómo se ejecutan los fallos: tu contrato ejecuta el resultado
Kleros se encarga de todo lo que ocurre entremedias: la selección de jurados, la votación, las apelaciones y la determinación del fallo final.
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:

  1. 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.

  1. ¿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.

  1. 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

  1. Presentación de evidencias

Decide cómo llegan las evidencias a los jurados:
  • Eventos en la cadena: emite eventos Evidence desde tu contrato
  • Módulo separado: usa el contrato EvidenceModule
  • Entre cadenas: evidencias desde una cadena externa mediante el gateway

Requisitos de la interfaz (V2)

Esta sección es específica de Kleros V2. En V1, los contratos implementan ERC-792 y ERC-1497 y deben emitir un evento MetaEvidence para que la interfaz de Court pueda mostrar la disputa.
Para integrarse con Kleros V2, tu contrato debe implementar:

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

Usa DisputeResolver 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

Empieza con 3 jurados en el General Court para la mayoría de las disputas. Aumenta el número en los casos de alto valor.

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