Saltar al contenido principal

Introducción

Kleros Oracle combina Reality.eth, un mecanismo de escalada de fianzas para respuestas colectivas, con Kleros Court como árbitro externo. Esto ofrece un oráculo descentralizado que puede responder a cualquier pregunta que tenga una respuesta verificable públicamente. Tu aplicación solo interactúa con Reality.eth. Kleros se invoca automáticamente cuando una disputa sobre una respuesta escala al arbitraje.

Contratos inteligentes

Interfaces de los contratos, direcciones de los proxies de árbitro y referencia de las funciones

Guía de integración

Guía paso a paso para formular preguntas y obtener respuestas desde tu contrato

V1: integración con SafeSnap (Ethereum / Gnosis Chain)

El oráculo Reality.eth + Kleros impulsa SafeSnap para la gobernanza de DAO, y la integración con V1 cuenta con soporte activo. Notas técnicas para integradores:
  • Zodiac / SafeSnap: el Kleros Reality Module funciona con Snapshot mediante la configuración de Gnosis Zodiac Safe. Los bots de Zodiac validan automáticamente los hashes keccak de las preguntas de Reality (emiten una advertencia en lugar de fallar cuando no se puede verificar un hash), normalizan los enlaces de Reality con un uso de mayúsculas coherente y gestionan las preguntas de Reality que no tienen ninguna propuesta de Snapshot adjunta.
  • Supervisión: las integraciones pueden supervisarse mediante ENS, Snapshot y las direcciones de los contratos (como se hizo con Panther Protocol).
  • Visualización en Court: Court V1 muestra “Invalid” en lugar de “Refuse to Arbitrate” en los casos de Reality.
  • Opciones de respuesta verificadas: Court V1 (desde octubre de 2026) y Dispute Resolver construyen las opciones de respuesta de los casos de Reality.eth a partir de la pregunta en la cadena y de su plantilla, no del script de visualización del contrato arbitrable, de modo que unos parámetros de pregunta manipulados no pueden cambiar las opciones que ven los jurados. Ambos muestran un aviso en la página del caso cuando otras interfaces muestran opciones distintas, o cuando los parámetros están mal formados o las opciones no se pueden verificar.
  • Redes: la integración de Realitio se extiende a la testnet Base Sepolia, y el proxy de Realitio entre cadenas se mantiene activamente.
Para ver el recorrido completo de la integración de SafeSnap, consulta la guía de integración.

Cómo funciona

1

Formula una pregunta

Tu contrato (o un usuario) envía una pregunta a Reality.eth, adjuntando opcionalmente ETH como recompensa, y designa un proxy de árbitro de Kleros para resolver las disputas.
2

Responde con fianzas

Cualquiera puede enviar una respuesta depositando una fianza. Para sustituir una respuesta existente, quien responde debe depositar una fianza de al menos el doble de la anterior. La escalada de fianzas hace que las respuestas incorrectas sean económicamente insostenibles.
3

Finalización o arbitraje

Si nadie impugna la respuesta actual dentro del plazo, la respuesta se finaliza. Si una parte no está de acuerdo, cualquiera puede pagar la tasa de arbitraje para escalar la pregunta a Kleros Court mediante el proxy de árbitro.
4

Fallo

Los jurados de Kleros evalúan la pregunta y las evidencias presentadas y votan la respuesta correcta. El proxy de árbitro comunica el fallo a Reality.eth, que finaliza la respuesta.

Arquitectura

La integración usa tres capas de contratos: Tu contrato solo interactúa con Reality.eth. La dirección del proxy de árbitro se especifica al formular la pregunta, y el proxy gestiona toda la comunicación con Kleros Court.

Misma cadena frente a entre cadenas

El sistema admite dos patrones de despliegue:
  • Misma cadena: la pregunta y el arbitraje están en la misma red. Es la integración más sencilla.
  • Entre cadenas: la pregunta está en una cadena (por ejemplo, Gnosis Chain o Polygon) mientras que el arbitraje se realiza en Ethereum o Arbitrum mediante un proxy entre cadenas. Úsalo cuando tu aplicación esté en una cadena sin un despliegue nativo de Kleros Court.
