Mendemonstrasikan penggunaan warpToSlot untuk menguji logika program yang bergantung pada waktu.
Manipulasi Clock Dasar
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);
Menguji Logika Terkunci Waktu
Contoh pola untuk menguji fungsionalitas terkunci waktu:
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);}
Membaca Jadwal Epoch
Anda dapat membaca jadwal epoch untuk memahami hubungan slot/epoch pada kluster:
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 memajukan field slot pada clock tetapi tidak secara otomatis
memperbarui epoch atau unixTimestamp. Gunakan setClock untuk kontrol penuh atas
field clock.
Manipulasi Clock Manual
Ketika program Anda membaca epoch atau unix_timestamp dari Clock sysvar, gunakan
setClock untuk mengatur field tersebut secara langsung:
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
Ini mencerminkan pola set_sysvar(&clock) di Rust. Gunakan warpToSlot untuk kemajuan
slot sederhana, gunakan setClock saat Anda membutuhkan kontrol epoch atau timestamp.
Kasus Penggunaan
Manipulasi waktu berguna untuk menguji:
| Skenario | Pendekatan |
|---|---|
| Vesting token | Warp melewati cliff/milestone vesting |
| Akhir lelang | Warp melewati slot akhir lelang |
| Hadiah staking | Gunakan setClock untuk mengatur epoch |
| Penarikan terkunci waktu | Warp melewati slot pembukaan kunci |
| Pembatasan laju | Warp di antara interval yang diizinkan |
| Order kedaluwarsa | Warp melewati kedaluwarsa order |
Ingat bahwa warpToSlot hanya mengubah slot. Unix timestamp mungkin tidak
diperbarui secara proporsional tergantung pada implementasi SVM.
Poin Utama
- Aktifkan Sysvar: Panggil
withSysvars()sebelum menggunakan metode clock - Maju ke Depan: Gunakan
warpToSlot(slot)untuk memajukan slot - Kontrol Penuh: Gunakan
setClocksaat Anda perlu mengaturepoch,unixTimestamp, atau field clock lainnya - Baca Clock: Gunakan
getClock()untuk membaca slot, epoch, timestamp saat ini - Pola Pengujian: Uji sebelum dan sesudah batas waktu
Is this page helpful?