SolRefer Protocol

A decentralized referral program protocol built on Solana that enables businesses to create and manage referral programs using NFTs.

Overview

SolRefer allows users to:

• Create and manage decentralized referral programs
• Mint NFTs that represent unique referral links
• Track referrals and conversions on-chain
• Distribute rewards automatically
• Monitor performance through a dashboard

Key Features

• NFT-Based Referrals: Each referral link is represented by a unique NFT
• Flexible Rewards: Support for both SOL and custom token rewards
• Automatic Distribution: Smart contract-based reward distribution
• Performance Tracking: On-chain tracking of clicks and conversions
• Decentralized Storage: Metadata stored on Arweave for permanence

Core Components

1. Referral Program Management

   • Create and configure referral programs
   • Set eligibility criteria and reward parameters

2. NFT Minting

   • Generate unique referral NFTs
   • Store metadata on Arweave

3. Referral Tracking

   • Track clicks and conversions
   • Monitor referral status

4. Reward Distribution

   • Automatic reward calculations
   • Configurable lock periods
   • Early redemption options

Protocol Flow

sequenceDiagram
    participant User
    participant SolRefer as SolRefer Program
    participant NFTMinting as NFT Minting Program
    participant ReferralTracking as Referral Tracking Program
    participant RewardDistribution as Reward Distribution Program
    participant Wallet as User Wallet
    participant Arweave as Arweave Storage

    User ->> SolRefer: Create Referral Program
    SolRefer ->> RewardDistribution: Define Fixed Rewards
    SolRefer ->> SolRefer: Set Eligibility Criteria
    SolRefer ->> NFTMinting: Mint Referral NFTs
    NFTMinting ->> Arweave: Store NFT Metadata

    User ->> NFTMinting: Mint Referral NFT
    NFTMinting ->> User: Generate Unique Referral Link
    NFTMinting ->> ReferralTracking: Track Referral Clicks

    User ->> ReferralTracking: Share Referral Link
    ReferralTracking ->> ReferralTracking: Track Clicks
    ReferralTracking ->> ReferralTracking: Track Conversions
    ReferralTracking ->> SolRefer: Update Referral Status

    User ->> RewardDistribution: Claim Rewards
    RewardDistribution ->> ReferralTracking: Check Referral Status
    RewardDistribution ->> RewardDistribution: Calculate Fixed Rewards
    RewardDistribution ->> Wallet: Send Rewards
    RewardDistribution ->> SolRefer: Update Reward Balance

    User ->> SolRefer: View Performance Dashboard
    SolRefer ->> SolRefer: Show Referral Metrics
    SolRefer ->> SolRefer: Show ROI Analysis

    User ->> SolRefer: Provide Feedback on Referral Program
    SolRefer ->> Arweave: Store Feedback
    SolRefer ->> SolRefer: Show Feedback to Businesses

Loading

Getting Started

1. Install dependencies:

   anchor build

2. Run tests:

   anchor test

3. Deploy program:

   anchor deploy

Architecture

For detailed technical specifications and architecture diagrams, see Architecture.md.

License

[Add License Information]

Program Id: EwUYBCEJYXkVNK49wwoYhi2T7m83jBLzhXvEG71UQ3kM

Signature: 2wqtNTut9jFj9SAmh4miHnSfy76D47wPaacKryEzv7n5RzQKYhkM7v6bLr1Nd1fxTJYJ6jBaLYqpPHhQpDyVpUjZ