Skip to content

solana-turbin3/Q4_25_Builder_Subodhkd001

Repository files navigation

πŸš€ Turbin3 Q4 2025 Builder Cohort

A comprehensive collection of Solana blockchain projects built during the Turbin3 Q4 2025 cohort. This repository showcases expertise in Solana development, smart contract programming with Anchor, and full-stack dApp development.

Solana Anchor TypeScript Rust

πŸ“š Table of Contents


🌟 Overview

This repository contains advanced Solana blockchain projects developed as part of the Turbin3 Builder Cohort Q4 2025. Each project demonstrates different aspects of Solana development, from DeFi protocols to NFT utilities and gaming mechanics.

Key Learning Outcomes:

  • βœ… Solana Program Development with Anchor Framework
  • βœ… PDA (Program Derived Addresses) Management
  • βœ… CPI (Cross-Program Invocation) Patterns
  • βœ… Token Management (SPL Tokens, NFTs)
  • βœ… Full-stack dApp Development
  • βœ… Smart Contract Security Best Practices

🎯 Projects

Project Description Tech Repository Link
🌍 TerraFund (Capstone) Decentralized crowdfunding platform with transparent fundraising campaigns Anchor, Next.js, TypeScript πŸ“‚ View Project
πŸ’± AMM Automated Market Maker implementing x*y=k constant product formula Anchor, Rust πŸ“‚ View Project
🎲 Dice Game On-chain dice game with provably fair randomness using Ed25519 Anchor, Rust πŸ“‚ View Project
🀝 Escrow Program Trustless P2P token swap escrow system Anchor, Rust πŸ“‚ View Project
🎨 Metaplex Core NFT NFT minting and management with Metaplex Core Anchor, Metaplex πŸ“‚ View Project
πŸ”’ NFT Staking Stake NFTs and earn reward tokens over time Anchor, Rust πŸ“‚ View Project
🏦 Vault Program Secure SOL vault with deposit/withdraw functionality Anchor, Rust πŸ“‚ View Project
πŸ“ Prerequisites Initial Turbin3 TypeScript setup and prerequisites TypeScript πŸ“‚ View Project
🎬 Starter Turbin3 starter code and examples TypeScript, Rust πŸ“‚ View Project

🌍 Capstone: TerraFund

A decentralized crowdfunding platform built on Solana

Enables transparent and secure fundraising campaigns with smart contract automation, featuring real-time tracking, secure withdrawals, and platform fee management.

Key Features:

  • πŸš€ Decentralized campaign creation and management
  • πŸ’° Transparent on-chain donation tracking
  • πŸ”’ Smart contract-enforced withdrawal rules (minimum 1 SOL)
  • πŸ“Š Real-time campaign progress monitoring
  • 🎯 Configurable platform fees (default 5%)
  • ⚑ Fast transactions with low costs on Solana

Tech Stack:

  • Smart Contracts: Anchor Framework (Rust)
  • Frontend: Next.js 14, React, TypeScript
  • Styling: Tailwind CSS
  • State Management: Redux Toolkit
  • Wallet: Solana Wallet Adapter

Architecture:

