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

# Reality

> Descripción general para desarrolladores del oráculo Reality.eth de Kleros y de SafeSnap: escalada de fianzas, proxies de árbitro e integración con la gobernanza de DAO.

## Introducción

Kleros Oracle combina [Reality.eth](https://reality.eth.limo/), 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.

> [card] [Contratos inteligentes](https://docs.kleros.io/es/developers/products/reality/smart-contracts.md)
>
> Interfaces de los contratos, direcciones de los proxies de árbitro y referencia de las funciones

> [card] [Guía de integración](https://docs.kleros.io/es/developers/products/reality/integration.md)
>
> 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](https://docs.kleros.io/es/developers/products/reality/integration.md).

***

## 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:

| Contrato | Cadena | Función |
| - | - | - |
| **Tu contrato** | Cualquier cadena compatible | Formula preguntas y lee las respuestas finalizadas |
| **Reality.eth** | La misma cadena que tu contrato | Escalada de fianzas, gestión de las respuestas y lógica de plazos |
| **Kleros Arbitrator Proxy** | La misma cadena que Reality.eth | Crea disputas en Kleros Court y comunica los fallos |

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](https://github.com/kleros/cross-chain-realitio-proxy/tree/master/contracts#deployments).

***

## Cadenas compatibles

Reality.eth está desplegado en varias cadenas. Hay proxies de árbitro de Kleros disponibles en:

| Cadena | Estado |
| - | - |
| Ethereum Mainnet | Activo (Court V1) |
| Gnosis Chain | Activo (Court V1) |
| Arbitrum One | Disponible mediante Court V2 |
| Polygon | Activo (Court V1) |

> [!NOTE]
>
> Consulta el [repositorio de despliegues de Reality.eth](https://github.com/RealityETH/reality-eth-monorepo/tree/main/packages/contracts/chains/deployments) 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](https://docs.kleros.io/es/developers/products/reality/smart-contracts.md).

***

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

| ID de plantilla | Tipo | Formato de la respuesta | Ejemplo |
| - | - | - | - |
| 0 | `bool` | Sí/No | "¿Ocurrió el evento X?" |
| 1 | `uint` | Valor numérico | "¿Cuál era el precio de ETH en la fecha Y?" |
| 2 | `single-select` | Una de N opciones | "¿Qué equipo ganó?" |
| 3 | `multiple-select` | Subconjunto de N opciones | "¿Qué propuestas se aprobaron?" |
| 4 | `datetime` | Marca de tiempo Unix | "¿Cuándo ocurrió el evento X?" |
| 5 | `hash` | Hash bytes32 | "¿Corresponde el hash X al documento Y?" |

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](https://reality.eth.link/app/template-generator). Para conocer todos los detalles sobre la codificación de los resultados, consulta [Contratos inteligentes → Interpretación de los resultados](https://docs.kleros.io/es/developers/products/reality/smart-contracts.md#result-interpretation).

***

## 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

> [accordion] Escalada de fianzas
>
> 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.

> [accordion] Escalada 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.

> [accordion] Presentación de evidencias
>
> 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](https://docs.kleros.io/es/developers/products/reality/integration.md#evidence-submission) para ver el flujo de envío y el formato de evidencias de ERC-1497.

> [accordion] Parámetros configurables
>
> 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.

> [accordion] Compatibilidad entre cadenas
>
> 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](https://seer.pm), Polkamarkets/Foreland y [Omen](https://omen.eth.limo) lo usan para verificar los resultados de eventos del mundo real
* **Gobernanza optimista**: el [módulo Zodiac SafeSnap](https://kleros.io/web3) lo implementa para una ejecución segura de las propuestas de las DAO
* **Moderación de contenidos**: [Moderate / Susie bot](https://docs.kleros.io/es/legacy/retired/moderate.md) lo aprovecha para aplicar de forma descentralizada las políticas de contenido

***

## Recursos

> [card] [Documentación de Reality.eth](https://reality.eth.limo/app/docs/html/index.html)
>
> Documentación oficial y referencia de la API de Reality.eth

> [card] [GitHub de Reality.eth](https://github.com/RealityETH/reality-eth-monorepo)
>
> Código fuente de los contratos y despliegues

> [card] [Página de Kleros Oracle](https://kleros.io/oracle/)
>
> Descripción general del producto

> [card] [Discord](https://discord.gg/MhXQGCyHd9)
>
> Soporte para desarrolladores


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