PRIV ProtocolPRIV Docs
Mobile App

Earnings

How to earn PRIV tokens through mobile VPN usage, view your earnings, and claim to your wallet.

Mobile Earnings

Earn PRIV tokens through VPN usage on your mobile device. This guide covers how earnings work, how to track them, and how to claim to your wallet.


How You Earn

Earning Sources

The mobile app supports multiple earning sources:

SourceDescriptionTypical Earnings
VPN SessionsTime connected to VPN~0.05 PRIV/hour
Data TransferBytes sent through VPN~0.001 PRIV/MB
Peak BonusesUsage during high-demand times1.5x multiplier
Region BonusesUsage in underserved areasUp to 2x multiplier

Session-Based Earnings

Earnings are calculated per VPN session:

interface SessionEarnings {
  baseRate: number       // PRIV per hour (~0.05)
  dataRate: number       // PRIV per MB (~0.001)
  peakMultiplier: number // 1.0 - 1.5x
  regionMultiplier: number // 1.0 - 2.0x
}

// Calculation
totalEarnings = (hours * baseRate + megabytes * dataRate)
                * peakMultiplier
                * regionMultiplier

Earnings Example

Typical 2-hour session:

Duration: 2 hours
Data: 500 MB
Time: Peak hours (1.5x)
Region: US East (1.0x)

Base earnings:   2 * 0.05 = 0.10 PRIV
Data earnings:   500 * 0.001 = 0.50 PRIV
Subtotal:        0.60 PRIV
Peak bonus:      0.60 * 1.5 = 0.90 PRIV

Total earned: 0.90 PRIV

Earnings Dashboard

Accessing Earnings

Tap the "Earnings" tab to see your complete earnings dashboard.

Balance Overview

The top card shows your balance:

+----------------------------------+
|         Total Earned             |
|         12.4567 PRIV             |
|                                  |
|  +--------+ +--------+ +--------+|
|  | Today  | |Pending | |Claimable|
|  | +0.05  | | 0.23   | | 11.96  ||
|  +--------+ +--------+ +--------+|
+----------------------------------+

Balance Types:

TypeDescription
Total EarnedLifetime PRIV accumulated
TodayEarnings from today's sessions
PendingRecent earnings awaiting confirmation (24-48h)
ClaimableConfirmed earnings ready to withdraw

Weekly Chart

Visual chart of last 7 days:

  • Each bar represents one day
  • Height corresponds to earnings
  • Today is highlighted
  • Tap any bar for details

Earnings by Source

Breakdown showing where your PRIV comes from:

VPN Usage        ████████████ 65%
Contributions    ████████     35%
Labeling         ██           8%
Referrals        █            4%

Each source shows:

  • Total PRIV earned
  • Percentage of total
  • Progress bar visualization

Earnings Summary API

Fetching Your Earnings

The app uses these API endpoints:

Get Earnings Summary:

GET /api/v1/user/earnings

Response:
{
  "total_earned": 12.4567,
  "today_earnings": 0.0523,
  "pending_amount": 0.2341,
  "claimable_amount": 11.9603,
  "last_claim_at": "2025-01-20T15:30:00Z",
  "earnings_by_source": {
    "vpn": 8.1234,
    "contributions": 3.2100,
    "labeling": 0.9876,
    "referrals": 0.1357
  }
}

Get Daily Earnings:

GET /api/v1/user/earnings/daily?days=7

Response:
{
  "daily_earnings": [
    { "date": "2025-01-22", "amount": 0.0523 },
    { "date": "2025-01-21", "amount": 0.1234 },
    // ... last 7 days
  ]
}

Get Transaction History:

GET /api/v1/user/earnings/transactions?limit=20

Response:
{
  "transactions": [
    {
      "id": "txn_123",
      "amount": 0.0234,
      "source": "vpn",
      "status": "confirmed",
      "created_at": "2025-01-22T10:30:00Z"
    },
    // ...
  ]
}

Claiming Earnings

Requirements

To claim your earnings:

  • Connected wallet - MetaMask, Coinbase Wallet, or WalletConnect
  • Minimum balance - At least 10 PRIV claimable
  • Network - Wallet on Base network

Claim Process

  1. Open Earnings Tab

    • View your claimable balance
  2. Tap "Claim to Wallet"

    • Confirm the amount to claim
  3. Confirm Transaction

    • Review gas fees (~$0.01 on Base)
    • Approve in your wallet app
  4. Wait for Confirmation

    • Transaction processes on-chain
    • Usually complete in seconds
  5. Success!

    • PRIV tokens in your wallet
    • Claimable balance reset

Claim Flow (Code)

