Skip to content

CarbonScribe is a full-stack Stellar platform that tokenizes ecosystem services into Dynamic Carbon Credits. Built with Next.js, Nest.js, and Soroban smart contracts, it allows corporations to purchase and instantly retire credits with real-time pricing based on live satellite and IoT verification data.

Notifications You must be signed in to change notification settings

estyemma/carbon-scribe

Β 
Β 

Repository files navigation

CarbonScribe: Carbon Credit Tokenization & Real-Time Retirement Platform

Stellar Mainnet License: AGPL-3.0 Soroban Rust Next.js 15 Carbon Real Time Verified

CarbonScribe is an end-to-end platform where regenerative agriculture and forestry projects issue carbon credits as Stellar Assets, which corporations can purchase and instantly retire with transparent, on-chain proof. We're building the Internet of Carbonβ€”a digital public utility that transforms ecosystem services into programmable financial assets with real-time environmental telemetry.

🌍 The Carbon Market Problem

Current carbon markets are opaque, inefficient, and lack trust:

  • Verification delays: 6-18 months for credit issuance and verification
  • Opaque pricing: No real-time price discovery, limited liquidity
  • Double counting risks: Inadequate global tracking systems
  • High transaction costs: 30-60% of credit value lost to intermediaries
  • Limited accessibility: Small projects in developing nations excluded
  • Static credits: Fixed value regardless of changing environmental conditions

✨ CarbonScribe's Solution

Real-time, transparent carbon ecosystem:

  • Instant tokenization: Convert verified carbon removals to Stellar Assets in minutes
  • Dynamic pricing: Credit values adjust based on satellite-verified ecosystem health
  • Global interoperability: Bridges to Verra, Gold Standard, and UN registries
  • Automated compliance: Built-in regulatory checks for Article 6, CORSIA, CBAM
  • Direct financing: Forward sales and derivatives for project pre-financing
  • Public transparency: Every credit and retirement visible on public ledger

πŸ—οΈ 7-Layer Architecture

Layer 1: Stellar Blockchain Core

Registry & Settlement Layer - The Trust Foundation:

  • carbon-asset-factory/: C-01 Token Standard (extended Stellar Asset with environmental metadata)
  • verifiable-registry/: Hybrid Stellar+IPFS registry with cross-chain bridges
  • compliance-engine/: Jurisdiction-specific regulatory checks and tax treatment

Key Innovations:

  • C-01 Token Standard: Embedded carbon methodology, vintage, and verification data
  • Time-locked vintages: Prevent premature credit issuance
  • Buffer pool contracts: Automated risk mitigation for reversals
  • Immutable retirement ledger: Global prevention of double counting

Folder Structure:

      stellar-core/
   β”œβ”€β”€ carbon-asset-factory/          # Soroban Smart Contracts (Rust)
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œβ”€β”€ lib.rs
   β”‚   β”‚   β”œβ”€β”€ carbon_asset.rs       # Class C-01 Token Standard (extended Stellar Asset)
   β”‚   β”‚   β”œβ”€β”€ retirement_tracker.rs # Immutable retirement ledger
   β”‚   β”‚   β”œβ”€β”€ buffer_pool.rs        # Risk mitigation pool
   β”‚   β”‚   └── methodology_library.rs # On-chain methodology NFTs
   β”‚   └── Cargo.toml
   β”œβ”€β”€ verifiable-registry/          # Stellar + IPFS Hybrid
   β”‚   β”œβ”€β”€ registry_contract.rs      # Project metadata anchoring
   β”‚   β”œβ”€β”€ merkle_bridge.rs          # Cross-registry compatibility (Verra->Stellar)
   β”‚   └── time_locks.rs             # Vintage locking mechanisms
   └── compliance-engine/            # Soroban Contracts
      β”œβ”€β”€ regulatory_checks.rs      # Jurisdiction-specific rules
      β”œβ”€β”€ tax_attribute.rs          # Carbon credit tax treatment
      └── audit_trail.rs            # Immutable compliance records

Layer 2: Earth Observation & IoT Verification

Satellite Oracle Network - The Truth Layer:

  • satellite-oracle-network/: ML processing of Sentinel-2, Planet Labs, and drone data
  • iot-device-network/: Soil sensors, methane detectors, wildlife cameras with edge computing
  • ground-truth-validation/: Mobile apps for field verification with validator staking

