Configuration

Surfnet::start() (Rust) and Surfnet.start() (JS) boot an offline Surfnet with transaction-mode block production and a payer pre-funded with 10 SOL. When you need anything else — a mainnet-forked Surfnet, a slower clock, deterministic funding, a specific payer keypair — reach for the builder (Rust) or startWithConfig (JS).

Defaults

If you call start() with no arguments, you get:

Custom Configuration

use surfpool_sdk::{BlockProductionMode, Pubkey, Surfnet};

#[tokio::test]
async fn starts_with_custom_configuration() {
    let alice = Pubkey::new_unique();

    let surfnet = Surfnet::builder()
        .remote_rpc_url("https://api.mainnet-beta.solana.com")
        .block_production_mode(BlockProductionMode::Transaction)
        .slot_time_ms(10)
        .airdrop_addresses(vec![alice])
        .airdrop_sol(5_000_000_000)
        .skip_blockhash_check(true)
        .start()
        .await
        .unwrap();

    assert_eq!(
        surfnet.rpc_client().get_balance(&alice).unwrap(),
        5_000_000_000
    );
}

Builder Reference

The Rust builder and the JS config object expose the same logical options under camelCase / snake_case naming.

Remote RPC Fallback

Setting remoteRpcUrl (or remote_rpc_url in Rust) flips the Surfnet out of offline mode. Accounts not present locally are fetched on demand from the upstream RPC, which is how mainnet-fork tests work.

let surfnet = Surfnet::builder()
    .remote_rpc_url("https://api.mainnet-beta.solana.com")
    .start()
    .await?;

Block Production Mode

Custom Payer

By default the payer is a freshly generated keypair. Provide your own when tests need a known address, for example to pre-build instructions referencing the payer's public key.

use surfpool_sdk::{Keypair, Signer, Surfnet};

let payer = Keypair::new();
let surfnet = Surfnet::builder().payer(payer.insecure_clone()).start().await?;

assert_eq!(surfnet.payer().pubkey(), payer.pubkey());

Feature Gates

Toggle individual SVM feature gates by ID, or activate every known feature with allFeatures: true (JS only — the Rust builder accepts feature_config for the full set).

use surfpool_sdk::{Pubkey, Surfnet};

let feature_id: Pubkey = "9bn2vTJUsUcnpiZWbu2woSKtTGW3ErZC9ERv88SDqQjK"
    .parse()
    .unwrap();

let surfnet = Surfnet::builder()
    .enable_feature(feature_id)
    .start()
    .await?;

Skip Blockhash Check

skip_blockhash_check(true) (Rust only) disables blockhash validation on all transactions. Useful for tests that sign transactions far in advance of submission or that don't care about expiry.

Errors

A misconfigured builder fails at start(). The Rust SDK returns SurfnetError:

The JS SDK throws an Error whose message wraps the same underlying variant.