Solana-DokumentationLiteSVMTypeScriptBeispiele

Zeitbasiertes Testen

Demonstriert die Verwendung von warpToSlot zum Testen zeitabhängiger Programmlogik.

Grundlegende Uhrzeitmanipulation

import { createClient, generateKeyPairSigner } from "@solana/kit";
import { litesvm } from "@solana/kit-plugin-litesvm";
import { signer } from "@solana/kit-plugin-signer";
const mySigner = await generateKeyPairSigner();
const client = createClient().use(signer(mySigner)).use(litesvm());
// Enable sysvars for clock access
client.svm.withSysvars();
// Check initial clock
const initialClock = client.svm.getClock();
console.log("Initial state:");
console.log(" Slot:", initialClock.slot);
console.log(" Epoch:", initialClock.epoch);
console.log(" Unix timestamp:", initialClock.unixTimestamp);
// Warp to slot 1000
client.svm.warpToSlot(1000n);
const afterWarp = client.svm.getClock();
console.log("\nAfter warpToSlot(1000):");
console.log(" Slot:", afterWarp.slot);
console.log(" Epoch:", afterWarp.epoch);
// Warp further
client.svm.warpToSlot(100000n);
const afterWarp2 = client.svm.getClock();
console.log("\nAfter warpToSlot(100000):");
console.log(" Slot:", afterWarp2.slot);
console.log(" Epoch:", afterWarp2.epoch);

Testen von zeitgesperrter Logik

Beispielmuster zum Testen zeitgesperrter Funktionalität:

import {
createClient,
address,
generateKeyPairSigner,
lamports
} from "@solana/kit";
import { litesvm } from "@solana/kit-plugin-litesvm";
import { signer } from "@solana/kit-plugin-signer";
const mySigner = await generateKeyPairSigner();
const client = createClient().use(signer(mySigner)).use(litesvm());
client.svm.withSigverify(false).withBlockhashCheck(false).withSysvars();
// Fund payer
client.svm.airdrop(client.payer.address, lamports(10_000_000_000n));
// Set up a time-locked vault account
// Structure: [u8 discriminator, u64 unlock_slot, u64 amount]
const unlockSlot = 10000n;
const lockedAmount = 5_000_000_000n;
const vaultData = new Uint8Array(1 + 8 + 8);
const view = new DataView(vaultData.buffer);
vaultData[0] = 0x01; // discriminator
view.setBigUint64(1, unlockSlot, true); // unlock_slot
view.setBigUint64(9, lockedAmount, true); // amount
const programId = address("TimeLockedVault11111111111111111111111"); // replace or generateKeyPairSigner()
const vaultAddress = address("Vault111111111111111111111111111"); // replace or generateKeyPairSigner()
const minBalance = client.svm.minimumBalanceForRentExemption(
BigInt(vaultData.length)
);
client.svm.setAccount({
address: vaultAddress,
data: vaultData,
executable: false,
lamports: lamports(minBalance + lockedAmount),
programAddress: programId,
space: BigInt(vaultData.length)
});
console.log("Vault created with unlock slot:", unlockSlot);
console.log("Locked amount:", Number(lockedAmount) / 1e9, "SOL");
// Test 1: Try to withdraw before unlock (should fail)
console.log("\n--- Test 1: Before unlock ---");
const currentClock = client.svm.getClock();
console.log("Current slot:", currentClock.slot);
// In a real test, you would:
// 1. Build a withdraw instruction
// 2. Send it and expect it to fail
console.log("Withdrawal attempt: EXPECTED TO FAIL (too early)");
// Test 2: Warp to after unlock slot
console.log("\n--- Test 2: After unlock ---");
client.svm.warpToSlot(unlockSlot + 100n);
const newClock = client.svm.getClock();
console.log("Current slot:", newClock.slot);
// In a real test:
// 1. Build a withdraw instruction
// 2. Send it and expect it to succeed
console.log("Withdrawal attempt: EXPECTED TO SUCCEED (after unlock)");
// Verify vault state
const updatedVault = client.svm.getAccount(vaultAddress);
if (updatedVault.exists) {
console.log("\nVault balance:", updatedVault.lamports);
}

Lesen des epoch-Zeitplans

Sie können den epoch-Zeitplan lesen, um die slot/epoch-Beziehung im Cluster zu verstehen:

import { createClient, generateKeyPairSigner } from "@solana/kit";
import { litesvm } from "@solana/kit-plugin-litesvm";
import { signer } from "@solana/kit-plugin-signer";
const mySigner = await generateKeyPairSigner();
const client = createClient().use(signer(mySigner)).use(litesvm());
client.svm.withSysvars();
const epochSchedule = client.svm.getEpochSchedule();
console.log("Slots per epoch:", epochSchedule.slotsPerEpoch);
console.log("First normal epoch:", epochSchedule.firstNormalEpoch);
console.log("First normal slot:", epochSchedule.firstNormalSlot);

warpToSlot setzt den slot-Wert der Uhr vor, aktualisiert jedoch nicht automatisch epoch oder unixTimestamp. Verwenden Sie setClock für die vollständige Kontrolle über die Uhrzeitfelder.

Manuelle Uhrzeitmanipulation

Wenn Ihr Programm epoch oder unix_timestamp aus dem Clock-Sysvar liest, verwenden Sie setClock, um diese Felder direkt zu setzen:

import { createClient, generateKeyPairSigner } from "@solana/kit";
import { litesvm } from "@solana/kit-plugin-litesvm";
import { signer } from "@solana/kit-plugin-signer";
const mySigner = await generateKeyPairSigner();
const client = createClient().use(signer(mySigner)).use(litesvm());
client.svm.withSysvars();
// Get clock, mutate, write back
const clock = client.svm.getClock();
clock.slot = 50000n;
clock.epoch = 5n;
clock.unixTimestamp = 1700000000n;
client.svm.setClock(clock);
const after = client.svm.getClock();
console.log("Slot:", after.slot); // 50000n
console.log("Epoch:", after.epoch); // 5n
console.log("Timestamp:", after.unixTimestamp); // 1700000000n

Dies entspricht dem Rust-Muster set_sysvar(&clock). Verwenden Sie warpToSlot für einfaches slot-Vorsetzen und setClock, wenn Sie epoch- oder Zeitstempelkontrolle benötigen.

Anwendungsfälle

Zeitmanipulation ist nützlich zum Testen von:

SzenarioAnsatz
Token-VestingÜber Vesting-Cliff/Meilensteine hinaus vorsetzen
AuktionsendenÜber den Auktionsend-slot hinaus vorsetzen
Staking-BelohnungensetClock verwenden, um epoch zu setzen
Zeitgesperrte AuszahlungenÜber den Freigabe-slot hinaus vorsetzen
RatenbegrenzungZwischen erlaubten Intervallen vorsetzen
Ablaufende AufträgeÜber den Auftragsablauf hinaus vorsetzen

Beachten Sie, dass warpToSlot nur den slot ändert. Der Unix-Zeitstempel wird je nach SVM-Implementierung möglicherweise nicht proportional aktualisiert.

Wichtige Punkte

  1. Sysvars aktivieren: Rufen Sie withSysvars() auf, bevor Sie Uhrzeitmethoden verwenden
  2. Vorwärts vorsetzen: Verwenden Sie warpToSlot(slot), um den slot vorzusetzen
  3. Vollständige Kontrolle: Verwenden Sie setClock, wenn Sie epoch, unixTimestamp oder andere Uhrzeitfelder setzen müssen
  4. Uhr lesen: Verwenden Sie getClock(), um den aktuellen slot, epoch und Zeitstempel zu lesen
  5. Testmuster: Vor und nach Zeitgrenzen testen

Is this page helpful?

Inhaltsverzeichnis

Seite bearbeiten
© 2026 Solana Foundation. Alle Rechte vorbehalten.