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

# Ejemplos de consultas

> Ejemplos de consultas GraphQL habituales en los subgraphs de Kleros V2 para obtener tribunales, disputas, jurados, rondas, votos, evidencias y plantillas de disputa en Arbitrum.

# Ejemplos de consultas

Consultas GraphQL habituales para obtener datos de los subgraphs de Kleros.

***

## Consultas core de V2 (Arbitrum)

> [!NOTE]
>
> Usa siempre el endpoint de la **red descentralizada** para las consultas en producción. Obtén el ID del subgraph en las páginas de Studio indicadas en [Endpoints del subgraph](https://docs.kleros.io/es/developers/subgraph/endpoints.md) y construye la URL como `https://gateway.thegraph.com/api/{API_KEY}/subgraphs/id/{SUBGRAPH_ID}`.

### Obtener los tribunales

Campos clave: `minStake` (en wei), `feeForJuror` (recompensa del jurado por voto), `timesPerPeriod` (array con las duraciones de las 4 fases en segundos).

```graphql theme={null}
{
  courts(first: 20, orderBy: id) {
    id
    hiddenVotes
    minStake
    alpha
    feeForJuror
    jurorsForCourtJump
    timesPerPeriod
    parent { id }
    policy { policy }
    numberDisputes
    numberStakedJurors
    stakedJurors {
      id
    }
  }
}
```

### Obtener las disputas recientes

Campos clave: `externalDisputeID` (el ID de tu aplicación), `templateId` (enlaza con DisputeTemplateRegistry), `ruled` (finalizada), `currentRuling` (opción de fallo activa).

```graphql theme={null}
{
  disputes(first: 10, orderBy: createdAtBlock, orderDirection: desc) {
    id
    arbitrated { id }
    court { id }

    period
    ruled
    currentRuling
    tied
    overridden
    lastPeriodChange
    nbRounds
    nbChoices
    externalDisputeID
    templateId
    rounds {
      nbVotes
      totalFeesForJurors
      drawnJurors { juror { id } }
    }
  }
}
```

### Obtener una disputa por su ID externo

Usa `externalDisputeID` para relacionar una disputa en la cadena con el ID interno de tu aplicación (emitido en `DisputeRequest`):

```graphql theme={null}
query GetDisputeByExternalID($externalId: BigInt!) {
  disputes(where: { externalDisputeID: $externalId }) {
    id
    period
    ruled
    currentRuling
    tied
    templateId
  }
}
```

### Obtener los stakes de un jurado para una dirección concreta

```graphql theme={null}
{
  jurorTokensPerCourts(where: { juror: "0xYOUR_ADDRESS_LOWERCASE" }) {
    court { id }
    staked
    locked
  }
}
```

### Obtener los sorteos activos de un jurado

```graphql theme={null}
query GetJurorDraws($juror: String!) {
  draws(where: { juror: $juror, vote_not: null }, first: 20) {
    dispute { id period currentRuling }
    round { id nbVotes }
    vote { choice }
  }
}
```

***

## Consultas de Curate (V1)

### Obtener los elementos registrados de una lista de Light Curate

```graphql theme={null}
{
  litems(
    first: 10
    where: {
      status: Registered
      registryAddress: "0xYOUR_LIST_ADDRESS_LOWERCASE"
    }
    orderBy: latestRequestResolutionTime
    orderDirection: desc
  ) {
    itemID
    data
    props {
      type
      label
      description
      value
    }
  }
}
```

### Obtener los elementos en periodo de impugnación

```graphql theme={null}
{
  litems(
    first: 10
    where: {
      status_in: [RegistrationRequested, ClearingRequested]
      registryAddress: "0xYOUR_LIST_ADDRESS_LOWERCASE"
      disputed: false
    }
    orderBy: latestRequestSubmissionTime
    orderDirection: asc
  ) {
    itemID
    status
    props {
      label
      value
    }
    requests(first: 1, orderBy: submissionTime, orderDirection: desc) {
      submissionTime
      requester
    }
  }
}
```

### Obtener los detalles de un elemento con su historial de solicitudes

```graphql theme={null}
query ItemDetails($id: ID!) {
  item(id: $id) {
    data
    requests(orderBy: submissionTime, orderDirection: desc) {
      requestType
      disputed
      disputeID
      submissionTime
      resolved
      requester
      challenger
      rounds(orderBy: creationTime, orderDirection: desc) {
        appealPeriodStart
        appealPeriodEnd
        ruling
        hasPaidRequester
        hasPaidChallenger
      }
    }
  }
}
```

Los ID de los elementos en el subgraph usan el formato `<itemID>@<listAddress>`:

```typescript theme={null}
const compoundId = `${itemID}@${tcrAddress.toLowerCase()}`;
const result = useQuery(ITEM_DETAILS_QUERY, { variables: { id: compoundId } });
```

***

## Registros de etiquetas de direcciones (Gnosis Chain)

Consulta por lotes para obtener las etiquetas de direcciones de los tres registros de etiquetas de direcciones de Kleros en Gnosis Chain:

```graphql theme={null}
{
  contractDomainTags: litems(
    where: {
      status_in: [Registered, ClearingRequested]
      registryAddress: "0x CONTRACT_DOMAIN_TAG_REGISTRY"
    }
    first: 1000
  ) {
    props { label value }
  }
  addressTags: litems(
    where: {
      status_in: [Registered, ClearingRequested]
      registryAddress: "0x ADDRESS_TAG_REGISTRY"
    }
    first: 1000
  ) {
    props { label value }
  }
}
```

Subgraph: [legacy-curate-gnosis](https://thegraph.com/explorer/subgraphs/9hHo5MpjpC1JqfD3BsgFnojGurXRHTrHWcUcZPPCo6m8) en Graph Explorer (ID del subgraph `9hHo5MpjpC1JqfD3BsgFnojGurXRHTrHWcUcZPPCo6m8`)

***

## Proof of Humanity

### Comprobar el estado de registro

```graphql theme={null}
{
  submission(id: "0xADDRESS_LOWERCASE") {
    registered
    name
    creationTime
    status
    requests(first: 1, orderBy: creationTime, orderDirection: desc) {
      evidence {
        URI
      }
    }
  }
}
```

Como alternativa, llama directamente a `isRegistered(address)` en el contrato de PoH en `0xC5E9dDebb09Cd64DfaCab4011A0D5cEDaf7c9BDb`.

***

## Consejos

* Las direcciones deben estar en **minúsculas** en todas las consultas. El subgraph las almacena como bytes y no entiende las direcciones con checksum.
* Los elementos con estado `ClearingRequested` siguen registrados hasta que se finaliza la solicitud de retirada. Inclúyelos al obtener los elementos "activos".
* El servicio alojado de The Graph tiene un **límite de 1000 elementos** por consulta. Para los registros con más elementos, pagina con `skip` o `id_gt`.
* Las entidades de Light Curate llevan el prefijo `l` (por ejemplo, `litems`, `lrequests`). Classic Curate usa entidades sin prefijo (`items`, `requests`).

***

## Lecturas adicionales

> [card] [Endpoints del subgraph](https://docs.kleros.io/es/developers/subgraph/endpoints.md)
>
> Lista completa de las URL de los subgraphs

> [card] [Integración con Light Curate](https://docs.kleros.io/es/developers/products/curate/light-curate.md)
>
> Guía completa de Light Curate para desarrolladores


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