What problem does it solve? Solana developers struggle with slow, heavyweight local testing: solana-test-validator requires large snapshots, cannot access real mainnet state, and lacks tools for manipulating time, balances, and account data during tests. Surfpool provides a drop-in replacement that forks mainnet state on demand and exposes cheatcodes for full state control. ## Core Features & Use Cases - Mainnet Forking: Clone accounts, programs, and token balances from mainnet just-in-time using a copy-on-read strategy, with pre-cloning configured in Surfpool.toml. - Cheatcodes: Use RPC methods like surfnet_setAccount, surfnet_setTokenAccount, surfnet_timeTravel, and surfnet_profileTransaction to manipulate state, control the clock, and profile compute units. - Infrastructure as Code: Define reproducible deployments with txtx DSL runbooks, plus Surfpool Studio at http://127.0.0.1:18488 for transaction inspection and a universal faucet. - Use Case: While testing an Anchor program that swaps on a mainnet DEX, start Surfpool, set token balances with cheatcodes, advance slots to simulate time passing, and profile the transaction's compute usage before deploying. ## Quick Start Ask the agent to start a local Surfpool network and set up a test wallet funded with SOL and USDC using cheatcodes.
