StormEye - Comprehensive System Documentation

System Overview

StormEye is an automated bidding system for Freelancer.com consisting of:

Chrome Extension: Automates bidding on Freelancer.com projects
Sale Website: Manages subscriptions, payments, referrals, and wallet
Backend API: Handles authentication, payments, and cryptocurrency transactions

Core Components

├── Extension (Chrome)
│   ├── Background Service Worker
│   ├── Content Script (Freelancer.com integration)
│   ├── Popup Interface
│   └── Settings Page
│
├── Sale Site (React Frontend)
│   ├── Landing Page
│   ├── Pricing Plans
│   ├── Authentication (Google OAuth, Email/Password)
│   ├── Wallet Dashboard
│   └── Referral System
│
└── Backend API (Python Flask)
    ├── User Management
    ├── Payment Processing
    ├── Crypto Wallet Service
    ├── Blockchain Integration
    └── Referral System

Extension Features

1. AI Proposal Generation

The extension offers three methods for generating bid proposals:

a) Template-Based Proposals

Use custom templates with shortcodes
Available Shortcodes:
- <EmployerName> - Client's name
- <ProjectTitle> - Project title
- <ProjectSkills> - Required skills (comma-separated)
- <FreelancerName> - Your name
Advanced Features:
- <Separator> - Split template into variants (random selection)
- [if_attachment]...[/if_attachment] - Conditional blocks
- {option1|option2|option3} - Random choice selection
- \n - Line breaks

Example Template:

Hi <EmployerName>,

I've reviewed "<ProjectTitle>" and I'm excited to help with {this project|your requirements}.

With expertise in <ProjectSkills>, I can {deliver|provide|complete} {quality work|excellent results}.

[if_attachment]
I've reviewed your attachments and understand the requirements clearly.
[/if_attachment]

Best regards,
<FreelancerName>

b) Freelancer's AI

Uses Freelancer.com's built-in AI
Automatically generates proposals based on project details
No configuration needed

c) Custom AI Integration

Supported AI providers:

Anthropic Claude
OpenAI
Google Gemini
Z.ai

Custom instructions can be provided for AI-generated proposals.

2. Advanced Project Filtering

Country Filters

Block Mode: Exclude specific countries
Allow Mode: Only bid on projects from selected countries
Support for 195+ countries worldwide

Client Filters

Payment Verified: Only bid on clients with verified payment methods
Client Verified: Only bid on verified clients
Deposit Made: Only bid on clients who made deposits

Project Type Filters

Fixed Price Projects
Hourly Projects
Budget range filtering (min/max)

Delivery Time Filters

Minimum delivery time (days)
Maximum delivery time (days)

Budget Configuration

Fixed Projects:

Bid at minimum budget
Bid at maximum budget
Custom budget ranges by currency
Custom delivery times per budget range

Hourly Projects:

Bid at minimum rate
Bid at maximum rate
Use own hourly rate
Custom rate ranges by currency

Skill Matching

Match projects with your skills
Automatic skill-based filtering

3. Bid Management

Milestone Configuration

Split payments into milestones
Configure percentage for each milestone
Milestone 1: Initial payment (default 100%)
Milestone 2: Final payment (optional)

Profile Selection

Select bidding profile (General or custom profiles)
Different profiles for different project types

Bid Logging

Complete history of all bids
Project title, URL, timestamp
Success/failure status
Direct links to projects

4. Contract Handling

The extension can automatically sign:

NDA (Non-Disclosure Agreement)
IP Agreement (Intellectual Property Agreement)

Requirements:

Configure signature details in settings:
- Full legal name
- Date of birth
- Address (Street, City, State, Zip, Country)
- Agreement to terms

5. Login Status Detection

Automatic Freelancer.com login detection
Real-time status updates
Cookie-based authentication
Periodic status checks (every 30 minutes)
Manual refresh option

6. Automation Features

Sound Notifications: Play custom sound on successful bid
Auto-Open Projects: Open project page after bidding
Rate Limiting: Respects Freelancer API limits
Error Handling: Graceful error recovery
Retry Logic: Automatic retry on failures

Pricing Plans

Plan Comparison

Plan	Price	Original Price	Duration	Savings
Free	$0	-	7 Days	-
Egg 🥚	$6	$10	1 Month	40%
Zerger 👾	$15	$30	3 Months	50%
Protossi 🤖	$24	$60	6 Months	60%
Terranium 💎	$36	$120	1 Year	70%

Plan Features

Free Plan (7-day trial):

Full access to all functionalities
Test all features before purchasing
No credit card required

Paid Plans: All paid plans include:

Unlimited automated bidding
AI proposal generation (all methods)
Advanced filtering options
Contract signing
Sound notifications
Priority support
SSL encryption & data protection

Most Popular: Zerger (3 months) - Best value for regular users

Best Value: Terranium (1 year) - Maximum savings for power users

Payment Methods

1. Direct Crypto Payment

How It Works:

User selects a plan
System generates a temporary wallet address
User sends BEP20 USDT (BSC network) to temporary wallet
System automatically verifies payment on blockchain
Payment is split automatically:
- 50% to Admin wallet
- 50% to Referrer wallet (if user was referred)
Plan is activated immediately after confirmation

Payment Details:

Network: BSC (Binance Smart Chain)
Token: USDT (BEP20)
Confirmation Time: 1-2 minutes
Payment Expiry: 10 minutes

Process Flow:

User → Temporary Wallet → [Auto Split] → Admin (50%) + Referrer (50%)
                                      ↓
                               Plan Activated

2. Wallet Payment

How It Works:

User must have sufficient USDT in their wallet
System checks on-chain balance
If insufficient BNB for gas fees:
- System automatically funds 0.0001 BNB from admin wallet
- Waits for confirmation
Transfers USDT from user's wallet:
- To admin wallet (50% or 100%)
- To referrer wallet (50% if applicable)
Plan activated immediately

Requirements:

Sufficient USDT balance in wallet
BSC network
BNB for gas (auto-funded if needed)

Advantages:

Use referral earnings to purchase plans
Instant activation
No need to send from external wallet

Referral System

Commission Structure

Commission Rate: 50%

When someone purchases a plan using your referral link:

You receive: 50% of the purchase price
Admin receives: 50% of the purchase price

Referral Link Format

https://stormeye.app?ref=YOUR_USERNAME

Example:

https://stormeye.app?ref=john_doe

How It Works

Step 1: Share Your Link

Get your unique referral link from the Referral section
Share on social media, blogs, forums, or directly with friends

