🌌 Aetheron Platform

@MastaTrill

🌌 Aetheron Platform

Revolutionary Blockchain & Space Exploration Ecosystem

Codename: Aetheron L3 Sentinel

Deployed Contracts

Polygon Mumbai Testnet (Chain ID: 80001)

AETH Token: 0x44F9c15816bCe5d6691448F60DAD50355ABa40b5
- View on PolygonScan: AETH Token on PolygonScan
Staking Contract: 0x896D9d37A67B0bBf81dde0005975DA7850FFa638
- View on PolygonScan: Staking Contract on PolygonScan

Polygon Mainnet (Chain ID: 137)

AETH Token: 0xAb5ae0D8f569d7c2B27574319b864a5bA6F9671e
- View on PolygonScan: AETH Token on PolygonScan
Staking Contract: 0x896D9d37A67B0bBf81dde0005975DA7850FFa638
- View on PolygonScan: Staking Contract on PolygonScan
Liquidity Pair: 0xd57c5E33ebDC1b565F99d06809debbf86142705D
- View on PolygonScan: Liquidity Pair on PolygonScan

Solana (if applicable for cross-chain or future features)

Solana Mint/Wallet/Program: 5fryQ4UPbZWKix8J3jtQhNTDXtSsoX24vyDQ8gQbFqki
- View on Solscan: Solana Account on Solscan

🚀 Live Demo

🌐 Admin Dashboard: https://mastatrill.github.io/Aetheron_platform
📱 Mobile App: Coming soon to App Store & Google Play
📖 Documentation: Complete guides and API reference
🔗 GitHub Repository: github.com/Mastatrill/aetheron-platform

🎯 Features

🎯 Mission Control — Participate in space exploration missions
💰 AETH Token — Native cryptocurrency with staking rewards
📱 Mobile App — iOS/Android cross‑platform application
🌐 Web Dashboard — Comprehensive admin and user interface
⛓️ Smart Contracts — Secure blockchain infrastructure
🔭 Discovery System — Real‑time space exploration tracking
⚡ Sentinel L3 Baseline — Target throughput benchmark: 10,000 TPS

🚄 Sovereign Baseline

Sentinel benchmark target: 10,000 TPS
Baseline contracts: Sentinel2.sol and AetheronRetainerVault.sol

🔄 Recent Updates (v2.0.0)

✅ Security Enhancement: Removed .env from Git history for credential protection
✅ CI/CD Improvements: Updated CircleCI config to v2.1 standards
✅ Smart Contract Testing: 35/39 tests passing with gas optimization
✅ Deployment Ready: Auto-deployment to GitHub Pages and Vercel
✅ Code Quality: Clean codebase with proper ignores and structure

💰 Tokenomics

AETH Token Specifications

Symbol: AETH
Name: Aetheron
Total Supply: 1,000,000,000 AETH
Network: Polygon Mainnet
Contract: 0xAb5ae0D8f569d7c2B27574319b864a5bA6F9671e

Tax Structure

Buy Tax: 5%
Sell Tax: 5% (reflected in buy tax for simplicity)
Tax Distribution:
- 3% - Liquidity Pool
- 2% - Marketing & Development

Security Features

Blacklist: Yes - Malicious addresses can be blacklisted
Max Transaction: 1% of total supply per transaction
Max Wallet: 2% of total supply per wallet
Anti-Whale Protection: Enabled

🛠️ Technology Stack

Frontend

React Native (Mobile)
React.js / Next.js (Web)
TypeScript
CSS3 / SCSS

Backend

Node.js / Express.js
MongoDB / PostgreSQL
JWT Authentication
WebSocket (Real‑time)

Blockchain

Solidity Smart Contracts
Hardhat Development Framework
Polygon / Ethereum Networks
Web3.js Integration

DevOps

Docker Containerization
Kubernetes Orchestration
GitHub Actions CI/CD
Terraform Infrastructure

📁 Project Structure

aetheron-platform/ ├── admin-dashboard/ # Web admin interface ├── mobile-app/ # React Native mobile app ├── backend-api/ # Node.js API server ├── smart-contracts/ # Solidity blockchain contracts ├── web-frontend/ # React web application ├── documentation/ # Project documentation ├── assets/ # Media and design files ├── deployment/ # Infrastructure configurations ├── testing/ # Test suites └── tools/ # Development utilities

🔐 Verification

GitHub Owner: @Mastatrill
Keeper’s Lantern Wallet: 0x127C3a5A0922A0A952aDE71412E2DC651Aa7AF82

Proof‑of‑Record Constellation

Herald’s Seal — Tx Hash: 0xb397…c82c94
Steward’s Seal — Tx Hash: 0x8a3a…c3452 (Dec‑16‑2025 09:27:45 AM UTC)
Lantern Seal — Wallet: 0x127C…AF82
Constellation Seal — Tx Hash: 0x428e…Be3E

✨ Four Seals, One Constellation — Eternal Proof.

🗺️ Roadmap

✅ Platform structure created
✅ Smart contracts drafted (ERC20 upgradeable)
🔄 Source code verification on BaseScan/Etherscan
🔄 Security audit (third‑party)
🔜 Mobile app release (App Store & Google Play)
🔜 Exchange listings for AETH token
🌌 Expansion into live mission tracking

🤝 Contributing We welcome contributions!

Fork the repository
Create your feature branch (git checkout -b feature/YourFeature)
Commit changes (git commit -m 'Add new feature')
Push to branch (git push origin feature/YourFeature)
Open a Pull Request

📄 License This project is licensed under the MIT License — see the LICENSE file for details.

🚀 Production Deployment Checklist

Before deploying Aetheron smart contracts to production, follow this comprehensive checklist to ensure a smooth and error-free deployment.

Prerequisites

Environment Setup
- Node.js (v16 or higher) installed
- npm or yarn installed
- Git installed and configured
Required Accounts & Keys
- Metamask or hardware wallet with private key
- Polygon RPC endpoint (from Alchemy, Infura, or QuickNode)
- PolygonScan API key (for contract verification)
- Sufficient POL in deployer wallet (minimum 0.5 POL recommended)

Step-by-Step Deployment Guide

1. Setup Environment Variables

cd smart-contract
cp .env.example .env

Edit .env file and configure the following required variables:

# REQUIRED: Your wallet's private key (must start with 0x)
PRIVATE_KEY=0x...

# REQUIRED: Polygon RPC URL (get from Alchemy, Infura, etc.)
POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/YOUR_API_KEY

# REQUIRED: Team wallet address (receives 20% of tokens)
TEAM_WALLET=0x...

# REQUIRED: Marketing wallet address (receives 15% of tokens)
MARKETING_WALLET=0x...

# OPTIONAL: For contract verification on PolygonScan
POLYGONSCAN_API_KEY=your_api_key_here

⚠️ CRITICAL ERRORS TO AVOID:

❌ Private key without 0x prefix
❌ Extra spaces in addresses or keys
❌ Using placeholder/example values
❌ Incorrect address format (must be 42 characters: 0x + 40 hex)

2. Install Dependencies

npm install

3. Run Pre-Deployment Verification

This step is MANDATORY - it validates your configuration and catches errors before deployment:

node scripts/verify-setup.js

The script will check:

✓ Environment file exists
✓ All required variables are set and properly formatted
✓ Network connectivity to Polygon RPC
✓ Deployer wallet has sufficient POL balance
✓ Wallet addresses are valid

Do not proceed if any checks fail! Fix all errors before continuing.

4. Deploy Smart Contracts

Once verification passes, deploy to Polygon Mainnet:

npx hardhat run scripts/deploy.js --network polygon

Or use the enhanced deployment script:

npx hardhat run scripts/redeploy.js --network polygon

Important: Save the deployment output! You'll need the contract addresses.

5. Update Environment with Contract Addresses

After deployment, update your .env file with the deployed contract address:

AETH_TOKEN_ADDRESS=0x... # Copy from deployment output

6. Verify Contracts on PolygonScan

npx hardhat verify --network polygon <AETH_TOKEN_ADDRESS> "<TEAM_WALLET>" "<MARKETING_WALLET>" "<STAKING_ADDRESS>"
npx hardhat verify --network polygon <STAKING_ADDRESS> "<AETH_TOKEN_ADDRESS>"

7. Enable Trading

node scripts/enable-trading.js

8. Add Liquidity to DEX

node scripts/add-liquidity.js

Or manually via QuickSwap interface: https://quickswap.exchange/#/pool

9. Post-Deployment Verification

Run the final deployment check:

node scripts/final-deployment-check.js

Common Errors & Solutions

Error	Cause	Solution
`PRIVATE_KEY is not defined`	Missing or empty .env file	Copy `.env.example` to `.env` and fill in values
`PRIVATE_KEY must start with 0x`	Missing 0x prefix	Add `0x` before your private key
`Invalid address format`	Wrong address length or format	Ensure address is 42 characters (0x + 40 hex)
`Insufficient funds for gas`	Not enough POL in wallet	Add at least 0.5 POL to deployer wallet
`Cannot connect to RPC`	Invalid or rate-limited RPC URL	Use a valid RPC from Alchemy/Infura/QuickNode
`AETH_TOKEN_ADDRESS not found`	Token not deployed yet	Deploy contracts first, then update .env
`Ownable: caller is not the owner`	Wrong private key in .env	Use the deployer's private key

Environment Variable Reference

Required Variables

Variable	Description	Format	Example
`PRIVATE_KEY`	Deployer wallet private key	0x + 64 hex chars	`0x1234...abcd`
`POLYGON_RPC_URL`	Polygon RPC endpoint	HTTPS URL	`https://polygon-mainnet.g.alchemy.com/v2/...`
`TEAM_WALLET`	Team wallet address	0x + 40 hex chars	`0x1234...5678`
`MARKETING_WALLET`	Marketing wallet address	0x + 40 hex chars	`0xabcd...ef01`

Post-Deployment Variables

Variable	Description	When to Set
`AETH_TOKEN_ADDRESS`	Deployed token contract address	After step 4 (deployment)
`STAKING_CONTRACT_ADDRESS`	Deployed staking contract address	After step 4 (deployment)

