surfpool

Fork Solana mainnet locally with cheatcodes and Infrastructure as Code.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/kiran-nebula/agentshaus --skill surfpool-kiran-nebula
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: surfpool
Source: https://github.com/kiran-nebula/agentshaus/tree/main/packages/agent-runtime/workspace/skills/sendaifun/surfpool
Command: npx skills add https://github.com/kiran-nebula/agentshaus --skill surfpool-kiran-nebula

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Surfpool provides a highly efficient and feature-rich local development environment for Solana programs, drastically reducing the time and complexity associated with testing and debugging.

Core Features & Use Cases

  • Mainnet Forking: Develop and test against a live fork of Solana Mainnet, ensuring compatibility and accuracy.
  • Cheatcodes: Utilize special RPC methods for advanced state manipulation, time control, and transaction profiling.
  • Infrastructure as Code: Define and manage deployments reproducibly using the txtx DSL.
  • Use Case: A Solana developer needs to test a new DeFi protocol upgrade. They can use Surfpool to instantly fork mainnet state, deploy their new program version, and use cheatcodes to simulate specific market conditions or user interactions before deploying to a live network.

Quick Start

Start a local Surfpool network by running the command surfpool start.

Frequently Asked Questions about surfpool

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fork Solana mainnet for local testing?

Surfpool provides a local Solana development environment that replaces `solana-test-validator` with enhanced features. It enables local program simulation by forking mainnet, offers cheatcodes for state manipulation and time control, and supports Infrastructure as Code for reproducible deployments.

What are cheatcodes in Solana development environments?

Cheatcodes are special RPC methods for advanced state manipulation, time control, and transaction profiling. Surfpool provides these cheatcodes to help developers simulate specific market conditions or user interactions during local testing.

Can I use surfpool as a replacement for solana-test-validator?

Yes, surfpool replaces `solana-test-validator` with enhanced features. It provides a highly efficient local development environment for Solana programs, drastically reducing the time and complexity associated with testing and debugging.

How do I start a local Solana development network?

Start a local Solana development network by running the command `surfpool start`. This initializes the environment, allowing you to fork mainnet, use cheatcodes, and manage deployments reproducibly.

What is Infrastructure as Code for Solana deployments?

Infrastructure as Code for Solana deployments means defining and managing deployments reproducibly using a domain-specific language. Surfpool supports this through the txtx DSL, ensuring consistent and reproducible deployment configurations.

How do I simulate specific market conditions when testing a Solana DeFi protocol?

To simulate specific market conditions when testing a Solana DeFi protocol, use cheatcodes to manipulate state and control time. Surfpool allows you to fork mainnet state, deploy your new program version, and use cheatcodes to simulate specific market conditions or user interactions.