Installation

Le SDK Surfpool est publié sous la forme de deux artefacts qui encapsulent le même runtime Rust :

Rust

Ajoutez la crate en tant que dépendance de développement. Le SDK est async-first et nécessite un runtime Tokio ; incluez donc tokio avec la fonctionnalité full pour les tests.

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

La crate réexporte les types Solana dont vous avez le plus souvent besoin, de sorte qu'un simple use surfpool_sdk::{...} est généralement suffisant :

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

Si vous avez besoin d'un type qui n'est pas réexporté, dépendez directement de la crate Solana sous-jacente — le SDK ne vous contraint à aucune version spécifique de solana-program ni de solana-client.

TypeScript / JavaScript

Installez en tant que dépendance de développement avec le gestionnaire de packages de votre choix :

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

Le package exporte une unique classe Surfnet ainsi que les types associés :

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

Plateformes prises en charge

Le package JS dépend de modules natifs spécifiques à la plateforme, installés automatiquement en tant que optionalDependencies :

Prérequis

• Node.js 18 ou version ultérieure. Le SDK utilise Uint8Array, fetch natif, et assert/strict de node:test.
• Un répertoire temporaire accessible en écriture. Chaque instance Surfnet alloue des ports et peut écrire des données transitoires dans le répertoire temporaire du système d'exploitation.

Vérification de l'installation

Un test rapide en une ligne confirme que le runtime démarre et que le point de terminaison RPC accepte les requêtes.

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

Résolution des problèmes