Folder Structure:

   verification-layer/
   β”œβ”€β”€ satellite-oracle-network/     # Python (ML + Geospatial)
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œβ”€β”€ sentinel_processor/   # ESA Sentinel-2, Planet Labs
   β”‚   β”‚   β”‚   β”œβ”€β”€ ndvi_calculator.py # Vegetation health
   β”‚   β”‚   β”‚   β”œβ”€β”€ biomass_estimator.py
   β”‚   β”‚   β”‚   └── change_detection.py # Deforestation alerts
   β”‚   β”‚   β”œβ”€β”€ drone_ingestion/      # Field drone data
   β”‚   β”‚   β”‚   β”œβ”€β”€ photogrammetry.py
   β”‚   β”‚   β”‚   └── lidar_processor.py
   β”‚   β”‚   └── oracle_consensus/
   β”‚   β”‚       β”œβ”€β”€ data_fusion.py    # Combine satellite + IoT + ground
   β”‚   β”‚       └── discrepancy_resolution.py
   β”‚   └── Dockerfile
   β”œβ”€β”€ iot-device-network/           # Go (Edge Computing)
   β”‚   β”œβ”€β”€ cmd/
   β”‚   β”‚   └── iot-gateway/
   β”‚   β”‚       └── main.go
   β”‚   β”œβ”€β”€ internal/
   β”‚   β”‚   β”œβ”€β”€ sensors/
   β”‚   β”‚   β”‚   β”œβ”€β”€ soil_sensor.go    # Soil carbon measurement
   β”‚   β”‚   β”‚   β”œβ”€β”€ methane_detector.go
   β”‚   β”‚   β”‚   └── wildlife_camera.go # Biodiversity proof
   β”‚   β”‚   β”œβ”€β”€ edge_compute/
   β”‚   β”‚   β”‚   β”œβ”€β”€ local_ml.go       # On-device inference
   β”‚   β”‚   β”‚   └── data_compression.go
   β”‚   β”‚   └── lorawan_handler.go    # Low-power transmission
   β”‚   └── Dockerfile
   └── ground-truth-validation/      # Mobile App + Blockchain
      β”œβ”€β”€ field-app/                # React Native
      β”‚   β”œβ”€β”€ src/
      β”‚   β”‚   β”œβ”€β”€ audit/
      β”‚   β”‚   β”‚   β”œβ”€β”€ tree_counter.tsx
      β”‚   β”‚   β”‚   └── photo_geotag.tsx
      β”‚   β”‚   └── offline-sync/
      β”‚   β”‚       └── block_sync.ts
      β”‚   └── package.json
      └── validator-staking/        # Soroban Contract
         └── validator_rewards.rs  # Incentives for ground truth

Key Innovations:

  • Multi-source consensus: Satellite + IoT + ground truth fusion
  • Real-time NDVI tracking: Vegetation health monitoring every 5 days
  • Automated change detection: Deforestation alerts within 24 hours
  • Biodiversity proof: Wildlife camera integration for co-benefit verification

Layer 3: Project Developer Portal

Farmer & Project Interface - The Creation Layer:

  • frontend/: Next.js 15 portal for project onboarding, monitoring, and financing
  • backend/: Go service handling project intake, methodology application, tokenization

Key Features:

  • Interactive project mapping: Time-lapse satellite imagery visualization
  • Automated PDD generation: Project Design Document creation with AI assistance
  • Forward sale marketplace: Sell future vintages for upfront financing
  • Real-time monitoring dashboards: NDVI timelines and alert systems

Folder Structure:

   project-portal/
   β”œβ”€β”€ frontend/                     # Next.js 15
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œβ”€β”€ app/
   β”‚   β”‚   β”‚   β”œβ”€β”€ (developer)/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ projects/
   β”‚   β”‚   β”‚   β”‚   β”‚   └── [id]/
   β”‚   β”‚   β”‚   β”‚   β”‚       β”œβ”€β”€ monitoring/
   β”‚   β”‚   β”‚   β”‚   β”‚       β”œβ”€β”€ verification/
   β”‚   β”‚   β”‚   β”‚   β”‚       └── financing/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ methodologies/
   β”‚   β”‚   β”‚   β”‚   └── analytics/
   β”‚   β”‚   β”‚   β”œβ”€β”€ api/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ webhook/
   β”‚   β”‚   β”‚   β”‚   └── satellite/
   β”‚   β”‚   β”‚   └── layout.tsx
   β”‚   β”‚   β”œβ”€β”€ components/
   β”‚   β”‚   β”‚   β”œβ”€β”€ maps/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ CarbonMap.tsx  # Interactive project mapping
   β”‚   β”‚   β”‚   β”‚   └── TimeLapseViewer.tsx
   β”‚   β”‚   β”‚   β”œβ”€β”€ monitoring/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ NDVITimeline.tsx
   β”‚   β”‚   β”‚   β”‚   └── AlertDashboard.tsx
   β”‚   β”‚   β”‚   └── financing/
   β”‚   β”‚   β”‚       β”œβ”€β”€ TokenizationWizard.tsx
   β”‚   β”‚   β”‚       └── ForwardSale.tsx
   β”‚   β”‚   └── lib/
   β”‚   β”‚       β”œβ”€β”€ stellar/
   β”‚   β”‚       β”‚   β”œβ”€β”€ carbonTokens.ts
   β”‚   β”‚       β”‚   └── retirement.ts
   β”‚   β”‚       β”œβ”€β”€ geospatial/
   β”‚   β”‚       β”‚   β”œβ”€β”€ mapbox.ts
   β”‚   β”‚       β”‚   └── satellite.ts
   β”‚   β”‚       └── ipfs/
   β”‚   β”‚           └── pinata.ts
   β”‚   └── next.config.js
   └── backend/                      # Go Service
      β”œβ”€β”€ cmd/
      β”‚   └── portal-api/
      β”‚       └── main.go
      β”œβ”€β”€ internal/
      β”‚   β”œβ”€β”€ project/
      β”‚   β”‚   β”œβ”€β”€ onboarding.go     # Project intake workflow
      β”‚   β”‚   β”œβ”€β”€ methodology.go    # Methodology application
      β”‚   β”‚   └── verification.go   # Verification request flow
      β”‚   β”œβ”€β”€ document/
      β”‚   β”‚   β”œβ”€β”€ pdf_generator.go  # PDD, monitoring reports
      β”‚   β”‚   └── ipfs_uploader.go  # Document anchoring
      β”‚   └── financing/
      β”‚       β”œβ”€β”€ tokenization.go   # Credit β†’ Stellar Asset
      β”‚       └── forward_sale.go   # Future vintages
      └── Dockerfile
      

