Havainnollistaa warpToSlot-funktion käyttöä aikasidonnaisen ohjelmaluogiikan testaamiseen.
Peruskellon manipulointi
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);
Aikalukitun logiikan testaaminen
Esimerkkimalli aikalukitun toiminnallisuuden testaamiseen:
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);}
Epoch-aikataulun lukeminen
Voit lukea epoch-aikataulun ymmärtääksesi slot/epoch-suhteen klusterissa:
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 edistää kellon slot-kenttää, mutta ei automaattisesti
päivitä epoch- tai unixTimestamp-kenttiä. Käytä setClock-funktiota kellon
kenttien täydelliseen hallintaan.
Manuaalinen kellon manipulointi
Kun ohjelmasi lukee epoch- tai unix_timestamp-arvon Clock-sysvarista, käytä
setClock-funktiota asettaaksesi nämä kentät suoraan:
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
Tämä vastaa Rustin set_sysvar(&clock)-mallia. Käytä warpToSlot-funktiota yksinkertaiseen
slot-etenemiseen ja setClock-funktiota, kun tarvitset epoch- tai aikaleimahallintaa.
Käyttötapaukset
Aikamanipulointi on hyödyllistä seuraavien testaamiseen:
| Skenaario | Lähestymistapa |
|---|---|
| Tokenin vesting | Siirry vesting-rajan/välietappien ohi |
| Huutokaupan päättymiset | Siirry huutokaupan päättymisslot:n ohi |
| Staking-palkkiot | Käytä setClock-funktiota epoch:n asettamiseen |
| Aikalukitut nostot | Siirry avausslot:n ohi |
| Nopeusrajoitus | Siirry sallittujen välien välillä |
| Vanhenevat tilaukset | Siirry tilauksen vanhentumisen ohi |
Muista, että warpToSlot muuttaa vain slot:n. Unix-aikaleima ei välttämättä
päivity suhteessa SVM-toteutuksesta riippuen.
Keskeiset kohdat
- Ota Sysvarit käyttöön: Kutsu
withSysvars()ennen kellometodien käyttöä - Siirry eteenpäin: Käytä
warpToSlot(slot)-funktiota slot:n edistämiseen - Täysi hallinta: Käytä
setClock-funktiota, kun haluat asettaaepoch-,unixTimestamp- tai muita kellokenttiä - Lue kello: Käytä
getClock()-funktiota nykyisen slot:n, epoch:n ja aikaleiman lukemiseen - Testausmalli: Testaa ennen ja jälkeen aikarajojen
Is this page helpful?