Surfpool

Surfpool is a drop-in replacement for solana-test-validator, purpose-built for Solana developers who need to simulate mainnet conditions locally. This tool enables realistic mainnet simulation for testing trading strategies, DeFi protocols, and smart contracts without spending real SOL or risking assets. At its core, Surfpool provides the power of Solana's mainnet environment on a developer's own machine, offering full control over network state, accounts, and token balances. It is designed for those who require precise, repeatable testing scenarios that mirror production, from individual instruction testing to complex multi-program workflows. The primary value is delivering a safe, cost-free sandbox that behaves identically to mainnet, accelerating development and reducing financial exposure.

Traditional Solana development involves significant friction: testnets lack real account states and token liquidity, while mainnet testing incurs transaction fees and risks of irreversible losses. Developers often resort to hacky workarounds or incomplete simulations that fail to catch edge cases. This pain point is especially acute for trading strategy researchers, DeFi developers, and auditors who must verify behavior against live market conditions, token distributions, and program interactions. Without accurate local simulation, bugs can slip into production, leading to financial exploits or failed strategies. Surfpool eliminates these risks by cloning real mainnet state—including programs, token balances, and account data—so developers can test with absolute fidelity, identify issues early, and iterate rapidly without consequences.

The first major feature is Mainnet Forking, which allows cloning any account, program, or token balance directly from Solana mainnet to the local network. This is not a simulation of state; it's an exact copy, including the full history of account data and program bytecode. Developers specify which accounts or programs to fork, and Surfpool fetches the live state in real time. The why is clear: testing against real USDC balances, actual Jupiter pool configurations, or a deployed Metaplex contract ensures that every interaction behaves as it would on mainnet. This feature is critical for regression testing, validating upgrades, and simulating trades that depend on precise token amounts and program authority structures.

The second major feature group is Cheatcodes, exposed via surfnet RPC methods that give developers superpowers over their local network. These include surfnet_setAccount for arbitrarily modifying any account's data, surfnet_timeTravel to advance the clock or warp to any slot, surfnet_setTokenBalance to set SOL or SPL token balances instantly, and surfnet_resetNetwork to restart cleanly. Each cheatcode is an RPC method that integrates seamlessly with existing tooling—standard Solana RPC calls continue to work alongside them. The utility is immense: developers can instantly simulate a token crash, test time-dependent oracles, or replay a sequence of transactions with manipulated state. This turns testing from a passive observation into an active, controlled experiment.