Skip to main content

Proof of Purpose: Technical Whitepaper

Executive Summary​

Proof of Purpose is a decentralized, impact-driven application that empowers youth—referred to as Champions—to earn onchain rewards for completing real-world tasks that benefit their communities. Built on the Base blockchain, the platform combines modern Web3 infrastructure with familiar Web2 tools to ensure transparency, accessibility, and frictionless participation.

Roles include:

  • Champions – Youth who complete verified tasks for rewards
  • Admins – Nonprofits and organizers who post bounties and mint rewards
  • Vendors – Local businesses who redeem tokens for instant USDC
  • Donors – Public supporters who fund the program transparently onchain

This whitepaper details the full architecture, logic, tokenomics, security, and role protocols of the Proof of Purpose ecosystem.

Origin Story & Motivation​

Proof of Purpose wasn’t planned. It arrived.

Over the span of just 12 days, this system was conceived, designed, coded, and deployed with urgency and intention. Fueled by a desire to create a real-world tool for youth engagement, it became a working prototype for how Web3 can serve underserved communities—not in theory, but in practice.

Every contract, screen, and flow was built for one thing: impact. And every youth who uses this system walks away with something more than tokens—they walk away with purpose.

System Architecture Overview​

Proof of Purpose is powered by a hybrid Web2/Web3 stack:

  • Frontend: Next.js 14 + Tailwind CSS + Mantine UI
  • Wallet Auth: Thirdweb In-App Wallet (email login, gasless)
  • Smart Contracts: Base chain (soulbound token + treasury logic)
  • Database: Firebase Realtime Database (user roles, bounties, logs)
  • Storage: Firebase Storage (bounty media, proof uploads)
  • QR Logic: React QR Scanner (for redemptions)
  • Donations: Thirdweb PayEmbed (USDC donations, tracked via webhook)

All components are modular and auditable, designed for future open-source deployment or DAO governance.

Smart Contract Infrastructure​

🪙 $PURPOSE Token​

  • Soulbound (non-transferable) ERC-20 token
  • Minted to Champions upon bounty completion
  • Burned during vendor redemption
  • Backed 1:1 by USDC in the treasury

💰 Treasury & Payment Flow​

  • Donors contribute USDC to the treasury
  • Upon redemption:
    • $PURPOSE is burned
    • Equivalent USDC is sent to the vendor’s wallet

🧮 Revenue Split​

  • Every donation is routed through a split contract:
    • 90% to the treasury (for youth bounties)
    • 10% to the team:
      • 8% → Admin multisig for operational incentives
      • 2% → Founder wallet for oversight

🛑 Emergency Functions​

  • Master Admin can pause contracts
  • Admins can be frozen if audit logs show misconduct

Role Breakdown​

👟 Champions (Youth Participants)​

  • Sign up with email → receive embedded wallet
  • Apply for bounties posted by Admins
  • Complete tasks, provide proof, and receive $PURPOSE tokens
  • Redeem tokens at local vendors for goods/services via QR code

🧑‍💼 Admins (Nonprofits & Organizers)​

  • Create bounties with descriptions, images, and deadlines
  • Approve Champion applicants
  • Mint $PURPOSE tokens to verified participants
  • View audit logs and monitor bounty activity

🏪 Vendors (Redemption Partners)​

  • Scan QR codes from Champions to redeem tokens
  • Automatically receive 1:1 USDC from treasury for each redemption
  • Cannot mint or modify balances

💸 Donors (Supporters)​

  • Donate via credit/debit or USDC using Thirdweb PayEmbed
  • Track impact and score based on donation history
  • Receive updates and recognition through the dashboard

Functionality & Logic​

🔐 Onboarding Flow​

  • User selects role: Champion, Admin, Vendor, Donor
  • Wallet auto-generated via Thirdweb (gasless, email-based)
  • Firebase tracks pending applications → Admin approval required
  • Approved users are assigned a role and dashboard view

📝 Bounty Lifecycle​

  1. Admin creates bounty (title, reward, description, image, quota)
  2. Champion applies → Admin reviews and approves
  3. Upon task completion, Admin marks as complete and mints tokens

📲 Redemption Flow​

  • Champion presents wallet QR code to vendor
  • Vendor scans → $PURPOSE tokens are burned
  • Treasury contract sends equivalent USDC to vendor instantly

🌐 Donations​

  • Donor visits donate page (logged-in or public)
  • Payment handled via Thirdweb PayEmbed → tracked via webhook
  • Firebase logs wallet, timestamp, and amount
  • Donor score updated in realtime

🧾 Admin Audit Features​

  • Admin actions are logged
  • Master Admin can freeze admin accounts or pause the contract
  • Webhook replay interface allows fixing missed donation logs

Tokenomics​

🔁 $PURPOSE Token​

  • Soulbound: cannot be traded, transferred, or withdrawn
  • Earned through real-world effort
  • Redeemed only at approved vendors
  • 1 $PURPOSE = 1 USDC of verified community impact

