الإعداد

Surfnet::start() (Rust) و Surfnet.start() (JS) يُشغّلان Surfnet في وضع عدم الاتصال مع إنتاج كتل في وضع المعاملات ودافع ممول مسبقاً بـ 10 SOL. عندما تحتاج إلى أي شيء آخر — Surfnet مُستنسَخ من الشبكة الرئيسية، أو ساعة أبطأ، أو تمويل حتمي، أو keypair دافع محدد — استخدم المنشئ (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
    );
}

مرجع المنشئ

يعرض منشئ 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 يتم إنشاؤه حديثًا. قدّم keypair خاصًا بك عندما تحتاج الاختبارات إلى عنوان معروف، على سبيل المثال لبناء تعليمات مسبقة تشير إلى المفتاح العام pubkey للدافع.

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 الفردية بواسطة المعرّف، أو قم بتفعيل جميع الميزات المعروفة باستخدام 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 على جميع المعاملات. مفيد للاختبارات التي توقّع المعاملات قبل وقت طويل من الإرسال أو التي لا تهتم بانتهاء الصلاحية.

الأخطاء

يفشل منشئ مُهيَّأ بشكل خاطئ عند start(). يُعيد Rust SDK الخطأ SurfnetError:

يُطلق JS SDK استثناءً Error تتضمّن رسالته نفس المتغير الأساسي.