Saltar al contenido principal

Registro de Facetas

Registro de Facetas (Capa de Gobernanza y Aprobación)​

Ubicación: src/facetRegistry/

Archivos clave:

  • FacetRegistry.sol — Gestiona el registro de facetas y el seguimiento de versiones.
  • IFacetRegistry.sol — Interfaz pública.

Qué hace​

El Registro de Facetas es el catálogo gobernado de facetas aprobadas. Actúa como un guardián asegurando que:

  • Solo las facetas preaprobadas puedan ser añadidas a los Jardines.
  • Las 4 facetas base inmutables (Propiedad, Corte, Actualización, Loupe) permanezcan protegidas.
  • Exista un rastro de auditoría completo de todos los cambios de facetas mediante versiones.
  • Las herramientas off-chain puedan descubrir qué facetas y funciones están disponibles.

Operaciones principales​

1. Registrar facetas: upgradeFacetRegistry()

Llamado por la gobernanza para registrar, actualizar o eliminar facetas. Valida que las facetas sean contratos y que las facetas base centrales nunca sean modificadas.

2. Operaciones de consulta:

  • getFacets(): Obtiene todas las facetas y sus selectores.
  • getFacetAddress(selector): Busca la faceta para una función específica.
  • isFacetRegistered(address): Verifica el estado de aprobación.

Mecanismos de seguridad​

  • Facetas base inmutables: La lógica central del Diamond no puede quedar inutilizada ("bricked").
  • Se requiere aprobación de la DAO: La gobernanza debe votar sobre los nuevos registros de facetas.
  • Seguimiento de versiones: Cada cambio crea un registro permanente en la historia.