Saltar al contenido principal

Ejemplos de consultas

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

Consultas core de V2 (Arbitrum)

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

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

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

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

Obtener los sorteos activos de un jurado


Consultas de Curate (V1)

Obtener los elementos registrados de una lista de Light Curate

Obtener los elementos en periodo de impugnación

Obtener los detalles de un elemento con su historial de solicitudes

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

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:
Subgraph: legacy-curate-gnosis en Graph Explorer (ID del subgraph 9hHo5MpjpC1JqfD3BsgFnojGurXRHTrHWcUcZPPCo6m8)

Proof of Humanity

Comprobar el estado de registro

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

Endpoints del subgraph

Lista completa de las URL de los subgraphs

Integración con Light Curate

Guía completa de Light Curate para desarrolladores