Layer 4: Corporate Purchaser Platform

Enterprise Carbon Management - The Retirement Layer:

  • frontend/: Next.js 15 corporate dashboard for portfolio management and reporting
  • backend/: NestJS service handling instant retirement, compliance, and marketplace

Key Features:

  • One-click retirement: Instantly retire credits with on-chain proof
  • Automated ESG reporting: Generate CSRD, GHG Protocol, and SBTi reports
  • Dutch auction marketplace: Dynamic pricing for carbon credits
  • Impact visualization: SDG alignment and co-benefit tracking

Folder Structure:

   corporate-platform/
   β”œβ”€β”€ frontend/                     # Next.js 15
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œβ”€β”€ app/
   β”‚   β”‚   β”‚   β”œβ”€β”€ (corporate)/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ portfolio/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ marketplace/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ retirement/
   β”‚   β”‚   β”‚   β”‚   └── reporting/
   β”‚   β”‚   β”‚   β”œβ”€β”€ api/
   β”‚   β”‚   β”‚   β”‚   └── retirement-webhook/
   β”‚   β”‚   β”‚   └── layout.tsx
   β”‚   β”‚   β”œβ”€β”€ components/
   β”‚   β”‚   β”‚   β”œβ”€β”€ retirement/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ RetirementCertificate.tsx
   β”‚   β”‚   β”‚   β”‚   └── LiveRetirementFeed.tsx
   β”‚   β”‚   β”‚   β”œβ”€β”€ reporting/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ SDGCalculator.tsx
   β”‚   β”‚   β”‚   β”‚   └── AuditTrailViewer.tsx
   β”‚   β”‚   β”‚   └── marketplace/
   β”‚   β”‚   β”‚       β”œβ”€β”€ CreditExplorer.tsx
   β”‚   β”‚   β”‚       └── ImpactVisualizer.tsx
   β”‚   β”‚   └── lib/
   β”‚   β”‚       β”œβ”€β”€ compliance/
   β”‚   β”‚       β”‚   β”œβ”€β”€ ghg_protocol.ts
   β”‚   β”‚       β”‚   └── csrd_report.ts
   β”‚   β”‚       └── analytics/
   β”‚   β”‚           β”œβ”€β”€ impact_dashboard.ts
   β”‚   β”‚           └── carbon_accounting.ts
   β”‚   └── next.config.js
   β”œβ”€β”€ backend/                      # Nest.js + TypeScript
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œβ”€β”€ retirement/
   β”‚   β”‚   β”‚   β”œβ”€β”€ retirement.module.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ retirement.controller.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ retirement.service.ts      # Instant retirement logic
   β”‚   β”‚   β”‚   β”œβ”€β”€ certificate.service.ts     # NFT certificate generation
   β”‚   β”‚   β”‚   β”œβ”€β”€ retirement.schema.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ retirement.repository.ts
   β”‚   β”‚   β”‚   └── retirement.interface.ts
   β”‚   β”‚   β”œβ”€β”€ compliance/
   β”‚   β”‚   β”‚   β”œβ”€β”€ compliance.module.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ compliance.controller.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ reporting-engine.service.ts # Automate ESG reports
   β”‚   β”‚   β”‚   β”œβ”€β”€ validation.service.ts      # Prevent double counting
   β”‚   β”‚   β”‚   β”œβ”€β”€ ghg-protocol.service.ts    # GHG Protocol calculations
   β”‚   β”‚   β”‚   β”œβ”€β”€ csrd.service.ts            # CSRD reporting
   β”‚   β”‚   β”‚   └── audit-trail.service.ts     # Immutable compliance records
   β”‚   β”‚   β”œβ”€β”€ marketplace/
   β”‚   β”‚   β”‚   β”œβ”€β”€ marketplace.module.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ marketplace.controller.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ discovery-engine.service.ts # Credit recommendation AI
   β”‚   β”‚   β”‚   β”œβ”€β”€ auction-mechanism.service.ts # Dutch auctions
   β”‚   β”‚   β”‚   β”œβ”€β”€ credit-listing.service.ts   # Stellar asset listings
   β”‚   β”‚   β”‚   └── portfolio.service.ts        # Corporate credit portfolios
   β”‚   β”‚   β”œβ”€β”€ stellar/
   β”‚   β”‚   β”‚   β”œβ”€β”€ stellar.module.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ stellar.service.ts         # Stellar blockchain interactions
   β”‚   β”‚   β”‚   β”œβ”€β”€ soroban.service.ts         # Soroban smart contract calls
   β”‚   β”‚   β”‚   β”œβ”€β”€ asset-transfer.service.ts  # Carbon credit transfers
   β”‚   β”‚   β”‚   └── retirement-tracker.service.ts # On-chain retirement verification
   β”‚   β”‚   β”œβ”€β”€ webhooks/
   β”‚   β”‚   β”‚   β”œβ”€β”€ webhooks.module.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ webhooks.controller.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ stellar-webhook.service.ts # Stellar transaction listeners
   β”‚   β”‚   β”‚   β”œβ”€β”€ satellite-webhook.service.ts # Earth data updates
   β”‚   β”‚   β”‚   └── verification-webhook.service.ts # Project verification updates
   β”‚   β”‚   β”œβ”€β”€ analytics/
   β”‚   β”‚   β”‚   β”œβ”€β”€ analytics.module.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ analytics.controller.ts
   β”‚   β”‚   β”‚   β”œβ”€β”€ impact-dashboard.service.ts # Corporate impact metrics
   β”‚   β”‚   β”‚   β”œβ”€β”€ carbon-accounting.service.ts # Scope 1,2,3 calculations
   β”‚   β”‚   β”‚   └── sdg-mapping.service.ts      # SDG alignment tracking
   β”‚   β”‚   β”œβ”€β”€ shared/
   β”‚   β”‚   β”‚   β”œβ”€β”€ database/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ database.module.ts
   β”‚   β”‚   β”‚   β”‚   └── prisma.service.ts      # PostgreSQL + Prisma
   β”‚   β”‚   β”‚   β”œβ”€β”€ cache/
   β”‚   β”‚   β”‚   β”‚   └── redis.service.ts       # Redis for real-time data
   β”‚   β”‚   β”‚   β”œβ”€β”€ messaging/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ kafka.service.ts       # Event streaming
   β”‚   β”‚   β”‚   β”‚   └── web-socket.service.ts  # Real-time updates
   β”‚   β”‚   β”‚   β”œβ”€β”€ ipfs/
   β”‚   β”‚   β”‚   β”‚   └── ipfs.service.ts        # Document storage (retirement certs)
   β”‚   β”‚   β”‚   β”œβ”€β”€ guards/
   β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ corporate-auth.guard.ts
   β”‚   β”‚   β”‚   β”‚   └── stellar-signature.guard.ts
   β”‚   β”‚   β”‚   └── interceptors/
   β”‚   β”‚   β”‚       └── logging.interceptor.ts
   β”‚   β”‚   β”œβ”€β”€ app.module.ts
   β”‚   β”‚   β”œβ”€β”€ app.controller.ts
   β”‚   β”‚   └── main.ts
   β”‚   β”œβ”€β”€ test/                      # E2E and unit tests
   β”‚   β”‚   β”œβ”€β”€ retirement.e2e-spec.ts
   β”‚   β”‚   β”œβ”€β”€ compliance.e2e-spec.ts
   β”‚   β”‚   └── marketplace.e2e-spec.ts
   β”‚   β”œβ”€β”€ prisma/
   β”‚   β”‚   └── schema.prisma         # Database schema
   β”‚   β”œβ”€β”€ .env.example
   β”‚   β”œβ”€β”€ .eslintrc.js
   β”‚   β”œβ”€β”€ nest-cli.json
   β”‚   β”œβ”€β”€ package.json
   β”‚   └── tsconfig.json

Layer 5: Financialization Engine

Carbon Derivatives & Financing - The Liquidity Layer:

  • carbon-derivatives/: Soroban contracts for futures, options, and stability pools
  • project-financing/: Go service for credit scoring and deal syndication
  • cross-chain-bridge/: Rust bridges to Verra, Gold Standard, and Polygon DeFi

Key Innovations:

  • Tokenized futures: Trade future vintages with automated settlement
  • Project credit scoring: AI-driven assessment of project creditworthiness
  • Cross-registry bridges: Interoperability with traditional registries
  • Insurance pools: Community-funded protection against reversals

Folder Structure:

   financialization/
   β”œβ”€β”€ carbon-derivatives/           # Soroban Contracts
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œβ”€β”€ futures_contract.rs   # Tokenized future vintages
   β”‚   β”‚   β”œβ”€β”€ options_contract.rs   # Carbon price options
   β”‚   β”‚   └── stability_pool.rs     # Liquidity for project financing
   β”‚   └── Cargo.toml
   β”œβ”€β”€ project-financing/            # Go Service
   β”‚   β”œβ”€β”€ cmd/
   β”‚   β”‚   └── financing-api/
   β”‚   β”‚       └── main.go
   β”‚   β”œβ”€β”€ internal/
   β”‚   β”‚   β”œβ”€β”€ scoring/
   β”‚   β”‚   β”‚   β”œβ”€β”€ project_scorer.go # Creditworthiness scoring
   β”‚   β”‚   β”‚   └── risk_assessment.go
   β”‚   β”‚   β”œβ”€β”€ syndication/
   β”‚   β”‚   β”‚   β”œβ”€β”€ deal_structure.go
   β”‚   β”‚   β”‚   └── payment_waterfall.go
   β”‚   β”‚   └── collateral/
   β”‚   β”‚       β”œβ”€β”€ credit_escrow.go
   β”‚   β”‚       └── insurance_pool.go
   β”‚   └── Dockerfile
   └── cross-chain-bridge/           # Rust (IBC/CCIP)
   |   soroban/                    # On-chain verification contracts
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œβ”€β”€ bridge_validator.rs  # Validates incoming messages
   β”‚   β”‚   └── asset_minter.rs      # Controlled minting authority
   β”‚   └── Cargo.toml
   β”œ   relayer/                    # Off-chain relay service
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œβ”€β”€ verra_relayer.rs
   β”‚   β”‚   └── polygon_relayer.rs
   β”‚   └── Cargo.toml
   └── config/                     # Bridge configuration

