Configurazione

Surfnet::start() (Rust) e Surfnet.start() (JS) avviano un Surfnet offline con produzione di blocchi in modalità transazione e un payer pre-finanziato con 10 SOL. Quando hai bisogno di altro — un Surfnet con fork da mainnet, un clock più lento, finanziamento deterministico, un keypair specifico per il payer — utilizza il builder (Rust) o startWithConfig (JS).

Impostazioni predefinite

Se chiami start() senza argomenti, ottieni:

Configurazione personalizzata

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
    );
}

Riferimento del builder

Il builder Rust e l'oggetto di configurazione JS espongono le stesse opzioni logiche con denominazione camelCase / snake_case.

Fallback RPC Remoto

Impostare remoteRpcUrl (o remote_rpc_url in Rust) disattiva la modalità offline di Surfnet. Gli account non presenti localmente vengono recuperati su richiesta dall'RPC upstream, che è il meccanismo con cui funzionano i test mainnet-fork.

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

Modalità di Produzione dei Blocchi

Pagatore Personalizzato

Per impostazione predefinita, il pagatore è un keypair generato al momento. Fornisci il tuo quando i test richiedono un indirizzo noto, ad esempio per pre-costruire istruzioni che fanno riferimento alla chiave pubblica del pagatore.

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 Gate

Attiva o disattiva singole feature gate SVM tramite ID, oppure abilita tutte le feature conosciute con allFeatures: true (solo JS — il builder Rust accetta feature_config per il set completo).

use surfpool_sdk::{Pubkey, Surfnet};

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

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

Ignora il Controllo del Blockhash

skip_blockhash_check(true) (solo Rust) disabilita la validazione del blockhash su tutte le transazioni. Utile per i test che firmano le transazioni molto prima dell'invio o che non si preoccupano della scadenza.

Errori

Un builder mal configurato fallisce su start(). L'SDK Rust restituisce SurfnetError:

L'SDK JS genera un Error il cui messaggio racchiude la stessa variante sottostante.