Smart Contracts

Overview

PRIV Protocol is built on Base (Chain ID: 8453) using Solidity 0.8.24. The protocol consists of 22 smart contracts that work together to enable privacy-preserving data exchange, advertising, staking, and governance.

Network Information

Deployment Order

The contracts must be deployed in a specific order due to dependencies:

graph TD
    A[1. PRIVToken] --> B[2. PRIVTimelock]
    A --> C[3. PRIVGovernor]
    B --> C
    A --> D[4. PRIVStaking]
    A --> E[5. FeeManager]
    E --> F[6. DataXchange]
    E --> G[7. AdNetwork]
    A --> H[8. DataContribution]
    A --> I[9. LabelingRewards]
    E --> J[10. DataWalletMarketplace]
    A --> K[11. TokenDistributionV2]
    A --> M[12. MintingController]
    A --> N[13. FounderPerformanceBond]
    A -.-> L[14. FounderVesting ARCHIVED]

    subgraph "Token Layer"
        A
    end

    subgraph "Governance Layer"
        B
        C
    end

    subgraph "Fee Infrastructure"
        E
    end

    subgraph "Application Layer"
        D
        F
        G
        H
        I
        J
    end

    subgraph "Distribution Layer"
        K
        M
        N
        L
    end

Deployment Steps:

1. PRIVToken - Deploy first as the base token for the ecosystem
2. PRIVTimelock - Deploy with initial delay (2 days recommended)
3. PRIVGovernor - Deploy with PRIVToken and PRIVTimelock addresses
4. PRIVStaking - Deploy with PRIVToken address
5. FeeManagerV2 - Deploy with PRIVToken, staking, and treasury addresses
6. DataXchange - Deploy with PRIVToken and FeeManagerV2 addresses
7. AdNetwork - Deploy with PRIVToken, FeeManager, and oracle addresses
8. DataContribution - Deploy with PRIVToken and oracle addresses
9. LabelingRewards - Deploy with PRIVToken and oracle addresses
10. DataWalletMarketplace - Deploy with PRIVToken and FeeManager addresses
11. TokenDistributionV2 - Deploy with PRIVToken and beneficiary addresses
12. MintingController - Deploy with PRIVToken address; configure phase caps (10M/5M/2M)
13. FounderPerformanceBond - Deploy with PRIVToken and TVL oracle addresses; configure milestone amounts ($1M/$5M/$10M/$25M)
14. FounderVesting - (Archived -- will NOT be deployed to mainnet) Standalone founder vesting, superseded by TokenDistributionV2
15. PriceOracle - Deploy with Chainlink feed addresses
16. PricingEngine - Deploy with PRIVToken, PriceOracle, and USDC addresses
17. Treasury - Deploy with multi-sig configuration
18. TreasuryManager - Deploy with Treasury and PRIVToken addresses
19. BountyEscrow - Deploy with PRIVToken, FeeManagerV2, and oracle addresses
20. ApproverRegistry - Deploy with PRIVToken address; register as BountyEscrow oracle
21. PRIVStakingV2 - Deploy with PRIVToken address and reward rate; fund rewards pool

Deployments

Base Mainnet

Base Sepolia (Testnet)

All 22 contracts deployed and verified. See packages/contracts/deployments/base-sepolia.json for full address list.

Architecture

                         +-----------------+
                         |   PRIVToken     |
                         |  (ERC20Votes)   |
                         +--------+--------+
                                  |
        +------------+------------+------------+------------+
        |            |            |            |            |
        v            v            v            v            v
+-------------+ +----------+ +----------+ +----------+ +----------+
| PRIVStaking | | DataX-   | | AdNetwork| | Data-    | | Labeling |
|             | | change   | |          | | Contrib  | | Rewards  |
+-------------+ +----------+ +----------+ +----------+ +----------+
                                  ^
                                  |
                         +--------+--------+
                         |                 |
                    +----+----+      +-----+-----+
                    | PRIV    |      | PRIV      |
                    | Governor|----->| Timelock  |
                    +---------+      +-----------+

Token Flow:

• All contracts use PRIV tokens for payments and rewards
• The token contract manages supply and minting
• Governance controls protocol parameters through timelock

Security Features

All contracts implement robust security patterns:

Development

Local Setup

cd packages/contracts
forge install
forge build

Running Tests

# Run all tests
forge test

# Run with verbosity
forge test -vvv

# Gas report
forge test --gas-report

Deploy

# Deploy to Base Sepolia
forge script script/Deploy.s.sol --rpc-url base-sepolia --broadcast

# Deploy to Base Mainnet
forge script script/Deploy.s.sol --rpc-url base --broadcast

Contract Documentation

Core Token

• PRIV Token - Native protocol token with governance voting

DeFi

• StakingV2 - ve-PRIV staking with 5 lock tiers and weighted rewards

Fee Infrastructure

• FeeManagerV2 - Central hub for processing and distributing protocol fees (40% burn / 35% stakers / 25% treasury)

Marketplaces

• DataXchange - Data marketplace with timelock protection
• AdNetwork - Advertising network with multi-oracle consensus
• DataWalletMarketplace - Bulk purchase marketplace for data wallet media (3% fee)

Data Rewards

• Data Contribution - Rewards for data uploads
• Labeling Rewards - AI training task marketplace

Token Distribution

• TokenDistributionV2 - Multi-tier vesting for Founder (3M TGE / 27M vested), Treasury, and Ecosystem allocations
• FounderVesting (archived -- see TokenDistributionV2) - Standalone founder vesting contract. Will NOT be deployed to mainnet.

Data Bounty Board

• BountyEscrow - Data bounty escrow with 3 payment tiers (Standard, DirectPRIV, StakedPRIV), auto-payout, FeeManagerV2 integration
• ApproverRegistry - Game-theory QA with 500 PRIV stake, 3-vote quorum, 66.67% consensus, slashing

Governance

• Governance - DAO governance with PRIVGovernor and PRIVTimelock