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 accessclient.svm.withSysvars();// Check initial clockconst 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 1000client.svm.warpToSlot(1000n);const afterWarp = client.svm.getClock();console.log("\nAfter warpToSlot(1000):");console.log(" Slot:", afterWarp.slot);console.log(" Epoch:", afterWarp.epoch);// Warp furtherclient.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 payerclient.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; // discriminatorview.setBigUint64(1, unlockSlot, true); // unlock_slotview.setBigUint64(9, lockedAmount, true); // amountconst 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 failconsole.log("Withdrawal attempt: EXPECTED TO FAIL (too early)");// Test 2: Warp to after unlock slotconsole.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 succeedconsole.log("Withdrawal attempt: EXPECTED TO SUCCEED (after unlock)");// Verify vault stateconst 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 backconst 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); // 50000nconsole.log("Epoch:", after.epoch); // 5nconsole.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:
| Szenario | Ansatz |
|---|---|
| Token-Vesting | Über Vesting-Cliff/Meilensteine hinaus vorsetzen |
| Auktionsenden | Über den Auktionsend-slot hinaus vorsetzen |
| Staking-Belohnungen | setClock verwenden, um epoch zu setzen |
| Zeitgesperrte Auszahlungen | Über den Freigabe-slot hinaus vorsetzen |
| Ratenbegrenzung | Zwischen 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
- Sysvars aktivieren: Rufen Sie
withSysvars()auf, bevor Sie Uhrzeitmethoden verwenden - Vorwärts vorsetzen: Verwenden Sie
warpToSlot(slot), um den slot vorzusetzen - Vollständige Kontrolle: Verwenden Sie
setClock, wenn Sieepoch,unixTimestampoder andere Uhrzeitfelder setzen müssen - Uhr lesen: Verwenden Sie
getClock(), um den aktuellen slot, epoch und Zeitstempel zu lesen - Testmuster: Vor und nach Zeitgrenzen testen
Is this page helpful?