Metadatos del proyecto
Los proyectos pueden almacenar metadatos off-chain mediante un sistema basado en URI compatible con ERC-721 y EIP-4906. Esto permite vincular documentos de auditoría, datos de ubicación, certificaciones y dashboards a los proyectos on-chain.
Definir los metadatos
El propietario del watcher define una URI de metadatos para cada proyecto:
registry.setProjectMetadataURI(projectId, "ipfs://Qm...");La URI puede apuntar a IPFS para instantáneas inmutables o a HTTPS para endpoints en vivo. El registro emite un evento ProjectMetadataURISet (compatible con EIP-4906) para que los indexadores sepan que deben actualizar.
Formato JSON recomendado
{
"name": "Solar Farm Alpha",
"description": "Rooftop solar installation in Nairobi, Kenya. 100 kWp rated.",
"image": "ipfs://QmImageHash",
"external_url": "https://myenergyproject.com",
"attributes": [
{ "trait_type": "Energy Type", "value": "solar" },
{ "trait_type": "Project Type", "value": "generator" },
{ "trait_type": "Installed Power (kWp)", "value": 100 },
{ "trait_type": "Country", "value": "Kenya" },
{ "trait_type": "Country Code", "value": "KE" },
{ "trait_type": "Data Collection", "value": "IoT" },
{ "trait_type": "Commissioned", "value": "2023-06-01" }
],
"properties": {
"fuel_type": "solar",
"project_type": "generator",
"installed_power_kwp": 100,
"location": {
"country": "KE",
"region": "Nairobi",
"lat": -1.286,
"lon": 36.817
},
"certifications": [
{
"name": "REC",
"issuer": "Gold Standard",
"valid_until": "2027-01-01",
"uri": "ipfs://QmCertificateHash"
}
],
"files": [
{
"uri": "ipfs://QmInstallationReport",
"type": "application/pdf",
"role": "installation_certificate"
},
{
"uri": "https://dashboard.example.com",
"type": "text/html",
"role": "live_dashboard"
}
]
},
"version": "1",
"updated_at": "2026-03-13T00: 00: 00Z"
}El formato usa campos compatibles con ERC-721 (name, description, image, attributes) extendidos con propiedades específicas de energía. Esto hace que los metadatos del proyecto sean legibles por marketplaces de NFT y visores de metadatos estándar.
Metadatos por atestación
Cada atestación también admite un campo metadataURI. Es útil para anclar evidencia por lectura, por ejemplo, un enlace de IPFS a la exportación en bruto del IoT o la verificación firmada de un auditor para ese período de reporte específico.