Yapılandırma

Surfnet::start() (Rust) ve Surfnet.start() (JS), işlem modunda blok üretimiyle ve 10 SOL ile önceden fonlanmış bir ödeyiciyle çevrimdışı bir Surfnet başlatır. Başka bir şeye ihtiyaç duyduğunuzda — mainnet'ten fork edilmiş bir Surfnet, daha yavaş bir saat, deterministik fonlama, belirli bir ödeyici keypair — Rust için builder'a ya da startWithConfig (JS) seçeneğine başvurun.

Varsayılanlar

start()'i hiçbir argüman olmadan çağırırsanız şunları elde edersiniz:

Özel Yapılandırma

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 Referansı

Rust builder ve JS yapılandırma nesnesi, camelCase / snake_case adlandırması altında aynı mantıksal seçenekleri sunar.

Uzak RPC Yedeklemesi

remoteRpcUrl (veya Rust'ta remote_rpc_url) ayarı, Surfnet'i çevrimdışı moddan çıkarır. Yerel olarak bulunmayan hesaplar, istek üzerine yukarı akış RPC'sinden getirilir; mainnet-fork testleri de bu şekilde çalışır.

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

Blok Üretim Modu

Özel Ödeyici

Varsayılan olarak ödeyici, yeni oluşturulmuş bir keypair'dir. Testlerin bilinen bir adrese ihtiyaç duyduğu durumlarda, örneğin ödeyicinin pubkey'ine referans veren talimatları önceden oluşturmak için kendi keypair'inizi sağlayın.

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

Özellik Kapıları

Bireysel SVM özellik kapılarını kimliğe göre açıp kapatın ya da tüm bilinen özellikleri allFeatures: true ile etkinleştirin (yalnızca JS — Rust oluşturucu tam set için feature_config kabul eder).

use surfpool_sdk::{Pubkey, Surfnet};

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

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

Blok Hash Doğrulamasını Atla

skip_blockhash_check(true) (yalnızca Rust) tüm işlemlerde blok hash doğrulamasını devre dışı bırakır. Gönderimden çok önce imzalanan veya süre dolumunu önemsemeyen işlemleri test etmek için kullanışlıdır.

Hatalar

Yanlış yapılandırılmış bir builder, start() aşamasında başarısız olur. Rust SDK şunu döndürür SurfnetError:

JS SDK, aynı temel varyantı sarmalayan bir mesajla birlikte Error fırlatır.