Optional Variables

Variable	Description	When Needed
`POLYGONSCAN_API_KEY`	PolygonScan API key	For contract verification (step 6)
`COINMARKETCAP_API_KEY`	CoinMarketCap API key	For gas reporting in tests

Troubleshooting Guide

Verification Script Fails

Check .env file exists: ls -la .env
Verify file contents: cat .env (be careful not to share output!)
Check for hidden characters: Open in text editor and remove any extra spaces/newlines
Validate each field: Compare with .env.example format

Deployment Fails

Check gas balance: Ensure you have 0.5+ POL
Verify network: Confirm POLYGON_RPC_URL is for Polygon Mainnet (Chain ID: 137)
Check nonce issues: Wait 30 seconds and retry
Review transaction: Check on PolygonScan for revert reason

Script Errors

Module not found: Run npm install in smart-contract directory
Cannot find artifact: Run npm run compile
Network timeout: Check internet connection and RPC endpoint status

Security Best Practices

✅ NEVER commit .env file to git
✅ Use hardware wallet for production deployments
✅ Store private keys securely (password manager, hardware wallet)
✅ Test on Mumbai testnet before mainnet deployment
✅ Verify all addresses before deploying
✅ Keep deployment logs for audit trail
✅ Use multisig wallet for contract ownership in production

Quick Start for Experienced Users

# 1. Setup
cd smart-contract && cp .env.example .env
# Edit .env with your values

# 2. Verify
node scripts/verify-setup.js

# 3. Deploy
npx hardhat run scripts/redeploy.js --network polygon

# 4. Update .env with AETH_TOKEN_ADDRESS

# 5. Enable trading
node scripts/enable-trading.js

# 6. Add liquidity
node scripts/add-liquidity.js

Support

If you encounter issues not covered in this guide:

Check existing GitHub Issues
Review smart contract README.md
Run verification script for diagnostic info
Open a new issue with error details and verification output

📞 Contact

GitHub: @Mastatrill
Repository: github.com/Mastatrill/aetheron-platform
Website: https://mastatrill.github.io/Aetheron_platform
Email: contact@aetheron.space

⭐ Star us on GitHub if you like this project!
Created by Mastatrill — Building the future of space exploration 🌌🚀 `

Aetheron Platform Dashboard

Overview

Aetheron Platform is a decentralized dashboard for token management, staking, analytics, and community engagement on Polygon.

Features

User profile management (edit, save)
Real-time notifications (push, email, in-app)
Onboarding flows (video walkthrough, gamified tutorial)
Language and RTL support
Accessibility settings (screen reader, dyslexia mode)
DeFi integrations (staking, lending, yield farming)
Analytics and AI-powered insights

Getting Started

Clone the repo: git clone https://github.com/MastaTrill/Aetheron_platform.git
Install dependencies: npm install
Start the dashboard: npm start
Open http://localhost:3000/dashboard.html in your browser

Testing

Frontend: Run npm test (Jest, dashboard.test.js)
Smart contracts: Run npm run test:smart-contract

Documentation

See inline comments in dashboard.js and dashboard.html
For API and contract docs, see the smart-contract folder

Deployment

Static site: Deploy manually to GitHub Pages or your preferred host
Contracts: See smart-contract/README.md for deployment steps

Deployment Automation

Static Site (Dashboard)

You can automate deployment to GitHub Pages using the following steps:

Ensure your repository is connected to GitHub.
Push your latest changes to the main or gh-pages branch.
In your repository settings, enable GitHub Pages and set the source to / (root) or /docs as needed.
Optionally, use GitHub Actions for CI/CD. Example workflow:

# .github/workflows/deploy.yml
name: Deploy Dashboard to GitHub Pages
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./

Smart Contracts

Automate contract deployment and verification using Hardhat scripts:

Deploy: npm run deploy:polygon or npm run deploy:mumbai
Verify: npm run verify:polygon or npm run verify:mumbai

You can also add a GitHub Actions workflow for contract deployment (with secrets for RPC and private key).

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

🌌 Aetheron Platform

Deployed Contracts

Polygon Mumbai Testnet (Chain ID: 80001)

Polygon Mainnet (Chain ID: 137)

Solana (if applicable for cross-chain or future features)

AETH Token Specifications

Tax Structure

Security Features

🚀 Production Deployment Checklist

Prerequisites

Step-by-Step Deployment Guide

1. Setup Environment Variables

2. Install Dependencies

3. Run Pre-Deployment Verification

4. Deploy Smart Contracts

5. Update Environment with Contract Addresses

6. Verify Contracts on PolygonScan

7. Enable Trading

8. Add Liquidity to DEX

9. Post-Deployment Verification

Common Errors & Solutions

Environment Variable Reference

Required Variables

Post-Deployment Variables

Optional Variables

Troubleshooting Guide

Verification Script Fails

Deployment Fails

Script Errors

Security Best Practices

Quick Start for Experienced Users

Support

Aetheron Platform Dashboard

Overview

Features

Getting Started

Testing

Documentation

Deployment

Deployment Automation

Static Site (Dashboard)

Smart Contracts