graph TB
    subgraph Flow["πŸ‘₯ User Actions"]
        F1[Create Campaign]
        F2[Donate SOL]
        F3[Withdraw Funds]
    end
    
    subgraph State["πŸ“‹ Program State"]
        PS["ProgramState
        campaign_count | platform_fee"]
    end
    
    subgraph Accounts["πŸ’Ύ Data Accounts"]
        A1["Campaign PDA
        creator | goal | amount_raised | balance"]
        A2["Transaction PDA
        donor | amount | timestamp"]
    end
    
    F1 --> A1
    F2 --> A1
    F2 --> A2
    F3 --> A1
    PS -.-> A1
    A1 -.-> A2
Loading

πŸ“‚ View Full Documentation β†’


πŸ’± AMM (Automated Market Maker)

Constant product AMM implementing x*y=k formula

A decentralized exchange protocol allowing users to provide liquidity, swap tokens, and earn fees.

Key Features:

  • Liquidity pool initialization with dual tokens
  • Add/remove liquidity with LP token minting/burning
  • Token swaps with configurable fee structure
  • Slippage protection mechanisms
  • Authority-controlled pool locking

Smart Contract Highlights:

  • Uses constant-product-curve library for calculations
  • PDA-based vault accounts for token storage
  • LP token minting for liquidity providers
  • Fee distribution to liquidity providers

πŸ“‚ View Project β†’


🎲 Dice Game

On-chain dice game with provably fair randomness

Implements a betting system where players can place bets on dice rolls with verifiable randomness using Ed25519 signatures.

Key Features:

  • Place bets with customizable roll predictions (2-96)
  • Provably fair randomness using Ed25519 signatures
  • House edge mechanism (1.5%)
  • Automatic payout calculation
  • Refund system for expired bets
  • Timeout protection (1000 slots)

Security:

  • Ed25519 signature verification for randomness
  • House-signed message validation
  • Time-based bet expiry
  • Secure vault management

πŸ“‚ View Project β†’


🀝 Escrow Program

Trustless token swap escrow system

Enables peer-to-peer token swaps without requiring trust between parties, with full refund capabilities.

Key Features:

  • Maker initiates escrow with token A deposit
  • Taker completes swap by providing token B
  • Maker can refund if deal expires
  • Supports SPL tokens and Token-2022
  • Atomic swap execution
  • PDA-based vault security

Use Cases:

  • OTC (Over-The-Counter) trades
  • NFT-for-token swaps
  • P2P trading without centralized exchange

πŸ“‚ View Project β†’ | Documentation β†’


🎨 Metaplex Core NFT

NFT minting and management with Metaplex Core

Implements creator whitelisting, collection management, and NFT minting with plugins.

Key Features:

  • Creator whitelist management (program authority controlled)
  • Collection creation with update authority
  • NFT minting with attributes plugin
  • Freeze/thaw delegate functionality
  • Burn delegate implementation
  • On-chain metadata storage

Advanced Features:

  • Plugin-based attribute system
  • Timestamp tracking
  • Creator/Minter attribution
  • Collection-based organization

πŸ“‚ View Project β†’


πŸ”’ NFT Staking

Stake NFTs and earn reward tokens

A comprehensive NFT staking system with reward token distribution and freeze delegate mechanics.

Key Features:

  • Collection-based NFT creation
  • NFT staking with freeze delegate
  • Points accumulation over time
  • Reward token minting and claiming
  • Configurable staking parameters
  • Freeze period enforcement
  • User-specific staking accounts

Architecture:

  • Config account for global settings
  • User accounts tracking points and stakes
  • Stake accounts per NFT
  • Reward mint for token distribution

πŸ“‚ View Project β†’


🏦 Vault Program

Secure SOL vault with deposit/withdraw functionality

A simple yet secure vault implementation demonstrating PDA patterns and rent-exempt account management.

Key Features:

  • Initialize personal vault with rent-exempt balance
  • Deposit SOL into vault
  • Withdraw SOL from vault
  • Close vault and recover all funds
  • PDA-based security model

Learning Objectives:

  • PDA derivation and signing
  • Rent-exempt balance management
  • CPI with signer seeds
  • Account closure patterns

πŸ“‚ View Project β†’ | Documentation β†’


πŸ“‹ Prerequisites

Required Tools

Tool Version Installation
Node.js v18.18.0+ Download
Rust v1.89.0+ Install
Anchor CLI v0.32.1+ cargo install --git https://github.com/coral-xyz/anchor avm --locked --force
Solana CLI v1.18.17+ Install
Yarn/pnpm Latest npm install -g yarn pnpm

Optional Tools

  • Surfpool - Enhanced local testing and runbooks
  • Txtx - Infrastructure as Code for Solana

πŸš€ Getting Started

Clone the Repository

git clone https://github.com/Subodhkd001/Q4_25_Builder_Subodhkd001.git
cd Q4_25_Builder_Subodhkd001

Set Up Solana Wallet

# Generate new keypair (if needed)
solana-keygen new

# Configure for devnet
solana config set --url devnet

# Get devnet SOL
solana airdrop 2

Working with Projects

Each project has its own setup. Navigate to the project directory:

# Example: Building the AMM project
cd anchor-amm-starter-q4-25
anchor build
anchor test

# Example: Running TerraFund (Capstone)
cd capstone/terra-fund
pnpm install
pnpm anchor-build
pnpm anchor deploy --provider.cluster devnet
pnpm dev

Using Surfpool (Optional)

Many projects include Surfpool runbooks for deployment:

# Start local Surfnet
surfpool start

# List available runbooks
surfpool ls

# Execute deployment runbook
surfpool run deployment

πŸ› οΈ Tech Stack

Blockchain & Smart Contracts

  • Solana - High-performance blockchain
  • Anchor Framework - Rust framework for Solana programs
  • SPL Token - Token standard implementation
  • Metaplex - NFT standard and tools

Frontend Development

  • React/Next.js - UI framework
  • TypeScript - Type-safe JavaScript
  • Tailwind CSS - Utility-first CSS
  • Solana Wallet Adapter - Wallet integration
  • Redux Toolkit - State management

Development Tools

  • Anchor CLI - Program development toolkit
  • Solana CLI - Command-line tools
  • Surfpool - Local validator and runbooks
  • Jest - Testing framework

🀝 Contributing

Contributions, issues, and feature requests are welcome!

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published