Встановлення

Surfpool SDK публікується як два артефакти, що обгортають однаковий Rust-рантайм:

Rust

Додайте крейт як dev-залежність. SDK є async-first і потребує рантайму Tokio, тому для тестів додайте tokio з функцією full.

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

Крейт повторно експортує типи Solana, які потрібні найчастіше, тому зазвичай достатньо одного 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
};

Якщо вам потрібен тип, який не реекспортується, залежте безпосередньо від відповідного крейту Solana — SDK не прив'язує вас до жодної конкретної версії solana-program чи solana-client.

TypeScript / JavaScript

Встановіть як dev-залежність за допомогою вашого менеджера пакетів:

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

Пакет експортує єдиний клас Surfnet та допоміжні типи:

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

Підтримувані платформи

JS-пакет залежить від платформо-специфічних нативних модулів, які встановлюються автоматично як optionalDependencies:

Вимоги

• Node.js 18 або новіше. SDK використовує Uint8Array, вбудований fetch та assert/strict з node:test.
• Доступна для запису тимчасова директорія. Кожен екземпляр Surfnet виділяє порти та може записувати тимчасові дані до системної тимчасової директорії.

Перевірка встановлення

Простий однорядковий тест підтверджує, що середовище виконання запускається та RPC-ендпоінт приймає запити.

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

Усунення несправностей