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:
| Source | Description | Typical Earnings |
|---|---|---|
| VPN Sessions | Time connected to VPN | ~0.05 PRIV/hour |
| Data Transfer | Bytes sent through VPN | ~0.001 PRIV/MB |
| Peak Bonuses | Usage during high-demand times | 1.5x multiplier |
| Region Bonuses | Usage in underserved areas | Up 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
* regionMultiplierEarnings 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 PRIVEarnings 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:
| Type | Description |
|---|---|
| Total Earned | Lifetime PRIV accumulated |
| Today | Earnings from today's sessions |
| Pending | Recent earnings awaiting confirmation (24-48h) |
| Claimable | Confirmed 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
-
Open Earnings Tab
- View your claimable balance
-
Tap "Claim to Wallet"
- Confirm the amount to claim
-
Confirm Transaction
- Review gas fees (~$0.01 on Base)
- Approve in your wallet app
-
Wait for Confirmation
- Transaction processes on-chain
- Usually complete in seconds
-
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
| Parameter | Value |
|---|---|
| Minimum claim | 10 PRIV |
| Maximum claim | Entire claimable balance |
| Claim frequency | No limit |
| Gas fees | ~$0.01 (Base L2) |
| Processing time | 1-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
| Status | Meaning |
|---|---|
| Pending | Session ended, awaiting verification (24-48h) |
| Confirmed | Verified, added to claimable balance |
| Claimed | Withdrawn to wallet |
| Failed | Error 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
-
Longer Sessions
- Hourly rate compounds over time
- Keep VPN connected while using phone
-
Peak Hours
- Evening hours (6 PM - 11 PM local) often have bonuses
- Check the app for current multipliers
-
Use More Data
- Streaming, downloads, and updates earn data bonuses
- Normal browsing earns less but still counts
-
Multiple Devices
- Desktop plugin + mobile app = more earnings
- Earnings from all sources combine
-
Stay Connected
- Brief disconnections reset session bonuses
- Use auto-reconnect feature
Earnings Limits
To ensure fair distribution:
| Limit | Value | Reason |
|---|---|---|
| Daily cap | 10 PRIV | Prevent gaming |
| Minimum session | 5 minutes | Quality data |
| Max rate boost | 3x | Reasonable 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 PRIVTroubleshooting
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 hourPending 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 IDClaim 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 claimBalance 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 detailsFAQs
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
- VPN Guide - Optimize your VPN usage
- Data Collection - Understand what's collected
- Development Guide - Contribute to the app