Layer 6: Global Registry & Interoperability

Unified Carbon Registry - The Coordination Layer:

  • registry-of-registries/: Stellar smart contract for global credit ID system
  • api-gateway/: Go service providing unified GraphQL interface
  • compliance-adapter/: Python service for regulatory framework integration

Key Innovations:

  • Global retirement ledger: Real-time double counting prevention
  • Unified credit ID: Cross-registry identifier system
  • Regulatory adapters: Automated compliance with Article 6, CORSIA, CBAM
  • High-performance caching: Sub-second query response times

Folder Structure:

   global-registry/
   β”œβ”€β”€ registry-of-registries/       # Stellar Smart Contract
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œβ”€β”€ cross_registry.rs     # Unified credit ID system
   β”‚   β”‚   β”œ-> double_counting.rs    # Global prevention system
   β”‚   β”‚   β””-> retirement_ledger.rs  # Global retirement database
   β”‚   └── Cargo.toml
   β”œβ”€β”€ api-gateway/                  # Go Service
   β”‚   β”œβ”€β”€ cmd/
   β”‚   β”‚   └── registry-api/
   β”‚   β”‚       └── main.go
   β”‚   β”œβ”€β”€ internal/
   β”‚   β”‚   β”œβ”€β”€ query/
   β”‚   β”‚   β”‚   β”œ-> graphql_server.go # Unified query interface
   β”‚   β”‚   β”‚   β””-> cache_layer.go    # High-performance caching
   β”‚   β”‚   β”œ-> validation/
   β”‚   β”‚   β”‚   β”œ-> credit_validator.go
   β”‚   β”‚   β”‚   β””-> retirement_checker.go
   β”‚   β”‚   β””-> webhook/
   β”‚   β”‚       β””-> notification.go   # Real-time updates
   β”‚   └── Dockerfile
   └── compliance-adapter/           # Python Service
      β”œβ”€β”€ src/
      β”‚   β”œ-> regulatory/
      β”‚   β”‚   β”œ-> article6_adapter.py # UN Paris Agreement
      β”‚   β”‚   β”œ-> corsia_adapter.py   # Aviation compliance
      β”‚   β”‚   β””-> cbam_adapter.py     # EU Carbon Border Adjustment
      β”‚   β””-> reporting/
      β”‚       β”œ-> ghg_protocol.py
      β”‚       β””-> sbti_reporting.py   # Science Based Targets
      └── requirements.txt

Layer 7: Public Transparency & Impact Dashboard

Open Data & Visualization - The Trust Layer:

  • public-dashboard/: Next.js static site with global project visualization
  • data-availability/: Archiver nodes for permanent data storage on Arweave/IPFS

Key Innovations:

  • 3D globe visualization: Interactive Earth with live project data
  • Live retirement ticker: Real-time display of credit retirements
  • Impact storytelling: Multimedia narratives from project communities
  • Permanent archiving: All data stored on decentralized storage networks

Folder Structure:

   transparency-layer/
   β”œβ”€β”€ public-dashboard/             # Next.js (Static Site)
   β”‚   β”œβ”€β”€ src/
   β”‚   β”‚   β”œ-> app/
   β”‚   β”‚   β”‚   β”œ-> global-map/
   β”‚   β”‚   β”‚   β”œ-> project-explorer/
   β”‚   β”‚   β”‚   β””-> retirement-ledger/
   β”‚   β”‚   β”œ-> components/
   β”‚   β”‚   β”‚   β”œ-> GlobeVisualization.tsx # 3D Earth with projects
   β”‚   β”‚   β”‚   β”œ-> LiveRetirementTicker.tsx
   β”‚   β”‚   β”‚   β””-> ImpactStories.tsx
   β”‚   β”‚   β””-> lib/
   β”‚   β”‚       β”œ-> data/
   β”‚   β”‚       β”‚   β”œ-> aggregatedQueries.ts
   β”‚   β”‚       β”‚   β””-> realtimeStream.ts
   β”‚   β”‚       β””-> visualization/
   β”‚   β”‚           β”œ-> d3-carbon-flow.ts
   β”‚   β”‚           β””-> threejs-globe.ts
   β”‚   └── next.config.js
   └── data-availability/           # Celestia/Arweave + IPFS
      β”œβ”€β”€ archiver-node/           # Go Service
      β”‚   β”œβ”€β”€ cmd/
      β”‚   β”‚   β””-> archiver/
      β”‚   β”‚       β””-> main.go
      β”‚   β”œβ”€β”€ internal/
      β”‚   β”‚   β”œ-> storage/
      β”‚   β”‚   β”‚   β”œ-> arweave_upload.go
      β”‚   β”‚   β”‚   β””-> ipfs_cluster.go
      β”‚   β”‚   β””-> indexing/
      β”‚   β”‚       β”œ-> carbon_graph.go
      β”‚   β”‚       β””-> search_index.go
      β”‚   └── Dockerfile
      └── public-api/              # GraphQL Service
         β”œβ”€β”€ schema/
         β”‚   β”œ-> carbon.graphql
         β”‚   β””-> project.graphql
         └── resolvers/
               β”œ-> queryResolver.js
               β””-> subscriptionResolver.js