Step 2: User Signs Up

New user clicks your referral link
Referral code is stored in their browser
Works even if they sign up later

Step 3: User Purchases

Referred user purchases any paid plan
System automatically calculates 50% commission

Step 4: Instant Payout

Commission goes directly to your crypto wallet
No waiting period
No approval needed
Visible in wallet instantly

Earnings Examples

Plan Purchased	Price	Your Commission (50%)
Egg	$6	$3
Zerger	$15	$7.50
Protossi	$24	$12
Terranium	$36	$18

Tracking Referrals

In your account dashboard, you can see:

Total number of referrals
Total earnings from referrals
Pending withdrawal amount
Complete referral history

Referral Earnings Management

Automatic Distribution:

Earnings credited to your wallet automatically
Blockchain transaction hash recorded
Viewable in transaction history

Use Your Earnings:

Withdraw to external wallet anytime
Use to purchase your own plans
No minimum withdrawal amount

Wallet Management

Wallet Creation

Automatic Setup:

Every user gets a crypto wallet automatically
Created during registration
Private key encrypted and stored securely

Wallet Details:

Network: BSC (Binance Smart Chain)
Token: USDT (BEP20)
Full custody: You control your wallet
Private key encrypted with strong encryption

Wallet Features

1. Real-Time Balance

Shows current USDT balance
Updates automatically every 30 seconds
Manual refresh available
Displays on-chain balance (verified from blockchain)

2. Transaction History

View complete history of:

Deposits: Incoming USDT transfers
Withdrawals: Outgoing USDT transfers
Purchases: Plan purchases using wallet
Referral Earnings: Commission from referrals

Transaction details include:

Amount (USD)
Currency (BEP20_USDT)
Transaction hash (blockchain link)
Timestamp
Status (Confirmed/Failed)

3. Deposit Funds

How to Deposit:

Click "Deposit" button in wallet
Copy your wallet address
Send BEP20 USDT from any wallet/exchange
Balance updates automatically after blockchain confirmation

Supported Networks:

BSC (Binance Smart Chain) - BEP20 USDT

Important:

Only send BEP20 USDT on BSC network
Sending other tokens or wrong network will result in loss
Minimum deposit: $0.01
Confirmation time: 1-2 minutes

4. Withdraw Funds

How to Withdraw:

Click "Withdraw" button in wallet dashboard
Enter amount to withdraw in USD
System displays available balance and maximum withdrawable amount:
- Available Balance: Your total blockchain balance
- Max Withdrawal: Available - $0.10 fee
Review withdrawal summary showing:
- Withdrawal amount
- $0.10 withdrawal fee (highlighted in yellow warning)
- Total deducted from balance (in red)
Enter destination wallet address (BSC address starting with 0x...)
Confirm network (BSC - pre-selected and locked) and token (USDT - pre-selected and locked)
Submit withdrawal request

Withdrawal Details:

Network: BSC (Binance Smart Chain) - Cannot be changed
Token: USDT (BEP20) - Cannot be changed
Withdrawal Fee: $0.10 per transaction (Fixed platform fee)
Minimum Withdrawal: $0.01 (must have at least $0.11 total including fee)
Maximum Withdrawal: Available balance - $0.10 (auto-calculated and shown)
Gas Fee: Automatically handled by system (funded if needed)
Processing time: 1-2 minutes for blockchain confirmation
Transaction Transparency: Both fee and withdrawal get separate TX hashes

Fee Structure:

Platform Fee: $0.10 (transferred to admin wallet first)
Network Gas Fee: ~$0.0001 BNB (automatically funded by admin if user lacks BNB)
Total User Cost: $0.10 (gas covered by system)

Real-time Withdrawal Summary Display: When you enter a withdrawal amount, the interface automatically calculates and displays:

Amount:          $20.00
Fee:             $0.10
─────────────────────────
Total Deducted:  $20.10

This real-time calculation helps you verify you have sufficient balance before submitting.

Gas Fee Auto-Funding:

System checks your BNB balance automatically
If BNB < 0.00005, system sends 0.0001 BNB from admin wallet
Gas funding transaction completes before main withdrawal
No action needed from user - completely automatic
Gas transactions are recorded but hidden from user transaction history

Withdrawal Process

Withdrawal Fee Structure

Platform Fee: $0.10 per withdrawal

Charged on every withdrawal transaction
Goes to admin wallet to cover operational costs
Separate from blockchain gas fees
Non-refundable

Total Withdrawal Cost:

Requested Amount: User-specified
Platform Fee: $0.10
Gas Fee: ~$0.0001 BNB (auto-handled)
Total Deducted: Amount + $0.10

Example:

Withdrawal Request: $20.00
Platform Fee:        $0.10
─────────────────────────
Total Deducted:     $20.10

You receive:        $20.00
Admin receives:      $0.10 (fee)

Standard Withdrawal (From Wallet)

Process:

Initiate Withdrawal:
- Go to Wallet page
- Click "Withdraw"
- Enter amount (e.g., $20.00)
Review Summary:
- Amount: $20.00
- Fee: $0.10
- Total Deducted: $20.10
- System verifies sufficient balance ($20.10 required)
Enter Destination:
- Paste BSC wallet address
- Verify address is correct
- Network auto-set to BSC
- Token auto-set to USDT
System Checks:
- Verifies sufficient balance (including fee)
- Checks destination address validity
- Ensures sufficient gas (BNB)
Fee Processing:
- $0.10 transferred to admin wallet first
- Transaction hash generated for fee
- Waits for blockchain confirmation
Auto Gas Funding (if needed):
- System detects low BNB balance
- Sends 0.0001 BNB from admin wallet
- Waits for gas confirmation
Main Transfer Execution:
- $20.00 USDT transferred to destination
- Transaction hash generated
- Blockchain confirmation
Completion:
- Both transactions recorded in history:
  - Withdrawal: $20.00 (your withdrawal)
  - Withdrawal Fee: $0.10 (platform fee)
- Balance updated
- Email notification (if enabled)

Withdrawal Scenarios

Scenario 1: Sufficient Balance - Standard Withdrawal

Blockchain Balance: $50.00
Withdrawal Request: $20.00
Fee: $0.10
Total Required: $20.10

✅ SUCCESS:
- Fee Transaction: $0.10 → Admin wallet (TX Hash 1)
- Main Transaction: $20.00 → Your wallet (TX Hash 2)  
- New Balance: $29.90
- Processing Time: ~2 minutes total

