Skip to content

Revise README for GEMLAB Protocol details and structure #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
DGuedz wants to merge 1 commit into
base: main
Choose a base branch
from
+104 −25
Open

Revise README for GEMLAB Protocol details and structure #4

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
129 changes: 104 additions & 25 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,45 +1,124 @@
# GEMLAB PROTOCOL (VSC Core)
# Protocolo GEMLAB: Rastreabilidade Mineral e Imunidade Política

![Status](https://img.shields.io/badge/status-Stealth%20Mode-grey)
![Architecture](https://img.shields.io/badge/architecture-VSC%20Compliant-blue)
![Security](https://img.shields.io/badge/security-Enterprise%20Grade-red)
![License](https://img.shields.io/badge/license-MIT-green)
![Status](https://img.shields.io/badge/status-Pilot%20Launch-yellow)
![Blockchain](https://img.shields.io/badge/blockchain-Ethereum-blue)
![EAS](https://img.shields.io/badge/EAS-Integrated-purple)
![Compliance](https://img.shields.io/badge/compliance-IN%20RFB%202.291%2F2025-brightgreen)
![Language](https://img.shields.io/badge/language-Português%20%7C%20English-orange)

> **Economy-First Blockchain Protocol for Real World Assets (RWA)**
> **Enterprise-grade blockchain protocol for emerald traceability, scientific certification, and fiscal compliance.**

---
Acesse aqui o modelo prototipado: https://undo-walnut-04123706.figma.site

## Visão Geral do Projeto

O **Protocolo GEMLAB** estabelece o primeiro **Protocolo Nativo de Conformidade Mineral** do Brasil. Nossa missão é transformar esmeraldas brutas de Campos Verdes (GO) em **Ativos do Mundo Real (RWA)** totalmente auditáveis, líquidos e compatíveis com a regulamentação brasileira, incluindo a **Instrução Normativa RFB nº 2.291/2025 (DeCripto/CARF)**.

A arquitetura centraliza a **mitigação absoluta de riscos** (físicos, geológicos e regulatórios) através da segregação clara de responsabilidades, garantindo:
* **Segurança Jurídica:** A validade do ativo é inscrita no código, assegurando a continuidade do projeto contra a instabilidade política.
* **Precisão Científica:** Uso de ciência de ponta para autenticar a gema.
* **Conformidade Fiscal:** Reporte de impostos automatizado e em conformidade com o padrão global CARF/OCDE.

## Arquitetura de Tripla Blindagem (Triple Shielding)

A blindagem do RWA Mineral ocorre em três camadas interligadas, utilizando a rede Ethereum (EVM) e o **Ethereum Attestation Service (EAS)**. O ativo digital é representado como um **Token ERC-721 (NFT)**.

### Camada 1: Blindagem Física e Fiscal
**(Ator: COOPESMERALDA - Oráculo Operacional e Custodiante)**

A Cooperativa Mista dos Garimpeiros de Esmeralda (**COOPESMERALDA**) atua como a âncora do mundo real, provendo a **Prova de Existência**.

* **Custódia:** Garante a custódia física do ativo mineral no **Underground Vault** (cofre na mina), para segregação do ativo.
* **Origem:** Emite a **Nota Fiscal Eletrônica (NFe)** de origem e registra o *hash* dessa NFe, criando o **Atestado de Origem (EAS #1)** na *blockchain*.
* **Risco Mitigado:** Fraude de volume e origem ilícita.

### Camada 2: Blindagem Científica e Política
**(Ator: GEMLAB Tech - Regente de Contratos e Auditor Digital)**

O GEMLAB é o **Oráculo Científico e Auditor Fiscal Digital**, responsável por criar a Prova Científica e a Prova Tributária.

* **Prova Científica (EAS #2):** A esmeralda é submetida à **Espectroscopia Raman**, gerando o **SpectralHash** (assinatura molecular única). O GEMLAB emite o **Atestado Científico (EAS #2)** na *blockchain*, provando a autenticidade e qualidade mineral.
* **Prova Tributária (EAS #5 - Imunidade Política):** O GEMLAB atesta que o pagamento do **CFEM e do ISS** foi calculado e protocolado (ancorando o *hash* do DARF/GUIA).
* **Regra Inabalável:** O Smart Contract (ERC-721) possui uma **regra IMUTÁVEL** que o torna **inválido e intransferível** se os três atestados (**EAS #1, #2 e #5**) não estiverem ativos. A arrecadação não pode ser desligada politicamente.

### Camada 3: Blindagem Financeira e Regulatória
**(Ator: VASP Parceiro - Gatekeeper de Liquidez)**

O **VASP Parceiro** Assume a custódia fiduciária, o KYC/AML e a liquidação financeira, blindando o ecossistema contra regulamentações bancárias.

* **Gatekeeper de Transferência:** O Smart Contract restringe a compra do NFT a carteiras com **Atestado *on-chain* de KYC/AML validado** (padrões como ERC-3643/1400).
* **Compliance DeCripto/CARF:** Para transações acima de **R$ 35.000**, o sistema integra **Zero-Knowledge Proofs (ZKPs)**. Um *ZK Proof of Transaction* é gerado para certificar o reporte obrigatório à Receita Federal (**DeCripto**) sem expor a margem de lucro e a identidade do vendedor (privacidade estratégica).

## 🔒 VSC (Value-Separated Control) Architecture
## Impacto Social e Governança Regenerativa

This repository contains the core implementation of the GEMLAB Protocol, architected under strict **VSC principles**:
O protocolo garante que parte da receita retorne para o desenvolvimento local, criando o **Lastro Social** do RWA. O impacto é medido e registrado via EAS:
* **Projeto Mãos de Pedra (R$ 100.000,00):** Focado na capacitação de jovens e adultos em lapidação, design e formação de **Operadores Raman**.
* **Projeto Mineração nas Escolas (R$ 140.000,00):** Promove a **transformação cultural** e a educação em Geociências e Mineração Sustentável, mitigando o risco social (ESG) e garantindo um *pipeline* de futuros técnicos.
* **Métrica de Sucesso:** O GEMLAB utiliza o EAS para criar um **Atestado de Impacto Educacional (EAS Schema)**, registrando o número de alunos alcançados e kits entregues anualmente.

1. **Value Layer (The Truth):** Off-chain scientific validation (Raman Spectroscopy) anchored via cryptographic hashes.
2. **Control Layer (The Rules):** Smart Contracts ensuring atomic settlement and fiscal compliance.
3. **Interface Layer (The View):** Decoupled front-ends for privacy and performance.
## Ferramentas para Desenvolvedores (EAS SDK)

### Core Features
O Ethereum Attestation Service (EAS) é a infraestrutura de confiança fundamental para o projeto. Os desenvolvedores podem interagir com os atestados usando as seguintes ferramentas:

* **Fail-Fast Validation:** Transactions revert immediately if required attestations (EAS) are missing.
* **Data Economy:** Heavy data (images, spectra) stored off-chain; only `bytes32` hashes touch the blockchain.
* **Zero-Trust Security:** Private keys managed via KMS/Env variables; strict role separation between Origin, Science, and Custody actors.
### Instalação do SDK (TypeScript/JavaScript)

Para integrar o EAS em seu projeto, use o comando abaixo para instalar a biblioteca:

```bash
yarn add @ethereum-attestation-service/eas-sdk
# ou npm install @ethereum-attestation-service/eas-sdk
```

### Contratos e Endpoints

A EAS funciona com dois contratos principais: `SchemaRegistry.sol` (define a estrutura de dados) e `EAS.sol` (cria os atestados).

A API **GraphQL** é o meio flexível para consultar dados de atestação.

| Rede | Endpoint GraphQL de Exemplo |
| :--- | :--- |
| Ethereum (Mainnet) | `https://easscan.org/graphql` |
| Ethereum (Sepolia) | `https://sepolia.easscan.org/graphql` |

O SDK é usado para:
* Criar atestações *on-chain* e *off-chain*.
* Verificar atestações fora da cadeia.
* Registrar um esquema.
* Revogar atestações.

---

## 🛠 Tech Stack
## Documentação Adicional

Confira as variações especializadas deste README:

* **Smart Contracts:** Solidity ^0.8.20 (OpenZeppelin + EAS)
* **Validation:** Ethereum Attestation Service (EAS)
* **Framework:** Hardhat
* **Network:** Ethereum Sepolia (Testnet) / Mainnet
- **[README-DEV.md](./README-DEV.md)** - Documentação técnica para desenvolvedores
- **[README-EXECUTIVE.md](./README-EXECUTIVE.md)** - Visão executiva para investidores e parceiros
- **[README-COMPLIANCE.md](./README-COMPLIANCE.md)** - Documentação regulatória e de compliance

---

## ⚠️ Private Repository Notice
## Conclusão

O **Protocolo GEMLAB** é mais do que um ativo tokenizado; é uma infraestrutura de governança que utiliza o código para automatizar a lei fiscal e a ciência mineral, tornando Campos Verdes um **Modelo Global de Mineração Regenerativa 2050**.

---

## Licença

Este projeto está licenciado sob a **MIT License** - veja o arquivo [LICENSE.md](LICENSE.md) para detalhes.

O EAS (Ethereum Attestation Service) é um **protocolo de bem público** e de **código aberto** que visa catalisar a inovação.

## Contato

This project is currently in **Stealth Mode**.
Access to source code, documentation, and deployment scripts is restricted to authorized personnel only.
Para mais informações sobre o projeto ou a arquitetura, entre em contato com o time do GEMLAB.

**Unauthorized use, copying, or distribution of this code is strictly prohibited.**
**GEMLAB Tech** - Campos Verdes, Goiás, Brasil
Website: [Em desenvolvimento]
Email: dguedz07@gmail.com

---

*© 2026 GEMLAB Protocol. All Rights Reserved.*
**Built with for transparent and sustainable mining**