Documentacao Tecnica

Whitepaper SementeToken

Infraestrutura de reflorestamento tokenizado com rastreabilidade on-chain, simulacao de crescimento por IA e mercado de carbono integrado.

v2.1 · Abril 2026Baixar PDF ↓

Visao geral

1. Resumo Executivo

SementeToken e uma plataforma de reflorestamento que transforma arvores reais em ativos digitais rastreavies na blockchain. Cada arvore plantada e vinculada a um NFT unico na rede Polygon, com coordenadas GPS, especie botanica e data de plantio registrados de forma imutavel.

A plataforma opera com um sistema de tokens duais: o Green Token, moeda interna de utilidade usada para transacoes no marketplace e recompensas, e o Seed Token, lastreado em arvores reais e cunhado como NFT na blockchain. O token SEME (ERC-20) funciona como token de governanca do ecossistema.

Um motor de inteligencia artificial simula o crescimento de cada arvore com base em modelos de curva sigmoide calibrados por especie e bioma, calculando diariamente a captura de CO2 e permitindo que proprietarios acompanhem o impacto ambiental em tempo real. O motor de carbono distribui creditos mensalmente para assinantes e proprietarios permanentes.

Para empresas, a plataforma oferece uma API B2B com chaves de acesso granulares, relatorios ESG automatizados com conformidade GRI/SASB e certificados de carbono verificaveis na blockchain. O objetivo e criar a infraestrutura que permita a qualquer pessoa ou organizacao financiar restauracao ecologica com confianca e transparencia.

Polygon

Blockchain principal

ERC-721

Padrao dos NFTs

6 Biomas

Cobertura nacional

API B2B

Integracao corporativa


Contexto

2. Contexto e Problema

2.1 Desmatamento no Brasil

O Brasil abriga seis biomas com biodiversidade unica: Amazonia, Mata Atlantica, Cerrado, Caatinga, Pantanal e Pampa. A pressao sobre esses ecossistemas continua sendo um dos maiores desafios ambientais globais. A Mata Atlantica, por exemplo, conserva apenas 12% de sua cobertura original, enquanto o Cerrado perde area equivalente a milhares de campos de futebol por ano.

Apesar de marcos regulatorios como o Codigo Florestal e compromissos internacionais assumidos pelo pais, a execucao de projetos de restauracao esbarra em falta de financiamento descentralizado, dificuldade de monitoramento e ausencia de mecanismos que conectem diretamente investidores a areas de plantio.

2.2 Limitacoes do Mercado de Carbono

O mercado voluntario de creditos de carbono movimenta bilhoes de dolares globalmente, mas apresenta problemas estruturais que limitam seu impacto:

  • Opacidade: o comprador raramente sabe onde, quando e como o carbono foi efetivamente compensado
  • Barreiras de entrada: pequenos produtores e proprietarios rurais nao conseguem acessar o mercado por conta de custos de certificacao
  • Dupla contagem: sem registro imutavel, o mesmo credito pode ser vendido mais de uma vez
  • Desconexao temporal: certificados sao emitidos com base em projecoes, sem acompanhamento contínuo do ativo biologico
  • Falta de granularidade: creditos sao comercializados em blocos grandes, excluindo pessoas fisicas e pequenas empresas

2.3 A Oportunidade

A convergencia de tres tecnologias cria uma oportunidade unica para resolver esses problemas: blockchain para rastreabilidade imutavel, inteligencia artificial para monitoramento continuo, e sensoriamento remoto para verificacao independente. O SementeToken combina essas tres camadas numa unica plataforma acessivel a qualquer pessoa com acesso a internet.


Plataforma

3. A Solucao SementeToken

O SementeToken e um ecossistema completo que conecta tres pontas: projetos de restauracao florestal que precisam de financiamento, individuos e empresas que desejam compensar sua pegada de carbono, e comunidades locais que executam o plantio e manutencao.

3.1 Pilares da Plataforma

Impacto verificavel