πŸš€ Quick Start

Prerequisites

  • Node.js 20+ and npm/yarn/pnpm
  • Rust 1.70+ with Cargo (for Soroban contracts)
  • Go 1.21+
  • Python 3.11+ with geospatial libraries
  • Docker and Docker Compose
  • Stellar Testnet account with 10,000 XLM test tokens

πŸ“– How It Works

For Project Developers (Farmers & NGOs)

  1. Project Onboarding: Submit land details and methodology through portal
  2. Satellite Verification: Automated baseline assessment via satellite data
  3. IoT Deployment: Install sensors for ground truth validation (optional)
  4. Credit Issuance: Verified removals tokenized as Stellar Assets
  5. Market Listing: Credits listed on marketplace with dynamic pricing
  6. Receive Payment: Instant settlement upon credit sale or retirement

For Corporate Buyers

  1. Carbon Inventory: Calculate Scope 1, 2, 3 emissions
  2. Credit Discovery: Browse marketplace with AI recommendations
  3. Due Diligence: Review project details, verification data, co-benefits
  4. Purchase & Retirement: One-click purchase with instant on-chain retirement
  5. Compliance Reporting: Automated generation of ESG and regulatory reports
  6. Impact Communication: Share retirement certificates and impact stories

For Validators & Oracles

  • Stake Tokens: Deposit tokens to participate in verification network
  • Process Data: Analyze satellite imagery or operate IoT devices
  • Submit Proofs: Provide verification data with cryptographic proof
  • Earn Rewards: Receive fees for accurate verification work
  • Risk Slashing: Lose stake for malicious or inaccurate submissions

πŸ’° Economic Model

Fee Structure

  • Issuance Fee: 5% of credit value (covers verification and tokenization)
  • Transaction Fee: 1% of purchase price (marketplace fee)
  • Retirement Fee: 0.5% of credit value (covers certificate generation)
  • Verification Fee: 2% of credit value (distributed to oracle network)

Revenue Distribution

  • 30% to verification oracle network (satellite data, IoT operators, validators)
  • 25% to platform development and maintenance
  • 20% to buffer pool insurance fund
  • 15% to project community development fund
  • 10% to CarbonScribe treasury

CarbonScribe Token (CSC)

  • Total Supply: 1,000,000,000 tokens

  • Distribution:

    • 35% Ecosystem incentives (staking, validation, liquidity)
    • 25% Team & advisors (4-year vesting)
    • 20% Foundation treasury
    • 15% Strategic partners
    • 5% Public sale
  • Token Utility:

    • Governance voting on protocol parameters
    • Fee discounts for token holders
    • Staking for validator roles
    • Access to premium features and data

    🌱 Supported Methodologies

Methodology Type Credit Type Verification Frequency Co-benefits
Agroforestry Removal Quarterly Biodiversity, soil health, farmer income
Improved Forest Management Avoidance/Removal Monthly Watershed protection, habitat conservation
Biochar Removal One-time with monitoring Soil amendment, waste utilization
Mangrove Restoration Removal/Blue Carbon Bi-annual Coastal protection, fisheries enhancement
Soil Carbon Removal Annual with spot checks Water retention, crop yield improvement
Renewable Energy Avoidance Real-time via IoT Energy access, health improvements

πŸ›‘οΈ Security & Integrity

Multi-Layer Verification

  • Satellite Consensus: 3+ independent satellite data sources
  • IoT Ground Truth: Soil sensors and field measurements
  • Community Validation: Local validator network with staked reputation
  • Buffer Pool Protection: 20% reserve for potential reversals
  • Insurance Backstop: Third-party insurance for catastrophic events

Regulatory Compliance

  • Article 6 Ready: Built-in corresponding adjustment tracking
  • CORSIA Eligible: Meets ICAO aviation carbon offset requirements
  • CBAM Compatible: EU Carbon Border Adjustment Mechanism integration
  • CSRD Reporting: Automated EU Corporate Sustainability Reporting
  • GHG Protocol: Aligned with global accounting standards

Transparency Guarantees

  • All data public: Satellite imagery, verification reports, transactions
  • Real-time tracking: Live dashboard of all credit issuances and retirements
  • Open source: Core contracts and verification algorithms publicly auditable
  • Decentralized storage: Critical data archived on Arweave/IPFS

πŸ“Š Impact Metrics

Environmental Impact

  • Carbon Removed: Target 100M tonnes COβ‚‚e by 2030
  • Biodiversity: >30% of projects with verified co-benefits
  • Deforestation Prevention: Real-time alerts protecting 1M+ hectares
  • Community Benefits: 60% revenue share to local communities

