Struct SurfnetBuilder 

pub struct SurfnetBuilder { /* private fields */ }

Builder for configuring a Surfnet instance before starting it.

use surfpool_sdk::{Surfnet, BlockProductionMode};

let surfnet = Surfnet::builder()
    .offline(true)
    .block_production_mode(BlockProductionMode::Transaction)
    .skip_blockhash_check(true)
    .airdrop_sol(10_000_000_000)
    .start()
    .await
    .unwrap();

Implementations

impl SurfnetBuilder

pub fn offline(self, offline: bool) -> Self

Run in offline mode (no mainnet RPC fallback). Default: true.

pub fn remote_rpc_url(self, url: impl Into<String>) -> Self

Set a remote RPC URL for account fallback (implies offline(false)).

pub fn block_production_mode(self, mode: BlockProductionMode) -> Self

How blocks are produced. Default: Transaction (advance on each tx).

pub fn slot_time_ms(self, ms: u64) -> Self

Slot time in milliseconds. Default: 1 (fast for tests).

pub fn airdrop_addresses(self, addresses: Vec<Pubkey>) -> Self

Additional addresses to airdrop SOL to at startup.

pub fn airdrop_sol(self, lamports: u64) -> Self

Amount of lamports to airdrop to the payer (and additional addresses) at startup. Default: 10 SOL.

pub fn skip_blockhash_check(self, skip: bool) -> Self

Skip blockhash validation for all transactions in this surfnet instance.

pub fn payer(self, keypair: Keypair) -> Self

Use a specific keypair as the payer. If not set, a random one is generated.

pub fn enable_feature(self, feature: Pubkey) -> Self

Enable an SVM feature gate at startup. Mirrors the CLI’s --feature flag.

pub fn disable_feature(self, feature: Pubkey) -> Self

Disable an SVM feature gate at startup. Mirrors the CLI’s --disable-feature flag.

pub fn feature_config(self, config: SvmFeatureConfig) -> Self

Replace the feature config wholesale. Default: [SvmFeatureConfig::default_mainnet_features].

pub async fn start(self) -> SurfnetResult<Surfnet>

Start the surfnet with the configured options.

Trait Implementations

impl Default for SurfnetBuilder

fn default() -> Self

Returns the “default value” for a type.