Cada arvore recebe coordenadas GPS e e vinculada a um NFT na Polygon. O registro e publico e imutavel.

Transparencia on-chain

Smart contracts auditaveis, metadados no IPFS e historico completo de transacoes acessivel a qualquer pessoa.

IA de crescimento

Modelos de curva sigmoide calibrados por especie e bioma simulam altura, diametro e captura de CO2 diariamente.

Economia circular

Tokens de utilidade, cashback em carbono, assinaturas e marketplace criam um ciclo virtuoso de conservacao.

3.2 Fluxo do Usuario

01

Escolha e plante

Selecione uma especie nativa no marketplace. Cada compra financia o plantio real de uma arvore em um projeto verificado com coordenadas GPS.

02

Receba seu NFT

Um token ERC-721 unico e registrado na Polygon com especie, bioma, localizacao e data de plantio. Metadados armazenados no IPFS via Pinata.

03

Acompanhe o crescimento

A IA simula o crescimento diariamente, calcula CO2 capturado e permite que voce converse com sua arvore pelo chatbot integrado.


Economia

4. Tokenomics

O ecossistema opera com um sistema de tres tokens complementares, cada um com funcao especifica na economia da plataforma. Esse modelo permite separar utilidade interna, representacao de ativos reais e governanca do protocolo.

Green Token

Utilidade interna

Moeda interna da plataforma. Utilizado para compras no marketplace, recompensas de gamificacao, missoes diarias e semanais. Conversivel para Seed Tokens na proporcao de 100:1.

Seed Token (NFT)

Ativo real tokenizado

ERC-721 na Polygon. Cada Seed Token representa uma arvore real plantada. Contem metadados no IPFS com especie, coordenadas GPS, bioma e impacto de CO2 estimado.

SEME (ERC-20)

Governanca

Token de governanca na Polygon. Usado para votacao em decisoes do protocolo, staking com rendimento e acesso a recursos premium. Cunhagem controlada pelo contrato owner.

5.1 Distribuicao por Compra

A cada compra de arvore na plataforma, o valor e distribuido de forma transparente entre tres destinacoes, garantindo sustentabilidade operacional e expansao do ecossistema:

40%

Plataforma

Operacao e desenvolvimento

40%

Expansao

Novos projetos de restauracao

20%

Brigadas

Recompensas comunitarias

5.2 Conversao Green → Seed

Usuarios podem converter Green Tokens em Seed Tokens na proporcao fixa de 100:1. A conversao e irreversivel e resulta na criacao de uma arvore com status VALIDATED, pronta para cunhagem como NFT na blockchain. O processo e atomico: o saldo e verificado, os tokens sao debitados e a arvore e criada na mesma transacao.

5.3 Modelo de Assinatura

Alem da compra avulsa, a plataforma oferece um modelo Plant-as-a-Service com tres modalidades de assinatura por especie:

  • Mensal: pagamento recorrente com alocacao mensal de carbono da arvore assinada
  • Anual: desconto sobre o valor mensal com alocacao continua e relatorio ESG anual incluso
  • Permanente: pagamento unico que transfere 100% do carbono vitalicio da arvore ao proprietario

Cada especie possui precificacao propria organizada em cinco tiers: Basic, Productive, Native ESG, Premium e Elite, com valores diferenciados baseados no potencial de captura de carbono e raridade.


Ativos digitais

5. Arvores como NFTs

Cada arvore plantada na plataforma e representada por um NFT unico no padrao ERC-721, cunhado na rede Polygon. O NFT funciona como um certificado digital de propriedade e impacto ambiental, contendo metadados detalhados armazenados de forma permanente no IPFS.

6.1 Estrutura de Metadados

Cada NFT armazena no IPFS um conjunto padronizado de atributos que identificam e rastreiam a arvore. Exemplo de metadados de uma Castanheira plantada na Amazonia:

Nome:Arvore Semente #123
Imagem:Armazenada no IPFS
Especie:Castanheira
Nome cientifico:Bertholletia excelsa
Bioma:Amazonia
Data de plantio:15/03/2025
Coordenadas:-3.5000, -60.2000
Impacto CO2:300 kg estimados

6.2 Ciclo de Vida da Arvore

Cada arvore atravessa um ciclo de vida com quatro status principais, garantindo rastreabilidade desde a criacao ate a cunhagem na blockchain:

PENDING

Criada, aguardando foto de validacao

VALIDATED

Foto confirmada, pronta para cunhagem

MINTED

NFT criado na Polygon

SOLD

Adquirida por usuario final

6.3 Estagios de Crescimento

O crescimento de cada arvore e classificado em quatro estagios baseados na idade desde o plantio:

🌱

Semente

0 – 6 meses

🌿

Muda

6 – 24 meses

🌳

Jovem

2 – 10 anos

🏔

Adulta

10+ anos

6.4 Especies Suportadas

A plataforma suporta multiplas especies nativas brasileiras, cada uma com parametros de crescimento calibrados. Exemplos de especies com seus modelos:

EspecieBiomaAltura max.CO2/anoMaturidade
CastanheiraAmazonia50m45 kg25 anos
Ipe AmareloCerrado15m22 kg15 anos
Pau-BrasilMata Atlantica20m25 kg20 anos
JatobaCerrado20m30 kg18 anos
MognoAmazonia40m40 kg22 anos
AraucariaMata Atlantica35m35 kg20 anos

Carbono

6. Motor de Carbono

O Motor de Carbono e o nucleo economico da plataforma. Ele calcula, aloca e distribui creditos de carbono de forma automatizada com base no crescimento real simulado de cada arvore. O ciclo opera mensalmente, no primeiro dia de cada mes.

7.1 Ciclo Mensal

Etapa 1

Atualizacao de producao

Para cada arvore com producao ativa, o sistema calcula o carbono produzido no mes e decrementa a capacidade remanescente. Arvores tem um ciclo de vida finito (padrao: 20 anos de captura).

Etapa 2

Alocacao para assinantes

Para cada assinatura ATIVA, o sistema cria um registro de CarbonUsage com os quilogramas produzidos pela arvore no periodo, com deduplicacao por mes/ano para evitar dupla alocacao.

Etapa 3

Proprietarios permanentes

Arvores com alocacao PERMANENTE recebem registro unico com todo o carbono remanescente da arvore, transferindo 100% do ciclo de vida ao proprietario.

Etapa 4

Expiracoes

Assinaturas vencidas (currentPeriodEnd ultrapassado) sao marcadas como EXPIRED e a arvore retorna ao status FREE, podendo ser reassinada.

7.2 Capacidade de Carbono

Cada arvore possui tres campos de carbono no banco de dados: capacidade total (carbonCapacity), produzido mensalmente (carbonMonthly) e remanescente (carbonRemaining). A capacidade total e calculada com base na especie e no tempo de vida estimado (padrao 240 meses). Quando o carbono remanescente chega a zero, a arvore encerra sua producao.

7.3 Multiplicadores por Bioma

A produtividade de carbono de cada arvore e ajustada pelo bioma onde esta plantada, refletindo diferencas reais de pluviosidade, solo e clima:

1.3x

Amazonia

1.1x

Mata Atlantica

1.0x

Pantanal

0.85x

Cerrado

0.75x

Pampa

0.6x

Caatinga


IA

7. Inteligencia Artificial

O servico de IA opera como um microsservico independente em Python (FastAPI) e e responsavel por duas funcionalidades centrais: simulacao de crescimento e chatbot de personalidade das arvores.

8.1 Simulacao de Crescimento

O modelo utiliza uma curva logistica (sigmoide) para simular o crescimento de cada arvore ao longo do tempo. A funcao recebe a especie, data de plantio, coordenadas e bioma, e retorna metricas atualizadas:

Modelo de crescimento sigmoide

