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. EllistMetadata del registro define el esquema mediante un array columns, y cada elemento se ajusta a esas columnas:
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
_item: cadena JSON que se ajusta al esquema de columnas del registro (consulta Formato de los datos de los elementos más arriba)
itemID: hash keccak256 de la cadena del elemento
Calcular el coste de envío
Ejemplo de envío
Retirada de elementos
Retirar un elemento
_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
_itemID: elemento con una solicitud pendiente_evidence: evidencias JSON que respaldan la impugnación
Ejemplo de impugnación
Ejecutar solicitudes
Ejecutar una solicitud
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
Protección frente a la reentrada
Protección frente a la reentrada
- 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
Desbordamiento de enteros
Desbordamiento de enteros
- Solidity 0.8.24 tiene protección integrada frente al desbordamiento
uint24 arbitrationParamsIndexpermite 16.777.215 cambios
Manipulación de las marcas de tiempo
Manipulación de las marcas de tiempo
- 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)