💸 Funding Model​

  • Donations go to a split contract:
    • 90% to the treasury (bounty payouts)
    • 8% to admin multisig (rewarding organizers)
    • 2% to founder (sustainability + oversight)

📊 Forecast Simulation​

  • Bounties range from 25–250 $PURPOSE
  • 30–100 bounties per city per week (scale-adjusted)
  • Multi-city forecast projects $14M/year in distributed youth rewards

Security Measures​

  • 🔐 Role-based access control via Firebase + contract logic
  • 🧾 Audit logs for bounty creation, minting, redemption
  • 🛑 Contract pausability by Master Admin in emergencies
  • ❄️ Admin freezing to halt malicious or negligent actors
  • 🪪 QR redemption security ensures tokens are only burned by vendors
  • 🧠 Webhook replay system to correct missed donation intents

Getting Started by Role​

Every role in Proof of Purpose has a clear path. Here's how to get involved.

👟 Champions (Youth Participants)​

Champions complete verified community tasks and earn $PURPOSE tokens.

Steps to Get Started:

  1. Select "Champion" on the login screen

  2. Sign up with your email (a wallet is auto-created)

  3. Submit your onboarding application 💡 Note: If you're under 18, a parent or legal guardian will need to help complete your application.

  4. A short video call or in-person meeting with an Admin will be scheduled to confirm your interest and go over how the program works

  5. Your guardian will sign a brief consent form to allow participation

  6. Once verified and approved, you'll be able to:

    • Browse available bounties

    • Apply for tasks that interest you

    • Complete them, upload proof, and earn $PURPOSE tokens

    • Redeem your tokens at local vendors for real rewards

No crypto experience is required. Wallets are gasless and fully embedded.

🧑‍💼 Admins (Organizers)​

Admins post and manage bounties for youth participants.

Steps to Get Started:

  1. Select "Admin" at sign-up
  2. Submit your organization details and credentials
  3. After vetting, you can:
    • Create bounties
    • Approve Champion applications
    • Mint $PURPOSE tokens upon completion
    • Access admin audit logs

🏪 Vendors (Local Businesses)​

Vendors accept $PURPOSE tokens and receive instant USDC from the treasury.

Steps to Get Started:

  1. Select "Vendor" when signing up
  2. Provide your business info and wallet address
  3. Once approved, you can:
    • Scan Champion wallet QR codes
    • Redeem tokens
    • Receive automatic 1:1 USDC payouts

💸 Donors​

Donors fund youth opportunity with transparency and trackable results.

Steps to Get Started:

  1. Visit the Donate page
  2. Choose one-time or monthly donation
  3. Pay with card or USDC (via PayEmbed)
  4. Track your donations and impact score in your dashboard

Code of Conduct & Program Rules​

To protect the integrity of the system, all users must follow strict conduct guidelines. Proof of Purpose is built on transparency and trust. Misuse will not be tolerated.

General Rules (All Users)​

  • Use real, verifiable information when signing up
  • No impersonation or wallet sharing
  • All token activity must reflect real-world actions
  • Attempting to game the system = immediate review and action

Admin Rules​

  • Only mint tokens after verifying completion
  • No bulk or auto-approval of bounties
  • Must maintain audit trails for every task
  • Repeated negligence may result in freeze or removal

Champion Rules​

  • Only sign up for bounties you intend to complete
  • Provide real evidence of completion (images, QR scans, etc.)
  • Sharing wallet access will result in a ban

Vendor Rules​

  • Do not redeem $PURPOSE unless scanning a Champion’s QR code in person
  • No redemption on behalf of others
  • Violations may result in disqualification and removal from payout contracts

Audit & Oversight​

Transparency is embedded at the contract and database level.

  • All Admin actions are logged and reviewed
  • Master Admin can freeze roles, pause contracts, or launch investigations
  • Every bounty, mint, and redemption is tied to an on-chain or Firebase event
  • Missed transactions (e.g. webhook failures) are replayable via the admin panel

Enforcement Tiers:

Violation CountAction Taken
First OffenseWarning + Audit Flag
Second OffenseTemporary Suspension
Third OffensePermanent Ban

Fraudulent use may be referred to law enforcement if necessary.

Future Plans​

  • 🌍 Expand to multiple cities with sharded Firebase architecture
  • 🧑‍⚖️ DAO-based governance for bounty approval, admin elections
  • 📱 Mobile app with native QR scanner and proof upload
  • 🧩 Vendor self-onboarding system with peer review
  • 📊 Public analytics dashboard and leaderboard for donors

Conclusion​

Proof of Purpose is more than a platform. It’s a framework for how we can use blockchain to create real-world, accountable impact—at scale. Designed fast, built for the long term, and ready to empower the next generation.

If this can be built in 12 days, imagine what we can build next.