Scenario 2: Insufficient Balance

Blockchain Balance: $10.00
Withdrawal Request: $20.00
Fee: $0.10
Total Required: $20.10

❌ ERROR: "Insufficient balance"
- System prevents transaction
- Error message shows: "Available: $10.00, Required: $20.10 ($20.00 + $0.10 fee)"
- No fees charged when transaction is prevented
- Balance remains: $10.00

Scenario 3: Exact Balance After Fee

Blockchain Balance: $20.10
Withdrawal Request: $20.00
Fee: $0.10
Total Required: $20.10

✅ SUCCESS:
- All funds withdrawn
- New Balance: $0.00
- You receive: $20.00 in your external wallet

Scenario 4: Maximum Withdrawal

Blockchain Balance: $100.00
User wants to withdraw everything

Calculation:
- Maximum possible withdrawal: $100.00 - $0.10 = $99.90
- UI automatically shows: "Max Withdrawal: $99.90 (after $0.10 fee)"

✅ SUCCESS if user enters $99.90:
- Fee: $0.10 → Admin wallet
- Withdrawal: $99.90 → Your wallet
- New Balance: $0.00

Scenario 5: Low BNB Balance (Auto Gas Funding)

Blockchain Balance: $50.00
BNB Balance: 0.00002 (insufficient for gas)
Withdrawal Request: $20.00

System Process:
1. Detects low BNB: 0.00002 < 0.00005 required
2. Auto-funds 0.0001 BNB from admin wallet
3. Waits for gas funding confirmation (~30 seconds)
4. Processes fee transaction: $0.10
5. Processes withdrawal transaction: $20.00

✅ SUCCESS:
- Total time: ~2.5 minutes (includes gas funding)
- User sees no difference in experience
- No additional cost to user

Scenario 6: Minimum Withdrawal

Blockchain Balance: $0.11
Withdrawal Request: $0.01 (minimum)
Fee: $0.10
Total Required: $0.11

✅ SUCCESS:
- Minimum withdrawal amount is $0.01
- Total deducted: $0.11
- You receive: $0.01 in external wallet
- New Balance: $0.00

Withdrawal from Referral Earnings

Two Options:

Option 1: Direct Withdrawal

Earnings automatically appear in wallet balance
Follow standard withdrawal process
$0.10 fee applies
Withdraw to any external BSC address

Example:

Referral Earnings: $15.00 (auto-deposited to wallet)
Wallet Balance: $15.00
Withdraw: $14.90 (keeping $0.10 for fee)
Fee: $0.10
Total Deducted: $15.00
You Receive: $14.90 in external wallet

Option 2: Use for Plan Purchase

Earnings available immediately in wallet
Use "Pay with Wallet" option when purchasing
No withdrawal fee (internal transfer)
More cost-effective

Example:

Referral Earnings: $15.00
Purchase Zerger Plan: $15.00
Fee: $0.00 (no fee for plan purchases)
Result: Plan activated, balance = $0.00

Transaction History Entries

Important: The system creates TWO separate blockchain transactions for each withdrawal, but the user interface only displays the main withdrawal transaction in the visible history to avoid confusion. The withdrawal fee transaction is recorded internally but hidden from the user-facing transaction list.

What Users See in Transaction History:

Withdrawal Transaction (User-Visible)

Type: Withdrawal ⬆️
Amount: -$20.00
Status: Success ✅
TX Hash: 0xabc...123 (clickable BSCScan link)
To: Your destination address
Date/Time: Timestamp of transaction

What Happens Behind the Scenes:

The system actually processes TWO transactions:

1. Withdrawal Fee Transaction (Internal - Hidden from UI)

Type: Withdrawal Fee 💵
Amount: -$0.10
Status: Success
TX Hash: 0xdef...456
To: Admin wallet
Note: Platform operational fee
Processing: Completed first, before main withdrawal

2. Main Withdrawal Transaction (User-Visible)

Type: Withdrawal ⬆️
Amount: -$20.00
Status: Success  
TX Hash: 0xabc...123
To: User's destination address
Processing: Executed after fee transaction confirms

Transaction Status Indicators:

✅ Success (Green badge) - Transaction confirmed on blockchain
❌ Failed (Red badge) - Transaction failed (rare, usually due to technical issues)

Transaction Filtering:

User transaction list automatically filters out:
- Pending transactions (not yet confirmed)
- Withdrawal fee transactions (internal bookkeeping)
- Gas funding transactions (automatic system maintenance)
Only confirmed or failed meaningful transactions are displayed
This provides a cleaner, more user-friendly transaction history

Blockchain Verification:

Each visible transaction includes a clickable TX Hash
Click TX Hash to view on BSCScan blockchain explorer
Full transparency - all transactions verifiable on-chain
Fee transactions also have TX hashes but are accessed through admin panel

Important Notes

Balance Requirements:

Minimum Withdrawal: $0.01 (must have at least $0.11 total: $0.01 withdrawal + $0.10 fee)
No Maximum: Withdraw up to (Available Balance - $0.10)
Real-time Validation: System calculates max withdrawal automatically
Fee Always Required: Every withdrawal must account for $0.10 platform fee

Processing & Timing:

No Waiting Period: Withdraw immediately after funds appear in blockchain balance
Instant Validation: System checks balance in real-time before allowing submission
Processing Time:
- Fee transaction: ~30-60 seconds
- Main withdrawal: ~30-60 seconds
- Total: 1-2 minutes typical
- With gas funding: 2-3 minutes maximum

Transaction Transparency:

Dual Transaction Hashes: Each withdrawal generates 2 TX hashes
- Fee TX Hash: Visible to admin only
- Withdrawal TX Hash: Provided to user with BSCScan link
Blockchain Verification: All transactions verifiable on BSCScan
Full Audit Trail: Complete transaction history maintained
Status Tracking: Real-time confirmation status updates

Fee Details:

Fixed Platform Fee: $0.10 per withdrawal (not percentage-based)
Non-Refundable: Fee charged even if main withdrawal fails (extremely rare)
Transparent Display: Fee clearly shown before transaction submission
Admin Allocation: Fee goes to admin wallet for operational costs
No Hidden Costs: Gas fees covered by system

Security & Validation:

Address Validation: System validates BSC address format
Network Locked: Only BSC supported (prevents wrong network errors)
Token Locked: Only USDT BEP20 (prevents wrong token errors)
Balance Verification: Double-checks balance before and during processing
Transaction Ordering: Fee always processed first, ensuring admin compensation

User Experience Features:

