Skip to content

aethercycle/aethercycle-protocol

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

Allocation Amount Percentage
Perpetual Endowment 311,111,111 35%
Ecosystem Rewards 355,555,555 40%
Contributor Airdrop 71,111,111 8%
Fair Launch 62,222,222 7%
Initial Liquidity 53,333,333 6%
Security Bounty 17,777,777 2%
Lottery/Gambit 8,888,889 1%
Founder (5yr cliff) 8,888,888 1%

πŸ”§ 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