Installation

Das Surfpool SDK wird als zwei Artefakte veröffentlicht, die dieselbe Rust-Laufzeitumgebung kapseln:

Rust

Füge das Crate als Dev-Abhängigkeit hinzu. Das SDK ist asynchron-first und erwartet eine Tokio-Laufzeitumgebung. Füge daher tokio mit dem full-Feature für Tests ein.

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

Das Crate re-exportiert die am häufigsten benötigten Solana-Typen, sodass ein einzelnes use surfpool_sdk::{...} in der Regel ausreicht:

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

Falls du einen Typ benötigst, der nicht re-exportiert wird, hänge direkt vom zugrunde liegenden Solana-Crate ab – das SDK bindet dich nicht an eine bestimmte Version von solana-program oder solana-client.

TypeScript / JavaScript

Installiere als Dev-Abhängigkeit mit deinem bevorzugten Paketmanager:

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

Das Paket exportiert eine einzelne Surfnet-Klasse sowie unterstützende Typen:

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

Unterstützte Plattformen

Das JS-Paket ist auf plattformspezifische native Module angewiesen, die automatisch als optionalDependencies installiert werden:

Anforderungen

• Node.js 18 oder neuer. Das SDK verwendet Uint8Array, natives fetch und assert/strict aus node:test.
• Ein beschreibbares temporäres Verzeichnis. Jede Surfnet-Instanz belegt Ports und kann transiente Daten in das temporäre Verzeichnis des Betriebssystems schreiben.

Installation überprüfen

Ein einzeiliger Schnelltest bestätigt, dass die Laufzeitumgebung startet und der RPC-Endpunkt Anfragen akzeptiert.

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

Fehlerbehebung