Real-time Summary: Withdrawal calculator shows total deduction as you type
Clear Warnings: Yellow warning box highlights withdrawal fee
Auto-calculated Max: System shows maximum withdrawable amount automatically
Clean History: Fee transactions hidden from user history for clarity
Instant Feedback: Success/error messages with transaction details
BSCScan Links: One-click blockchain verification

Error Handling:

Insufficient Balance: Clear error message with exact amounts needed
Invalid Address: Immediate validation of wallet address format
Gas Funding Issues: Automatic retry logic with admin notification
Network Issues: Timeout protection with user notification
Failed Transactions: Rare but handled gracefully with full refund (minus fee)

Technical Implementation Details (For Developers)

Backend Architecture:

Withdrawal Function: wallet_service.process_withdrawal()

Parameters:
- encrypted_private_key: User's encrypted wallet private key
- to_address: Destination wallet address  
- amount: Withdrawal amount in USD
- network: 'bsc' or 'polygon' (only BSC currently active)
- token: 'usdt' or 'usdc' (only USDT currently active)
- username: User's username for transaction recording

Returns:
- success (bool): Transaction success status
- tx_hash (str): Main withdrawal transaction hash
- error (str): Error message if failed
- tx_id (int): Database transaction ID
- fee_tx_hash (str): Fee transaction hash

Processing Flow:

Initialization & Validation

# Decrypt user's private key
private_key = decrypt_private_key(encrypted_private_key)
account = Account.from_key(private_key)

# Select network and contract
web3_client = bsc_web3  # BSC Web3 instance
contract_address = BEP20_USDT_CONTRACT

Gas Fee Check & Auto-Funding

user_bnb_balance = get_bnb_balance(account.address)
min_bnb_required = 0.00005

if user_bnb_balance < min_bnb_required:
    # Send 0.0001 BNB from admin wallet
    send_gas_fee_from_admin(account.address, 0.0001)
    wait_for_transaction_confirmation(gas_tx_hash, timeout=60)

Balance Verification

WITHDRAWAL_FEE = 0.1
total_required = amount + WITHDRAWAL_FEE

if balance_formatted < total_required:
    return False, "Insufficient balance"

Fee Transaction Processing

# Get current nonce
fee_nonce = web3_client.eth.get_transaction_count(account.address)

# Build fee transaction
fee_transaction = contract.functions.transfer(
    ADMIN_WALLET_ADDRESS,
    fee_amount_wei
).build_transaction({
    'from': account.address,
    'nonce': fee_nonce,
    'gas': 100000,
    'gasPrice': web3_client.eth.gas_price
})

# Sign and send
signed_fee = web3_client.eth.account.sign_transaction(fee_transaction, private_key)
fee_tx_hash = web3_client.eth.send_raw_transaction(signed_fee.rawTransaction)

# Wait for confirmation
wait_for_transaction_confirmation(fee_tx_hash, timeout=60)

Main Withdrawal Processing

# Use incremented nonce (nonce management is critical)
withdrawal_nonce = fee_nonce + 1

# Build withdrawal transaction
transaction = contract.functions.transfer(
    to_address,
    amount_wei
).build_transaction({
    'from': account.address,
    'nonce': withdrawal_nonce,
    'gas': 100000,
    'gasPrice': web3_client.eth.gas_price
})

# Sign and send
signed_txn = web3_client.eth.account.sign_transaction(transaction, private_key)
tx_hash = web3_client.eth.send_raw_transaction(signed_txn.rawTransaction)

Frontend Implementation:

Withdrawal Component: Wallet.js

const WITHDRAWAL_FEE = 0.1;

// Real-time validation
const availableBalance = wallet?.blockchain_balances?.total_usd || 0;
const maxWithdrawal = Math.max(0, availableBalance - WITHDRAWAL_FEE);

// Balance check before submission
const totalRequired = amount + WITHDRAWAL_FEE;
if (totalRequired > availableBalance) {
    setError(`Insufficient balance. Required: $${totalRequired.toFixed(2)}`);
    return;
}

// API call
const response = await withdrawFunds(amount, address, network, token);

API Endpoint: /api/wallet/withdraw

@app.route('/api/wallet/withdraw', methods=['POST'])
@jwt_required()
def withdraw_from_wallet():
    # Get user and validate
    # Check blockchain balance
    # Process withdrawal with fee
    # Return success with TX hashes

Database Schema:

Transactions Table:

transactions (
    id: INTEGER PRIMARY KEY,
    username: VARCHAR(255),
    type: VARCHAR(50),  -- 'withdrawal', 'withdrawal_fee', 'deposit', etc.
    amount: DECIMAL(10,2),
    currency: VARCHAR(20),  -- 'BEP20_USDT', 'POLYGON_USDC'
    status: VARCHAR(20),  -- 'pending', 'confirmed', 'failed'
    tx_hash: VARCHAR(255),  -- Blockchain transaction hash
    from_address: VARCHAR(255),
    to_address: VARCHAR(255),
    created_at: TIMESTAMP,
    metadata: JSON  -- Additional transaction details
)

Transaction Recording:

Each withdrawal creates 2 database entries:
1. type='withdrawal_fee', amount=0.10, to_address=admin_wallet
2. type='withdrawal', amount=user_amount, to_address=user_destination
Fee transactions filtered from user-facing transaction history
Both transactions maintain complete audit trail

Configuration:

# Environment Variables
WITHDRAWAL_FEE = 0.1  # Fixed $0.10 fee
ADMIN_WALLET_ADDRESS = "0x..."  # Fee recipient
BEP20_USDT_CONTRACT = "0x55d398326f99059ff775485246999027b3197955"
BSC_RPC_URL = "https://bsc-dataseed.binance.org/"
MIN_BNB_FOR_GAS = 0.00005  # Threshold for auto gas funding
GAS_FUNDING_AMOUNT = 0.0001  # BNB amount to send for gas

Error Handling:

All errors logged with emoji indicators (💰, ✅, ❌, ⚠️)
Transaction failures update database status
Failed transactions don't deduct from balance (except fee if already transferred)
Comprehensive error messages returned to frontend

Nonce Management (Critical):

Fee transaction uses current nonce
Main withdrawal uses incremented nonce (fee_nonce + 1)
Prevents transaction replacement and ensures proper ordering
Essential for reliable dual-transaction flow

Extension-Sale Site Integration

Authentication Flow

1. Extension Initialization

When extension starts:

Extension → Backend: POST /api/extension/init
{
  "username": "freelancer_username",
  "referrer": "optional_referrer"
}

