Instalación

El SDK de Surfpool se publica como dos artefactos que envuelven el mismo runtime de Rust:

Rust

Añade el crate como dependencia de desarrollo. El SDK es async por defecto y requiere un runtime de Tokio, así que incluye tokio con la característica full para los tests.

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

El crate re-exporta los tipos de Solana que necesitas con más frecuencia, por lo que un único use surfpool_sdk::{...} suele ser suficiente:

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

Si necesitas un tipo que no está re-exportado, depende directamente del crate de Solana subyacente — el SDK no te vincula a ninguna versión específica de solana-program ni de solana-client.

TypeScript / JavaScript

Instala como dependencia de desarrollo con el gestor de paquetes de tu elección:

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

El paquete exporta una única clase Surfnet junto con los tipos de soporte:

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 compatibles

El paquete JS depende de módulos nativos específicos de cada plataforma que se instalan automáticamente como optionalDependencies:

Requisitos

• Node.js 18 o superior. El SDK utiliza Uint8Array, fetch nativo y assert/strict de node:test.
• Un directorio temporal con permisos de escritura. Cada instancia de Surfnet asigna puertos y puede escribir datos transitorios en el directorio temporal del sistema operativo.

Verificación de la Instalación

Una prueba de funcionamiento básico en una sola línea confirma que el entorno de ejecución se inicia y que el endpoint RPC acepta solicitudes.

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

Solución de Problemas