A curva logistica simula o crescimento biologico natural: aceleracao inicial, crescimento maximo na fase jovem e desaceleracao na maturidade. Os parametros sao calibrados por especie (altura maxima, ponto medio de crescimento, CO2 anual base) e ajustados pelo multiplicador do bioma.

CO2 acumulado

Total de carbono capturado desde o plantio, em quilogramas

CO2 diario

Absorcao diaria atual em gramas, baseada na taxa de crescimento

Crescimento diario

Incremento de altura em centimetros por dia

Status de saude

Excelente, Bom ou Estavel, baseado na taxa de crescimento

A simulacao e executada automaticamente todos os dias as 3h UTC pelo servico TreeGrowthService, processando arvores em lotes de 50 com intervalo de 1 segundo entre lotes para evitar sobrecarga.

8.2 Chatbot da Arvore

Cada arvore na plataforma possui uma personalidade unica e pode conversar com seu proprietario. O chatbot utiliza o modelo GPT-4o Mini via OpenRouter, com um system prompt que instrui a IA a responder como se fosse a propria arvore, incorporando dados reais da especie, bioma, localizacao e estagio de crescimento.

  • Personalidade unica baseada na especie e bioma da arvore
  • Conteudo educacional sobre clima, solo e biodiversidade
  • Historico de conversas persistente no banco de dados
  • Fallback automatico para respostas offline quando a API externa esta indisponivel

Blockchain

8. Blockchain e Smart Contracts

A infraestrutura blockchain do SementeToken opera primariamente na rede Polygon, escolhida por suas baixas taxas de gas, compatibilidade EVM completa e compromisso com sustentabilidade (Proof of Stake). Um único smart contract constitui a camada on-chain do protocolo.

9.1 Contratos Implantados

ERC-721 + ERC-4907

SementeNFT

Cada arvore = 1 NFT com URI unica apontando para metadados no IPFS. Implementa o padrao ERC-4907 (Rental NFT): o owner permanece com o protocolo ate a compra definitiva, enquanto assinantes recebem direitos temporarios via setUser com data de expiracao. Extensao URIStorage permite consulta de tokenURI() por qualquer pessoa. IDs auto-incrementados. Cunhagem restrita ao owner do contrato.

9.2 Fluxo de Cunhagem

O processo de cunhagem de um NFT segue seis etapas, desde a validacao da arvore ate o registro final no banco de dados:

1

Arvore atinge status VALIDATED no banco de dados

2

Metadados gerados: especie, bioma, GPS, CO2 estimado, imagem

3

Upload dos metadados para o IPFS via Pinata

4

Chamada ao smart contract SementeNFT na Polygon

5

Confirmacao on-chain e extracao do tokenId

6

Registro do txHash, tokenId e ipfsHash no banco

9.3 Escolha da Polygon

  • Taxas de gas inferiores a $0.01 por transacao, viabilizando cunhagem em escala
  • Proof of Stake: baixo consumo energetico, coerente com a missao ambiental
  • Compatibilidade EVM completa: ferramentas e bibliotecas maduras (ethers.js, OpenZeppelin)
  • Finalidade rapida: confirmacao em segundos, nao minutos
  • Ecossistema robusto: integracao com marketplaces de NFT e protocolos DeFi

Comercio

9. Marketplace

O marketplace e o principal ponto de entrada para usuarios adquirirem arvores e produtos sustentaveis. Opera com pagamentos em BRL via Stripe e oferece um sistema de cashback em carbono que incentiva compras recorrentes.

10.1 Produtos e Precificacao

Cada produto no marketplace esta vinculado a um projeto de restauracao e a uma especie. A precificacao e em centavos de Real (BRL) e inclui um valor de carbon cashback — quilogramas de CO2 creditados imediatamente na conta do comprador alem do impacto da arvore adquirida.

10.2 Fluxo de Compra

1

Usuario seleciona produto e quantidade no marketplace

2

Sessao de checkout criada no Stripe (moeda BRL)

3