// Initiate claim
const claimResponse = await fetch('/api/v1/user/earnings/claim', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${session.access_token}`,
    'Content-Type': 'application/json'
  }
})

// Response includes transaction hash
{
  "success": true,
  "transaction_hash": "0x...",
  "amount_claimed": 11.9603,
  "new_claimable_balance": 0
}

Claim Limits

ParameterValue
Minimum claim10 PRIV
Maximum claimEntire claimable balance
Claim frequencyNo limit
Gas fees~$0.01 (Base L2)
Processing time1-60 seconds

Gas fees are paid from your wallet, not deducted from your PRIV balance.


Transaction History

Viewing History

The Earnings tab shows recent transactions:

+----------------------------------+
| Recent Transactions              |
+----------------------------------+
| [shield] VPN Session             |
|   +0.0234 PRIV    Jan 22, 10:30 |
|   [confirmed]                    |
+----------------------------------+
| [shield] VPN Session             |
|   +0.0156 PRIV    Jan 22, 09:15 |
|   [confirmed]                    |
+----------------------------------+
| [arrow-up] Claim                 |
|   -5.0000 PRIV    Jan 21, 18:00 |
|   [claimed]                      |
+----------------------------------+

Transaction Status

StatusMeaning
PendingSession ended, awaiting verification (24-48h)
ConfirmedVerified, added to claimable balance
ClaimedWithdrawn to wallet
FailedError processing (rare)

Filtering History

Filter transactions by:

  • Time period (today, week, month, all)
  • Source (VPN, contributions, labeling, referrals)
  • Status (pending, confirmed, claimed)

Maximizing Earnings

Tips for More PRIV

  1. Longer Sessions

    • Hourly rate compounds over time
    • Keep VPN connected while using phone
  2. Peak Hours

    • Evening hours (6 PM - 11 PM local) often have bonuses
    • Check the app for current multipliers
  3. Use More Data

    • Streaming, downloads, and updates earn data bonuses
    • Normal browsing earns less but still counts
  4. Multiple Devices

    • Desktop plugin + mobile app = more earnings
    • Earnings from all sources combine
  5. Stay Connected

    • Brief disconnections reset session bonuses
    • Use auto-reconnect feature

Earnings Limits

To ensure fair distribution:

LimitValueReason
Daily cap10 PRIVPrevent gaming
Minimum session5 minutesQuality data
Max rate boost3xReasonable limits

Daily caps reset at midnight UTC. Plan your highest-earning activities accordingly.


Earnings Calculation Details

Base Rates

Current base rates (subject to change):

const EARNING_RATES = {
  // Per hour of VPN connection
  baseHourlyRate: 0.05,

  // Per MB of data transferred
  dataRatePerMB: 0.001,

  // Minimum session for any earnings
  minSessionMinutes: 5,

  // Daily maximum
  dailyCap: 10,
}

Multipliers

Peak Hours (Region-Specific):

const PEAK_HOURS = {
  'US': { start: 18, end: 23, multiplier: 1.5 },
  'EU': { start: 19, end: 24, multiplier: 1.5 },
  'APAC': { start: 20, end: 1, multiplier: 1.4 },
}

Regional Bonuses:

const REGION_BONUSES = {
  'US-EAST': 1.0,
  'US-WEST': 1.0,
  'EU': 1.1,
  'LATAM': 1.5,
  'APAC': 1.3,
  'AFRICA': 2.0, // Underserved region bonus
}

Real-Time Calculation

While connected, the app shows estimated earnings:

// Updates every second
const estimatedEarnings = useMemo(() => {
  const hours = elapsedSeconds / 3600
  const megabytes = bytesTransferred / (1024 * 1024)

  const base = hours * RATES.baseHourlyRate
  const data = megabytes * RATES.dataRatePerMB
  const multiplied = (base + data) * currentMultiplier

  return Math.min(multiplied, dailyRemaining)
}, [elapsedSeconds, bytesTransferred, currentMultiplier])

Unified Earnings

Cross-Platform Balance

Your PRIV balance is unified across:

  • Mobile app (VPN sessions)
  • Desktop plugin (browsing data)
  • Web dashboard (labeling tasks)

All earnings flow to the same account.

Viewing Unified Balance

The Earnings tab shows earnings from all sources:

{
  "earnings_by_source": {
    "vpn": 8.1234,         // Mobile VPN sessions
    "contributions": 3.21,  // Desktop browsing data
    "labeling": 0.98,       // Web labeling tasks
    "referrals": 0.13       // Referral program
  },
  "total_earned": 12.4567
}

Claiming Unified Earnings

When you claim, all claimable PRIV from all sources is transferred:

Desktop plugin earnings: 3.50 PRIV
Mobile VPN earnings:     6.25 PRIV
Labeling earnings:       0.75 PRIV
---------------------------------
Total claimable:        10.50 PRIV

Troubleshooting

Earnings Not Showing

1. Wait 5 minutes after session ends
2. Pull to refresh the Earnings tab
3. Check internet connectivity
4. Sign out and sign back in
5. Contact support if persists > 1 hour

Pending for Too Long

If earnings are pending for more than 48 hours:

1. Check session actually completed
2. Verify minimum session time (5 min) was met
3. Look for error notifications
4. Contact support with session ID

Claim Failed

1. Ensure wallet is connected
2. Check you have ETH for gas (~$0.01)
3. Verify wallet is on Base network
4. Try reconnecting wallet
5. Retry the claim

Balance Discrepancy

If your balance seems wrong:

1. Check all source breakdowns
2. Review transaction history
3. Account for pending amounts
4. Note daily cap limits
5. Contact support with details

FAQs

Q: Why do earnings take 24-48 hours to confirm?

A: We verify session data to prevent fraud. This ensures fair earnings for everyone.

Q: Can I earn while sleeping?

A: Yes! Keep the VPN connected and you earn passively. Just note iOS may disconnect after extended background time.

Q: Do I lose earnings if I uninstall?

A: No. Earnings are stored on our servers. Reinstall and sign in to access them.

Q: Why did my earnings rate change?

A: Rates vary based on network demand, time of day, and region. Check the app for current rates.

Q: Is there a minimum to claim?

A: Yes, 10 PRIV minimum. This keeps transaction costs reasonable.


Next Steps