Installazione

L'SDK Surfpool è pubblicato come due artefatti che racchiudono lo stesso runtime Rust:

Rust

Aggiungi il crate come dev-dependency. L'SDK è async-first e richiede un runtime Tokio, quindi includi tokio con la feature full per i test.

[dev-dependencies]
surfpool-sdk = "1"
tokio = { version = "1", features = ["full"] }

Il crate ri-esporta i tipi Solana più utilizzati, quindi un singolo use surfpool_sdk::{...} è solitamente sufficiente:

use surfpool_sdk::{
    Keypair, Pubkey, RpcClient, Signer,        // re-exported Solana types
    Surfnet, SurfnetBuilder, SurfnetError,     // SDK entry points
    BlockProductionMode, SimnetEvent,          // re-exported surfpool types
};

Se hai bisogno di un tipo che non viene ri-esportato, dipendi direttamente dal crate Solana sottostante — l'SDK non ti vincola a nessuna versione specifica di solana-program o solana-client.

TypeScript / JavaScript

Installa come dev-dependency con il package manager che preferisci:

npm install --save-dev @solana/surfpool
# or
pnpm add -D @solana/surfpool
# or
yarn add --dev @solana/surfpool

Il pacchetto esporta una singola classe Surfnet insieme ai tipi di supporto:

import {
  Surfnet, // entry point
  type SurfnetConfig, // config for startWithConfig
  type DeployOptions, // explicit program deploy
  type SetTokenAccountUpdate,
  type ResetAccountOptions,
  type StreamAccountOptions,
  type SimnetEventValue, // event drained from drainEvents()
  type KeypairInfo, // shape returned by Surfnet.newKeypair()
  type EpochInfoValue,
  type ClockValue
} from "@solana/surfpool";

Piattaforme Supportate

Il pacchetto JS dipende da moduli nativi specifici per piattaforma che vengono installati automaticamente come optionalDependencies:

Requisiti

• Node.js 18 o versione successiva. L'SDK utilizza Uint8Array, fetch nativo e assert/strict da node:test.
• Una directory temporanea scrivibile. Ogni istanza di Surfnet alloca porte e può scrivere dati transitori nella directory temporanea del sistema operativo.

Verifica dell'Installazione

Un semplice test in una riga conferma che il runtime si avvia e che l'endpoint RPC accetta richieste.

use surfpool_sdk::{Signer, Surfnet};

#[tokio::test]
async fn surfpool_sdk_smoke() {
    let surfnet = Surfnet::start().await.expect("start surfnet");
    let balance = surfnet
        .rpc_client()
        .get_balance(&surfnet.payer().pubkey())
        .expect("get balance");
    assert!(balance > 0);
}

Risoluzione dei Problemi