feat(anchor): add sysvar data aliases

Author: DaviRain-Su

CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to the Solana SDK Zig implementation will be documented in this file.
 
+### Session 2026-01-15-090
+
+**Date**: 2026-01-15
+**Goal**: Add sysvar data aliases
+
+#### Completed Work
+1. Added pre-defined SysvarData aliases (Clock/Rent/EpochSchedule/etc.)
+2. Added sysvar id-only wrappers
+3. Updated docs and examples
+
+#### Test Results
+- `./solana-zig/zig build test --summary all`
+
 ### Session 2026-01-15-089
 
 **Date**: 2026-01-15

anchor/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to sol-anchor-zig will be documented in this file.
 
+### Session 2026-01-15-018
+
+**Date**: 2026-01-15
+**Goal**: Add sysvar data aliases
+
+#### Completed Work
+1. Added pre-defined SysvarData aliases (Clock/Rent/EpochSchedule/etc.)
+2. Added sysvar id-only wrappers
+3. Updated docs and examples
+
+#### Test Results
+- `./solana-zig/zig build test --summary all`
+
 ### Session 2026-01-15-017
 
 **Date**: 2026-01-15

anchor/README.md

@@ -365,6 +365,18 @@ fn addMemo(ctx: anchor.Context(Accounts)) !void {
 }
 ```
 
+## Sysvar Data Wrappers
+
+Use `SysvarData` aliases to parse common sysvars directly.
+
+```zig
+const Accounts = struct {
+    clock: anchor.ClockData,
+    rent: anchor.RentData,
+    epoch_schedule: anchor.EpochScheduleData,
+};
+```
+
 ## Stake Wrappers + CPI Helpers
 
 Use `anchor.StakeAccount` to parse stake state and `anchor.stake` CPI helpers

anchor/ROADMAP.md

@@ -1,5 +1,11 @@
 # sol-anchor-zig Roadmap
 
+## ✅ v3.2.68 - Sysvar Data Aliases
+
+- [x] Add common SysvarData aliases (Clock/Rent/EpochSchedule/etc.)
+- [x] Add sysvar id-only wrappers
+- [x] Update docs and examples
+
 ## ✅ v3.2.67 - Transfer Checked Sugar
 
 - [x] Add `transferCheckedWithMint` helper for token CPI

anchor/src/root.zig

@@ -559,6 +559,24 @@ pub const Sysvar = sysvar_account.Sysvar;
 /// Sysvar account wrapper with data parsing.
 pub const SysvarData = sysvar_account.SysvarData;
 
+/// Sysvar data wrappers
+pub const ClockData = sysvar_account.ClockData;
+pub const RentData = sysvar_account.RentData;
+pub const EpochScheduleData = sysvar_account.EpochScheduleData;
+pub const SlotHashesData = sysvar_account.SlotHashesData;
+pub const SlotHistoryData = sysvar_account.SlotHistoryData;
+pub const EpochRewardsData = sysvar_account.EpochRewardsData;
+pub const LastRestartSlotData = sysvar_account.LastRestartSlotData;
+
+/// Sysvar id-only wrappers
+pub const ClockSysvar = sysvar_account.ClockSysvar;
+pub const RentSysvar = sysvar_account.RentSysvar;
+pub const EpochScheduleSysvar = sysvar_account.EpochScheduleSysvar;
+pub const SlotHashesSysvar = sysvar_account.SlotHashesSysvar;
+pub const SlotHistorySysvar = sysvar_account.SlotHistorySysvar;
+pub const EpochRewardsSysvar = sysvar_account.EpochRewardsSysvar;
+pub const LastRestartSlotSysvar = sysvar_account.LastRestartSlotSysvar;
+
 // ============================================================================
 // Context Module
 // ============================================================================
@@ -947,6 +965,20 @@ test "anchor module exports" {
     _ = Context;
     _ = Sysvar;
     _ = SysvarData;
+    _ = ClockData;
+    _ = RentData;
+    _ = EpochScheduleData;
+    _ = SlotHashesData;
+    _ = SlotHistoryData;
+    _ = EpochRewardsData;
+    _ = LastRestartSlotData;
+    _ = ClockSysvar;
+    _ = RentSysvar;
+    _ = EpochScheduleSysvar;
+    _ = SlotHashesSysvar;
+    _ = SlotHistorySysvar;
+    _ = EpochRewardsSysvar;
+    _ = LastRestartSlotSysvar;
     _ = token;
     _ = associated_token;
     _ = memo;

anchor/src/sysvar_account.zig

@@ -18,6 +18,22 @@ pub fn SysvarId(comptime sysvar_id: PublicKey) type {
 pub const Instructions = SysvarId(sol.INSTRUCTIONS_ID);
 pub const StakeHistory = SysvarId(sol.STAKE_HISTORY_ID);
 
+pub const ClockData = SysvarData(sol.clock.Clock);
+pub const RentData = SysvarData(sol.rent.Rent.Data);
+pub const EpochScheduleData = SysvarData(sol.epoch_schedule.EpochSchedule);
+pub const SlotHashesData = SysvarData(sol.slot_hashes.SlotHashes);
+pub const SlotHistoryData = SysvarData(sol.slot_history.SlotHistory);
+pub const EpochRewardsData = SysvarData(sol.epoch_rewards.EpochRewards);
+pub const LastRestartSlotData = SysvarData(sol.last_restart_slot.LastRestartSlot);
+
+pub const ClockSysvar = SysvarId(sol.sysvar_id.CLOCK);
+pub const RentSysvar = SysvarId(sol.sysvar_id.RENT);
+pub const EpochScheduleSysvar = SysvarId(sol.sysvar_id.EPOCH_SCHEDULE);
+pub const SlotHashesSysvar = SysvarId(sol.sysvar_id.SLOT_HASHES);
+pub const SlotHistorySysvar = SysvarId(sol.sysvar_id.SLOT_HISTORY);
+pub const EpochRewardsSysvar = SysvarId(sol.sysvar_id.EPOCH_REWARDS);
+pub const LastRestartSlotSysvar = SysvarId(sol.sysvar_id.LAST_RESTART_SLOT);
+
 /// Sysvar account wrapper with address validation.
 pub fn Sysvar(comptime SysvarType: type) type {
     if (!@hasDecl(SysvarType, "id")) {

anchor/src/typed_dsl.zig

@@ -164,27 +164,39 @@ pub fn SysvarAccount(comptime sysvar_id: PublicKey) type {
 
 /// Rent Sysvar marker.
 /// Usage: `.rent = RentSysvar`
-pub const RentSysvar = SysvarAccount(PublicKey.comptimeFromBase58("SysvarRent111111111111111111111111111111111"));
+pub const RentSysvar = SysvarAccount(sol.sysvar_id.RENT);
 
 /// Clock Sysvar marker.
 /// Usage: `.clock = ClockSysvar`
-pub const ClockSysvar = SysvarAccount(PublicKey.comptimeFromBase58("SysvarC1ock11111111111111111111111111111111"));
+pub const ClockSysvar = SysvarAccount(sol.sysvar_id.CLOCK);
 
 /// Epoch Schedule Sysvar marker.
 /// Usage: `.epoch_schedule = EpochScheduleSysvar`
-pub const EpochScheduleSysvar = SysvarAccount(PublicKey.comptimeFromBase58("SysvarEpochScheworLNPkL1MWVrwsLE4D8F2auJV1"));
+pub const EpochScheduleSysvar = SysvarAccount(sol.sysvar_id.EPOCH_SCHEDULE);
 
 /// Slot Hashes Sysvar marker.
 /// Usage: `.slot_hashes = SlotHashesSysvar`
-pub const SlotHashesSysvar = SysvarAccount(PublicKey.comptimeFromBase58("SysvarS1otHashes111111111111111111111111111"));
+pub const SlotHashesSysvar = SysvarAccount(sol.sysvar_id.SLOT_HASHES);
+
+/// Slot History Sysvar marker.
+/// Usage: `.slot_history = SlotHistorySysvar`
+pub const SlotHistorySysvar = SysvarAccount(sol.sysvar_id.SLOT_HISTORY);
 
 /// Stake History Sysvar marker.
 /// Usage: `.stake_history = StakeHistorySysvar`
-pub const StakeHistorySysvar = SysvarAccount(PublicKey.comptimeFromBase58("SysvarStakeHistory1111111111111111111111111"));
+pub const StakeHistorySysvar = SysvarAccount(sol.sysvar_id.STAKE_HISTORY);
+
+/// Epoch Rewards Sysvar marker.
+/// Usage: `.epoch_rewards = EpochRewardsSysvar`
+pub const EpochRewardsSysvar = SysvarAccount(sol.sysvar_id.EPOCH_REWARDS);
+
+/// Last Restart Slot Sysvar marker.
+/// Usage: `.last_restart_slot = LastRestartSlotSysvar`
+pub const LastRestartSlotSysvar = SysvarAccount(sol.sysvar_id.LAST_RESTART_SLOT);
 
 /// Instructions Sysvar marker.
 /// Usage: `.instructions = InstructionsSysvar`
-pub const InstructionsSysvar = SysvarAccount(sol.instructions_sysvar.ID);
+pub const InstructionsSysvar = SysvarAccount(sol.sysvar_id.INSTRUCTIONS);
 
 // ============================================================================
 // Data Account with Type-Safe Config
@@ -1262,6 +1274,41 @@ test "predefined sysvar markers" {
         &ClockSysvar.ID.toBase58String(),
     );
 
+    // Epoch Schedule Sysvar
+    try std.testing.expect(EpochScheduleSysvar.IS_SYSVAR == true);
+    try std.testing.expectEqualStrings(
+        "SysvarEpochSchedu1e111111111111111111111111",
+        &EpochScheduleSysvar.ID.toBase58String(),
+    );
+
+    // Slot Hashes Sysvar
+    try std.testing.expect(SlotHashesSysvar.IS_SYSVAR == true);
+    try std.testing.expectEqualStrings(
+        "SysvarS1otHashes111111111111111111111111111",
+        &SlotHashesSysvar.ID.toBase58String(),
+    );
+
+    // Slot History Sysvar
+    try std.testing.expect(SlotHistorySysvar.IS_SYSVAR == true);
+    try std.testing.expectEqualStrings(
+        "SysvarS1otHistory11111111111111111111111111",
+        &SlotHistorySysvar.ID.toBase58String(),
+    );
+
+    // Epoch Rewards Sysvar
+    try std.testing.expect(EpochRewardsSysvar.IS_SYSVAR == true);
+    try std.testing.expectEqualStrings(
+        "SysvarEpochRewards1111111111111111111111111",
+        &EpochRewardsSysvar.ID.toBase58String(),
+    );
+
+    // Last Restart Slot Sysvar
+    try std.testing.expect(LastRestartSlotSysvar.IS_SYSVAR == true);
+    try std.testing.expectEqualStrings(
+        "SysvarLastRestartS1ot1111111111111111111111",
+        &LastRestartSlotSysvar.ID.toBase58String(),
+    );
+
     // Instructions Sysvar
     try std.testing.expect(InstructionsSysvar.IS_SYSVAR == true);
     try std.testing.expect(InstructionsSysvar.ID.equals(sol.instructions_sysvar.ID));
@@ -1275,10 +1322,16 @@ test "Accounts with predefined programs" {
         .memo_program = MemoProgram,
         .stake_program = StakeProgram,
         .rent = RentSysvar,
+        .clock = ClockSysvar,
+        .epoch_schedule = EpochScheduleSysvar,
+        .slot_hashes = SlotHashesSysvar,
+        .slot_history = SlotHistorySysvar,
+        .epoch_rewards = EpochRewardsSysvar,
+        .last_restart_slot = LastRestartSlotSysvar,
     });
 
     const fields = @typeInfo(TestAccounts).@"struct".fields;
-    try std.testing.expect(fields.len == 6);
+    try std.testing.expect(fields.len == 12);
 }
 
 test "isEventFieldWrapper" {

anchor/stories/v3.2.68-sysvar-data-aliases.md

@@ -0,0 +1,35 @@
+# Story: v3.2.68 Sysvar Data Aliases
+
+> Add pre-defined SysvarData wrappers for common sysvars.
+
+## Goals
+
+- Provide `ClockData`, `RentData`, `EpochScheduleData`, etc. for easy sysvar parsing.
+- Provide sysvar ID-only wrappers for common sysvars.
+
+## Acceptance Criteria
+
+### anchor/src/sysvar_account.zig
+
+- [x] Add SysvarData aliases for Clock/Rent/EpochSchedule/SlotHashes/SlotHistory/EpochRewards/LastRestartSlot.
+- [x] Add SysvarId aliases for common sysvars.
+
+### anchor/src/root.zig
+
+- [x] Export sysvar data aliases and id-only wrappers.
+
+### anchor/src/typed_dsl.zig
+
+- [x] Extend predefined sysvar markers to include epoch schedule, slot hashes, slot history, epoch rewards, last restart slot.
+
+### Documentation
+
+- [x] Update README and compatibility docs.
+- [x] Add sysvar data example.
+- [x] Update ROADMAP and CHANGELOG.
+
+## Completion Status
+
+- Start date: 2026-01-15
+- Completion date: 2026-01-15
+- Status: ✅ Completed

docs/ANCHOR_COMPATIBILITY.md

@@ -31,6 +31,7 @@ const sol = anchor.sdk;
 - Memo CPI helpers (`anchor.memo`)
 - Stake CPI helpers and StakeAccount wrapper (`anchor.stake`, `anchor.StakeAccount`)
 - ATA init/payer semantics via `anchor.typed.ATA` + `anchor.associated_token`
+- Sysvar data wrappers (`ClockData`, `RentData`, `EpochScheduleData`, etc.)
 
 ## Not Implemented Yet
 
@@ -72,7 +73,7 @@ const sol = anchor.sdk;
 | Stake account wrapper | `StakeAccount` | `anchor.StakeAccount(.{})` | ✅ |
 | Stake CPI helpers | `anchor_spl::stake::*` | `anchor.stake.*` | ✅ |
 | ATA init | `associated_token::create` | `anchor.typed.ATA` + `anchor.associated_token` | ✅ |
-| Sysvar parsing | `Sysvar<'info, T>` | `anchor.SysvarData(T)` | ✅ |
+| Sysvar parsing | `Sysvar<'info, T>` | `anchor.SysvarData(T)` / `ClockData` / `RentData` | ✅ |
 
 ## Example
 

examples/anchor_sysvar_data.zig

@@ -0,0 +1,15 @@
+//! Example: SysvarData wrappers.
+
+const anchor = @import("sol_anchor_zig");
+
+const Accounts = struct {
+    clock: anchor.ClockData,
+    rent: anchor.RentData,
+    epoch_schedule: anchor.EpochScheduleData,
+};
+
+pub fn readSysvars(ctx: anchor.Context(Accounts)) !void {
+    _ = ctx.accounts.clock.data;
+    _ = ctx.accounts.rent.data;
+    _ = ctx.accounts.epoch_schedule.data;
+}