Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

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

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /