Cấu hình

Surfnet::start() (Rust) và Surfnet.start() (JS) khởi động một Surfnet ngoại tuyến với chế độ sản xuất khối theo giao dịch và người thanh toán được nạp sẵn 10 SOL. Khi bạn cần bất kỳ điều gì khác — một Surfnet được fork từ mainnet, đồng hồ chậm hơn, tài trợ xác định, một keypair người thanh toán cụ thể — hãy dùng builder (Rust) hoặc startWithConfig (JS).

Mặc định

Nếu bạn gọi start() mà không có đối số, bạn sẽ nhận được:

Cấu hình tùy chỉnh

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

Tham chiếu Builder

Rust builder và đối tượng cấu hình JS cung cấp các tùy chọn logic giống nhau theo cách đặt tên camelCase / snake_case.

Dự phòng RPC từ xa

Thiết lập remoteRpcUrl (hoặc remote_rpc_url trong Rust) sẽ chuyển Surfnet ra khỏi chế độ ngoại tuyến. Các tài khoản không có sẵn ở local sẽ được tải theo yêu cầu từ RPC upstream, đây là cách các bài kiểm thử mainnet-fork hoạt động.

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

Chế độ sản xuất khối

Người thanh toán tùy chỉnh

Theo mặc định, người thanh toán là một keypair được tạo mới. Hãy cung cấp keypair của riêng bạn khi các bài kiểm thử cần một địa chỉ đã biết, ví dụ để xây dựng trước các lệnh tham chiếu đến khóa công khai của người thanh toá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());

Cổng tính năng

Bật/tắt từng cổng tính năng SVM theo ID, hoặc kích hoạt tất cả các tính năng đã biết với allFeatures: true (chỉ JS — Rust builder chấp nhận feature_config cho bộ đầy đủ).

use surfpool_sdk::{Pubkey, Surfnet};

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

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

Bỏ qua kiểm tra Blockhash

skip_blockhash_check(true) (chỉ Rust) vô hiệu hóa xác thực blockhash trên tất cả các giao dịch. Hữu ích cho các bài kiểm thử ký giao dịch từ trước khi nộp hoặc không quan tâm đến thời hạn hết hạn.

Lỗi

Một builder bị cấu hình sai sẽ thất bại tại start(). Rust SDK trả về SurfnetError:

JS SDK ném ra một Error có thông báo bao gồm cùng biến thể lỗi bên dưới.