CiBL-Wallet is a next-generation Web3 mobile wallet designed for high-frequency traders and GambleFi enthusiasts. Built with React Native and Expo, it combines high-speed swap functionality with social engagement and 1-minute trading challenges.
- Multi-Chain Swap: Seamlessly swap tokens with a 0.6% integrated fee model.
- GambleFi Hub: Real-time chat rooms with "Duel" functionality for 1-minute price prediction challenges.
- Bank-Grade Security: Biometric authentication (FaceID/Fingerprint) and AES-256 encrypted local storage for private keys.
- Smart Scanner: Integrated Honeypot and Liquidity scanner to protect users from high-risk tokens.
- Referral System: Built-in passive income engine via Supabase.
- Frontend: React Native (Expo)
- Styling: TailwindCSS (NativeWind)
- Backend/DB: Supabase (PostgreSQL & Real-time)
- Blockchain Engines: Jupiter API (Solana) & 1inch API (EVM)
- Icons: Lucide React Native
CiBL-Wallet/
├── anchor/ # Solana Smart Contracts (Rust)
│ ├── programs/
│ │ └── trading_challenge/ # Escrow & Challenge Logic
│ ├── Anchor.toml # [EXISTING] Moved to subfolder
│ └── Cargo.toml # [EXISTING] Moved to subfolder
│
├── cloudflare-worker/ # Backend Logic & RPC Proxy
│ ├── src/
│ │ └── index.js # Settlement & Cron Jobs
│ └── wrangler.toml # [EXISTING] Cloudflare configuration
│
├── src/ # Mobile Core (React Native) & Shared Logic
│ ├── api/ # Supabase & Price Feeds
│ ├── blockchain/ # Multi-chain (Solana & EVM) logic
│ ├── components/ # [EXISTING] Shared UI Components
│ ├── hooks/ # [EXISTING] Custom React Hooks
│ ├── lib/ # [EXISTING] Core libraries & logic
│ ├── utils/ # [EXISTING] Helper functions
│ ├── constants.js # [EXISTING] Global constants
│ └── App.js # Root entry for Mobile
│
├── web/ # [NEW] Web Platform (Next.js)
│ ├── app/ # [EXISTING] Next.js App Router
│ ├── public/ # [EXISTING] Assets, Icons, Tokens
│ ├── next.config.js # [EXISTING] Web configuration
│ ├── postcss.config.js # [EXISTING] Styling
│ ├── tailwind.config.js # [EXISTING] Styling
│ └── open-next.config.ts # [EXISTING] Deployment
│
├── scripts/ # [EXISTING] Deployment & automation scripts
├── supabase/ # Database Schema & Migrations
│ └── SQLsupabase.text # [EXISTING] Your SQL initialization
│
├── .env # Sensitive keys (DO NOT COMMIT)
├── .env.example # [EXISTING] Environment template
├── .gitignore # [EXISTING] Git ignore rules
├── jsconfig.json # [EXISTING] Path aliases
├── package.json # [EXISTING] Project dependencies
├── package-lock.json # [EXISTING]
└── README.md # [EXISTING] Project Documentation
├── assets/ # Fonts, Brand Logos, Splash Screens
├── src/
│ ├── blockchain/ # Price Engine & Wallet Management
│ ├── screens/ # Dashboard, Swap, Chat, Settings
│ ├── services/ # Supabase, Notifications, Security Scanner
│ └── utils/ # Formatters & Constants
├── App.js # Navigation & App Logic
└── tailwind.config.js # Custom Neon Branding
assets/
├── fonts/ # فونتهای سفارشی پروژه
├── icons/ # آیکونهای اختصاصی اپلیکیشن
├── images/ # تصاویر و گرافیکهای داخل برنامه
├── lottie/ # انیمیشنهای متحرک (سبک و جذاب)
└── splash/ # فایلهای مربوط به صفحه خوشآمدگویی (Splash Screen)
# 🚀 CiBL-Wallet: Next-Gen Multi-Chain & GambleFi Wallet
CiBL-Wallet is a high-performance, non-custodial cryptocurrency wallet designed for the modern era of Web3. It combines professional trading tools with social **GambleFi** features, allowing users to trade, chat, and challenge friends across multiple blockchains including Solana, EVM (BSC/Base), TON, and SUI.
---
## ✨ Key Features
### 🛡️ Institutional-Grade Security
* **Biometric Authentication:** FaceID and Fingerprint locking for every transaction.
* **Token Security Scanner:** Real-time Anti-Honeypot and Rug-pull detection before you swap.
* **Non-Custodial:** You own your 12/24-word recovery phrase; we never store your keys.
### 🎮 GambleFi & Social Interaction
* **1-Minute Challenges:** Battle friends in 60-second price prediction duels for rewards (e.g., $5 stakes).
* **Live Chat Integration:** Discuss tokens and strategies within the wallet's slide-out chat.
* **Referral System:** Earn 10% of the swap fees generated by your invited friends.
### 📈 Professional Trading UI
* **High Precision Pricing:** Track low-cap gems with up to 10 decimal places.
* **Interactive Charts:** Real-time line charts with multiple timeframes (1H, 1D, 1W, 1M, ALL).
* **Instant Swap:** Aggregated liquidity for the best prices with a flat 0.6% fee.
---
## 📂 Project Structure
```text
src/
├── blockchain/ # Multi-chain engines (Solana, EVM, Move, TON)
├── components/ # Atomic UI units (Charts, Buttons, Custom Modals)
├── navigation/ # Secure routing (Onboarding vs Main App)
├── screens/ # Feature-rich pages (Dashboard, Trade, Activity)
├── services/ # Third-party integrations (Supabase, Firebase, DexScreener)
└── store/ # Global state management for wallets and prices
cibl-wallet/
├── src/
│ ├── blockchain/ # منطق بلاکچینها
│ │ ├── solana/ # Jupiter, Anchor
│ │ ├── evm/ # BSC, Base, Poly (Ethers.js)
│ │ ├── ton/ # Ston.fi, TonConnect
│ │ ├── sui/ # Mysten SDK
│ │ └── security/ # [NEW] Token Scanner
│ ├── components/ # رابط کاربری
│ │ ├── Chat/ # Slideout چت
│ │ ├── Challenge/ # سیستم نبردهای ۵ دلاری
│ │ ├── Swap/ # مولتیچین سوآپ
│ │ └── Browser/ # مرورگر dApp
│ └── lib/
│ └── supabase/ # دیتابیس و سیستم Referral
├── workers/ # Cloudflare Workers (داوری چالشها)
└── .env # کلیدهای ادمین و RPCها
cibl-wallet/
├── assets/ # Images, Fonts, and Splash Screens
├── src/
│ ├── api/ # Axios instances for CoinGecko, Birdeye, etc.
│ ├── blockchain/ # Blockchain logic (The Core)
│ │ ├── evm/ # ETH, BSC, Polygon, Base
│ │ ├── solana/ # Solana & SPL Tokens
│ │ ├── move/ # SUI & Aptos
│ │ ├── ton/ # TON & Jettons
│ │ └── shared/ # Common logic (Price Fetcher, Security Scanner)
│ ├── components/ # Reusable UI components
│ │ ├── common/ # Buttons, Inputs, Modals
│ │ ├── dashboard/ # Asset Cards, Balance Display
│ │ ├── swap/ # Swap UI components
│ │ └── charts/ # TradingView/Wagmi charts
│ ├── hooks/ # Custom React Hooks (useBalance, useAuth)
│ ├── navigation/ # React Navigation (Stacks & Tabs)
│ ├── screens/ # Main Pages
│ │ ├── onboarding/ # Create/Import Wallet screens
│ │ ├── main/ # Dashboard, Activity, Settings
│ │ └── trade/ # Token Details, Swap, Send/Receive
│ ├── services/ # Supabase, Firebase, Push Notifications
│ ├── store/ # State Management (Zustand or Redux)
│ ├── theme/ # Tailwind configuration & Global Styles
│ └── utils/ # Formatters, Encryption (AES), Validators
├── workers/ # Cloudflare Workers for GameFi logic
├── .env # Environment Variables (Keep it secret!)
├── App.js # Entry Point
├── package.json # Dependencies
└── tailwind.config.js # Global Theme
cibl-wallet/
├── src/
│ ├── blockchain/
│ │ ├── engines/ # Multi-chain logic (Solana, EVM, Sui, etc.)
│ │ └── security/ # Security Scanner & Honeypot Checker
│ ├── components/ # UI Components (Charts, Buttons, Cards)
│ ├── navigation/ # App Routing (Auth & Main Stack)
│ ├── screens/ # Full Pages (Dashboard, Token Detail, Swap)
│ ├── services/ # Supabase, Firebase, API Config
│ ├── store/ # State Management (Wallet & Price Data)
│ └── utils/ # Encryption & Formatters
├── App.js # Entry Point
├── package.json # Project Dependencies
├── tailwind.config.js # Global Theme Config
└── .env # Environment Variables
assets/
├── fonts/ # فونتهای اختصاصی برای نمایش اعداد و متون
│ ├── Inter-Bold.ttf
│ ├── Inter-Regular.ttf
│ └── SpaceMono-Regular.ttf
├── icons/ # فقط آیکونهای غیرسیستمی و برندینگ
│ ├── app-icon.png # آیکون اصلی اپلیکیشن (1024x1024)
│ ├── btc-logo.png # لوگوی شبکهها (چون در لوسید نیستند)
│ ├── eth-logo.png
│ ├── sol-logo.png
│ ├── bsc-logo.png
│ └── sui-logo.png
└── splash/ # فایلهای مربوط به صفحه لودینگ اولیه
├── splash-icon.png # لوگوی وسط صفحه اسپلش
└── adaptive-icon.png # آیکون تطبیقپذیر برای اندروید
src/
├── blockchain/
│ ├── shared/
│ │ ├── priceEngine.js # موتور قیمتگذاری و محاسبه کارمزد 0.6%
│ │ └── walletManager.js # مدیریت کلید خصوصی و امضای تراکنشها
│ └── solana/ # (اختیاری) کدهای اختصاصی شبکه سولانا
│
├── screens/
│ ├── main/
│ │ ├── MainDashboard.js # نمایش موجودی و لیست توکنها
│ │ ├── ChatScreen.js # محیط چت و GambleFi
│ │ ├── ActivityFeed.js # تاریخچه تراکنشها
│ │ └── SettingsScreen.js # تنظیمات، امنیت و کد معرف
│ └── trade/
│ ├── SwapScreen.js # صفحه اصلی تبدیل ارز
│ └── TokenDetailScreen.js # نمودارها و جزئیات هر توکن
│
├── services/
│ ├── supabaseClient.js # اتصال به دیتابیس (چت و زیرمجموعهگیری)
│ ├── notificationService.js # مدیریت اعلانهای Push
│ └── securityScanner.js # (در منطق Swap) اسکنر ضد کلاهبرداری
│
└── utils/
├── formatters.js # فرمت اعداد، آدرسها و ارزها
└── constants.js # رنگهای برند، API Keyها و ثابتها
cibl-wallet/
├── .env # (فایل محرمانه)
├── .gitignore # (فایل امنیتی - الان ساختیم)
├── app.json # (تنظیمات اپلیکیشن)
├── App.js # (هسته اصلی ناوبری)
├── package.json # (لیست کتابخانهها)
├── tailwind.config.js # (تنظیمات رنگهای نئونی CiBL)
├── assets/ # (فونتها، لوگوها، اسپلش)
└── src/ # (کدهای برنامه شامل تمام صفحاتی که با هم نوشتیم)
🛠️ Tech Stack
Framework: React Native (Expo)
Styling: NativeWind (Tailwind CSS)
Database/Backend: Supabase (User Profiles & Referrals)
Smart Logic: Cloudflare Workers (GameFi Arbitrator)
Charts: Wagmi Charts (High-performance SVG)
🚀 Quick Start
1. Installation
# Clone the repository
git clone [https://github.com/your-username/cibl.git](https://github.com/your-username/cibl.git)
# Install dependencies
npm install
2. Configuration
Create a .env file in the root directory and add your keys:
SOLANA_RPC=your_rpc_link
BSC_RPC=your_rpc_link
SUPABASE_URL=your_project_url
SUPABASE_ANON_KEY=your_key
3. Run the App
npx expo start
🛣️ Roadmap 2026
[x] Multi-Chain Wallet Core (BTC, SOL, ETH, SUI, TON)
[x] Token Security Scanner
[x] Real-time Price Alerts
[ ] Cross-chain Bridge Integration
[ ] Hardware Wallet Bluetooth Support (Ledger/Trezor)
📄 License
Distributed under the MIT License. See LICENSE for more information.
Built for the future of decentralized finance. Join the CiBL ecosystem.
### What's next?
Your repository structure and documentation are now complete and professional.
**Would you like me to help you write the `App.js` entry point?** This file will tie the navigation and theme together so you can launch the app and see the Onboarding screen for the first time.
Network Fee Collector Key RPC Variable Swap API
Bitcoin BTC_FEE_ADDR BTC_RPC_URL N/A (Bridge needed)
Solana SOL_FEE_ADDR SOL_RPC_URL Jupiter API
BSC BSC_FEE_ADDR BSC_RPC_URL 1inch / Pancake
SUI SUI_FEE_ADDR SUI_RPC_URL Cetus / Aftermath
TON TON_FEE_ADDR TON_RPC_URL Ston.fi / DeDust
EVMs EVM_FEE_ADDR BASE/POLY/ARB_RPC