Tijdreizen

De Surfpool-runtime biedt drie tijdreishelpers. Elk verplaatst de lokale klok naar een absoluut doelwit (geen relatieve verschuiving) en geeft de bijgewerkte EpochInfo terug, zodat tests kunnen controleren of de runtime daadwerkelijk de gevraagde tijd heeft bereikt.

Spring Naar Een Slot

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

Spring Naar Een Epoch

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

Spring Naar Een Unix-tijdstempel

Geef de tijdstempel door in milliseconden, niet in seconden. De runtime berekent het dichtsbijzijnde slot op dat tijdstempel.

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

Veelvoorkomende Patronen

Test Een Vergrendeling Of Vestingvenster

Het onderstaande voorbeeld is een schets — assertWithdrawFails en assertWithdrawSucceeds zijn tijdelijke aanduidingen voor de client-side helpers die uw testsuite gebruikt om RPC-gedrag te controleren.

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

Stuur Een Multi-Epoch Scenario Aan

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

EpochInfo Structuur

Beide SDK's geven een EpochInfo-vormig object terug met de volgende velden: