Configuratie

Surfnet::start() (Rust) en Surfnet.start() (JS) starten een offline Surfnet op met blokverwerkingsmodus op basis van transacties en een betaler die vooraf is gevuld met 10 SOL. Als je iets anders nodig hebt — een mainnet-geforkte Surfnet, een langzamere klok, deterministische financiering, een specifiek keypair voor de betaler — gebruik dan de builder (Rust) of startWithConfig (JS).

Standaardwaarden

Als je start() aanroept zonder argumenten, krijg je:

Aangepaste configuratie

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-referentie

De Rust-builder en het JS-configuratieobject bieden dezelfde logische opties onder camelCase- / snake_case-naamgeving.

Remote RPC Fallback

Het instellen van remoteRpcUrl (of remote_rpc_url in Rust) schakelt de Surfnet uit de offlinemodus. Accounts die lokaal niet aanwezig zijn, worden op aanvraag opgehaald van de upstream RPC, wat de basis is voor mainnet-fork tests.

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

Blokproductiemodus

Aangepaste betaler

Standaard is de betaler een nieuw gegenereerd keypair. Geef uw eigen keypair op wanneer tests een bekend adres vereisen, bijvoorbeeld om instructies vooraf op te bouwen die verwijzen naar de publieke sleutel van de betaler.

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

Schakel individuele SVM-feature gates in of uit via ID, of activeer alle bekende features met allFeatures: true (alleen JS — de Rust-builder accepteert feature_config voor de volledig set).

use surfpool_sdk::{Pubkey, Surfnet};

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

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

Blokhash-controle overslaan

skip_blockhash_check(true) (alleen Rust) schakelt blokhashvalidatie uit voor alle transacties. Handig voor tests die transacties ruim van tevoren ondertekenen of die zich niet bekommeren om vervaldatums.

Fouten

Een verkeerd geconfigureerde builder mislukt bij start(). De Rust SDK retourneert SurfnetError:

De JS SDK gooit een Error waarvan het bericht dezelfde onderliggende variant omhult.