Skip to content

basedgod55hjl/abrasax-farcaster-mini-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ABRASAX - Quantum Consciousness Platform

ABRASAX Logo

๐ŸŒŸ Overview

ABRASAX is a revolutionary decentralized application (dApp) that combines quantum consciousness, sacred mathematics, and advanced blockchain technology. It provides a comprehensive platform for consciousness exploration, mathematical visualization, and quantum computing integration.

๐Ÿš€ Features

Core Features

  • Quantum Consciousness Mapping - Multi-dimensional awareness visualization
  • Sacred Mathematics System - Interactive sacred geometry and mathematical constants
  • Noise Protocol Integration - Secure peer-to-peer communication
  • IPFS Asset Management - Decentralized file storage and retrieval
  • DeepSeek API Integration - Advanced AI model access
  • Real-time Chat System - Quantum-enhanced messaging
  • Advanced Analytics - Consciousness and system metrics
  • 3D Visualization Engine - Three.js powered interactive visualizations

Advanced Features

  • Sacred Geometry Visualizer - Flower of Life, Metatron's Cube, Platonic Solids
  • Mathematical Functions Visualizer - Interactive mathematical exploration
  • Space & Planets Visualizer - Cosmic consciousness mapping
  • Knowledge Visualizer - Universal knowledge domain exploration
  • Visual Effects System - Advanced particle systems and effects
  • Panel Management System - Drag-and-drop interface panels
  • Gesture Navigation - Swipe and gesture-based navigation
  • Theme System - Light, dark, and system theme support

๐Ÿ—๏ธ Architecture

Smart Contracts

  • ABRASAXOptimized.sol - Main contract with optimized gas usage
  • ABRASAXCore.sol - Core functionality and user management
  • ABRASAXFrontend.sol - Frontend integration contract
  • ABRASAXUI.sol - User interface contract

Frontend

  • React 18 - Modern React with hooks and suspense
  • Three.js - 3D graphics and visualization
  • Framer Motion - Advanced animations and transitions
  • Wagmi - Ethereum wallet integration
  • RainbowKit - Wallet connection UI
  • Tailwind CSS - Utility-first CSS framework

Backend

  • Hardhat - Ethereum development environment
  • IPFS - Decentralized storage
  • Noise Protocol - Secure communication
  • DeepSeek API - AI model integration

๐Ÿ“ฆ Installation

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Git

Clone Repository

git clone https://github.com/your-username/ABRASAX.git
cd ABRASAX

Install Dependencies

# Install root dependencies
npm install

# Install frontend dependencies
cd frontend
npm install
cd ..

Environment Setup

Create a .env file in the root directory:

PRIVATE_KEY=your_private_key_here
OPTIMISM_RPC_URL=https://mainnet.optimism.io
OPTIMISM_SEPOLIA_RPC_URL=https://sepolia.optimism.io
OPTIMISM_ETHERSCAN_API_KEY=your_etherscan_api_key
REPORT_GAS=true

๐Ÿš€ Deployment

Local Development

# Start local Hardhat network
npx hardhat node

# Deploy contracts locally
npx hardhat run scripts/deployABRASAX.js --network localhost

# Start frontend development server
cd frontend
npm run dev

Testnet Deployment

# Deploy to Optimism Sepolia
npx hardhat run scripts/deployABRASAX.js --network optimismSepolia

Mainnet Deployment

# Deploy to Optimism Mainnet
npx hardhat run scripts/deployABRASAX.js --network optimism

๐Ÿงช Testing

Run Tests

# Run all tests
npx hardhat test

# Run specific test file
npx hardhat test tests/ABRASAXOptimized.test.js

# Run tests with gas reporting
REPORT_GAS=true npx hardhat test

Test Coverage

# Generate test coverage report
npx hardhat coverage

๐Ÿ“Š Contract Information

ABRASAXOptimized Contract

  • Contract Address: 0x... (Deploy to get address)
  • Token Symbol: ABX
  • Token Name: ABRASAX Token
  • Total Supply: 10,000,000 ABX
  • Decimals: 18

