Rewards Program

SECURITY NOTICE: This program has not been audited. Use at your own risk. Not recommended for production use with real funds without a thorough security review.

Program ID

7kw4iaikc9qTaFGcWx4wDiCXkkLddTb65HV8xH7KbHyc

Deployments

Network	Program ID

Overview

A token vesting program for Solana that enables authorities to create distributions with configurable vesting schedules. Recipients can claim tokens as they vest over time according to their individual schedule.

Key Features

• Two distribution types - Direct (on-chain recipient accounts) and Merkle (off-chain tree, on-chain root)
• Configurable vesting schedules - Immediate, Linear, Cliff, and CliffLinear
• Per-recipient configuration - Each recipient has their own vesting schedule within a distribution
• Token-2022 support - Works with both SPL Token and Token-2022 mints

When to Use What

Distribution Type

	Direct	Merkle
How it works	Creates an on-chain account per recipient	Stores a single merkle root on-chain; recipients provide proofs to claim
Upfront cost	Authority pays rent for every recipient account	No per-recipient accounts until someone claims
Scalability	Practical up to low thousands of recipients	Scales to millions with constant on-chain storage
Mutability	Recipients can be added after creation	Recipient set is fixed at creation
Best for	Small, dynamic distributions	Large, fixed distributions

Vesting Schedule

Schedule	Behavior
Immediate	All tokens are claimable right away
Linear	Tokens unlock proportionally between start_ts and end_ts
Cliff	Nothing unlocks until cliff_ts, then everything unlocks at once
CliffLinear	Nothing unlocks until cliff_ts, then linear vesting from start_ts to end_ts (tokens accrued before the cliff become claimable at the cliff)

Account Types

Account	PDA Seeds	Description
DirectDistribution	["direct_distribution", mint, authority, seeds]	Distribution config (authority, mint, totals)
DirectRecipient	["direct_recipient", distribution, recipient]	Recipient allocation and vesting schedule
MerkleDistribution	["merkle_distribution", mint, authority, seeds]	Distribution config with merkle root
MerkleClaim	["merkle_claim", distribution, claimant]	Tracks claimed amount per claimant

Workflow

Direct Distribution

sequenceDiagram
    participant Authority
    participant Program
    participant Accounts

    Authority->>Program: CreateDirectDistribution
    Program->>Accounts: create Distribution PDA
    Program->>Accounts: create Vault ATA
    Program->>Accounts: transfer initial funding

    Authority->>Program: AddDirectRecipient
    Program->>Accounts: create Recipient PDA
    Program->>Accounts: update total_allocated

Loading

sequenceDiagram
    participant Recipient
    participant Program
    participant Accounts

    Note over Recipient,Accounts: time passes, tokens vest

    Recipient->>Program: ClaimDirect
    Program->>Accounts: calculate unlocked amount
    Program->>Recipient: transfer vested tokens
    Program->>Accounts: update claimed_amount

Loading

Merkle Distribution

sequenceDiagram
    participant Authority
    participant Program
    participant Accounts

    Note over Authority: build merkle tree off-chain
    Authority->>Program: CreateMerkleDistribution (with root)
    Program->>Accounts: create Distribution PDA
    Program->>Accounts: create Vault ATA
    Program->>Accounts: transfer initial funding

Loading

sequenceDiagram
    participant Claimant
    participant Program
    participant Accounts

    Note over Claimant,Accounts: time passes, tokens vest

    Claimant->>Program: ClaimMerkle (with proof)
    Program->>Accounts: verify proof against root
    Program->>Accounts: create/update MerkleClaim PDA
    Program->>Claimant: transfer vested tokens

Loading

Closing

sequenceDiagram
    participant Authority
    participant Program
    participant Accounts

    Authority->>Program: CloseDirectDistribution / CloseMerkleDistribution
    Program->>Accounts: return remaining tokens
    Program->>Accounts: close Distribution PDA
    Program->>Authority: reclaim rent

Loading

Documentation

• CU Benchmarks - Compute unit usage per instruction

Local Development

Prerequisites

• Rust
• Node.js (see .nvmrc)
• pnpm (see package.json packageManager)
• Solana CLI

All can be conveniently installed via the Solana CLI Quick Install.

Build & Test

# Install dependencies
just install

# Full build (IDL + clients + program)
just build

# Run integration tests
just integration-test

# Run integration tests with CU tracking
just integration-test --with-cu

# Format and lint
just fmt

Tech Stack

• Pinocchio - Lightweight no_std Solana framework
• Codama - IDL-driven client generation
• LiteSVM - Fast local testing

---

Built and maintained by the Solana Foundation.

Licensed under MIT. See LICENSE for details.

Support

• Solana StackExchange - tag rewards-program
• Open an Issue