Skip to content

Repository files navigation

AetherCycle Protocol

⚠️ ORIGINAL IMPLEMENTATION ⚠️

This is the ORIGINAL AetherCycle Protocol implementation by Fukuhi (@aethercycle). Any fork must prominently display "Forked from AetherCycle Protocol by Fukuhi" and maintain proper attribution.


The first mathematically sustainable DeFi protocol with proven infinite operation through autonomous smart contracts.

🚀 Overview

AetherCycle implements Autonomous Finance (AutonoFi) - replacing human promises with mathematical certainty. Once deployed, the protocol operates forever without any human intervention.

Key Features:

  • 99% community ownership
  • Mathematical proof of infinite operation
  • No admin keys, no upgrades, truly immutable
  • Self-sustaining through Perpetual Endowment system

📊 Core Stats

  • Total Supply: 888,888,888 AEC
  • Smart Contracts: 15+ production contracts
  • Test Coverage: 600+ comprehensive tests
  • Security: AGPL-3.0 license with attribution protection

🏗️ Architecture

AetherCycle Protocol - Autonomous Finance (AutonoFi)

├── 🏛️ Core Layer (Foundation)
│ ├── AECToken - Native token with Tolerant Fortress tax system
│ ├── PerpetualEngine - Autonomous reward distributor & cycle manager
│ └── PerpetualEndowment - Mathematical sustainability fund (35% of supply)
├── 🎯 Staking Layer (Rewards)
│ ├── AECStakingLP - Liquidity provider rewards with tier system
│ ├── AECStakingToken - Token holder staking with decay mechanism
│ └── AECStakingNFT - NFT staking (500 max supply, bonus rewards)
├── 🚀 Distribution Layer (Genesis)
│ ├── TokenDistributor - Genesis distribution & allocation manager
│ ├── FairLaunch - Public sale mechanism with price discovery
│ └── LiquidityDeployer - Initial liquidity deployment & LP staking
├── 🌟 Community Layer (Engagement)
│ ├── ContributorPoints - Reputation system with CP tokens
│ ├── FairAirdrop - CP-based distribution mechanism
│ └── AECGambit - Lottery system with dynamic allocation
├── 🎨 NFT Layer (Digital Assets)
│ └── AetheriaNFT - Protocol NFTs with staking benefits
├── ⏰ Vesting Layer (Governance)
│ └── FounderVesting - 5-year cliff vesting for founder allocation
└── 🏛️ DAO Layer (Governance)
└── AccountabilityDAO - Community governance & founder oversight

Key Innovations:

  • Perpetual Endowment System - Mathematical proof of infinite operation
  • Tolerant Fortress Tax - Three-tier tax system protecting ecosystem
  • Autonomous Finance - No admin keys, truly immutable contracts
  • Community-First - 99% community ownership, 1% founder (5yr cliff)

💰 Tokenomics

AllocationAmountPercentage
Perpetual Endowment311,111,11135%
Ecosystem Rewards355,555,55540%
Contributor Airdrop71,111,1118%
Fair Launch62,222,2227%
Initial Liquidity53,333,3336%
Security Bounty17,777,7772%
Lottery/Gambit8,888,8891%
Founder (5yr cliff)8,888,8881%

🔧 Quick Start

# Clone repository
git clone https://github.com/aethercycle/aethercycle-protocol.git
cd aethercycle-protocol
# Install dependencies
npm install
# Compile contracts
npx hardhat compile
# Run tests
npx hardhat test# Deploy (configure .env first)
npx hardhat run scripts/deployment/deploy-mainnet.js --network base

🧪 Testing

Comprehensive Test Suite (600+ tests):

# All tests (600+ comprehensive tests)
npx hardhat test# Specific test categories
npx hardhat test test/unit/ # Contract-specific unit tests
npx hardhat test test/integration/ # Multi-contract integration tests
npx hardhat test test/edge/ # Edge case & security tests# Test coverage analysis
npx hardhat coverage # Generate coverage report

Test Categories:

  • Unit Tests - Individual contract functionality
  • Integration Tests - Multi-contract interactions
  • Edge Case Tests - Security & boundary conditions
  • Gas Optimization Tests - Efficiency validation
  • Security Tests - Vulnerability assessment

Coverage Areas:

  • ✅ Core token mechanics & tax system
  • ✅ Staking rewards & decay mechanisms
  • ✅ Distribution & allocation logic
  • ✅ Community governance & DAO functions
  • ✅ NFT staking & bonus systems
  • ✅ Vesting & founder oversight
  • ✅ Lottery & gambling mechanics

📁 Project Structure

contracts/
├── core/ # Foundation contracts (AECToken, PerpetualEngine, Endowment)
├── staking/ # Reward mechanisms (LP, Token, NFT staking)
├── distribution/ # Token distribution (FairLaunch, LiquidityDeployer)
├── airdrop/ # Community distribution (ContributorPoints, FairAirdrop)
├── lottery/ # Gambit system (AECGambit)
├── nft/ # Digital assets (AetheriaNFT)
├── vesting/ # Governance (FounderVesting)
├── dao/ # Community governance (AccountabilityDAO)
├── interfaces/ # Contract interfaces
└── mocks/ # Testing mocks
test/
├── unit/ # Contract-specific tests
├── integration/ # Multi-contract tests
└── edge/ # Edge case & security tests

🔗 Documentation

  • Whitepaper: AetherCycle Whitepaper v2.0
  • Technical Docs: See contract comments and /docs
  • Website: aethercycle.xyz

📄 License

AGPL-3.0 License

Built by @aethercycle

Releases

Packages

Contributors

Languages