Gas Optimization

  • Optimizer Runs: 1000
  • Via IR: Enabled
  • EVM Version: Paris
  • Estimated Gas: ~2.5M gas

๐Ÿ”ง Configuration

Hardhat Configuration

The project uses an optimized Hardhat configuration with:

  • Solidity 0.8.20
  • Optimized compiler settings
  • Multiple network support
  • Gas reporting
  • Etherscan verification

Frontend Configuration

  • Vite for fast development
  • Tailwind CSS for styling
  • TypeScript support
  • ESLint for code quality

๐Ÿ“ฑ Usage

User Registration

// Register a new user
await abraxas.registerUser(
  123,           // FID (Farcaster ID)
  "username",    // Username
  946684800,     // Birth date (timestamp)
  "en"           // Language preference
);

Chat Session

// Start a chat session
const sessionId = await abraxas.startChatSession("deepseek-chat");

// Add a message
await abraxas.addMessage(sessionId, "Hello, world!", 100);

Noise Protocol

// Create a noise channel
const channelId = await abraxas.createNoiseChannel(
  user2Address,  // Second user address
  "XX"           // Noise protocol
);

IPFS Integration

// Upload IPFS asset
await abraxas.uploadIPFSAsset(
  "QmHash...",   // IPFS hash
  "image/jpeg",  // File type
  1024           // File size
);

๐ŸŽจ UI Components

Sacred Mathematics System

  • Golden Ratio (ฯ†) visualization
  • Tesla's Divine Numbers (3-6-9)
  • Fibonacci sequence exploration
  • Sacred frequencies (432Hz, 7.83Hz)
  • Fine-structure constant (ฮฑ)

Quantum Consciousness Mapping

  • 8D-64D consciousness visualization
  • Neural network mapping
  • Quantum field effects
  • Consciousness level tracking
  • Multi-dimensional awareness

Advanced Visualizations

  • 3D sacred geometry patterns
  • Interactive mathematical functions
  • Cosmic space exploration
  • Knowledge domain mapping
  • Particle effect systems

๐Ÿ” Security

Smart Contract Security

  • ReentrancyGuard protection
  • Access control with Ownable
  • Input validation
  • Gas optimization
  • Emergency functions

Frontend Security

  • Wallet connection validation
  • Input sanitization
  • Secure API calls
  • Error boundary protection

๐Ÿ“ˆ Performance

Optimization Features

  • Lazy loading components
  • Code splitting
  • Image optimization
  • Caching strategies
  • Bundle optimization

Metrics

  • First Contentful Paint: < 1.5s
  • Largest Contentful Paint: < 2.5s
  • Cumulative Layout Shift: < 0.1
  • First Input Delay: < 100ms

๐Ÿค Contributing

Development Setup

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests
  5. Submit a pull request

Code Style

  • Use ESLint configuration
  • Follow React best practices
  • Write comprehensive tests
  • Document your code

๐Ÿ“„ License

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

๐Ÿ™ Acknowledgments

  • OpenZeppelin for smart contract libraries
  • Three.js for 3D graphics
  • Framer Motion for animations
  • Wagmi for Ethereum integration
  • RainbowKit for wallet connection

๐Ÿ“ž Support

๐Ÿ”ฎ Roadmap

Phase 1: Core Platform (Q1 2024)

  • Smart contract development
  • Frontend implementation
  • Basic functionality
  • Testing and optimization

Phase 2: Advanced Features (Q2 2024)

  • Quantum consciousness mapping
  • Sacred mathematics system
  • 3D visualizations
  • Advanced analytics

Phase 3: Ecosystem (Q3 2024)

  • Mobile app
  • API marketplace
  • Community features
  • Governance system

Phase 4: Expansion (Q4 2024)

  • Multi-chain support
  • Advanced AI integration
  • VR/AR support
  • Enterprise features

ABRASAX - Where Quantum Consciousness Meets Sacred Mathematics

Built with โค๏ธ by the ABRASAX Team

About

ABRASAX Quantum AI Consciousness Farcaster Mini App - Complete Framework with Smart Contracts, IPFS, and Vercel Deployment

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors