Skip to content

README.md

Latest commit

 

History

History
133 lines (96 loc) · 4.09 KB

README.md

File metadata and controls

133 lines (96 loc) · 4.09 KB

CurrentDao-contracts

Smart contracts for the CurrentDao solar energy ecosystem on Stellar/Soroban.

Overview

This project contains comprehensive smart contracts for energy trading:

  1. Energy Token ($WATT) - A custom token representing 1kWh of energy
  2. Energy Trading Escrow - Secure escrow system for energy trades with dispute resolution
  3. DAO Contract - Allows members to vote on where to build new solar arrays
  4. Security & Access Control - Comprehensive security framework
  5. Fee Management - Dynamic fee system for network operations
  6. Emergency Systems - Emergency response and recovery mechanisms

🚀 New Feature: Energy Trading Escrow System

We've implemented a comprehensive Energy Trading Escrow System that provides:

Key Features

  • Multi-party Escrow: Buyer, seller, and mediator roles
  • Time-based Auto-release: Automatic token release after 48 hours
  • Dispute Resolution: Admin arbitration with penalty system
  • Milestone Trading: Partial releases for milestone-based deliveries
  • Emergency Recovery: Multi-signature emergency release mechanisms
  • Comprehensive Audit Trail: Complete transaction history tracking
  • Security Protection: Reentrancy guards, rate limiting, input validation
  • Gas Optimization: Efficient batch operations

Quick Start

# Deploy the escrow system
npm run deploy:escrow development

# Run tests
npm run test:escrow

# View documentation
cat docs/escrow/EnergyEscrow.md

Project Structure

CurrentDao-contracts/
├── Cargo.toml                    # Workspace configuration
├── contracts/
│   ├── token/                    # Energy Token ($WATT) contract
│   │   ├── Cargo.toml
│   │   └── src/
│   │       └── lib.rs
│   ├── escrow/                   # Escrow contract
│   │   ├── Cargo.toml
│   │   └── src/
│   │       └── lib.rs
│   └── dao/                      # DAO contract
│       ├── Cargo.toml
│       └── src/
│           └── lib.rs
└── README.md

Prerequisites

  • Rust (1.70 or later)
  • Soroban CLI (cargo install stellar-soroban-cli)

Building

To build all contracts:

cargo build --target wasm32-unknown-unknown --release

The compiled WASM files are in:

  • target/wasm32-unknown-unknown/release/energy_token.wasm
  • target/wasm32-unknown-unknown/release/escrow_contract.wasm
  • target/wasm32-unknown-unknown/release/dao_contract.wasm

Contract Details

Energy Token ($WATT)

The Energy Token represents 1kWh of energy and is used to track energy contributions from solar panel installations.

Functions:

  • initialize(admin, decimals, name, symbol) - Initialize the token
  • mint(to, amount) - Mint new tokens
  • transfer(from, to, amount) - Transfer tokens
  • balance(addr) - Get token balance
  • set_admin(new_admin) - Set admin
  • burn(from, amount) - Burn tokens

Escrow Contract

The Escrow contract holds payments from contributors until the smart meter confirms energy delivery.

Functions:

  • initialize(admin) - Initialize escrow
  • create_escrow(sender, recipient, amount) - Create new escrow
  • confirm_delivery(escrow_id) - Confirm delivery, release funds
  • cancel_escrow(escrow_id) - Cancel escrow
  • get_escrow(escrow_id) - Get escrow details

DAO Contract

The DAO allows members to propose and vote on where to build new solar arrays.

Functions:

  • initialize(admin, token_address) - Initialize DAO
  • create_proposal(proposer, location, description, amount) - Create proposal
  • vote(voter, proposal_id, support) - Vote on proposal
  • finalize(proposal_id) - Finalize proposal
  • get_proposal(id) - Get proposal details

Usage

Deploying Contracts

  1. Deploy the Energy Token contract first
  2. Deploy the Escrow contract
  3. Deploy the DAO contract with the token address

Contributor Flow

  1. Contributors receive $WATT tokens (representing their energy contribution)
  2. DAO members vote on proposals for new solar installations
  3. Escrow ensures payments are held until energy delivery is confirmed