Configuration

Surfnet::start() (Rust) et Surfnet.start() (JS) démarrent un Surfnet hors ligne avec un mode de production de blocs par transaction et un payeur pré-financé avec 10 SOL. Lorsque vous avez besoin d'autre chose — un Surfnet forké depuis le mainnet, une horloge plus lente, un financement déterministe, un keypair de payeur spécifique — utilisez le builder (Rust) ou startWithConfig (JS).

Valeurs par défaut

Si vous appelez start() sans arguments, vous obtenez :

Configuration personnalisée

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

Référence du builder

Le builder Rust et l'objet de configuration JS exposent les mêmes options logiques sous les conventions de nommage camelCase / snake_case.

Basculement vers le RPC distant

Définir remoteRpcUrl (ou remote_rpc_url en Rust) fait sortir le Surfnet du mode hors ligne. Les comptes absents localement sont récupérés à la demande depuis le RPC amont, ce qui est le fonctionnement des tests mainnet-fork.

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

Mode de Production de Blocs

Payeur Personnalisé

Par défaut, le payeur est un keypair fraîchement généré. Fournissez le vôtre lorsque les tests nécessitent une adresse connue, par exemple pour pré-construire des instructions référençant la clé publique du payeur.

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

Activez ou désactivez des feature gates SVM individuelles par ID, ou activez toutes les fonctionnalités connues avec allFeatures: true (JS uniquement — le builder Rust accepte feature_config pour l'ensemble complet).

use surfpool_sdk::{Pubkey, Surfnet};

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

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

Ignorer la Vérification du Blockhash

skip_blockhash_check(true) (Rust uniquement) désactive la validation du blockhash sur toutes les transactions. Utile pour les tests qui signent des transactions bien avant leur soumission ou qui ne se soucient pas de l'expiration.

Erreurs

Un builder mal configuré échoue à start(). Le SDK Rust retourne SurfnetError :

Le SDK JS lève une Error dont le message encapsule la même variante sous-jacente.