Los despliegues de los proxies entre cadenas aparecen en el repositorio cross-chain-realitio-proxy.

Cadenas compatibles

Reality.eth está desplegado en varias cadenas. Hay proxies de árbitro de Kleros disponibles en:
Consulta el repositorio de despliegues de Reality.eth para ver la lista completa de despliegues por cadena y las direcciones de los contratos. Para las direcciones de los proxies de árbitro de Kleros, consulta la página Contratos inteligentes.

Tipos de pregunta

Reality.eth admite varias plantillas de pregunta. Cada plantilla define el formato de la respuesta y cómo se codifica el resultado. Se pueden registrar plantillas personalizadas para casos de uso específicos de una aplicación mediante createTemplate() o el generador de plantillas de Reality.eth. Para conocer todos los detalles sobre la codificación de los resultados, consulta Contratos inteligentes → Interpretación de los resultados.

Flujo de resolución

El sistema sigue un modelo push/pull. Tu dApp envía una pregunta a Reality.eth y, más tarde, obtiene la respuesta verificada. Una pregunta puede resolverse por dos vías:

Camino feliz: resolución por consenso

  1. Alguien envía una respuesta con una fianza
  2. Nadie la impugna dentro del plazo
  3. La respuesta se finaliza automáticamente
  4. Tu dApp lee el resultado mediante resultFor(questionID)

Camino infeliz: resolución por arbitraje

  1. Alguien envía una respuesta con una fianza
  2. Otro usuario publica una respuesta contraria con una fianza mayor
  3. La escalada de fianzas puede continuar hasta que una parte solicite el arbitraje
  4. La pregunta queda congelada en Reality.eth
  5. Se crea una disputa en Kleros Court mediante el proxy de árbitro
  6. Se abre el periodo de presentación de evidencias
  7. Los jurados revisan las evidencias y votan
  8. El fallo se comunica a Reality.eth
  9. Tu dApp lee el resultado arbitrado
Todas las interacciones se realizan mediante la interfaz de Reality.eth. Tu dApp no necesita interfaces separadas para las dos vías.

Funciones clave

Cada respuesta sucesiva debe depositar al menos el doble de la fianza anterior. Esto hace que sostener respuestas incorrectas sea exponencialmente caro, por lo que la mayoría de las preguntas se resuelven correctamente sin llegar nunca al arbitraje.
En cualquier momento después de la primera respuesta, cualquiera puede solicitar el arbitraje pagando la tasa de arbitraje. El Kleros Arbitrator Proxy crea una disputa en el tribunal y el subtribunal configurados, con el número inicial de jurados configurado.
Las evidencias se envían a través del contrato Kleros Arbitrator Proxy, no de Reality.eth. El proxy gestiona el grupo de evidencias y reenvía los envíos a Kleros Court. Consulta la guía de integración para ver el flujo de envío y el formato de evidencias de ERC-1497.
Cada proxy de árbitro se despliega con un subtribunal, un número inicial de votos de jurados y una tasa de arbitraje concretos. El equipo de Kleros puede desplegar proxies personalizados, incluidos proxies con un documento principal personalizado para los jurados cuando las pautas de arbitraje estándar no bastan para un caso de uso.
El sistema admite proxies entre cadenas, lo que permite que una pregunta en una cadena la arbitre Kleros Court en otra. Esto hace posibles las integraciones en cadenas sin un despliegue nativo de Kleros Court.

Kleros Oracle en producción

El oráculo Reality.eth + Kleros impulsa sistemas en producción de varias categorías:
  • Mercados de predicción: Seer, Polkamarkets/Foreland y Omen lo usan para verificar los resultados de eventos del mundo real
  • Gobernanza optimista: el módulo Zodiac SafeSnap lo implementa para una ejecución segura de las propuestas de las DAO
  • Moderación de contenidos: Moderate / Susie bot lo aprovecha para aplicar de forma descentralizada las políticas de contenido

Recursos

Documentación de Reality.eth

Documentación oficial y referencia de la API de Reality.eth

GitHub de Reality.eth

Código fuente de los contratos y despliegues

Página de Kleros Oracle

Descripción general del producto

Discord

Soporte para desarrolladores