Contratos on-chain - BrightCity Chain

A plataforma energética usa quatro contratos Solidity na BrightCity Chain: EuroToken, SensorRegistry, EnergyMarket e EnergySettlement.

Fluxo on-chain

Contrato	Papel na aplicação
`EuroToken`	ERC-20 privado usado para crédito e pagamento entre carteiras de sensores
`SensorRegistry`	Registro on-chain de `sensor_id`, carteira Besu e estado habilitado
`EnergyMarket`	Ofertas on-chain, compra por `transferFrom` e cancelamento
`EnergySettlement`	Registro de liquidação com comprador, vendedor, kWh, preço e timestamp

EuroToken é o token privado da BrightCity Chain.

O bridge recebe a confirmação externa do Oracle Service e executa mint(to, amount) por meio do Transactions Service.

SensorRegistry registra o vínculo on-chain entre sensor e carteira Besu.

Função	Uso
`registerSensor(sensorId, wallet)`	Registra sensor com carteira Besu
`enableSensor(sensorId)`	Habilita sensor
`disableSensor(sensorId)`	Desabilita sensor
`isSensorEnabled(sensorId)`	Consulta o estado operacional

O sensor_id é convertido para bytes32 antes da chamada on-chain e precisa caber em 32 bytes quando codificado em UTF-8.

EnergyMarket registra ofertas on-chain e compras com token privado.

Função	Uso
`createOffer(sellerSensorId, kwh, pricePerKwh)`	Cria oferta de energia
`purchaseOffer(offerId, buyerSensorId, seller, buyer)`	Compra oferta usando `transferFrom`
`cancelOffer(offerId)`	Cancela oferta aberta

Os estados on-chain de oferta são OPEN, SOLD e CANCELLED.

EnergySettlement registra liquidações energéticas.

Função	Uso
`settle(buyerSensorId, sellerSensorId, kwh, price)`	Grava liquidação entre comprador e vendedor

Cada liquidação guarda settlementId, sensores comprador e vendedor, kWh, preço e timestamp.

Ver a integração entre serviços e contratos