DisputeTemplateRegistry y pueden contener marcadores dinámicos que el sistema de asignaciones de datos rellena al crear la disputa.
Estructura de la plantilla
Una plantilla de disputa completa es un objeto JSON. Los campos marcados con{{variable}} son marcadores que las asignaciones de datos resuelven al crear la disputa. Los campos marcados con {{{variable}}} (triple llave) se tratan como valores sin procesar ni escapar (por ejemplo, URI).
Referencia de campos
ID de las respuestas
Los ID de las respuestas son valores de fallo codificados en hexadecimal:
KlerosCore trata de forma especial el fallo
0x00: si la mayoría lo elige, se considera que ninguna parte ha ganado.
Evidencias previas a la disputa (extraEvidences)
El campo extraEvidences permite a los contratos arbitrables mostrar directamente en la interfaz de Kleros Court las evidencias que se presentaron antes de crear la disputa, como el envío de registro de un solicitante o la objeción de un impugnante. Sin este campo, los jurados tendrían que ir por separado a la aplicación arbitrable para encontrar esas evidencias.
Esquema
Uso en las plantillas
extraEvidences es un array que rellena el sistema de asignaciones de datos. En la práctica, Curate V2 usa condicionales de Handlebars para incluir las evidencias del solicitante y del impugnante solo cuando existen, unidas por una coma cuando están ambas:
requesterEvidence y challengerEvidence las rellena una asignación fetch/ipfs/json que obtiene de IPFS el archivo de evidencias de cada parte:
extraEvidences es el mecanismo que conecta la actividad previa a la disputa (envíos de registro, objeciones de los impugnantes) con la interfaz de disputas de Kleros. Sin él, los jurados deben salir de Court para encontrar el contexto. Rellénalo siempre que tu contrato arbitrable genere evidencias estructuradas en el momento del envío.Asignaciones de datos
El parámetrotemplateDataMappings es un array JSON que define cómo se rellenan los marcadores {{variable}} de la plantilla a partir de fuentes de datos externas al crear la disputa. El sistema resuelve las asignaciones de forma secuencial: las asignaciones posteriores pueden hacer referencia a valores rellenados por las anteriores.
Cada objeto de asignación tiene un campo type que determina su estructura, además de seek (lista de rutas de datos que extraer) y populate (lista de nombres de variables de la plantilla que rellenar, en el mismo orden que seek).
Tipos de asignación
graphql: consulta a un subgraph
Obtiene datos de un endpoint de subgraph de TheGraph.
graphql: consulta a un subgraphendpoint: URL del gateway de The Graph. El SDK inyecta{{{graphApiKey}}}en tiempo de ejecución.query: una cadena de consulta GraphQL estándar.variables: variables de la consulta; pueden hacer referencia a{{template_vars}}ya rellenadas.seek: rutas con notación de puntos dentro de los datos de la respuesta GraphQL.populate: nombres de las variables de la plantilla que establecer, en correspondencia posicional conseek.
fetch/ipfs/json: obtención de JSON de IPFS
Recupera un archivo JSON de IPFS y extrae campos.
fetch/ipfs/json: obtención de JSON de IPFSipfsUri: una URI de IPFS, normalmente rellenada por un paso de asignación anterior. La triple llave{{{...}}}indica que el valor se usa como URI sin procesar, sin escape HTML.seek: rutas de los campos JSON dentro del documento obtenido.populate: nombres de las variables de la plantilla que rellenar.
abi/call: llamada a un contrato inteligente
Llama a una función de consulta (view) de un contrato y extrae los valores devueltos.
abi/call: llamada a un contrato inteligenteabi: cadena ABI legible de la función.functionName: la función a la que llamar.address: dirección del contrato.args: argumentos que se pasan a la función. Pueden hacer referencia a{{template_vars}}.seek: índices (como cadenas) de la tupla devuelta o nombres de los valores devueltos.populate: nombres de las variables de la plantilla que rellenar.
abi/event: datos de eventos en la cadena
Extrae datos de un evento emitido previamente en la cadena.
abi/event: datos de eventos en la cadenaabi: cadena ABI legible del evento.eventName: el evento que buscar.address: dirección del contrato que emitió el evento.seek: nombres de los parámetros del evento que extraer.populate: nombres de las variables de la plantilla que rellenar.
json: valores fijos
Inyecta valores fijos directamente en las variables de la plantilla.
json: valores fijosEncadenar asignaciones
Las asignaciones se ejecutan en el orden del array. Una variable rellenada en el paso 1 puede usarse en el paso 2. Por ejemplo:transactionUri se rellena en el paso 1 y se usa como {{{transactionUri}}} en el paso 2.
Ejemplos reales
Escrow V2
Curate V2: registro
Las disputas de registro y de retirada usan plantillas distintas con la lógica de respuesta invertida. En el registro, aceptar significa que el elemento debe añadirse; en la retirada, aceptar significa que el elemento debe retirarse.0x01 significa “sí, retirar”:
Reality V2
"type" ("single-select", "multiple-select", "uint", "datetime", "bool") que corresponde al tipo de pregunta de Reality.eth. La opción “Answered Too Soon” (“Respondida demasiado pronto”, 0x00) siempre está presente en las disputas de Reality.
Registro
Las plantillas se registran enDisputeTemplateRegistry:
DisputeRequest con el templateId que tienes almacenado:
_templateUri en lugar de registrarla directamente.
Actualizar las plantillas
UsachangeDisputeTemplate() (disponible en contratos arbitrables como Escrow) para actualizar la plantilla después del despliegue: las nuevas disputas usarán la plantilla actualizada, mientras que las antiguas conservan la instantánea del templateId original.
templateId se emite en el evento DisputeTemplate de DisputeTemplateRegistry, y tu contrato debe almacenarlo para usarlo en DisputeRequest.