Kurulum

Surfpool SDK, aynı Rust çalışma zamanını saran iki artifact olarak yayımlanmaktadır:

Rust

Crate'i bir dev-dependency olarak ekleyin. SDK, async-first yapısıyla Tokio çalışma zamanını bekler; bu nedenle testler için full özelliğiyle birlikte tokio ekleyin.

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

Crate, en sık ihtiyaç duyulan Solana türlerini yeniden dışa aktarır; bu nedenle genellikle tek bir use surfpool_sdk::{...} yeterli olur:

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

Yeniden dışa aktarılmayan bir türe ihtiyaç duyarsanız, ilgili Solana crate'ine doğrudan bağımlı olun — SDK sizi solana-program veya solana-client'nin belirli bir sürümüne bağlamaz.

TypeScript / JavaScript

Tercih ettiğiniz paket yöneticisiyle dev-dependency olarak yükleyin:

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

Paket, tek bir Surfnet sınıfı ve destekleyici türleri dışa aktarır:

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

Desteklenen Platformlar

JS paketi, optionalDependencies olarak otomatik yüklenen platforma özgü yerel modüllere bağlıdır:

Gereksinimler

• Node.js 18 veya daha yenisi. SDK, Uint8Array, yerel fetch ve node:test'dan alınan assert/strict kullanır.
• Yazılabilir bir geçici dizin. Her Surfnet örneği port tahsis eder ve işletim sistemi geçici dizinine geçici veriler yazabilir.

Kurulumu Doğrulama

Tek satırlık bir smoke test, çalışma zamanının başladığını ve RPC uç noktasının istekleri kabul ettiğini doğrular.

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

Sorun Giderme