Pagamento confirmado via webhook (checkout.session.completed)

4

Arvores geradas com status VALIDATED e vinculadas ao usuario

5

Green Tokens e XP creditados como recompensa de gamificacao

6

Carbon cashback alocado imediatamente na conta do comprador

7

NFT cunhado na Polygon com metadados no IPFS

10.3 Processamento de Pagamentos

Todos os pagamentos sao processados via Stripe em BRL. O backend utiliza raw body parsing para validacao de webhooks com assinatura criptografica. Verificacao de idempotencia impede processamento duplicado de uma mesma sessao de pagamento. Os metadados da sessao carregam userId, productId, quantidade e valor para reconstrucao completa do pedido.


Corporativo

10. ESG Corporativo

O modulo ESG permite que empresas integrem reflorestamento verificavel em suas estrategias de sustentabilidade. A plataforma oferece desde compra avulsa de arvores ate integracoes B2B automatizadas via API.

11.1 API de Parceiros (B2B)

Empresas e brigadas ambientais podem acessar a plataforma programaticamente atraves de chaves de API com permissoes granulares:

RecursoPermissoesDescricao
treescreate, read, update, deleteCRUD completo de arvores no projeto vinculado
orderscreate, readCriar e consultar pedidos via API
carbonreadConsultar alocacoes e relatorios de carbono
reportsread, generateGerar relatorios ESG em PDF
  • Chaves com prefixo visivel (sk-xyz...) e hash armazenado no banco para seguranca
  • Rate limiting configuravel por chave (padrao: 60 requisicoes por minuto)
  • Contagem de requisicoes e timestamp de ultimo uso para auditoria
  • Isolamento por projeto: cada chave e vinculada a um projeto especifico

11.2 Relatorios ESG

A plataforma gera relatorios ESG automatizados em formato PDF contendo: cabecalho com dados da empresa, resumo de arvores plantadas e CO2 compensado, detalhamento por especie/bioma/estado e hash da transacao blockchain para cada arvore. Os relatorios seguem frameworks de conformidade GRI e SASB.

11.3 Dados Municipais (MapBiomas)

O modulo ESG inclui dados de estimativa de arvores por municipio brasileiro, alimentados pelo dataset de uso do solo MapBiomas. Cada registro contem o codigo IBGE do municipio, bioma, area em hectares, estimativa de arvores e coordenadas, permitindo agregacao por regiao e planejamento de novos projetos de restauracao.


Engajamento

11. Gamificacao

A plataforma incorpora mecanicas de gamificacao para incentivar engajamento continuo e criar um ciclo virtuoso de participacao. O sistema opera em tres eixos: progressao, missoes e conquistas.

Progressao

Niveis e XP

Cada acao na plataforma concede XP. Usuarios sobem de nivel ao acumular experiencia, desbloqueando recursos exclusivos e titulos.

Missoes

Diarias e Semanais

Tarefas rotativas que recompensam com Green Tokens e XP. Exemplos: plantar primeira arvore, completar pedido, fazer check-in diario.

Conquistas

Badges e Marcos

Insignias permanentes por marcos de impacto: primeira arvore, 10 arvores, 100 arvores, 50kg de CO2, 500kg de CO2.

12.1 Check-in Diario

Usuarios que fazem login diario acumulam streaks (sequencias consecutivas). O streak e resetado se um dia for pulado. Recompensas escalam com a sequencia, incentivando retencao e engajamento de longo prazo.


Seguranca

12. Seguranca e Autenticacao

A plataforma implementa multiplas camadas de seguranca para proteger dados de usuarios, transacoes financeiras e operacoes blockchain.

13.1 Autenticacao

  • JWT com tokens de acesso (15 minutos) e refresh tokens (7 dias)
  • Senhas hashadas com bcrypt (custo computacional adequado)
  • Tres papeis de usuario: USER, ADMIN e CORPORATE com guards de autorizacao
  • Atribuicao automatica de ADMIN para o e-mail configurado em ADMIN_EMAIL
  • Suporte a OAuth via Firebase (Google)

