Asennus

Surfpool SDK julkaistaan kahtena artefaktina, jotka käyttävät samaa Rust-suoritusympäristöä:

Rust

Lisää crate dev-riippuvuudeksi. SDK on async-ensijainen ja edellyttää Tokio-suoritusympäristöä, joten sisällytä tokio ja full-ominaisuus testejä varten.

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

Crate vie uudelleen yleisimmin tarvitsemasi Solana-tyypit, joten yksittäinen use surfpool_sdk::{...} riittää yleensä:

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

Jos tarvitset tyyppiä, jota ei viedä uudelleen, riippuu suoraan taustalla olevasta Solana-cratesta — SDK ei sido sinua mihinkään tiettyyn versioon solana-program:stä tai solana-client:stä.

TypeScript / JavaScript

Asenna dev-riippuvuudeksi valitsemallasi paketinhallintaohjelmalla:

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

Paketti vie yhden Surfnet-luokan sekä sitä tukevat tyypit:

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

Tuetut alustat

JS-paketti riippuu alustakohtaisista natiiveista moduuleista, jotka asennetaan automaattisesti optionalDependencies-riippuvuuksina:

Vaatimukset

• Node.js 18 tai uudempi. SDK käyttää Uint8Array, natiiveja fetch- ja assert/strict-ominaisuuksia paketista node:test.
• Kirjoitettava väliaikaishakemisto. Jokainen Surfnet-instanssi varaa portteja ja saattaa kirjoittaa tilapäistä dataa käyttöjärjestelmän temp-hakemistoon.

Asennuksen Varmentaminen

Yksirivisellä smoke-testillä varmistetaan, että ajoympäristö käynnistyy ja RPC-päätepiste hyväksyy pyynnöt.

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

Vianmääritys