Programs Architecture

Comprehensive overview of Gold Digger's Solana programs and backend infrastructure

System Architecture

Solana Programs

On-chain smart contracts handling core game logic, NFT operations, and DeFi functions

Backend Services

Next.js API routes, Supabase database, and real-time synchronization services

External APIs

Helius RPC, Jupiter aggregator, and third-party integrations

Data Flow Architecture

Frontend → API Routes → Solana Programs → Blockchain
Blockchain Events → Webhooks → Database → Real-time Updates
External APIs → Cache Layer → Frontend Components

Gaming Program

Core gaming logic handling battles, tournaments, achievements, and player progression with cross-program invocations.

Core Instructions

start_battle
Initialize battle state
end_battle
Process battle results
claim_reward
Distribute battle rewards
stake_nft
Stake NFTs for bonuses

State Management

Player profiles with stats and achievements
Battle instances with real-time state
Leaderboards and ranking systems
Reward pools and distribution logic
Cross-Program Integration

Gaming program invokes NFT Factory for reward minting, Staking program for bonus calculations, and integrates with external oracles for randomness and fair play verification.

NFT Factory Program

Advanced NFT creation system with compressed NFTs, mystery packs, dynamic metadata, and rarity-based distribution.

Factory Features

Compressed NFT minting (99% gas reduction)
Mystery pack creation and revealing
Dynamic metadata generation
Verifiable randomness for fair drops

Rarity System

Common
60%
Rare
25%
Epic
12%
Legendary
3%

Staking Program

Multi-asset staking system supporting tokens and NFTs with flexible lock periods, compound rewards, and governance integration.

Staking Features

Multi-token support (DIGR, GOLD)
NFT staking with APY bonuses
Compound interest calculations
Governance voting power

Program Instructions

initialize_pool
Create staking pool
stake_tokens
Deposit tokens
unstake_tokens
Withdraw with penalties
claim_rewards
Harvest earnings

Swap Program

Decentralized exchange functionality with Jupiter integration, limit orders, and cross-chain bridge support.

Swap Features

Instant token swaps via Jupiter
Limit order functionality
MEV protection and slippage control
Cross-chain bridge integration

Integration Points

Jupiter Aggregator for best prices
Orca and Raydium DEX protocols
Meteora for advanced strategies
Wormhole for cross-chain assets

Backend Infrastructure

Comprehensive backend services handling data persistence, real-time updates, and external API integrations.

Supabase Integration

• Real-time database subscriptions
• Row-level security policies
• Automatic schema migrations
• Edge functions for webhooks

API Routes

• RESTful endpoints
• Server actions for mutations
• Middleware for authentication
• Rate limiting and caching

Data Services

• Portfolio aggregation
• Price feed synchronization
• Transaction monitoring
• Analytics and reporting

Security & Performance

Security Measures

Multi-signature program upgrades
Comprehensive access controls
Input validation and sanitization
Audit trail and monitoring

Performance Optimizations

Compressed NFTs for gas efficiency
Batch transaction processing
Optimized account layouts
Efficient state management