Backend Response:

{
  "success": true,
  "isNewUser": true/false,
  "user": {
    "username": "freelancer_username",
    "currentPlan": "egg",
    "planExpireDate": "2025-12-31T23:59:59Z",
    "isExpired": false,
    "referrals": 5,
    "earnings": 42.50
  }
}

2. Sale Site Authentication

User logs in on sale site:

Google OAuth
Email/Password
Email verification required

JWT tokens generated:

Access Token (1 hour expiry)
Refresh Token (30 days expiry)

3. Extension-Sale Site Sync

Sync Process:

Extension → Sale Site: Check if user logged in
Sale Site → Backend: GET /api/extension/check_auth (with JWT)
Backend → Extension: Returns logged_in status and username

If logged in:
  Extension → Backend: POST /api/extension/sync
  {
    "freelancer_username": "john_doe"
  }
  Backend links: freelancer_username ↔ user_email
  
Extension → Backend: GET /api/extension/plan_info (with JWT)
Backend returns:
  {
    "plan_type": "egg",
    "plan_expire_date": timestamp,
    "plan_start_date": timestamp,
    "status": "Active"
  }

4. Plan Synchronization

Scenarios:

Scenario A: No Plan Purchased

{
  "success": true,
  "no_plan_purchased": true,
  "message": "Using extension free trial"
}

Scenario B: Active Plan

{
  "success": true,
  "plan_type": "egg",
  "plan_expire_date": 1735689599000,
  "plan_start_date": 1732924800000,
  "status": "Active"
}

Scenario C: Expired Plan

{
  "success": true,
  "plan_type": "egg",
  "plan_expire_date": 1732924800000,
  "status": "Expired"
}

Extension Start Tracking

Purpose: Track when users start using the extension

Process:

Extension calls /api/extension/register_start on first launch
Backend stores start_timestamp (milliseconds)
Timestamp persists across sessions
Used for analytics and trial management

Technical Architecture

Technology Stack

Frontend (Sale Site)

Framework: React 18
Routing: React Router v6
State Management: Context API
Styling: CSS Modules
HTTP Client: Fetch API
Authentication: JWT + Google OAuth

Backend (API Server)

Framework: Flask (Python)
Authentication: Flask-JWT-Extended
Database: MongoDB
Encryption: Cryptography library
Blockchain: Web3.py
Email: SMTP (Gmail)

Extension

Manifest: Version 3
Service Worker: Background.js
Content Scripts: Content.js
Storage: chrome.storage.local
Permissions: activeTab, storage, cookies, notifications

Database Schema

Users Collection

{
  username: String,
  email: String,
  password_hash: String (bcrypt),
  email_verified: Boolean,
  verification_token: String,
  currentPlan: String, // 'egg', 'zerger', etc.
  planExpireDate: DateTime,
  planStartDate: DateTime,
  wallet_address: String, // BSC address
  encrypted_private_key: String,
  referrer: String, // Username of referrer
  referrals: Number,
  earnings: Number, // USD
  pendingWithdrawal: Number, // Deprecated
  last_blockchain_balance: Number,
  createdAt: DateTime,
  updatedAt: DateTime
}

Transactions Collection

{
  username: String,
  type: String, // 'deposit', 'withdrawal', 'withdrawal_fee', 'purchase', 'referral_earning'
  amount: Number,
  currency: String, // 'BEP20_USDT'
  tx_hash: String, // Blockchain transaction hash
  status: String, // 'confirmed', 'pending', 'failed'
  from_address: String,
  to_address: String,
  metadata: Object,
  created_at: DateTime
}

Pending Payments Collection

{
  payment_id: String,
  username: String,
  plan_id: String,
  amount: Number,
  duration_days: Number,
  temp_wallet_address: String,
  temp_wallet_private_key_encrypted: String,
  referrer: String,
  referrer_wallet: String,
  referrer_amount: Number,
  admin_amount: Number,
  status: String, // 'waiting', 'received', 'transferring', 'completed', 'expired', 'failed'
  received_amount: Number,
  transfer_tx_hash_admin: String,
  transfer_tx_hash_referrer: String,
  expires_at: DateTime,
  created_at: DateTime,
  updated_at: DateTime
}

Extension Infos Collection

{
  freelancer_username: String,
  start_timestamp: Number, // milliseconds
  user_email: String, // Linked sale site account
  created_at: DateTime,
  updated_at: DateTime
}

Referrals Collection

{
  referrer: String,
  referred_user: String,
  plan: String,
  commission: Number,
  currency: String,
  tx_hash: String,
  date: DateTime
}

API Endpoints

Authentication

POST   /api/auth/signup              - Register with email/password
POST   /api/auth/login               - Login with email/password  
POST   /api/auth/google              - Login/Register with Google
POST   /api/auth/verify-email        - Verify email with token
POST   /api/auth/resend-verification - Resend verification email
POST   /api/auth/refresh             - Refresh access token
GET    /api/auth/me                  - Get current user

Extension Integration

POST   /api/extension/init           - Initialize extension
POST   /api/extension/register_start - Register start timestamp
POST   /api/extension/get_extension_info - Get extension info
GET    /api/extension/check_auth     - Check if logged in (JWT)
GET    /api/extension/plan_info      - Get plan info (JWT)
POST   /api/extension/sync           - Sync extension with account (JWT)

Payment

POST   /api/payment/direct/create    - Create direct crypto payment
POST   /api/payment/direct/verify    - Verify crypto payment
GET    /api/payment/direct/status/:id - Get payment status
POST   /api/wallet-payment/purchase  - Purchase with wallet balance
POST   /api/payment/auto/check/:id   - Auto-check payment status

Wallet

GET    /api/wallet/info              - Get wallet info with balance
GET    /api/wallet/transactions      - Get transaction history
POST   /api/wallet/withdraw          - Withdraw funds
POST   /api/wallet/deposit/verify    - Verify deposit transaction
GET    /api/wallet/balance/onchain   - Get on-chain balance

Pricing

GET    /api/pricing/plans            - Get all pricing plans (public)

Security Features

Password Security

Hashing: bcrypt with salt
Minimum Requirements: 8+ characters
No plaintext storage: Ever

JWT Authentication

Access Token: 1 hour expiry
Refresh Token: 30 days expiry
HttpOnly Cookies: Prevents XSS
CORS: Strict origin validation

Crypto Wallet Security

