Saltar al contenido principal

Estructuras de datos principales

Estructura Item

Estructura Request

Parámetros de arbitraje

Enumeraciones


Inicialización

Función Initialize

Array de depósitos base

Ejemplo de inicialización

Pautas para el periodo de impugnación:
  • Testnet: 3600 segundos (1 hora)
  • Mainnet: 259200-604800 segundos (3-7 días)

Formato de los datos de los elementos

Los elementos de Curate V2 se almacenan como una cadena JSON. El listMetadata del registro define el esquema mediante un array columns, y cada elemento se ajusta a esas columnas:
Un elemento enviado debe ser un objeto JSON con una clave por cada etiqueta de columna:
El itemID es keccak256(abi.encodePacked(itemJSON)): el hash de la cadena JSON exacta enviada. El sistema de asignaciones de datos usa esta estructura de columnas para extraer las variables de plantilla {{itemName}} y {{itemDescription}}.

arbitrationParamsIndex: versionado

Cada Request almacena un uint24 arbitrationParamsIndex que captura los parámetros de arbitraje del registro en el momento del envío. Esto es fundamental: si el governor actualiza el árbitro o el extraData después de enviar una solicitud, los parámetros originales se conservan para el ciclo de vida de impugnación y disputa de esa solicitud. Esto significa que:
  • Quienes impugnan deben usar el mismo arbitrationParamsIndex que el envío original: obtenlo de la solicitud antes de impugnar
  • Los cálculos de coste deben usar los parámetros de arbitraje de request.arbitrationParamsIndex, no los parámetros actuales

Registro frente a retirada: plantillas de disputa separadas

Curate V2 usa dos plantillas de disputa separadas: una para las solicitudes de registro y otra para las solicitudes de retirada (clearing). Tienen una lógica de respuesta distinta: Ambas se establecen en la inicialización mediante TemplateRegistryParams.registrationTemplateParameters y removalTemplateParameters. Debes aportar ambas, y deben ser coherentes con tu documento de política.

Envío de elementos

Añadir un elemento

Parámetros:
  • _item: cadena JSON que se ajusta al esquema de columnas del registro (consulta Formato de los datos de los elementos más arriba)
Devuelve:
  • itemID: hash keccak256 de la cadena del elemento

Calcular el coste de envío

Ejemplo de envío


Retirada de elementos

Retirar un elemento

Parámetros:
  • _itemID: hash del elemento que se va a retirar
  • _evidence: cadena JSON de evidencias que respalda la retirada

Ejemplo de retirada


Impugnar solicitudes

Impugnar una solicitud

Parámetros:
  • _itemID: elemento con una solicitud pendiente
  • _evidence: evidencias JSON que respaldan la impugnación

Ejemplo de impugnación

Las impugnaciones deben enviarse durante el periodo de impugnación. Comprueba los plazos antes de impugnar.

Ejecutar solicitudes

Ejecutar una solicitud

Ejecuta una solicitud no impugnada una vez transcurrido el periodo de impugnación.

Ejemplo de ejecución


Funciones de consulta

Obtener la información de un elemento

Obtener la información de una solicitud

Funciones del contrato View

El contrato CurateView ofrece consultas por lotes mejoradas:

Ejemplo del contrato View


Funciones del governor

Actualizaciones de la configuración

Gestión directa de los elementos


Eventos

Eventos del ciclo de vida de los elementos

Eventos de las disputas

Eventos de configuración


Control de acceso

Modificador del governor

Modificador del relayer

Acceso combinado


Consideraciones de seguridad

  • Usa .send() con un límite de 2300 de gas para los reembolsos
  • Las actualizaciones de estado se producen antes de las llamadas externas
  • No se usa .call() directamente para las transferencias de ETH
  • Solidity 0.8.24 tiene protección integrada frente al desbordamiento
  • uint24 arbitrationParamsIndex permite 16.777.215 cambios
  • Los periodos de impugnación usan block.timestamp
  • Los mineros pueden manipularlo en ±15 segundos
  • Usa periodos suficientemente largos (horas o días como mínimo)

Buenas prácticas