Skip to content

BuenDia-Builders/be-energy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

323 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

BeEnergy

Renewable energy cooperatives deserve proof. BeEnergy puts it on-chain.

Live Demo Network License


๐Ÿ† Recognition

Award Event
๐Ÿฅ‡ Featured Project Stellar Buenos Aires Hackathon 2025
๐Ÿ… Innovation Certificate Stellar Jury โ€” Buenos Aires 2025
๐ŸŒ Selected ClimateLaunchpad 2026 โ€” world's largest green startup competition, powered by Climate-KIC & Chrysalis LEAP

The Problem

Renewable energy cooperatives generate clean energy every day โ€” but they can't prove it.

  • No standardized way to record generation
  • No verifiable certificate that travels with the energy claim
  • No access to ESG markets, carbon offsetting programs, or institutional buyers
  • Manual, paper-based processes that nobody trusts

Meanwhile, companies and funds with ESG commitments are actively looking for verifiable renewable energy claims โ€” and can't find them.

The gap between cooperatives and buyers is a trust gap. BeEnergy closes it.


The Solution

BeEnergy is a cooperative management dashboard + on-chain certification infrastructure on Stellar.

Every kWh registered by a cooperative becomes a proto-certificate: a verifiable, on-chain claim tied to a real meter, a real cooperative, and a real time period.

Smart meter sends reading โ†’ POST /api/meters/readings
         โ†“
BeEnergy validates & mints token on Stellar (1 token = 1 kWh)
         โ†“
Certificate is assigned to cooperative members
         โ†“
External buyer (company / ESG fund) purchases certificate
         โ†“
Buyer retires certificate on-chain (verifiable burn)
         โ†“
Permanent, auditable proof on Stellar blockchain

No intermediaries. No PDFs. No trust required โ€” the chain is the proof.


How It Works โ€” Full Platform Flow

For Cooperatives

1. Register cooperative on BeEnergy
2. Add smart meters (physical IoT devices)
3. Meters send generation readings automatically via API
4. BeEnergy mints proto-certificates on Stellar
5. Manage members, view generation stats, track certificates

For Buyers

1. Browse available certificates by cooperative / technology / period
2. Purchase certificates (linked to specific on-chain tokens)
3. Retire certificate โ†’ recorded permanently on Stellar
4. Receive auditable proof of renewable energy support

Authentication

BeEnergy supports two access methods โ€” no setup required to try:

Email + Password (for admins, buyers, internal team)

/login โ†’ Supabase auth โ†’ JWT issued โ†’ Stellar wallet auto-assigned โ†’ /dashboard

Try it: demo@beenergy.coop / Demo2026!

Stellar Wallet (for cooperatives with Freighter / xBull / Lobstr)

Connect wallet โ†’ Server issues challenge โ†’ User signs with private key
โ†’ Signature verified on-chain โ†’ JWT issued โ†’ /dashboard

Both methods issue the same JWT and give full platform access. Wallet users can additionally sign on-chain transactions.


Stellar Integration โ€” What's Actually On-Chain

This is not a wrapper. Stellar is load-bearing infrastructure:

What How
Certificate issuance Mint SEP-41 tokens directly on Stellar Testnet
Certificate retirement On-chain burn, permanently auditable
Member allocation energy_distribution contract splits tokens by participation %
Governance community_governance contract for cooperative proposals
Wallet auth Challenge-response signature verification (no gas, no tx)
Token standard SEP-41 (fungible) with OpenZeppelin Stellar Pausable + Upgradeable

Deployed Contracts โ€” Stellar Testnet

Contract Address Purpose
energy_token CCYOVOFD...MRPBA6 SEP-41 token โ€” 1 token = 1 kWh certified
energy_distribution CBTDPLFN...NX2UDZ Distributes certificates to members
community_governance CCH2EXXN...BJD6YI Cooperative on-chain governance

Built with OpenZeppelin Stellar Contracts v0.5.1 + Soroban SDK 23.1.0 โ€” 65 tests passing.


Customer Discovery

We validated the problem directly with:

  • Energy cooperatives in Argentina โ€” confirmed the pain of not being able to sell renewable attributes
  • ESG compliance teams โ€” confirmed demand for verifiable, auditable certificates
  • Climate program coordinators โ€” confirmed interest in blockchain-based proof over PDFs

