Διαμόρφωση

Surfnet::start() (Rust) και Surfnet.start() (JS) εκκινούν ένα εκτός σύνδεσης Surfnet με παραγωγή μπλοκ σε λειτουργία συναλλαγής και έναν πληρωτή προχρηματοδοτημένο με 10 SOL. Όταν χρειάζεστε οτιδήποτε άλλο — ένα Surfnet με fork από το mainnet, πιο αργό ρολόι, ντετερμινιστική χρηματοδότηση, ένα συγκεκριμένο keypair πληρωτή — χρησιμοποιήστε τον builder (Rust) ή startWithConfig (JS).

Προεπιλογές

Αν καλέσετε το start() χωρίς ορίσματα, λαμβάνετε:

Προσαρμοσμένη Διαμόρφωση

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

Ο builder της Rust και το αντικείμενο διαμόρφωσης JS εκθέτουν τις ίδιες λογικές επιλογές με ονοματολογία camelCase / snake_case.

Εναλλακτικό Απομακρυσμένο RPC

Η ρύθμιση remoteRpcUrl (ή remote_rpc_url σε Rust) βγάζει το Surfnet από τη λειτουργία εκτός σύνδεσης. Λογαριασμοί που δεν υπάρχουν τοπικά ανακτώνται κατ' απαίτηση από το ανάντη RPC, που είναι ο τρόπος λειτουργίας των δοκιμών mainnet-fork.

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

Λειτουργία Παραγωγής Μπλοκ

Προσαρμοσμένος Πληρωτής

Από προεπιλογή, ο πληρωτής είναι ένα νεοδημιουργημένο keypair. Παρέχετε το δικό σας όταν οι δοκιμές χρειάζονται μια γνωστή διεύθυνση, για παράδειγμα για την εκ των προτέρων κατασκευή εντολών που αναφέρονται στο δημόσιο κλειδί του πληρωτή.

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

Πύλες Χαρακτηριστικών

Εναλλάξτε μεμονωμένες πύλες χαρακτηριστικών SVM ανά ID, ή ενεργοποιήστε κάθε γνωστό χαρακτηριστικό με allFeatures: true (μόνο JS — ο κατασκευαστής Rust δέχεται feature_config για το πλήρες σύνολο).

use surfpool_sdk::{Pubkey, Surfnet};

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

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

Παράλειψη Ελέγχου Blockhash

Το skip_blockhash_check(true) (μόνο Rust) απενεργοποιεί την επικύρωση blockhash σε όλες τις συναλλαγές. Χρήσιμο για δοκιμές που υπογράφουν συναλλαγές πολύ νωρίτερα από την υποβολή ή που δεν ενδιαφέρονται για τη λήξη.

Σφάλματα

Ένας λανθασμένα διαμορφωμένος builder αποτυγχάνει στο start(). Το Rust SDK επιστρέφει SurfnetError:

Το JS SDK εκτοξεύει ένα Error του οποίου το μήνυμα περιτυλίγει την ίδια υποκείμενη παραλλαγή.