Optimus Protocol Instructions

Admin Instructions

Protocol Management

• init_global: Initialize the protocol with initial parameters
  • Sets curve multiplier, graduation requirements, fees, and durations
  • Configures treasury and authority accounts
  • Initializes protocol state
• update_global: Update protocol configuration
  • Modifies curve parameters, fees, and durations
  • Updates treasury and authority settings
  • Can update protocol operational state
• update_global_authority: Update the global authority address
  • Only callable by current authority
  • Updates master and config authority

Emergency Controls

• emergency_withdraw: Emergency fund withdrawal
• pause_trading: Pause trading operations
• resume_trading: Resume trading operations

Creator Instructions

Bonding Curve Management

• init_bonding_curve: Initialize a new bonding curve
  • Sets up referral system
  • Configures token metadata (name, symbol, URI)
  • Initializes curve parameters
  • Sets up initial pool state

Pool Management

• graduate_pool: Graduate a pool from alpha to main phase
  • Validates graduation requirements
  • Updates pool status
  • Configures main trading parameters
  • Handles wrapped SOL conversions

Meme Coin Launch

• initialize_token: Initialize new meme coin
• setup_liquidity: Set up initial liquidity pool
• configure_bonding_curve: Configure token bonding curve
• set_launch_params: Set launch parameters

Vault Management

• create_alpha_vault: Create new alpha vault
• configure_vault: Configure vault parameters
• update_vault_status: Update vault status

User Instructions

Alpha Phase Operations

• alpha_deposit: Deposit SOL during alpha phase
  • Accepts SOL deposits
  • Records referral information
  • Updates alpha phase statistics
  • Validates deposit limits
• alpha_claim: Claim tokens after alpha phase
  • Validates claim eligibility
  • Processes token distribution
  • Updates claim status
  • Handles wrapped SOL conversions

Trading Operations

• buy: Buy tokens from bonding curve
  • Calculates price using polynomial curve
  • Handles slippage protection
  • Updates balances and statistics
  • Processes wrapped SOL conversions
• sell: Sell tokens back to bonding curve
  • Calculates return amount
  • Validates minimum output
  • Updates pool state
  • Handles wrapped SOL conversions

Fee Management

• claim_fees: Claim accumulated fees
  • Validates claim eligibility
  • Processes fee distribution
  • Updates fee tracking
  • Handles wrapped SOL conversions

Treasury Operations

• transfer_bonding_sol: Transfer SOL from bonding curve to treasury
  • Validates transfer requirements
  • Updates pool balances
  • Handles wrapped SOL conversions

Vault Operations

• deposit_to_vault: Deposit to alpha vault
• claim_from_vault: Claim from alpha vault
• graduate_vault: Graduate vault to main trading

Referral System

• set_referral: Set referral relationship
• claim_referral_rewards: Claim referral rewards
• update_referral_status: Update referral status

Instruction Flow

Trading Flow

1. User initiates trade
2. Protocol validates:
   • Account authorization
   • Balance sufficiency
   • Trading restrictions
   • Slippage limits
   • Wrapped SOL balance
3. Execute trade through polynomial curve
4. Update state and balances
5. Process fees and rewards
6. Handle wrapped SOL conversions
7. Emit events

Alpha Phase Flow

1. User deposits to alpha vault
2. Protocol validates:
   • Vault status
   • Deposit limits
   • User eligibility
   • Alpha phase timing
   • Wrapped SOL balance
3. Process deposit
4. Update vault state
5. Track alpha phase progress
6. Handle wrapped SOL conversions
7. Emit events

Graduation Flow

1. Creator initiates graduation
2. Protocol validates:
   • Graduation requirements
   • Pool status
   • Authority permissions
   • Wrapped SOL balance
3. Update pool status
4. Configure main trading
5. Initialize bonding curve
6. Handle wrapped SOL conversions
7. Emit events