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

# SDK de Kleros V2

> Referencia de la biblioteca de TypeScript @kleros/kleros-sdk: relleno de plantillas de disputa, gestión de evidencias e interacción con los contratos de Kleros V2 en Arbitrum.

El Kleros SDK (`@kleros/kleros-sdk`) es una biblioteca de TypeScript para interactuar con el protocolo Kleros V2. Sustituye a Archon y ofrece utilidades para rellenar plantillas de disputa, gestionar evidencias e interactuar con los contratos.

> [!WARNING]
>
> El SDK está en desarrollo activo. Para el uso en producción, fija una versión concreta y revisa el registro de cambios antes de actualizar. Las ABI de `@kleros/kleros-v2-contracts` son estables para la interacción directa con los contratos.

## Instalación

```bash theme={null}
npm install @kleros/kleros-sdk
# Peer dependencies
npm install @kleros/kleros-v2-contracts viem
```

## Paquetes

El SDK se encuentra en [github.com/kleros/kleros-v2](https://github.com/kleros/kleros-v2), dentro del workspace `kleros-sdk/`. Se publica como `@kleros/kleros-sdk`.

## Funciones clave

### Relleno de plantillas de disputa

El SDK resuelve `templateDataMappings` para rellenar los marcadores `{{variable}}` de las plantillas de disputa. Es el caso de uso principal: ejecuta las asignaciones en el cliente para mostrar un contexto detallado de la disputa.

```typescript theme={null}
import { populateTemplate } from "@kleros/kleros-sdk";

// disputeTemplate: the JSON template string from DisputeTemplateRegistry
// mappings: the JSON mappings array string from DisputeTemplateRegistry
// externalDisputeID: your app's dispute/transaction ID
const populated = await populateTemplate(
  disputeTemplate,
  mappings,
  externalDisputeID,
  { graphApiKey: process.env.GRAPH_API_KEY }
);

console.log(populated.title);       // "Escrow dispute: Widget delivery"
console.log(populated.description); // "Buyer claims goods were not delivered..."
```

### Codificación y decodificación de ExtraData

```typescript theme={null}
import { encodeExtraData, decodeExtraData } from "@kleros/kleros-sdk";

// Encode: General Court (ID 1), 3 jurors
const extraData = encodeExtraData(1n, 3n);
// → "0x000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003"

// Decode
const { courtId, minJurors } = decodeExtraData(extraData);
// → { courtId: 1n, minJurors: 3n }
```

### Envío de evidencias

```typescript theme={null}
import { uploadEvidence, submitEvidence } from "@kleros/kleros-sdk";

// Upload evidence to IPFS
const { uri } = await uploadEvidence({
  name: "Delivery Receipt",
  description: "Screenshot showing delivery on Jan 15",
  fileURI: "/ipfs/QmFile...",
});

// Submit on-chain
await submitEvidence(walletClient, {
  arbitrator: KLEROS_CORE_ADDRESS,
  evidenceGroupID: txID,
  evidence: uri,
});
```

### Descubrimiento de contratos

```typescript theme={null}
import { getContracts } from "@kleros/kleros-sdk";

const contracts = await getContracts(chainId);
// → { klerosCore, sortitionModule, disputeKitClassic, templateRegistry, ... }
```

## Staking

```typescript theme={null}
import { setStake } from "@kleros/kleros-sdk";

// Stake 200 PNK in court 1
await setStake(walletClient, {
  courtId: 1n,
  amount: parseUnits("200", 18),
});
```

## Resumen de capacidades

| Función | Descripción |
| - | - |
| Relleno de plantillas | Resuelve `templateDataMappings` para rellenar las `{{variables}}` de las plantillas de disputa |
| Códec de ExtraData | Codifica y decodifica el ID del tribunal + el número de jurados para `createDispute()` |
| Subida de evidencias | Sube el JSON de la evidencia a IPFS y emite el evento `Evidence` en la cadena |
| Descubrimiento de contratos | Resuelve KlerosCore, SortitionModule, etc. por ID de cadena |
| Staking | Establece o retira el stake de PNK en los tribunales |
| Consultas de disputas | Obtiene las disputas activas, los votos de los jurados y el estado del sorteo |
| Financiación colectiva de apelaciones | Contribuye a las rondas de apelación |
| Validación del contenido | Verifica la integridad de las evidencias y plantillas mediante hash |

## Código fuente

[GitHub: kleros/kleros-v2/kleros-sdk](https://github.com/kleros/kleros-v2/tree/dev/kleros-sdk)


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