GreenLedger

GreenLedger is a climate investment intelligence platform for discovering verified sustainability projects, tracking real-world environmental impact, and managing tokenized carbon rewards through a transparent portfolio experience.

Live app: https://greenledger-beige.vercel.app

Overview

GreenLedger combines climate finance discovery, due diligence, and impact tracking in one product. Investors can explore verified projects, review risk and proof signals, simulate new allocations, invest through a wallet-connected flow, and trade GreenCredit Tokens (GCT) in an integrated exchange experience.

Key Features

• Verified climate project marketplace with funding progress, yield projections, and location-based discovery
• Intelligence workspace with due diligence scores, fraud-risk signals, verification alerts, and scenario forecasting
• Portfolio impact dashboard for CO2 offset, water saved, homes powered, and token rewards
• Wallet connection with MetaMask support and preview wallet fallback for guided product exploration
• Integrated GCT exchange for buy and sell flows with live balance updates
• Durable hosted persistence using Upstash Redis on Vercel

Tech Stack

• Frontend: React 19, Vite
• Styling: Custom CSS
• Backend: Node.js, Express 5
• Storage: Upstash Redis
• Deployment: Vercel
• Tooling: ESLint, npm workspaces, concurrently

Product Sections

Insights Hub

Central decision layer for understanding project quality, fraud risk, verifier activity, and projected portfolio outcomes.

Marketplace

Search and filter climate projects across energy, nature, water, and infrastructure categories with embedded diligence context.

Portfolio Impact

Track deployed capital, GCT rewards, and measurable environmental outcomes in a single dashboard.

Token Exchange

Buy and sell GreenCredit Tokens using the integrated exchange interface and live wallet updates.

Project Structure

GreenLedger/
├── api/                  # Vercel serverless API entry
├── client/               # React + Vite frontend
├── lib/                  # Shared core logic and persistence helpers
├── server/               # Local Express development API
├── data/                 # Local persisted state for development
├── package.json          # Workspace scripts
└── vercel.json           # Vercel build and routing config

Local Development

Prerequisites

• Node.js 18+
• npm

Install

npm install

Run locally

npm run dev

Frontend runs on http://localhost:5173.

Build

npm run build

Lint

npm run lint

Environment Variables

For durable hosted persistence, configure one of these supported Redis REST credential pairs:

• UPSTASH_REDIS_REST_URL
• UPSTASH_REDIS_REST_TOKEN

or

• KV_REST_API_URL
• KV_REST_API_TOKEN

For local development, the app can also fall back to file-based persistence.

API Endpoints

• GET /api/health
• GET /api/state
• POST /api/invest
• POST /api/trade
• POST /api/reset

Deployment

The project is configured for Vercel deployment with a Vite frontend and serverless API routes. Production persistence is powered by Upstash Redis.

Vision

GreenLedger is designed to make climate investing more transparent, data-backed, and engaging by connecting capital deployment, project verification, and measurable impact in one unified platform.