Configuración

Surfnet::start() (Rust) e Surfnet.start() (JS) inician una Surfnet sin conexión con producción de bloques en modo transacción y un pagador pre-financiado con 10 SOL. Cuando necesites algo más — una Surfnet bifurcada de mainnet, un reloj más lento, financiación determinista, un keypair de pagador específico — utiliza el builder (Rust) o startWithConfig (JS).

Valores por defecto

Si llamas a start() sin argumentos, obtienes:

Configuración personalizada

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

Referencia del builder

El builder de Rust y el objeto de configuración de JS exponen las mismas opciones lógicas bajo nomenclatura camelCase / snake_case.

Alternativa RPC Remota

Configurar remoteRpcUrl (o remote_rpc_url en Rust) saca a Surfnet del modo sin conexión. Las cuentas que no están presentes localmente se obtienen bajo demanda desde el RPC de origen, que es como funcionan las pruebas de mainnet-fork.

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

Modo de Producción de Bloques

Pagador Personalizado

De forma predeterminada, el pagador es un keypair generado de nuevo. Proporciona el tuyo cuando las pruebas necesiten una dirección conocida, por ejemplo para pre-construir instrucciones que hagan referencia a la clave pública del pagador.

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

Compuertas de Funcionalidades

Activa o desactiva compuertas de funcionalidades individuales del SVM por ID, o activa todas las funcionalidades conocidas con allFeatures: true (solo JS — el constructor de Rust acepta feature_config para el conjunto completo).

use surfpool_sdk::{Pubkey, Surfnet};

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

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

Omitir Verificación de Blockhash

skip_blockhash_check(true) (solo Rust) deshabilita la validación de blockhash en todas las transacciones. Útil para pruebas que firman transacciones con mucha anticipación a su envío o que no se preocupan por la expiración.

Errores

Un builder mal configurado falla en start(). El SDK de Rust devuelve SurfnetError:

El SDK de JS lanza un Error cuyo mensaje encapsula la misma variante subyacente.