surfpool

Fork mainnet state locally for deterministic Solana program testing.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/labsaistudio/AABC-Labs --skill surfpool-labsaistudio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: surfpool
Source: https://github.com/labsaistudio/AABC-Labs/tree/main/backend/agent/skills/catalog/surfpool
Command: npx skills add https://github.com/labsaistudio/AABC-Labs --skill surfpool-labsaistudio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Solana developers often need a local environment that faithfully mirrors on-chain state to test programs and interactions. Surfpool provides a complete development environment that forks mainnet data, offers cheatcodes to manipulate state, and includes infrastructure-as-code tooling plus a Studio dashboard for observability.

Core Features & Use Cases

  • Mainnet-forged local network for deterministic testing of Solana programs
  • Cheatcodes for time travel, balance manipulation, program deployment, and account state control
  • Infrastructure as Code (txtx DSL) for reproducible deployments and runbooks
  • Surfpool Studio dashboard for transaction inspection, profiling, and observability
  • Use Case: Validate program behavior against real mainnet state without external dependencies

Quick Start

Start Surfpool locally with a configuration that forks mainnet, enables cheatcodes, and launches Studio.

Frequently Asked Questions about surfpool

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

FAQPage Schema
How do I test Solana programs against mainnet state locally?

You can test Solana programs against mainnet state locally by using a mainnet-forked local network that simulates on-chain data for deterministic testing. This approach allows you to validate program behavior with real mainnet data fidelity without relying on external dependencies.

What are cheatcodes in Solana development and how do they manipulate state?

Cheatcodes in Solana development are commands used to manipulate local network state for testing. They enable developers to perform time travel, balance manipulation, program deployment, and account state control to test edge cases deterministically.

How do I create reproducible deployments for Solana infrastructure?

You can create reproducible Solana deployments by using infrastructure-as-code tooling with a txtx DSL to define runbooks. This approach ensures deterministic deployments and reproducible environment setup for testing and integration workflows.

Can I inspect Solana transactions and profile accounts during local testing?

Yes, you can inspect Solana transactions and profile accounts locally by using an integrated Studio dashboard. This dashboard provides observability for transaction inspection, profiling, and account state review during local development.

Does this local Solana development environment require external dependencies?

No, this local Solana development environment does not require external dependencies to validate program behavior. It simulates mainnet state directly on your local network, ensuring deterministic runs and infrastructure-as-code reproducibility without external connections.