Interoperabilidade
Como o registry público de créditos é projetado para integração externa, verificabilidade independente e interoperabilidade com sistemas externos.
Last updated on
Projetado para integração
Os smart contracts da Rede Carrot são construídos em padrões abertos e implantados em uma blockchain pública, tornando-os inerentemente interoperáveis com sistemas externos e ferramentas padronizadas. Cada operação — desde a emissão de MassIDs até a compra de créditos e a distribuição de recompensas — emite eventos on-chain que sistemas externos podem monitorar, indexar e verificar.
Verificabilidade on-chain
Todas as transações de smart contracts da Carrot são publicamente visíveis na blockchain. Isso significa:
- Compras e aposentadorias de créditos podem ser verificadas de forma independente por auditores, reguladores ou qualquer parte interessada.
- Saldos de tokens e certificados registrados podem ser consultados em tempo real.
- A cadeia de proveniência — de MassID, passando por certificado, até crédito aposentado — é rastreável on-chain: a blockchain guarda cada registro, suas quantidades e uma referência endereçada por conteúdo ao seu documento de proveniência no IPFS.
Como esses dados residem na blockchain pública, a transparência e a confiança não dependem da infraestrutura da Carrot. Qualquer explorador de blockchain (como PolygonScan) ou indexador pode acessar dados brutos de transações diretamente on-chain, e o Metadata Viewer abre o documento de proveniência por trás de um registro. O Carrot Registry adiciona uma visão focada no domínio — definições de metodologia, execução de regras e homologações — para contexto ambiental e rastreabilidade.
Eventos consultáveis
Cada operação principal emite eventos estruturados que podem ser indexados por sistemas off-chain:
| Operação | Eventos principais |
|---|---|
| Emissão | MassID emitido, Certificado emitido, Créditos emitidos |
| Compra | Compra executada, Créditos queimados ou transferidos, Recompensas atribuídas |
| Aposentadoria | Créditos aposentados, Créditos queimados, Recibo de aposentadoria emitido |
| Recompensas | Recompensas registradas, Saques de notas de recompensa |
| Revogação | Token revogado |
Como toda compra é atualmente aposentada integralmente quando é liquidada, uma compra emite uma queima de crédito em vez de uma transferência de entrega ao comprador. A transferência aparece apenas no caminho de aposentadoria parcial, que não é usado atualmente.
Esses eventos permitem que aplicações de terceiros construam dashboards, ferramentas de análise ou sistemas de relatórios de conformidade sobre dados da Carrot, sem exigir acesso direto à plataforma.
Transferibilidade de créditos
Enquanto todos os NFTs no sistema Carrot são soulbound (intransferíveis), os tokens de crédito (ERC-20) são transferíveis por design. Hoje, toda compra é aposentada quando é liquidada, então nenhum crédito é entregue a compradores nem circula fora da custódia da rede.
Dois desvios em relação a um ERC-20 comum importam para integradores:
- A pausa interrompe toda movimentação de saldo. Minting, transferências e queimas param enquanto o contrato Credit está pausado, porque a verificação de pausa fica na única etapa interna pela qual toda mudança de saldo passa. Aprovações e permits continuam disponíveis.
- A queima iniciada pelo detentor está desabilitada.
burneburnFromaparecem na ABI do contrato, mas revertem para qualquer chamador que não seja o Vault ou o CreditRetirementManager, de modo que a aposentadoria é o único caminho que destrói créditos.
Descoberta de contratos baseada em registro
A arquitetura de smart contracts utiliza um ContractRegistry que mapeia nomes lógicos para endereços implantados. Esse design permite:
- Atualizações contínuas — Os contratos utilizam o padrão de proxy UUPS (EIP-1967), de modo que o endereço do proxy permanece estável entre atualizações. Quando o proxy é atualizado (
upgradeToAndCall), o endereço do proxy e sua entrada no ContractRegistry permanecem os mesmos, então todos os contratos dependentes continuam operando sem reimplantação. A chamada de atualização pode carregar calldata de migração, que a nova implementação executa sobre o armazenamento já existente do proxy. - Acoplamento fraco — Os contratos não codificam endereços de suas dependências diretamente, tornando o sistema mais resiliente e fácil de evoluir.
Rede de implantação
A Rede Carrot é agnóstica em relação à rede blockchain: os smart contracts são implementados em Solidity e podem ser implantados em qualquer rede compatível com EVM. Atualmente, a Carrot implanta na Polygon PoS pelos seguintes motivos:
- Baixo custo de transação — Operações com créditos ambientais (emissão, compra, aposentadoria) podem ser executadas de forma acessível em escala.
- Compatibilidade EVM — Compatibilidade total com ferramentas, carteiras e ecossistema de desenvolvedores Ethereum.
- Ecossistema estabelecido — Amplo suporte de indexadores, exploradores e protocolos DeFi.
A produção roda na mainnet Polygon PoS (chain ID 137, polygonscan.com). Ambientes que não são de produção rodam na testnet Polygon Amoy (chain ID 80002, amoy.polygonscan.com), então uma integração apontada para um ambiente que não seja de produção deve indexar a Amoy, e não a mainnet.
Saiba mais sobre smart contracts · Saiba mais sobre categorias de contratos · Acesse o Carrot Registry
Segurança
Modelo de segurança — arquitetura de smart contracts, segurança de governança e mecanismos anti-manipulação.
Metadata Viewer
O Metadata Viewer em viewer.carrot.eco — ferramenta pública que abre o documento de proveniência por trás de um registro de MassID, Certificado ou recibo da Carrot, com um conjunto deliberadamente estreito de conferências sobre o que esse documento diz.