Instalacja

Surfpool SDK jest publikowany jako dwa artefakty opakowujące to samo środowisko uruchomieniowe Rust:

Rust

Dodaj skrzynkę jako zależność deweloperską. SDK jest zaprojektowany asynchronicznie i wymaga środowiska uruchomieniowego Tokio, dlatego dołącz tokio z funkcją full dla testów.

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

Skrzynka ponownie eksportuje najczęściej potrzebne typy Solana, więc zazwyczaj wystarczy pojedyncze use surfpool_sdk::{...}:

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

Jeśli potrzebujesz typu, który nie jest ponownie eksportowany, zależą bezpośrednio od odpowiedniej skrzynki Solana — SDK nie ogranicza Cię do żadnej konkretnej wersji solana-program ani solana-client.

TypeScript / JavaScript

Zainstaluj jako zależność deweloperską przy użyciu wybranego menedżera pakietów:

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

Pakiet eksportuje pojedynczą klasę Surfnet wraz z typami pomocniczymi:

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";

Obsługiwane platformy

Pakiet JS zależy od natywnych modułów specyficznych dla platformy, które są instalowane automatycznie jako optionalDependencies:

Wymagania

• Node.js 18 lub nowszy. SDK używa Uint8Array, natywnego fetch i assert/strict z node:test.
• Zapisywalny katalog tymczasowy. Każda instancja Surfnet przydziela porty i może zapisywać dane przejściowe do katalogu tymczasowego systemu operacyjnego.

Weryfikacja instalacji

Jednoliniowy test dymny potwierdza, że środowisko uruchomieniowe startuje i punkt końcowy RPC przyjmuje żądania.

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

Rozwiązywanie problemów