Saltar al contenido principal
Esta guía es específica de Kleros V2: usa las interfaces IArbitrableV2 e IArbitratorV2 y KlerosCore en Arbitrum. Para construir sobre Kleros V1 (ERC-792 y ERC-1497), consulta Aplicaciones arbitrables V1.

Referencia de las interfaces

Antes de construir, comprende las dos interfaces con las que interactúa tu contrato.

IArbitratorV2 (KlerosCore)

IArbitrableV2 (tu contrato)

Codificación de extraData

extraData configura el tribunal y el número de jurados:
Empates: cuando los votos se reparten por igual, currentRuling() devuelve tied = true y ruling = 0. La disputa permanece en apelación hasta que se resuelve. Si nunca se apela una vez terminado el periodo, se ejecuta el fallo 0 (Negarse a arbitrar). Gestiona siempre explícitamente el fallo 0 en tu contrato.

Pago de tasas en ERC-20

En Arbitrum One, KlerosCore acepta ETH y tokens ERC-20 aceptados (por ejemplo, WETH):
Las tasas en ERC-20 solo funcionan al llamar directamente a KlerosCore en Arbitrum. El ForeignGateway (para las disputas entre cadenas desde Ethereum o Gnosis) solo acepta ETH nativo.
Para comprobar los tokens aceptados, escucha el evento AcceptedFeeToken(token, accepted) en KlerosCore.

Construir un contrato de escrow

Construiremos un escrow completo que usa el arbitraje de Kleros. Cubre todos los patrones que necesitarás.

Estructura del contrato

Crear transacciones

Abrir disputas

Recibir los fallos

Plantillas de disputa

Las plantillas indican a los jurados qué están decidiendo. Hay dos enfoques: Almacena la plantilla en IPFS y haz referencia a ella mediante su URI:
Súbela a IPFS y usa la URI en DisputeRequest.

Opción B: registro de plantillas en la cadena

Registra las plantillas en la cadena para las disputas dinámicas:

Asignaciones de datos

Para las plantillas dinámicas, usa asignaciones para inyectar los datos de la transacción:

Presentación de evidencias

Emitir eventos de evidencia

Formato JSON de las evidencias

Las evidencias son inmutables una vez enviadas. El fileURI debe apuntar a IPFS/Arweave para garantizar su permanencia.

Gestionar las apelaciones

Las apelaciones las gestiona el Dispute Kit, no tu contrato. Sin embargo, puedes seguir el estado de las apelaciones:

Patrones de gestión de tasas

Patrón: paga el perdedor

Cobra depósitos a ambas partes y reembolsa al ganador:

Patrón: comprobación dinámica de la tasa

Obtén siempre el coste actual antes de crear la disputa:

Codificación de los datos adicionales

Configura el tribunal y el número de jurados:

Ejemplo completo

Próximos pasos

Prueba tu integración

Escenarios de prueba y estrategias de depuración