Introducing Surfnet

Surfnet is Surfpool's local Solana network simulator, designed to provide developers with a powerful testing environment that mimics the behavior of the Solana blockchain without the overhead of a full validator node.

What is Surfnet?

Surfnet provides a lightweight, fast, and feature-rich alternative to running a local Solana validator. It offers the same RPC interface as a standard Solana validator but with enhanced development features and testing capabilities.

Key Benefits

  • Instant startup time (no sync required)
  • Built-in testing cheatcodes
  • State manipulation capabilities
  • Deterministic block production

Perfect For

  • Local development and testing
  • CI/CD pipeline integration
  • Program deployment testing
  • Transaction simulation

Getting Started

Start a Surfnet instance using the Surfpool CLI:

terminal
surfpool start

This will start a local Surfnet instance on http://localhost:8899with all RPC endpoints available.

Available RPC API Categories

Transactions

Send, simulate, and inspect transaction data. Get signatures, fees, and confirmation status.

Accounts

Query account states, balances, token holdings, and program-specific storage data.

Cheatcodes

Powerful testing utilities to manipulate blockchain state, set account data, and profile transactions.

Node Health

Monitor node status, health checks, cluster information, and validator details.

Network Health

Access network-wide information like epoch data, inflation rates, and performance metrics.

Admin

Administrative controls for managing the Surfnet instance, plugins, and system configuration.

Learn More

CLI Documentation

Learn how to use the Surfpool CLI to manage Surfnet instances and execute runbooks.

View CLI Docs →

WebSocket API

Subscribe to real-time updates for accounts, transactions, and network events.

View WebSocket Docs →