13.2 Pagamentos

  • Webhooks Stripe validados com assinatura criptografica (raw body parsing)
  • Verificacao de idempotencia para evitar processamento duplicado
  • Valores sempre processados em centavos para evitar erros de ponto flutuante

13.3 API e Rate Limiting

  • Chaves de API com hash no banco (prefixo visivel para identificacao)
  • Rate limiting por chave configuravel (padrao: 60 RPM)
  • Permissoes granulares no formato resource:action
  • Monitoramento de uso com contagem de requisicoes e ultimo acesso

13.4 Blockchain

  • Chave privada do deployer isolada em variavel de ambiente
  • Cunhagem restrita ao owner do contrato (onlyOwner modifier)
  • Fallback para transacoes stub quando escrita esta desabilitada
  • Aguarda recibo de transacao antes de registrar sucesso no banco

Planejamento

13. Roadmap

O desenvolvimento do SementeToken segue um plano de cinco fases, da concepcao ate a globalizacao do protocolo. As tres primeiras fases estao concluidas.

Fase 1: Fundacao

Q1 2024Concluida
  • Website e Whitepaper
  • Smart Contracts (Beta)
  • Parcerias iniciais de reflorestamento
  • Venda privada de SementeTokens

Fase 2: Expansao

Q2 2024Concluida
  • Lancamento do Marketplace
  • Integracao com API de Especies
  • Modulo ESG Corporativo
  • Auditoria de seguranca dos contratos

Fase 3: Ecossistema

Q1 2025Concluida
  • Calculadora de Carbono publica
  • Sistema de assinaturas e planos
  • Chat com IA das arvores
  • Expansao para novos biomas

Fase 4: Escala

Q2 2026Em andamento
  • App Mobile (iOS e Android)
  • Turismo Verde e experiencias imersivas
  • Staking de SementeTokens
  • Brigadas ambientais corporativas

Fase 5: Globalizacao

Q4 2026+Planejada
  • Parcerias internacionais
  • Integracao com mercados de carbono globais
  • Governanca DAO completa
  • Listagem em grandes exchanges

Referencia

14. Glossario

ERC-20

Padrao de token fungivel na Ethereum e redes compativeis (Polygon). Usado pelo token SEME.

ERC-721

Padrao de token nao-fungivel (NFT). Cada arvore e representada por um NFT unico neste padrao.

IPFS

InterPlanetary File System. Rede descentralizada de armazenamento onde os metadados dos NFTs sao guardados permanentemente.

PostGIS

Extensao do PostgreSQL para dados geoespaciais. Armazena localizacao das arvores como pontos geograficos.

Curva sigmoide

Funcao matematica em forma de S usada para modelar crescimento biologico. Captura aceleracao inicial e desaceleracao na maturidade.

Gas

Custo computacional para executar transacoes na blockchain. Na Polygon, taxas de gas sao muito baixas.

Cunhagem (Minting)

Processo de criar um novo NFT na blockchain, registrando permanentemente os metadados da arvore.

Carbon cashback

Quilogramas de CO2 creditados imediatamente na conta do comprador como bonus pela compra de um produto.

Rate limiting

Limite de requisicoes por periodo de tempo para proteger a API contra abuso.

GRI / SASB

Frameworks internacionais de relatorio de sustentabilidade. GRI (Global Reporting Initiative) e SASB (Sustainability Accounting Standards Board).

DAO

Organizacao Autonoma Descentralizada. Modelo de governanca onde detentores de tokens votam em decisoes do protocolo.

MapBiomas

Iniciativa multi-institucional que mapeia o uso e cobertura do solo no Brasil. Fonte dos dados municipais de estimativa de arvores.


Pronto para fazer parte?

Plante arvores reais, receba NFTs verificaveis e acompanhe seu impacto ambiental em tempo real.

SementeToken Whitepaper v2.1 · Abril 2026 · Todos os direitos reservados