MetaMiles

Introduction

The platform is live hosted at https://meta-miles.vercel.app/

Find our link to docs https://smits-organization-1.gitbook.io/metamiles

MetaMiles is a cross-chain, card-linked rewards platform built for MetaMask Card users.

It turns your everyday spending into real-world perks — like concert tickets, local discounts, NFT drops, and exclusive DAO rewards — based on onchain proof-of-spend.

By connecting your MetaMask Card with your MetaMiles dashboard, you can:

• Track your spending across chains

• Unlock rewards tiers (Bronze, Silver, Gold)

• Claim real perks tied to location, events, or merchant campaigns

• Bridge your rewards to any chain via LI.FI SDK + Circle CCTP

• Earn NFTs that reflect your loyalty, status, or streaks

All rewards are triggered via USDC spend, and can be redeemed or claimed directly from your MetaMiles wallet.

How MetaMiles Delivers

1. Optimize User Finances
   We want users to get more value from their spending.
   → MetaMiles transforms spending into real perks like discounts, tickets, and exclusive NFTs so every purchase feels like progress.

2. Create Card-Linked Experiences
   We aim to connect the card to meaningful real-world uses.
   → With MetaMiles, your card activity directly unlocks IRL experiences: event access, retail perks, food vouchers, and more based on your location and spending tier.

3. Use Onchain Identity or Activity as a Trigger
   We want to use wallet-based behavior to activate benefits.
   → MetaMiles uses Zero-Knowledge Proofs (Proof Of Spend) to verify how much you’ve spent without revealing what you bought and uses that to trigger tier upgrades and mint reward NFTs.

4. Merge Onchain & Real Life
   We want to bridge your digital wallet with the physical world.
   → MetaMiles enables token-gated perks like merch, IRL discounts, or access to events all tied to your onchain spending behavior.

5. Stablecoin First (USDC)
   We encourage USDC for simple, stable usage.
   → MetaMiles uses USDC for reward sharing .

   ---

   User Flow

   ---

   1. Onboarding

   • User visits the MetaMiles dApp

   • Connects their wallet via MetaMask SDK

   • Verifies MetaMask Card ownership using a signed message

   • Enrolls in Circle Wallet to receive cross-chain rewards

   ---

   2. Spending & Tracking

   • User makes purchases using the MetaMask Card

   • Chainlink Functions fetch spending data securely

   • On-chain SpendTracker Contract is updated

     • Only cumulative spend is stored (no transaction history exposed)

   ---

   3. Proof Generation (ZK)

   • User returns to MetaMiles to claim rewards

   • ZK circuit runs locally:
     “Prove I’ve spent over $X this month without revealing details”

   • A ZK-SNARK proof is generated pseudonymously

   • Proof is submitted on-chain to the ZKVerifier Contract

   ---

   4. Reward Unlock

   • ZKVerifier confirms proof of spend

   • A Soulbound NFT (SBT) is minted to represent user tier

     • Bronze / Silver / Gold

   • SBT grants access to exclusive benefits:

     • Token-gated tickets

     • IRL discounts (via QR/NFC)

     • Exclusive merch or digital perks

   ---

   5. Cross-Chain / Custody

   • If the reward is hosted on another chain:

     • LI.FI SDK bridges assets

     • Circle CCTP transfers native USDC

   • Reward is delivered to:

     • User’s preferred chain

     • Or Circle Wallet if selected

   ---

   6. Ongoing Use

   • Spend tracking resets monthly

   • User repeats the cycle:
     Spend → Prove → Unlock

   • All progress and perks are visible in the MetaMiles Dashboard

   ---

   Partner Flow

   ---

   1. Partner Onboarding

   • Brand, DAO, or Event Organizer visits the MetaMiles Partner Portal

   • Registers as a verified reward partner

   • Sets up an organization profile with logo, description, region, and contact details

   ---

   2. Perk Configuration

   • Defines region-specific reward logic

     • Example: "Spend $200 in San Francisco → Get a concert ticket"

   • Uploads inventory:

     • NFT rewards (e.g., access passes, exclusive merch)

     • NFC unlock codes for in-person redemption

     • Airdrop assets or digital perks

   • Sets thresholds and tier gating for each reward (Bronze, Silver, Gold)

   ---

   3. Integration & Monitoring

   • Integrates using the MetaMiles SDK and Reward APIs to:

     • Validate user tier (using on-chain Soulbound NFTs)

     • Distribute rewards based on eligibility

     • Track redemptions and participation in real-time

   ---

   4. Cross-Chain Ready

   • All perks and rewards can be bridged across supported chains using:

     • LI.FI SDK for routing

     • Circle CCTP V2 for native USDC movement

   • Enables seamless, chain-agnostic reward delivery

   ---

   5. Insights & Loyalty Tools

   • Partner dashboard displays key analytics:

     • User engagement by location

     • Tiers achieved over time

     • Redemption and usage metrics

   • Allows re-targeting and advanced loyalty campaign setup via on-chain behavior

   • Here's a detailed section on MetaMiles Token/Reward Economics, designed to help you prove value, ensure sustainability, and align incentives across users, partners, and the MetaMask ecosystem.

     ---

     Economics of MetaMiles

     ---

     Reward Funding Model

     Stakeholder	Contribution / Role	Incentive to Participate
     MetaMask/Consensys	Seed reward pool or match partner contributions	Drives card usage, USDC volume, and ecosystem loyalty
     Partners / Merchants	Provide IRL perks (discounts, tickets, free items)	Targeted user acquisition, measurable ROI, brand loyalty
     User	Spends via MetaMask Card (USDC)	Unlocks real-world perks, exclusive experiences, and status NFTs

     ---

     Reward Mechanics

     Tier	Spend Threshold (USDC)	Reward Example	Type
     Bronze	$50 / month	Free coffee, discount code	Token-gated
     Silver	$250 / month	Event ticket, merch coupon	NFT claim
     Gold	$1000+ / month	Festival pass, limited merch, early access	SBT / POAP

     • Reward delivery: via NFTs (claimable or auto-minted) used to access IRL perks.

     • Perks vary by region: Local partnerships create custom perks. Optional tier-based rarity.

     ---