Cyrus The Great - Anonymous Web3 Vault

Live Demo: cyrusthegreat.dev

A sophisticated, privacy-focused Web3 vault that enables anonymous ETH and ERC20 token transfers across multiple blockchain networks.

🚀 Features

Core Functionality

• Anonymous ETH Operations: Deposit, withdraw, and internal transfers
• Full ERC20 Support: Dynamic token detection and management
• Multi-Chain Ready: Ethereum, Binance Smart Chain, Base, and Solana (coming soon)
• Smart Fee System: Dynamic $0.10 USD fees via Chainlink price feeds

User Experience

• Beautiful UI/UX: Modern, responsive design with shadcn/ui components
• Multiple Display Modes: Tabs, Cards, Tabbed-Cards, and Native/Tokens views
• Real-Time Updates: Live balance updates and transaction confirmations
• One-Click Operations: Uniswap-style approval and deposit flows

Security & Privacy

• Method ID Privacy: Obfuscated transaction methods
• Event Privacy: Anonymous internal transfers
• Smart Contract Security: Audited vault contracts with proper access controls

🛠️ Technology Stack

• Frontend: React 18 + TypeScript + Vite
• UI Framework: shadcn/ui + Tailwind CSS
• Web3 Integration: Wagmi + Viem + Reown AppKit
• Blockchain: Ethereum (Sepolia/Mainnet), BSC, Base
• Deployment: Cloudflare Pages

🚀 Quick Start

Prerequisites

• Node.js 18+ (20+ recommended)
• npm or yarn
• MetaMask or compatible Web3 wallet

Installation

# Clone the repository
git clone https://github.com/yourusername/cyrus-the-great.git
cd cyrus-the-great

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your API keys and contract addresses

# Start development server
npm run dev

Environment Variables

Create a .env file in the root directory:

# Cyrus The Great Vault Configuration
VITE_CTGVAULT_ADDRESS_ETH=your_eth_contract_address
VITE_CTGVAULT_ADDRESS_BSC=your_bsc_contract_address

# API Keys
VITE_REOWN_PROJECT_ID=your_reown_project_id
VITE_ANKR_API_KEY=your_ankr_api_key
VITE_ALCHEMY_API_KEY=your_alchemy_api_key
VITE_ETHERSCAN_API_KEY=your_etherscan_api_key
VITE_BSCSCAN_API_KEY=your_bscscan_api_key

📱 Usage

Display Modes

• Tabs Mode: Clean tabbed interface for tokens
• Cards Mode: Visual card-based token display
• Tabbed-Cards Mode: Hybrid approach with internal tabs
• Native/Tokens Mode: Separate native currency and token management

Keyboard Shortcuts

• Ctrl+1: Switch to Tabs mode
• Ctrl+2: Switch to Cards mode
• Ctrl+3: Switch to Tabbed-Cards mode
• Ctrl+4: Switch to Native/Tokens mode

Token Operations

1. Deposit: Approve and deposit tokens to vault
2. Withdraw: Remove tokens from vault to wallet
3. Transfer: Send tokens anonymously to other vault users

🔧 Development

Available Scripts

npm run dev          # Start development server
npm run build        # Build for production
npm run preview      # Preview production build
npm run lint         # Run ESLint
npm run type-check   # Run TypeScript type checking

Project Structure

src/
├── components/          # React components
│   ├── modals/         # Modal dialogs
│   ├── ui/             # shadcn/ui components
│   ├── VaultCore.tsx   # Main dashboard
│   └── WalletConnector.tsx
├── hooks/              # Custom React hooks
├── config/             # Configuration files
├── lib/                # Utility libraries
└── pages/              # Page components

🌐 Deployment

Cloudflare Pages (Recommended)

1. Connect your GitHub repository to Cloudflare Pages
2. Set build command: npm run build
3. Set output directory: dist
4. Add environment variables
5. Deploy and connect custom domain

Manual Deployment

# Build the project
npm run build

# Deploy to your preferred hosting service
# The built files are in the `dist` directory

🔒 Security

• No API keys are stored in the repository
• Environment variables are properly excluded from git
• Smart contract interactions use proper error handling
• User data is never stored or transmitted

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

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

🙏 Acknowledgments

• Reown AppKit for wallet integration
• shadcn/ui for beautiful UI components
• Wagmi for Web3 React hooks
• Viem for low-level Ethereum interactions

📞 Support

• Website: cyrusthegreat.dev
• Twitter: @humanperzeus
• GitHub: Issues

---

Made with ❤️ by @humanperzeus

Cyrus The Great - Empowering anonymous Web3 transactions