Private Key Encryption: AES-256
Encryption Key: Stored in environment variables
Never Exposed: Private keys never sent to client
Server-Side Signing: All transactions signed server-side

API Rate Limiting

Extension API: Respects Freelancer.com rate limits
Backend API: Rate limiting on sensitive endpoints
Blockchain Calls: Cached to reduce RPC calls

User Workflows

Workflow 1: New User Registration & First Purchase

1. User visits https://stormeye.app
   ↓
2. Clicks "Sign Up"
   ↓
3. Chooses registration method:
   - Email/Password
   - Google OAuth
   ↓
4. If Email: Verifies email via link
   ↓
5. System automatically creates:
   - User account
   - Crypto wallet (BSC)
   - Encrypted private key
   ↓
6. User browses pricing plans
   ↓
7. Selects a plan (e.g., Zerger - $15)
   ↓
8. Chooses payment method:
   
   Option A: Pay with Crypto
   - Temporary wallet address generated
   - Sends BEP20 USDT from exchange/wallet
   - Payment auto-verified on blockchain
   - Auto-split: $7.50 admin + $7.50 referrer
   - Plan activated
   
   Option B: Pay with Wallet
   - Checks wallet balance
   - Insufficient funds → Must deposit first
   - Sufficient funds → Transfers to admin
   - Plan activated
   - **Note**: No withdrawal fee for plan purchases
   ↓
9. Downloads Chrome extension
   ↓
10. Opens extension settings
    ↓
11. Extension detects Freelancer login
    ↓
12. Extension calls /api/extension/init
    ↓
13. User can now click "Sync with Sale Site"
    ↓
14. Extension checks JWT authentication
    ↓
15. Extension syncs plan info
    ↓
16. User configures bidding settings
    ↓
17. Starts automated bidding!

Workflow 2: Referral Earnings → Withdrawal

1. User gets referral link from dashboard
   ↓
2. Shares link on social media/forums
   ↓
3. Friend clicks link → ref=username stored
   ↓
4. Friend signs up and purchases Zerger ($15)
   ↓
5. System splits payment:
   - Admin: $7.50
   - Referrer (You): $7.50
   ↓
6. $7.50 deposited to your wallet instantly
   ↓
7. Transaction recorded with blockchain hash
   ↓
8. You see balance update in wallet dashboard
   ↓
9. Go to Wallet → Click "Withdraw"
   ↓
10. Enter:
    - Amount: $7.50
    - Destination: Your personal BSC wallet
    - Network: BSC (auto-selected)
    - Token: USDT (auto-selected)
    ↓
11. System checks:
    - Balance sufficient? ✓
    - BNB for gas? If not → Auto-fund 0.0001 BNB
    ↓
12. Withdrawal executed
    ↓
13. Transaction hash generated
    ↓
14. USDT arrives in your wallet (1-2 min)
    ↓
15. Transaction appears in history

Workflow 3: Using Extension for Automated Bidding

1. Install extension & log into Freelancer.com
   ↓
2. Extension detects login automatically
   ↓
3. Open extension settings page
   ↓
4. Configure Country Filters:
   - Block: India, Pakistan, Bangladesh
   - Or Allow: USA, UK, Canada, Australia
   ↓
5. Configure Client Filters:
   - ✓ Payment Verified
   - ✓ Email Verified
   - ✓ Deposit Made
   ↓
6. Configure Budget:
   Fixed Projects:
   - If $100-$500 → Bid $120, Deliver in 7 days
   - If $500-$1000 → Bid $580, Deliver in 14 days
   
   Hourly Projects:
   - Use own rate: $50/hour
   ↓
7. Configure Proposal:
   Choose method:
   - Template (with shortcodes)
   - Freelancer's AI
   - Custom AI (Claude/GPT)
   ↓
8. If NDA/IP projects:
   - Add signature details
   - Extension will auto-sign
   ↓
9. Enable sound notification (optional)
   ↓
10. Click extension icon → Start Bidding
    ↓
11. Extension monitors Freelancer.com:
    - Checks new projects every 30 seconds
    - Applies all filters
    - Generates proposals
    - Submits bids automatically
    ↓
12. For each successful bid:
    - Sound notification plays (if enabled)
    - Project tab opens (if enabled)
    - Bid logged in history
    - Counter updated
    ↓
13. View bid history:
    - All bids with timestamps
    - Direct links to projects
    - Success/failure status

Workflow 4: Using Referral Earnings to Buy Plans

1. Earned $15 from referrals
   ↓
2. Wallet shows: $15 available
   ↓
3. Current plan expires in 2 days
   ↓
4. Go to Pricing page
   ↓
5. Select Zerger plan ($15 for 3 months)
   ↓
6. Click "Purchase"
   ↓
7. Choose "Pay with Wallet"
   ↓
8. System checks balance: $15 available ✓
   ↓
9. System executes transfer:
   - Check BNB for gas
   - If low → Auto-fund from admin wallet
   - Transfer $15 to admin wallet
   - No referrer split (your own purchase)
   ↓
10. Plan activated immediately
    ↓
11. Extension syncs automatically
    ↓
12. New plan active: Zerger (3 months)
    ↓
13. Wallet balance: $0
    ↓
14. Continue bidding with new plan!

Workflow 5: Failed Referrer Payment Scenario

1. Your referral purchases Terranium ($36)
   ↓
2. System attempts split:
   - Admin transfer: $18 → SUCCESS ✓
   - Referrer transfer: $18 → FAILED ✗
   ↓
3. Purchase still completes:
   - User's plan activated
   - Admin received payment
   ↓
4. System logs failed referrer transfer:
   - Referrer wallet address
   - Amount: $18
   - Admin TX hash (for reference)
   - Error message
   ↓
5. Your earnings recorded as "pending":
   - Shows in dashboard
   - Status: Pending manual payout
   ↓
6. Admin reviews failed transfers daily
   ↓
7. Manual payout processed within 24 hours:
   - Admin sends $18 directly to your wallet
   - Transaction hash recorded
   - Status updated to "confirmed"
   ↓
8. Email notification sent
   ↓
9. Balance available for withdrawal

Best Practices

For Users

Setting Up Extension

Start with conservative filters: Don't block too many countries initially
Test proposal templates: Create multiple variants and test which works best
Monitor bid logs: Check which projects you're winning
Adjust budgets: Update based on your win rate
Use AI wisely: Custom AI can be expensive, template works for most cases

Managing Referrals

Share strategically: Target freelancer communities and forums
Create content: Write blog posts or YouTube videos about the tool
Track performance: Monitor which channels bring most referrals
Withdraw regularly: Don't let earnings sit idle
Reinvest earnings: Use to extend your own subscription

Wallet Security

Backup wallet: Save your wallet address safely
Never share private key: System handles everything
Verify addresses: Double-check before withdrawing
Use correct network: Always BSC for USDT
Keep small amounts: Withdraw larger earnings regularly

For Administrators

Payment Processing

Monitor temporary wallets: Check for stuck payments
Handle failed referrer transfers: Process manually within 24 hours
Monitor gas prices: Adjust gas funding amounts if BSC fees spike
Verify blockchain transactions: Always confirm on BSCScan
Keep admin wallet funded: Ensure enough BNB for gas funding

User Support

Email verification issues: Check spam folders, resend if needed
Payment not confirmed: Check blockchain explorer, may need more confirmations
Wrong network deposits: Educate users about BEP20 on BSC only
Extension not syncing: Verify JWT tokens, check CORS settings
Referral not credited: Check referral collection in database

Troubleshooting Guide

Extension Issues

Extension not detecting login:

Clear browser cookies
Log out and log back into Freelancer.com
Click "Refresh Status" in extension
Check if cookies are enabled

Bids not submitting:

Verify Freelancer.com account is active
Check if you have enough connects
Verify project filters aren't too restrictive
Check browser console for errors

AI proposal generation failing:

Verify API key is correct
Check API quota/billing
Try different AI provider
Fall back to template method

Payment Issues

Payment not confirmed:

Wait for blockchain confirmation (1-2 minutes)
Check transaction on BSCScan
Verify sent to correct address
Verify correct network (BSC, not ETH/TRC20)

Wallet balance not updating:

Click refresh button
Wait 30 seconds for auto-refresh
Check blockchain explorer
Verify transaction confirmed

Withdrawal failed:

Check if sufficient balance
Verify destination address
Check if address is BSC compatible
Contact support if gas funding failed

Account Issues

Email not verified:

Check spam/junk folder
Request new verification email
Wait 5 minutes between requests
Contact support if persistent

Plan not activating:

Verify payment completed
Check transaction status
Refresh extension (reload settings page)
Check plan expiry date in dashboard

Referral not credited:

Verify referred user completed purchase
Check if referral link was used correctly
Wait 5 minutes for system processing
Check transaction history

API Reference (Quick)

Base URL

Production: https://stormeye-backend-server.onrender.com
Development: http://localhost:5000

Authentication Headers

{
  "Authorization": "Bearer <access_token>",
  "Content-Type": "application/json"
}

Example Requests

Get Pricing Plans (Public)

curl https://stormeye-backend-server.onrender.com/api/pricing/plans

Response:

{
  "success": true,
  "plans": [
    {
      "id": "egg",
      "name": "Egg",
      "price": 6,
      "originalPrice": 10,
      "duration": "1 Month",
      "duration_days": 30,
      "avatar": "🥚",
      "features": ["Perfect for starters", "Save 40% cost"],
      "highlight": false,
      "color": "#ffd700"
    }
  ]
}

Create Direct Crypto Payment

curl -X POST \
  https://stormeye-backend-server.onrender.com/api/payment/direct/create \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "egg"
  }'

Response:

{
  "success": true,
  "payment_id": "abc123def456...",
  "amount": 6,
  "temp_wallet_address": "0x1234567890abcdef...",
  "expires_at": "2025-10-22T12:30:00Z",
  "referrer": "john_doe",
  "referrer_amount": 3
}

Get Wallet Info

curl -X GET \
  https://stormeye-backend-server.onrender.com/api/wallet/info \
  -H "Authorization: Bearer <token>"

Response:

{
  "success": true,
  "wallet": {
    "wallet_address": "0x1234567890abcdef...",
    "wallet_balance": 42.50,
    "earnings": 42.50,
    "blockchain_balances": {
      "bep20_usdt": 42.50,
      "total_usd": 42.50
    }
  }
}

Withdraw Funds

curl -X POST \
  https://stormeye-backend-server.onrender.com/api/wallet/withdraw \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 20.00,
    "to_address": "0xabcdef1234567890...",
    "network": "bsc",
    "token": "usdt"
  }'

Response:

{
  "success": true,
  "message": "Withdrawal of $20.00 initiated",
  "tx_hash": "0x9876543210fedcba...",
  "explorer_url": "https://bscscan.com/tx/0x9876543210fedcba..."
}

Configuration Files

Pricing Configuration (pricing.json)

{
  "plans": [
    {
      "id": "egg",
      "name": "Egg",
      "price": 6,
      "originalPrice": 10,
      "duration": "1 Month",
      "duration_days": 30,
      "avatar": "🥚",
      "avatarType": "emoji",
      "features": [
        "Perfect for starters",
        "Save 40% cost"
      ],
      "highlight": false,
      "color": "#ffd700"
    }
  ]
}

Environment Variables

Backend (.env)

# Database
MONGODB_URI=mongodb+srv://...

# JWT
SECRET_KEY=your-secret-key
JWT_SECRET_KEY=your-jwt-secret-key

# Email
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your-email@gmail.com
SMTP_PASSWORD=your-app-password

# Crypto Wallet
WALLET_ENCRYPTION_KEY=your-encryption-key
ADMIN_PRIVATE_KEY=your-admin-private-key

# BSC RPC
BSC_RPC_URL=https://bsc-dataseed.binance.org/

# Referral
REFERRAL_COMMISSION_RATE=0.5

# Pricing
PRICING_CONFIG_FILE=config/pricing.json

# Frontend URL
FRONTEND_URL=https://stormeye.app

Frontend (.env)

REACT_APP_API_URL=https://stormeye-backend-server.onrender.com
REACT_APP_BASE_URL=https://stormeye.app
REACT_APP_GOOGLE_CLIENT_ID=your-google-client-id

Deployment Guide

Backend Deployment (Render.com)

Create Web Service
- Connect GitHub repository
- Select backend folder
- Environment: Python 3
Configure Build Command
```
pip install -r requirements.txt
```
Configure Start Command
```
gunicorn app:app
```
Add Environment Variables
- Copy all from .env.example
- Update with production values
Deploy
- Automatic deployment on git push
- Monitor logs for errors

Frontend Deployment (Vercel/Netlify)

Build Configuration
- Build Command: npm run build
- Output Directory: build
- Node Version: 18.x
Environment Variables
- REACT_APP_API_URL
- REACT_APP_BASE_URL
- REACT_APP_GOOGLE_CLIENT_ID
Domain Configuration
- Add custom domain: stormeye.app
- Configure DNS records
- Enable HTTPS (automatic)

