Skip to content

Troubleshooting#

Solutions to common issues when using Marinade.

Transaction Errors#

"Transaction failed"#

Causes:

Cause Solution
Insufficient SOL for fees Add SOL to wallet (0.01 SOL minimum)
Stale blockhash Retry the transaction
RPC congestion Try a different RPC endpoint
Slippage exceeded Increase slippage tolerance

Quick fix:

Bash
# Check wallet balance
solana balance YOUR_WALLET

"Blockhash not found"#

The transaction took too long to submit. Solutions:

  1. Retry immediately - Blockhashes expire after ~60 seconds
  2. Use faster RPC - Switch to a premium RPC provider
  3. Reduce network load - Try during off-peak hours

"Simulation failed"#

The transaction would fail if submitted. Check:

  • Sufficient balance for amount + fees
  • Correct accounts and permissions
  • Valid program instruction data

Staking Issues#

"Stake not appearing"#

After staking, if your position doesn't show:

  1. Wait for confirmation - Transactions need 30+ confirmations
  2. Check explorer - Verify on Solana Explorer
  3. Refresh wallet - Disconnect and reconnect
  4. Clear cache - Clear browser cache and reload

"mSOL not in wallet"#

If mSOL doesn't appear after staking:

  1. Add token manually:

  2. Mint: mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So

  3. Check transaction - Verify deposit succeeded on explorer

  4. Wallet support - Ensure wallet supports SPL tokens

"Stake account not found"#

For native staking:

Bash
# List all stake accounts
solana stakes --withdraw-authority YOUR_PUBKEY

# Check specific account
solana stake-account STAKE_ACCOUNT_PUBKEY

Unstaking Issues#

"Instant unstake unavailable"#

The liquidity pool may be depleted. Options:

  1. Reduce amount - Try unstaking less
  2. Use delayed unstake - Wait ~1-2 epochs, no fee
  3. External DEX - Swap mSOL on Jupiter/Orca
  4. Wait - Pool rebalances over time

"Delayed unstake taking too long"#

Delayed unstake timing:

Stage Duration
Request submitted Immediate
Deactivation ~1 epoch (~2 days)
Withdrawable After deactivation

Check epoch progress:

Bash
solana epoch-info

"Cannot withdraw stake"#

For native staking, ensure:

  1. Stake is deactivated - Must complete cooldown
  2. You have withdraw authority - Check with solana stakes
  3. Account has balance - Verify on explorer

Wallet Issues#

"Wallet not connecting"#

  1. Refresh page - Simple reload often fixes
  2. Check extension - Ensure wallet extension is enabled
  3. Try different browser - Some wallets work better in specific browsers
  4. Update wallet - Use latest wallet version

"Wrong network"#

Ensure wallet is on mainnet:

  • Phantom: Settings → Change Network → Mainnet Beta
  • Solflare: Network selector → Mainnet

"Hardware wallet not detected"#

For Ledger:

  1. Unlock device - Enter PIN
  2. Open Solana app - Must be active
  3. Enable blind signing - Settings → Blind signing → Enabled
  4. Close other apps - Close Ledger Live, browser extensions using device

API Issues#

"Rate limited"#

You've exceeded API limits:

Tier Limit
Public 60 requests/minute

Solutions: - Implement backoff/retry logic - Cache responses - Contact team for higher limits

"API returning errors"#

Bash
# Test API health
curl -s "https://validators-api.marinade.finance/health"

If unhealthy: - Check Marinade Status (if available) - Report in Discord #dev-support

Performance Issues#

"App loading slowly"#

  1. Check RPC - Your RPC may be slow
  2. Network congestion - Solana may be congested
  3. Browser - Clear cache, disable extensions
  4. Try different time - Off-peak hours are faster

"Rewards seem low"#

Verify expected rewards:

  1. Check APY - Current rates at app.marinade.finance
  2. Calculate - Amount × APY ÷ 365 × days = expected rewards
  3. Epoch timing - Did you stake mid-epoch?

Native Staking Specific#

"Stake authority mismatch"#

Your stake account may not be managed by Marinade:

Bash
# Check stake authority
solana stake-account STAKE_PUBKEY | grep "Stake Authority"

# Expected for Max Yield:
# Stake Authority: stWirqFCf2Uts1JBL1Jsd3r6VBWhgnpdPxCTe1MFjrq

"Cannot find prepared unstake"#

After requesting delayed unstake:

  1. Wait for processing - API processes requests periodically
  2. Check status - Use Staking Rewards API
  3. Verify request - Check transaction succeeded

"Exit authority set unexpectedly"#

If stake authority is exit authority, your unstake is being processed:

Text Only
Exit Authority: ex9CfkBZZd6Nv9XdnoDmmB45ymbu4arXVk7g5pWnt3N

This is normal - wait for deactivation to complete.

Getting Help#

If these solutions don't work:

  1. Discord - discord.gg/marinade - #support
  2. Provide details:
  3. Wallet address (public key only!)
  4. Transaction signature
  5. Error message
  6. Steps to reproduce

Never Share

Never share your seed phrase or private key with anyone, including support staff.

Topic Link
FAQ Frequently Asked Questions
Wallet Setup Supported Wallets
Security Security Guide