Installation

Install the PRIV Chrome extension to start earning from your browsing data.

Supported Browsers

Chrome Web Store

The PRIV extension will be available on the Chrome Web Store soon.

Coming Soon - Chrome Web Store Link

Once published, installation is one click:

1. Visit the Chrome Web Store listing
2. Click "Add to Chrome"
3. Confirm the installation

Manual Installation (Developer Mode)

For testing or development, install the extension manually.

Step 1: Download the Extension

Download the latest release from GitHub:

git clone https://github.com/priv-protocol/priv-protocol.git
cd priv-protocol/extensions/chrome

Step 2: Install Dependencies and Build

# Install dependencies
npm install

# Build for production
npm run build:prod

The built extension will be in the dist/ folder.

Step 3: Load in Chrome

1. Open Chrome and navigate to chrome://extensions
2. Enable Developer mode using the toggle in the top right
3. Click Load unpacked
4. Select the extensions/chrome/dist folder

[Screenshot: Chrome extensions page with Developer mode enabled and Load unpacked button highlighted]

Step 4: Pin the Extension

1. Click the puzzle piece icon in Chrome toolbar
2. Find "PRIV Protocol" in the list
3. Click the pin icon to keep it visible

Build from Source

For contributors and developers who want the latest features.

Prerequisites

Build Commands

# Clone the repository
git clone https://github.com/priv-protocol/priv-protocol.git
cd priv-protocol/extensions/chrome

# Install dependencies
npm install

# Development build with watch mode
npm run dev

# Production build
npm run build:prod

# Run tests
npm test

Development vs Production Build

Initial Setup

After installation, configure the extension.

1. Open the Extension

Click the PRIV icon in your Chrome toolbar to open the popup.

2. Connect Your Wallet

1. Click Connect Wallet
2. Select MetaMask or your preferred wallet
3. Approve the connection request
4. Your wallet address will appear in the header

3. Configure Data Sharing

1. Toggle Data Sharing to enable collection
2. Select which data types you want to share
3. Review the estimated earnings for each type

Permissions Explained

The extension requests specific permissions for functionality.

Host Permissions

The extension connects to these domains:

• api.privprotocol.xyz - API server for data submission
• *.supabase.co - Backend services

What We Don't Do

The extension does NOT:

• Access your passwords or form data
• Read your email or messages
• Track in incognito mode
• Access banking or healthcare sites
• Send unencrypted data

Updating the Extension

Chrome Web Store

Updates are automatic. Chrome checks for updates periodically.

Manual Installation

For manual installations, update by rebuilding:

cd priv-protocol/extensions/chrome
git pull origin main
npm install
npm run build:prod

Then reload the extension:

1. Go to chrome://extensions
2. Find PRIV Protocol
3. Click the refresh icon

Uninstalling

Remove from Chrome

1. Right-click the PRIV icon in your toolbar
2. Select Remove from Chrome
3. Confirm removal

Data After Uninstall

• Local data: Deleted when you uninstall
• Wallet earnings: Remain in your connected wallet
• Server data: Contact support to delete

Verification

Confirm the extension is working correctly.

Check Status

1. Click the PRIV icon
2. Verify the status shows Connected (green indicator)
3. Check that your wallet address appears

Test Data Collection

1. Enable data sharing and browsing history
2. Visit a few websites
3. Open the extension
4. Check that data points are increasing

Debug Information

Open Chrome DevTools for the extension:

1. Go to chrome://extensions
2. Find PRIV Protocol
3. Click Inspect views: service worker
4. Check the Console tab for logs

Next Steps

• How It Works - Understand the architecture
• Data Types - Learn what data you can share
• Wallet Integration - Connect your wallet