Instalação

O SDK Surfpool é publicado como dois artefatos que encapsulam o mesmo runtime Rust:

Rust

Adicione o crate como dev-dependency. O SDK é assíncrono por padrão e requer um runtime Tokio, portanto inclua tokio com a feature full para testes.

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

O crate reexporta os tipos Solana mais utilizados, portanto um único use surfpool_sdk::{...} geralmente é suficiente:

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

Se precisar de um tipo que não é reexportado, dependa diretamente do crate Solana subjacente — o SDK não o vincula a nenhuma versão específica de solana-program ou solana-client.

TypeScript / JavaScript

Instale como dev-dependency com o gerenciador de pacotes de sua preferência:

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

O pacote exporta uma única classe Surfnet mais tipos de suporte:

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

Plataformas Suportadas

O pacote JS depende de módulos nativos específicos de plataforma que são instalados automaticamente como optionalDependencies:

Requisitos

• Node.js 18 ou mais recente. O SDK utiliza Uint8Array, fetch nativo e assert/strict do node:test.
• Um diretório temporário com permissão de escrita. Cada instância do Surfnet aloca portas e pode gravar dados transitórios no diretório temporário do sistema operacional.

Verificando a Instalação

Um teste rápido de uma linha confirma que o runtime inicia e que o endpoint RPC aceita requisições.

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

Solução de Problemas