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

# Formato de las políticas

> Formato de las políticas de Kleros V2: especificación JSON de las políticas de los tribunales en PolicyRegistry y de las políticas de disputa referenciadas mediante policyURI en las plantillas de disputa.

Kleros utiliza dos tipos de documentos de política:

1. **Políticas de los tribunales**: definen las reglas generales de un tribunal concreto de Kleros. Se registran en el contrato `PolicyRegistry` y se muestran a los jurados en todas las disputas de ese tribunal.
2. **Políticas de disputa**: definen las reglas específicas de una aplicación arbitrable concreta. Se referencian mediante `policyURI` en la plantilla de disputa. Se espera que los jurados lean ambas.

Ambas son archivos JSON almacenados en IPFS.

***

## JSON de la política de un tribunal

```json theme={null}
{
  "name": "General Court Policy",
  "description": "Rules for the General Court - handles disputes not covered by specialized courts.",
  "summary": "The General Court is the court of last resort for disputes without a specialized subcourt. Jurors should apply reasonable judgment to the facts presented.",
  "requiredFields": [
    {
      "label": "Contract terms",
      "description": "The original agreement between the parties, if any"
    },
    {
      "label": "Evidence of breach",
      "description": "Specific evidence showing how the agreement was violated"
    }
  ],
  "rulingOptions": {
    "titles": ["Option A", "Option B"],
    "descriptions": [
      "What happens if Option A is selected",
      "What happens if Option B is selected"
    ]
  },
  "uri": "/ipfs/QmPolicyFileHash"
}
```

***

## Política de disputa (por aplicación)

Las políticas de disputa se vinculan mediante el campo `policyURI` de las plantillas de disputa. Definen cómo deben fallar los jurados en **tu aplicación concreta**.

Una política de disputa bien redactada debe incluir:

| Sección | Descripción |
| - | - |
| **Contexto** | Qué hace tu aplicación y qué representa la disputa |
| **Criterios de fallo** | Condiciones exactas de cada opción de fallo |
| **Casos límite** | Cumplimiento parcial, evidencias ambiguas, información que falta |
| **Negarse a arbitrar** | Cuándo deben elegir los jurados el fallo 0 (disputa no válida, fuera de ámbito) |
| **Requisitos de las evidencias** | Qué tipos de evidencias son aceptables |

### Ejemplo de estructura de una política de disputa

```json theme={null}
{
  "name": "Escrow V2 Dispute Policy",
  "version": "1.0",
  "description": "Rules for resolving escrow payment disputes on Escrow V2.",
  "rulingCriteria": {
    "0": "Refuse to Arbitrate - The dispute is invalid, the question is unanswerable, or critical evidence is missing.",
    "1": "Refund the Buyer - The seller failed to deliver the goods or services as described.",
    "2": "Pay the Seller - The seller fulfilled their obligations as described in the transaction terms."
  },
  "edgeCases": [
    "If delivery is partial, consider whether it materially meets the contract terms.",
    "If the buyer raised the dispute in bad faith with no evidence, prefer ruling 2.",
    "If terms are ambiguous and both parties have plausible claims, prefer ruling 0."
  ],
  "evidenceGuidelines": "Acceptable: screenshots, delivery confirmations, contract terms, payment records. Not acceptable: personal testimony without supporting evidence.",
  "policyURI": "/ipfs/QmPolicyIPFSHash"
}
```

***

## Campo `specification` de las plantillas de disputa

Las plantillas de disputa pueden incluir un campo `specification` que hace referencia a la KIP (propuesta de mejora de Kleros) o al estándar que sigue la plantilla:

```json theme={null}
{
  "specification": "KIP-99",
  ...
}
```

Es informativo: ayuda a auditores e integradores a entender qué estándar rige la estructura de la plantilla. Reality V2 lo usa para enlazar con la especificación de arbitraje de Reality.eth.

***

## Contrato PolicyRegistry

```solidity theme={null}
function setPolicy(uint96 _courtID, string calldata _courtName, string calldata _policyURI) external
```

Solo el governor de KlerosCore puede registrar políticas de tribunales. `_policyURI` es una URI de IPFS que apunta al JSON de la política del tribunal.

Para leer la política actual de un tribunal:

```solidity theme={null}
(string memory name, string memory uri) = policyRegistry.policies(courtID);
```

***

## Consejos para redactar buenas políticas

* Escribe para un público general: los jurados no son expertos jurídicos ni especialistas en la materia
* Usa ejemplos concretos para cada opción de fallo
* Especifica exactamente qué evidencias bastan para cambiar el fallo
* Evita términos ambiguos como "razonable" sin definir qué significan en tu contexto
* Prueba la política con disputas simuladas antes del despliegue
* Almacénala en IPFS con varios proveedores de pinning (Pinata, Infura, Cloudflare) para garantizar su permanencia


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