Extension Publishing (Chrome Web Store)

Prepare Extension
- Update manifest.json with production URLs
- Remove development permissions
- Update icons and screenshots

Create ZIP

cd Fab
zip -r stormeye-extension.zip . -x "*.git*" "node_modules/*" ".env"

Upload to Chrome Web Store
- Pay $5 one-time developer fee
- Upload ZIP file
- Fill in store listing details
- Submit for review
Privacy Policy
- Required for Chrome Web Store
- Host on stormeye.app/privacy
- Include data collection details

Support & Contact

For Users

Website: https://stormeye.app
Email: support@stormeye.app
Documentation: https://stormeye.app/docs

For Developers

GitHub: (Private repositories)
API Docs: https://stormeye.app/api-docs
Status: https://status.stormeye.app

Emergency Contact

Critical Issues: admin@stormeye.app
Security Issues: security@stormeye.app
Response Time: 24 hours

Changelog

Version 1.0.0 (Current)

Extension Features:

✓ Automated bidding on Freelancer.com
✓ AI proposal generation (Template, Freelancer AI, Custom AI)
✓ Advanced project filtering (Country, Client, Budget)
✓ Automatic NDA/IP contract signing
✓ Bid logging and history
✓ Sound notifications

Sale Site Features:

✓ User registration (Email, Google OAuth)
✓ 5 pricing plans with discounts
✓ Crypto payment processing (BEP20 USDT)
✓ Wallet payment option
✓ 50% referral commission
✓ Crypto wallet management
✓ Withdrawal system
✓ Real-time balance updates
✓ Transaction history

Backend Features:

✓ JWT authentication
✓ MongoDB database
✓ Blockchain integration (BSC)
✓ Automatic payment splitting
✓ Gas fee management
✓ Email verification
✓ RESTful API

Future Roadmap

Planned Features

Q1 2026:

Mobile app (iOS/Android)
Additional payment methods (Card payments via Stripe)
More AI providers (Anthropic Claude Opus, Grok)
Advanced analytics dashboard
Bid success rate tracking

Q2 2026:

Multi-platform support (Upwork, Fiverr)
Team collaboration features
API for third-party integrations
Webhook notifications
White-label solution

Q3 2026:

Machine learning bid optimization
Automatic skill matching
Portfolio integration
Client relationship management
Invoice generation

Q4 2026:

Multiple wallet support (Polygon, Arbitrum)
Fiat payment options
Subscription management
Advanced reporting
Premium support tiers

Legal & Compliance

Terms of Service

Users must be 18+ years old
Freelancer.com account required
Comply with Freelancer.com ToS
No spam or abusive bidding
Referral fraud prohibited

Privacy Policy

Data encryption at rest and in transit
No selling of user data
GDPR compliant
Email used for notifications only
Wallet keys stored encrypted

Refund Policy

7-day money-back guarantee
Pro-rated refunds on request
No refunds for completed months
Referral earnings non-refundable

Glossary

BEP20: Token standard on Binance Smart Chain (BSC)

BSC: Binance Smart Chain - blockchain network for smart contracts

Gas Fee: Transaction fee on blockchain networks

JWT: JSON Web Token - authentication method

NDA: Non-Disclosure Agreement

IP Agreement: Intellectual Property Agreement

TX Hash: Transaction Hash - unique identifier for blockchain transactions

USDT: Tether - stablecoin pegged to USD

Wallet: Cryptocurrency wallet for storing and sending crypto

RPC: Remote Procedure Call - communication protocol for blockchain

Chrome Extension: Browser add-on that extends functionality

Service Worker: Background script that runs without UI

Content Script: Script that runs in webpage context

OAuth: Open standard for access delegation (Google login)

Appendix

Supported Countries (195 total)

Full list available in extension settings. Notable countries:

🇺🇸 United States
🇬🇧 United Kingdom
🇨🇦 Canada
🇦🇺 Australia
🇩🇪 Germany
🇮🇳 India
🇵🇰 Pakistan
... (and 188 more)

Supported Currencies

USD - US Dollar
EUR - Euro
GBP - British Pound
AUD - Australian Dollar
CAD - Canadian Dollar
INR - Indian Rupee
... (Freelancer.com supported currencies)

Blockchain Explorers

BSC: https://bscscan.com
Polygon (future): https://polygonscan.com

Document Version: 1.0.0
Last Updated: October 22, 2025
Maintained By: StormEye Development Team

This documentation is subject to change as the system evolves. Always refer to the latest version at https://stormeye.app/docs

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
README.md		README.md

PLSpeak/StormEye_Documentation

Folders and files

Latest commit

History

Repository files navigation

StormEye - Comprehensive System Documentation

Table of Contents

System Overview

Core Components

Extension Features

1. AI Proposal Generation

a) Template-Based Proposals

b) Freelancer's AI

c) Custom AI Integration

2. Advanced Project Filtering

Country Filters

Client Filters

Project Type Filters

Delivery Time Filters

Budget Configuration

Skill Matching

3. Bid Management

Milestone Configuration

Profile Selection

Bid Logging

4. Contract Handling

5. Login Status Detection

6. Automation Features

Pricing Plans

Plan Comparison

Plan Features

Payment Methods

1. Direct Crypto Payment

2. Wallet Payment

Referral System

Commission Structure

Referral Link Format

How It Works

Step 1: Share Your Link

Step 2: User Signs Up

Step 3: User Purchases

Step 4: Instant Payout

Earnings Examples

Tracking Referrals

Referral Earnings Management

Wallet Management

Wallet Creation

Wallet Features

1. Real-Time Balance

2. Transaction History

3. Deposit Funds

4. Withdraw Funds

Withdrawal Process

Withdrawal Fee Structure

Standard Withdrawal (From Wallet)

Withdrawal Scenarios

Withdrawal from Referral Earnings

Transaction History Entries

Important Notes

Technical Implementation Details (For Developers)

Extension-Sale Site Integration

Authentication Flow

1. Extension Initialization

2. Sale Site Authentication

3. Extension-Sale Site Sync

4. Plan Synchronization

Extension Start Tracking

Technical Architecture

Technology Stack

Frontend (Sale Site)

Backend (API Server)

Extension

Database Schema

Users Collection

Transactions Collection

Pending Payments Collection

Extension Infos Collection

Referrals Collection

API Endpoints

Authentication