Key insight: the bottleneck isn't production โ€” cooperatives generate plenty. The bottleneck is verifiable proof. BeEnergy solves exactly that.


Live Demo

Platform: https://be-energy-six.vercel.app Network: Stellar Testnet Demo login: demo@beenergy.coop / Demo2026!

Watch Demo Video โ†’


Tech Stack

Layer Technology
Blockchain Stellar Testnet (Soroban smart contracts)
Smart Contracts Rust + OpenZeppelin Stellar v0.5.1
Token Standard SEP-41 fungible token
Frontend Next.js 16 + React 19 + TypeScript
Styling Tailwind CSS v4 + shadcn/ui
Auth Supabase + JWT + Stellar wallet signature
Wallet Support Freighter, xBull, Lobstr (via Stellar Wallets Kit)
Backend Next.js API Routes + Supabase
Deployment Vercel
Monorepo Turborepo + pnpm

Monorepo Structure

be-energy/
โ”œโ”€โ”€ apps/
โ”‚   โ”œโ”€โ”€ contracts/           # Soroban smart contracts (Rust)
โ”‚   โ”‚   โ”œโ”€โ”€ energy_token/         # SEP-41 certificate token
โ”‚   โ”‚   โ”œโ”€โ”€ energy_distribution/  # Member allocation logic
โ”‚   โ”‚   โ””โ”€โ”€ community_governance/ # DAO-style proposals
โ”‚   โ””โ”€โ”€ web/                 # Next.js dashboard
โ”‚       โ”œโ”€โ”€ app/             # App Router pages
โ”‚       โ”œโ”€โ”€ components/      # UI components
โ”‚       โ””โ”€โ”€ lib/             # Auth, wallet, Stellar utils
โ”œโ”€โ”€ packages/
โ”‚   โ””โ”€โ”€ stellar/             # Shared wallet & config utilities
โ””โ”€โ”€ tooling/
    โ””โ”€โ”€ issues/              # GitHub issue templates

Quick Start

git clone https://github.com/BuenDia-Builders/be-energy.git
cd be-energy
pnpm install
pnpm dev

Frontend: http://localhost:3000

Build & test contracts:

cd apps/contracts
stellar contract build
cargo test

Roadmap

Level What Status
1 โ€” Internal registry Token = verifiable production record โœ… Live on Testnet
2 โ€” Verified certification IoT oracles + independent meter validation ๐Ÿ”„ Next
3 โ€” Recognized standard Integration with I-REC, Energy Web, TIGR ๐Ÿ”ฎ Future

Planned Stellar Ecosystem Integrations

BeEnergy is designed to plug into Stellar's growing DeFi and payments ecosystem. Planned integrations from the SCF Integration Track:

Integration What it unlocks for BeEnergy
DeFindex Cooperatives earn yield on certificate proceeds held in vaults โ€” idle capital works while certificates wait for buyers
Blend Protocol Use certificates as collateral for credit lines โ€” cooperatives access working capital without selling
Soroswap AMM liquidity pool for certificate tokens โ€” enables price discovery and secondary market for renewable attributes
USDC (Circle) Stablecoin payments for certificate purchases โ€” buyers pay in USDC, cooperatives receive USDC, no FX volatility
Aquarius Liquidity incentives for BETOKEN/USDC pairs โ€” bootstraps the certificate secondary market
Fiat On/Off Ramp (SEP-24) Cooperatives receive payments in local fiat (ARS, COP, BRL) via Stellar anchors โ€” no crypto knowledge required
Stellar Turrets / smart oracles Automated certificate minting triggered by verified IoT meter readings โ€” removes manual intervention

These integrations are load-bearing features on the product roadmap, not checkbox items. DeFindex is the most immediate โ€” partial integration already exists in the codebase.


Contributing

PRs welcome. Branch to develop, keep commits focused.

git checkout develop
git checkout -b feat/your-feature
pnpm install && pnpm dev
# Open PR to develop

License

Apache-2.0 โ€” See LICENSE


Built on Stellar ยท BuenDia Builders 2026

About

Decentralized energy management platform built on Stellar/Soroban

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors