Zeitreise

Die Surfpool-Laufzeitumgebung stellt drei Zeitreise-Hilfsfunktionen bereit. Jede bewegt die lokale Uhr zu einem absoluten Zielwert (kein relativer Offset) und gibt den aktualisierten EpochInfo zurück, damit Tests bestätigen können, dass die Laufzeitumgebung die angeforderte Zeit tatsächlich erreicht hat.

Zu einem Slot springen

use surfpool_sdk::Surfnet;

let surfnet = Surfnet::start().await?;
let cheats = surfnet.cheatcodes();

let info = cheats.time_travel_to_slot(1_000_000)?;
assert!(info.absolute_slot >= 1_000_000);

Zu einer Epoch springen

let info = cheats.time_travel_to_epoch(420)?;
assert_eq!(info.epoch, 420);

Zu einem Unix-Zeitstempel springen

Übergebe den Zeitstempel in Millisekunden, nicht in Sekunden. Die Laufzeitumgebung berechnet den nächstgelegenen slot zu diesem Zeitstempel.

// 2030-01-01T00:00:00Z
let info = cheats.time_travel_to_timestamp(1_893_456_000_000)?;

Häufige Muster

Sperrzeit oder Vesting-Fenster testen

Das folgende Beispiel ist eine Skizze — assertWithdrawFails und assertWithdrawSucceeds sind Platzhalter für beliebige clientseitige Hilfsfunktionen, die deine Test-Suite verwendet, um das RPC-Verhalten zu prüfen.

import { Surfnet } from "@solana/surfpool";

const surfnet = Surfnet.start();
const beneficiary = Surfnet.newKeypair();

// 1. Set up a vesting account that unlocks at slot 1,000,000.
surfnet.setAccount(/* ...lockup program state... */);

// 2. Verify withdrawal fails before unlock.
await assertWithdrawFails(surfnet.rpcUrl, beneficiary);

// 3. Travel past the unlock slot.
surfnet.timeTravelToSlot(1_000_001);

// 4. Verify withdrawal succeeds.
await assertWithdrawSucceeds(surfnet.rpcUrl, beneficiary);

surfnet.stop();

Ein Multi-Epoch-Szenario steuern

for epoch in 2..=5 {
    cheats.time_travel_to_epoch(epoch)?;
    surfnet.rpc_client().send_transaction(&claim_rewards_tx)?;
}

EpochInfo-Struktur

Beide SDKs geben ein EpochInfo-Objekt mit folgenden Feldern zurück: