🐷 PorketOption - Decentralized Savings & Investment Platform

PorketOption is a revolutionary mobile application that combines the power of decentralized finance (DeFi) with user-friendly savings and investment management. Built on Starknet with Cairo smart contracts, it offers multiple savings options with competitive interest rates while maintaining complete transparency and security.

🚀 Key Features

💰 Comprehensive Savings Ecosystem

• Embedded Wallet: Seamless onboarding with email-based wallet creation
• Flexi Save: 18% APY with instant liquidity and automated recurring deposits
• Lock Save: 5.5% to 12.5% APY based on lock duration (10-365 days) with automatic payouts
• Goal Save: Purpose-driven savings with categories, progress tracking, and achievement rewards
• Group Save: Social savings with public/private groups, leaderboards, and competitive challenges

🌍 Global Financial Access

• Global Accessibility: Multi-currency support (NGN, USD, EUR) with onramp/offramp integration
• Multi-language Support: Localized experience for global users
• Cross-Chain Deposits: Accept funds from Ethereum, Polygon, BSC, and other major networks

⚡ Advanced Financial Technology

• Dynamic Interest Rates: Real-time calculation based on market conditions and lock duration
• Automated Smart Contracts: Built on Starknet with Cairo for secure, transparent operations
• Real-time Updates: Live balance tracking and instant transaction confirmation

🎮 Gamified User Experience

• Gamified Experience: Streaks, achievements, and social features to encourage consistent saving
• Progress Tracking: Visual progress indicators for all savings goals
• Achievement System: Badges and rewards for financial milestones
• Social Leaderboards: Competitive features to motivate users

🔒 Security & User Experience

• Gasless Transactions: AVNU Paymaster integration for seamless, gas-free user experience
• Secure Transactions: Enterprise-grade security with transparent fee structure
• Emergency Controls: Owner-controlled pause/unpause functionality for added security
• Transparent Operations: All transactions visible on-chain with clear audit trails

🛠️ Technology Stack

Frontend

• Flutter 3.0+: Cross-platform mobile development
• Dart: Programming language
• Stacked Architecture: MVVM architecture pattern
• Firebase: Authentication and backend services
• Fl Chart: Beautiful data visualization

Blockchain

• Starknet: Layer 2 scaling solution for Ethereum
• Cairo 2.0: Smart contract programming language
• OpenZeppelin: Secure contract templates and components
• USDC Integration: Stablecoin support for deposits

Development Tools

• Golden Toolkit: Visual regression testing
• SnForge: Starknet contract testing framework
• Build Runner: Code generation
• Mockito: Testing utilities

📊 Smart Contract Architecture

Core Contracts

• SavingsVault: Main contract handling all savings operations
• AutomationScheduler: Automated interest distribution and maturity handling

Savings Types

1. Flexi Savings: 4% APY, instant withdrawals
2. Lock Savings: 4-15% APY based on duration (30-365 days)
3. Goal Savings: 6% APY, target-based savings
4. Group Savings: 8% APY, collaborative saving pools

🚀 Getting Started

Prerequisites

• Flutter SDK 3.0+
• Dart 3.0+
• Starknet/Cairo development environment
• Firebase project setup

Installation

1. Clone the repository

   git clone https://github.com/Devsol01/PorketOption.git
   cd PorketOption

2. Setup Mobile App

   cd mobile_app
   flutter pub get

3. Setup Smart Contracts

   cd contract
   scarb build

Running the Application

Mobile App:

cd mobile_app
flutter run

Contract Testing:

cd contract
snforge test

Innovation

• First multi-type savings platform on Starknet with flexible interest rates
• Social savings feature enabling group financial goals
• Streak-based rewards system to encourage consistent saving habits

Technical Excellence

• Gas-optimized Cairo contracts with efficient storage patterns
• Real-time interest calculation without oracle dependency
• Comprehensive test coverage with 100+ test cases

User Experience

• Intuitive mobile interface with smooth animations
• Zero learning curve for traditional banking users
• Instant transaction feedback with real-time updates

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

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

📄 License

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