Market Efficiency

  • Verification Speed: 90% reduction vs. traditional processes (days vs. months)
  • Transaction Cost: 80% reduction in intermediary fees
  • Liquidity: 24/7 global trading with transparent pricing
  • Accessibility: 10x more small projects able to participate

Technology Performance

  • Satellite Refresh: Every 5 days (Sentinel-2)
  • Verification Confidence: >95% accuracy via multi-source consensus
  • Transaction Finality: <5 seconds on Stellar network
  • System Uptime: 99.9% target with decentralized architecture

🀝 Partnerships & Integrations

Registry Partnerships

  • Verra: Bridge for VCU tokenization
  • Gold Standard: GS-certified project integration
  • American Carbon Registry: US-focused methodologies
  • UNFCCC: Article 6 corresponding adjustment tracking

Technology Partners

  • Planet Labs: Daily satellite imagery
  • Sentinel Hub: Earth observation data processing
  • Arweave: Permanent data storage
  • Chainlink: Oracle services for external data

Implementation Partners

  • World Bank: FCPF program integration
  • UN-REDD: Forest conservation projects
  • Conservation International: Biodiversity-focused methodologies
  • Farmers' Organizations: Local implementation networks

πŸ—ΊοΈ Development Roadmap

Phase 1: Foundation & MVP (Q3-Q4 2024) βœ… COMPLETED

Status: Core infrastructure implemented, Farmer Portal Live

βœ… Completed Components:

  • Project Portal Frontend (Layer 3): Complete farmer dashboard with:
    • Project management system (CRUD operations, filtering, search)
    • Real-time monitoring dashboard (satellite insights, alerts)
    • Financing module (credit tokenization status, revenue tracking)
    • Team management interface
    • Document management system
    • Settings & configuration panel
  • UI/UX Foundation:
    • Design system with Tailwind CSS v4
    • Responsive layouts (mobile-first approach)
    • Component library with consistent patterns
    • Custom animations and transitions
  • Frontend Architecture:
    • Next.js 15 App Router implementation
    • TypeScript with full type safety
    • Context API for state management
    • Modular component architecture

🎯 Current Status:

Farmer-facing portal is fully operational with mock data. Ready for backend integration and blockchain connectivity.


Phase 2: Backend Integration & Blockchain Layer (Q1 2025)

Focus: Connect frontend to Stellar blockchain and backend services

πŸ”„ In Progress / Next Steps:

  1. Stellar Integration (Layer 1)

    • Stellar SDK integration for wallet connectivity
    • Soroban smart contract interactions
    • C-01 Token Standard implementation
    • Carbon asset minting and transfer functions
    • On-chain retirement verification
  2. Backend Services (Layer 3 Backend - Go)

    • Project onboarding API endpoints
    • Document management with IPFS integration
    • Credit tokenization workflow
    • Farmer authentication and authorization
    • Real-time data synchronization
  3. Satellite Data Integration (Layer 2)

    • Sentinel-2 API integration
    • NDVI calculation service
    • Real-time vegetation monitoring
    • Automated alert system

πŸ“Š Milestones:

  • M1.1: Connect to Stellar testnet, mint test carbon credits
  • M1.2: Implement project CRUD with Go backend
  • M1.3: Integrate satellite data feeds
  • M1.4: Deploy to Staging environment

Phase 3: Corporate Platform & Marketplace (Q2 2025)

Focus: Build corporate buyer interface and marketplace functionality

🎯 Planned Components:

  1. Corporate Platform (Layer 4)

    • Corporate dashboard for credit purchasing
    • One-click retirement interface
    • ESG reporting automation
    • Portfolio management tools
    • Compliance document generation
  2. Marketplace Engine

    • Credit discovery and search
    • Dutch auction mechanism
    • Real-time price discovery
    • Credit recommendation AI
    • Corporate onboarding flow
  3. Advanced Features

    • Forward sale agreements
    • Credit bundling options
    • API access for enterprise integration
    • Bulk purchasing interface

πŸ“Š Milestones:

  • M2.1: Corporate platform MVP launch
  • M2.2: First corporate pilot programs
  • M2.3: Marketplace with basic auction functionality
  • M2.4: Integration with major registries (Verra bridge)

Phase 4: Financialization & Advanced Features (Q3 2025)

Focus: Implement financial instruments and cross-chain capabilities

🎯 Planned Components:

  1. Financialization Engine (Layer 5)

    • Carbon credit futures contracts
    • Options trading platform
    • Project financing mechanisms
    • Credit scoring algorithms
    • Insurance pool implementation
  2. Cross-Chain Integration

    • Verra registry bridge (soroban/)
    • Gold Standard bridge
    • Polygon/Ethereum DeFi integration
    • IBC/CCIP implementation
  3. Dynamic Carbon Credits

    • Real-time value adjustment algorithms
    • Environmental condition tracking
    • Automated buffer pool adjustments
    • Risk assessment models

πŸ“Š Milestones:

  • M3.1: Launch carbon derivatives platform
  • M3.2: Cross-chain bridge to Verra
  • M3.3: Dynamic credit valuation v1
  • M3.4: Institutional investor onboarding

Phase 5: Global Registry & Scale (Q4 2025)

Focus: Deploy global registry and achieve enterprise scale

🎯 Planned Components:

  1. Global Registry (Layer 6)

    • Registry-of-registries smart contract
    • Unified credit ID system
    • Global double counting prevention
    • High-performance API gateway
    • Regulatory adapter framework
  2. Enterprise Features

    • Multi-tenant architecture
    • SSO and enterprise auth
    • Advanced reporting suite
    • Audit trail system
    • SLA guarantees
  3. Public Transparency (Layer 7)

    • Global impact dashboard
    • Real-time retirement ticker
    • 3D globe visualization
    • Data availability layer
    • Public API access

πŸ“Š Milestones:

  • M4.1: Global registry mainnet launch
  • M4.2: Enterprise customer deployment
  • M4.3: Public transparency dashboard
  • M4.4: 100+ projects onboarded

Phase 6: Ecosystem Expansion & AI Integration (2026)

Focus: Expand methodology coverage and integrate advanced AI

🎯 Planned Components:

  1. 2026 Twist: Dynamic Carbon Credits

    • Real-time satellite value updates
    • Forest growth tracking algorithms
    • Drought condition impact modeling
    • Automated risk adjustment
    • Predictive analytics for credit valuation
  2. AI & Machine Learning

    • AI-powered project verification
    • Predictive deforestation alerts
    • Automated methodology matching
    • Credit price forecasting
    • Anomaly detection systems
  3. Ecosystem Expansion

    • Blue carbon methodologies
    • Urban carbon projects
    • Industrial carbon capture
    • Carbon removal technologies
    • Biodiversity credit integration
  4. Mobile & Field Applications

    • Offline-first mobile apps
    • Drone data integration
    • Field sensor networks
    • Community validation tools
    • Local language support

πŸ“Š Milestones:

  • M5.1: Dynamic carbon credits live on mainnet
  • M5.2: AI verification system deployment
  • M5.3: Mobile app launch for field teams
  • M5.4: 1,000+ projects across 50+ countries

Phase 7: Global Impact & Decentralization (2027+)

Focus: Achieve platform decentralization and global scale impact

🎯 Long-term Vision:

  1. Full Decentralization

    • DAO governance implementation
    • Validator network expansion
    • Protocol-owned liquidity
    • Community-driven development
    • Open source ecosystem
  2. Global Standards

    • ISO certification for methodologies
    • UNFCCC recognition
    • Industry standard adoption
    • Regulatory framework contributions
    • Academic research partnerships
  3. Impact Targets

    • 1 billion tonnes COβ‚‚e tokenized
    • $10B+ in project financing
    • 10,000+ projects globally
    • 1M+ hectares protected
    • 500K+ livelihoods improved
  4. Technology Evolution

    • Quantum-resistant cryptography
    • Advanced satellite constellations
    • IoT sensor networks expansion
    • Interplanetary file system integration
    • Carbon metaverse integration

πŸ“Š Ultimate Goals:

  • Vision: Become the global standard for transparent carbon markets
  • Mission: Make high-quality carbon credits accessible to all projects
  • Impact: Significant contribution to global climate goals
  • Innovation: Continuous advancement in environmental fintech

πŸ”„ Current Development Status

βœ… Completed (Phase 1)

  • Farmer Portal Frontend: 100%
  • UI/UX Design System: 100%
  • Component Library: 100%
  • Mock Data Integration: 100%
  • Responsive Design: 100%

πŸ”„ In Progress (Phase 2)

  • Stellar Integration: 0%
  • Backend API Development: 0%
  • Satellite Data Integration: 0%
  • Authentication System: 0%

πŸ“… Upcoming (Phase 2-3)

  • Corporate Platform: 0%
  • Marketplace Engine: 0%
  • Financialization Features: 0%
  • Cross-Chain Bridges: 0%

πŸ“Š Overall Progress: 10%

Based on completed frontend vs. full 7-layer architecture implementation


🎯 Key Technical Milestones Timeline

timeline
    title CarbonScribe Development Timeline
    section 2026
        January : Project Portal MVP<br>Farmer Dashboard Live
        February : Stellar Integration<br>Backend APIs
        March : Corporate Platform<br>Marketplace v1
        April : Financialization Engine<br>Cross-chain Bridges
        May : Global Registry<br>Enterprise Features
        June : Public Dashboard<br>Scale Launch
        July : Dynamic Credits<br>AI Verification
        August : Mobile Apps<br>Field Tools Deployment
    section 2026 Q3-Q4
        September : Methodology Expansion
        October : DAO Transition Begins
        November : Ecosystem Partnerships
        December : 2026 Vision Complete
    section 2027+
        Early 2027 : Full Decentralization
        Mid 2027 : Global Standard Adoption
        Late 2027 : Impact Scale Targets
Loading

CarbonScribe: Making every ton of carbon count. Transparent, verifiable, and accessible to all.

About

CarbonScribe is a full-stack Stellar platform that tokenizes ecosystem services into Dynamic Carbon Credits. Built with Next.js, Nest.js, and Soroban smart contracts, it allows corporations to purchase and instantly retire credits with real-time pricing based on live satellite and IoT verification data.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 58.8%
  • Go 30.0%
  • Rust 9.8%
  • PLpgSQL 0.6%
  • CSS 0.4%
  • Makefile 0.3%
  • JavaScript 0.1%