genlayer 0.32.6 → 0.33.0

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 
-## 0.32.6 (2025-12-12)
+## 0.33.0 (2026-01-13)
+
+### Features
+
+* validator tree traversal, primed column, prime-all command ([#270](https://github.com/yeagerai/genlayer-cli/issues/270)) ([75b9b06](https://github.com/yeagerai/genlayer-cli/commit/75b9b06a3bb80a24e7dabf422ceed44620765ccb))
+
+## 0.32.8 (2025-12-12)
 
 ## 0.32.5 (2025-12-09)
 

package/README.md

@@ -306,14 +306,16 @@ COMMANDS:
    validator-deposit [options]   Make an additional deposit as a validator
    validator-exit [options]      Exit as a validator by withdrawing shares
    validator-claim [options]     Claim validator withdrawals after unbonding period
+   validator-prime [validator]   Prime a validator for the next epoch
+   prime-all [options]           Prime all validators that need priming
    delegator-join [options]      Join as a delegator by staking with a validator
    delegator-exit [options]      Exit as a delegator by withdrawing shares
    delegator-claim [options]     Claim delegator withdrawals after unbonding period
-   validator-info [validator]    Get information about a validator
+   validator-info [validator]    Get information about a validator (--debug for raw data)
    validator-history [validator] Show slash and reward history for a validator
    delegation-info [validator]   Get delegation info for a delegator with a validator
    epoch-info [options]          Get current/previous epoch info (--epoch <n> for specific)
-   validators [options]          Show validator set with stake, status, and weight
+   validators [options]          Show validator set with stake, primed status, and weight
    active-validators [options]   List all active validators
    quarantined-validators        List all quarantined validators
    banned-validators             List all banned validators
@@ -399,20 +401,29 @@ EXAMPLES:
    genlayer staking validators
    genlayer staking validators --all  # Include banned validators
 
-   # Show validator slash/reward history (testnet only)
+   # Show validator slash/reward history (testnet only, default: last 10 epochs)
    genlayer staking validator-history 0x...
+   genlayer staking validator-history 0x... --epochs 5   # Last 5 epochs
+   genlayer staking validator-history 0x... --from-epoch 3  # From epoch 3
+   genlayer staking validator-history 0x... --all  # Complete history (slow)
    genlayer staking validator-history 0x... --limit 20
    # Output:
-   # ┌─────────────┬───────┬────────┬────────────────────────┬─────────┐
-   # │ Time        │ Epoch │ Type   │ Details                │ Block   │
-   # ├─────────────┼───────┼────────┼────────────────────────┼─────────┤
-   # │ 12-11 14:20 │ 5     │ REWARD │ Val: 0 GEN, Del: 0 GEN │ 4725136 │
-   # │ 12-10 18:39 │ 4     │ SLASH  │ 1.00% penalty          │ 4717431 │
-   # └─────────────┴───────┴────────┴────────────────────────┴─────────┘
+   # ┌─────────────┬───────┬────────┬────────┬────────────────────────────────────┐
+   # │ Time        │ Epoch │ Type   │ Details│ GL TxId / Block                    │
+   # ├─────────────┼───────┼────────┼────────┼────────────────────────────────────┤
+   # │ 12-11 14:20 │ 5     │ REWARD │ Val: …│ block 4725136                      │
+   # │ 12-10 18:39 │ 4     │ SLASH  │ 1.00% │ 0x52db90a9...                       │
+   # └─────────────┴───────┴────────┴────────┴────────────────────────────────────┘
 
    # Exit and claim (requires validator wallet address)
    genlayer staking validator-exit --validator 0x... --shares 100
    genlayer staking validator-claim --validator 0x...
+
+   # Prime a validator for next epoch
+   genlayer staking validator-prime 0x...
+
+   # Prime all validators that need priming (anyone can call)
+   genlayer staking prime-all
 ```
 
 ### Running the CLI from the repository

package/dist/index.js

@@ -20078,7 +20078,7 @@ var require_cli_table3 = __commonJS({
 import { program } from "commander";
 
 // package.json
-var version = "0.32.6";
+var version = "0.33.0";
 var package_default = {
   name: "genlayer",
   version,
@@ -51305,7 +51305,16 @@ function initializeTransactionsCommands(program2) {
 
 // src/commands/staking/StakingAction.ts
 import { readFileSync as readFileSync8, existsSync as existsSync7 } from "fs";
-import { ethers as ethers6 } from "ethers";
+import { ethers as ethers6, ZeroAddress } from "ethers";
+var STAKING_TREE_ABI = [
+  {
+    name: "validatorsRoot",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "address" }]
+  }
+];
 var StakingAction = class extends BaseAction {
   constructor() {
     super();
@@ -51392,7 +51401,7 @@ var StakingAction = class extends BaseAction {
     }
     this.stopSpinner();
     const password = await this.promptPassword(`Enter password to unlock account '${accountName}':`);
-    this.startSpinner("Continuing...");
+    this.startSpinner("Unlocking account...");
     const wallet = await ethers6.Wallet.fromEncryptedJson(keystoreJson, password);
     return wallet.privateKey;
   }
@@ -51439,6 +51448,52 @@ var StakingAction = class extends BaseAction {
       signerAddress: account.address
     };
   }
+  /**
+   * Get all validators by traversing the validator tree.
+   * This finds ALL validators including those not yet active/primed.
+   */
+  async getAllValidatorsFromTree(config) {
+    const network = this.getNetwork(config);
+    const rpcUrl = config.rpc || network.rpcUrls.default.http[0];
+    const stakingAddress = config.stakingAddress || network.stakingContract?.address;
+    if (!stakingAddress) {
+      throw new Error("Staking contract address not configured");
+    }
+    const publicClient = createPublicClient({
+      chain: network,
+      transport: http3(rpcUrl)
+    });
+    const root = await publicClient.readContract({
+      address: stakingAddress,
+      abi: STAKING_TREE_ABI,
+      functionName: "validatorsRoot"
+    });
+    if (root === ZeroAddress) {
+      return [];
+    }
+    const validators = [];
+    const stack = [root];
+    const visited = /* @__PURE__ */ new Set();
+    while (stack.length > 0) {
+      const addr = stack.pop();
+      if (addr === ZeroAddress || visited.has(addr.toLowerCase())) continue;
+      visited.add(addr.toLowerCase());
+      validators.push(addr);
+      const info = await publicClient.readContract({
+        address: stakingAddress,
+        abi: abi_exports.STAKING_ABI,
+        functionName: "validatorView",
+        args: [addr]
+      });
+      if (info.left !== ZeroAddress) {
+        stack.push(info.left);
+      }
+      if (info.right !== ZeroAddress) {
+        stack.push(info.right);
+      }
+    }
+    return validators;
+  }
 };
 
 // src/commands/staking/validatorJoin.ts
@@ -51605,6 +51660,38 @@ var ValidatorPrimeAction = class extends StakingAction {
       this.failSpinner("Failed to prime validator", error.message || error);
     }
   }
+  async primeAll(options) {
+    this.startSpinner("Fetching validators...");
+    try {
+      const client = await this.getStakingClient(options);
+      this.setSpinnerText("Fetching validators...");
+      const allValidators = await this.getAllValidatorsFromTree(options);
+      this.stopSpinner();
+      console.log(`
+Priming ${allValidators.length} validators:
+`);
+      let succeeded = 0;
+      let skipped = 0;
+      for (const addr of allValidators) {
+        process.stdout.write(`  ${addr} ... `);
+        try {
+          const result = await client.validatorPrime({ validator: addr });
+          console.log(source_default.green(`primed ${result.transactionHash}`));
+          succeeded++;
+        } catch (error) {
+          const msg = error.message || String(error);
+          const shortErr = msg.length > 60 ? msg.slice(0, 57) + "..." : msg;
+          console.log(source_default.gray(`skipped: ${shortErr}`));
+          skipped++;
+        }
+      }
+      console.log(`
+${source_default.green(`${succeeded} primed`)}, ${source_default.gray(`${skipped} skipped`)}
+`);
+    } catch (error) {
+      this.failSpinner("Failed to prime validators", error.message || error);
+    }
+  }
 };
 
 // src/commands/staking/setOperator.ts
@@ -51814,6 +51901,7 @@ var StakingInfoAction = class extends StakingAction {
       ]);
       const currentEpoch = epochInfo.currentEpoch;
       const result = {
+        ...options.debug && { currentEpoch: currentEpoch.toString() },
         validator: info.address,
         owner: info.owner,
         operator: info.operator,
@@ -51828,19 +51916,20 @@ var StakingInfoAction = class extends StakingAction {
         live: info.live,
         banned: info.banned ? info.bannedEpoch?.toString() : "Not banned",
         selfStakePendingDeposits: (() => {
-          const pending = info.pendingDeposits.filter((d) => d.epoch + ACTIVATION_DELAY_EPOCHS > currentEpoch);
-          return pending.length > 0 ? pending.map((d) => {
+          const deposits = options.debug ? info.pendingDeposits : info.pendingDeposits.filter((d) => d.epoch + ACTIVATION_DELAY_EPOCHS > currentEpoch);
+          return deposits.length > 0 ? deposits.map((d) => {
             const depositEpoch = d.epoch;
             const activationEpoch = depositEpoch + ACTIVATION_DELAY_EPOCHS;
             const epochsUntilActive = activationEpoch - currentEpoch;
+            const isActivated = epochsUntilActive <= 0n;
             return {
               epoch: depositEpoch.toString(),
               stake: d.stake,
               shares: d.shares.toString(),
               activatesAtEpoch: activationEpoch.toString(),
-              epochsRemaining: epochsUntilActive.toString()
+              ...options.debug ? { status: isActivated ? "ACTIVATED" : `pending (${epochsUntilActive} epochs)` } : { epochsRemaining: epochsUntilActive.toString() }
             };
-          }) : "None";
+          }) : options.debug ? `None (raw count: ${info.pendingDeposits.length})` : "None";
         })(),
         selfStakePendingWithdrawals: info.pendingWithdrawals.length > 0 ? info.pendingWithdrawals.map((w) => {
           const exitEpoch = w.epoch;
@@ -52072,6 +52161,7 @@ var StakingInfoAction = class extends StakingAction {
         myAddress = await this.getSignerAddress();
       } catch {
       }
+      const allTreeAddresses = await this.getAllValidatorsFromTree(options);
       const [activeAddresses, quarantinedList, bannedList, epochInfo] = await Promise.all([
         client.getActiveValidators(),
         client.getQuarantinedValidatorsDetailed(),
@@ -52080,12 +52170,9 @@ var StakingInfoAction = class extends StakingAction {
       ]);
       const quarantinedSet = new Map(quarantinedList.map((v) => [v.validator.toLowerCase(), v]));
       const bannedSet = new Map(bannedList.map((v) => [v.validator.toLowerCase(), v]));
-      const allAddresses = /* @__PURE__ */ new Set([
-        ...activeAddresses,
-        ...quarantinedList.map((v) => v.validator),
-        ...options.all ? bannedList.map((v) => v.validator) : []
-      ]);
-      this.setSpinnerText(`Fetching details for ${allAddresses.size} validators...`);
+      const activeSet = new Set(activeAddresses.map((a) => a.toLowerCase()));
+      const allAddresses = options.all ? allTreeAddresses : allTreeAddresses.filter((addr) => !bannedSet.has(addr.toLowerCase()));
+      this.setSpinnerText(`Fetching details for ${allAddresses.length} validators...`);
       const BATCH_SIZE = 5;
       const addressArray = Array.from(allAddresses);
       const validatorInfos = [];
@@ -52103,7 +52190,7 @@ var StakingInfoAction = class extends StakingAction {
         const addrLower = info.address.toLowerCase();
         const isQuarantined = quarantinedSet.has(addrLower);
         const isBanned = bannedSet.has(addrLower);
-        const isActive = activeAddresses.some((a) => a.toLowerCase() === addrLower);
+        const isActive = activeSet.has(addrLower);
         let status = "";
         if (isBanned) {
           const banInfo = bannedSet.get(addrLower);
@@ -52111,8 +52198,6 @@ var StakingInfoAction = class extends StakingAction {
         } else if (isQuarantined) {
           const qInfo = quarantinedSet.get(addrLower);
           status = `quarant(e${qInfo.untilEpoch})`;
-        } else if (info.needsPriming) {
-          status = "prime!";
         } else if (isActive) {
           status = "active";
         } else {
@@ -52156,6 +52241,7 @@ var StakingInfoAction = class extends StakingAction {
           source_default.cyan("Self"),
           source_default.cyan("Deleg"),
           source_default.cyan("Pending"),
+          source_default.cyan("Primed"),
           source_default.cyan("Weight"),
           source_default.cyan("Status")
         ],
@@ -52190,12 +52276,19 @@ var StakingInfoAction = class extends StakingAction {
         if (moniker.length > 20) moniker = moniker.slice(0, 19) + "\u2026";
         const validatorCell = moniker ? `${moniker}${roleTag}
 ${source_default.gray(info.address)}` : `${source_default.gray(info.address)}${roleTag}`;
+        let primedStr;
+        if (info.ePrimed >= currentEpoch) {
+          primedStr = source_default.green(`e${info.ePrimed}`);
+        } else if (info.ePrimed === currentEpoch - 1n) {
+          primedStr = source_default.yellow(`e${info.ePrimed}`);
+        } else {
+          primedStr = source_default.red(`e${info.ePrimed}!`);
+        }
         let statusStr = status;
         if (status === "active") statusStr = source_default.green(status);
         else if (status === "BANNED") statusStr = source_default.red(status);
         else if (status.startsWith("quarant")) statusStr = source_default.yellow(status);
         else if (status.startsWith("banned")) statusStr = source_default.red(status);
-        else if (status === "prime!") statusStr = source_default.magenta(status);
         else if (status === "pending") statusStr = source_default.gray(status);
         table.push([
           (idx + 1).toString(),
@@ -52203,6 +52296,7 @@ ${source_default.gray(info.address)}` : `${source_default.gray(info.address)}${r
           formatStake(info.vStake),
           formatStake(info.dStake),
           pendingStr,
+          primedStr,
           weightStr,
           statusStr
         ]);
@@ -52281,7 +52375,22 @@ var ValidatorHistoryAction = class extends StakingAction {
         chain,
         transport: http3(chain.rpcUrls.default.http[0])
       });
-      const fromBlock = options.fromBlock ? BigInt(options.fromBlock) : 0n;
+      const epochInfo = await client.getEpochInfo();
+      const currentEpoch = epochInfo.currentEpoch;
+      const defaultEpochs = 10n;
+      let minEpoch = null;
+      let fromBlock = "earliest";
+      if (options.fromBlock) {
+        fromBlock = BigInt(options.fromBlock);
+      } else if (options.fromEpoch) {
+        minEpoch = BigInt(options.fromEpoch);
+      } else if (options.all) {
+        console.log(source_default.yellow("Warning: Fetching all history from genesis. This may be slow for long-lived validators."));
+        console.log(source_default.yellow("Consider using --epochs <n> or --from-epoch <n> for faster queries.\n"));
+      } else {
+        const numEpochs = options.epochs ? BigInt(options.epochs) : defaultEpochs;
+        minEpoch = currentEpoch > numEpochs ? currentEpoch - numEpochs : 0n;
+      }
       const limit = options.limit ? parseInt(options.limit) : 50;
       this.setSpinnerText("Fetching slash events...");
       const slashLogs = await publicClient.getLogs({
@@ -52315,7 +52424,7 @@ var ValidatorHistoryAction = class extends StakingAction {
           blockTimestamps.set(block.number, new Date(Number(block.timestamp) * 1e3));
         });
       }
-      const slashEvents = slashLogs.map((log) => ({
+      let slashEvents = slashLogs.map((log) => ({
         type: "slash",
         epoch: log.args.epoch,
         txId: log.args.txId,
@@ -52323,7 +52432,7 @@ var ValidatorHistoryAction = class extends StakingAction {
         blockNumber: log.blockNumber,
         timestamp: blockTimestamps.get(log.blockNumber) || /* @__PURE__ */ new Date(0)
       }));
-      const rewardEvents = filteredRewardLogs.map((log) => ({
+      let rewardEvents = filteredRewardLogs.map((log) => ({
         type: "reward",
         epoch: log.args.epoch,
         validatorRewards: log.args.validatorRewards,
@@ -52331,6 +52440,10 @@ var ValidatorHistoryAction = class extends StakingAction {
         blockNumber: log.blockNumber,
         timestamp: blockTimestamps.get(log.blockNumber) || /* @__PURE__ */ new Date(0)
       }));
+      if (minEpoch !== null) {
+        slashEvents = slashEvents.filter((e2) => e2.epoch >= minEpoch);
+        rewardEvents = rewardEvents.filter((e2) => e2.epoch >= minEpoch);
+      }
       const allEvents = [...slashEvents, ...rewardEvents];
       allEvents.sort((a, b) => Number(b.blockNumber - a.blockNumber));
       const limitedEvents = allEvents.slice(0, limit);
@@ -52384,7 +52497,9 @@ var ValidatorHistoryAction = class extends StakingAction {
       console.log(source_default.bold(`History for ${validatorAddress}`));
       console.log(table.toString());
       console.log("");
+      const epochRangeInfo = minEpoch !== null ? `epochs ${minEpoch}-${currentEpoch}` : options.fromBlock ? `from block ${options.fromBlock}` : "all epochs";
       console.log(source_default.gray("Summary:"));
+      console.log(source_default.gray(`  Range: ${epochRangeInfo}`));
       console.log(source_default.gray(`  Slash events: ${slashEvents.length}`));
       console.log(source_default.gray(`  Reward events: ${rewardEvents.length}`));
       console.log(source_default.gray(`  Total validator rewards: ${client.formatStakingAmount(totalValidatorRewards)}`));
@@ -52392,6 +52507,7 @@ var ValidatorHistoryAction = class extends StakingAction {
       if (allEvents.length > limit) {
         console.log(source_default.gray(`  (showing ${limit} of ${allEvents.length} events)`));
       }
+      console.log(source_default.gray(`  Use --all to fetch complete history, --epochs <n> for last N epochs`));
       console.log("");
     } catch (error) {
       this.failSpinner("Failed to get validator history", error.message || error);
@@ -53084,6 +53200,10 @@ function initializeStakingCommands(program2) {
     const action = new ValidatorPrimeAction();
     await action.execute({ ...options, validator });
   });
+  staking.command("prime-all").description("Prime all validators that need priming").option("--account <name>", "Account to use (pays gas)").option("--network <network>", "Network to use (localnet, testnet-asimov)").option("--rpc <rpcUrl>", "RPC URL for the network").option("--staking-address <address>", "Staking contract address (overrides chain config)").action(async (options) => {
+    const action = new ValidatorPrimeAction();
+    await action.primeAll(options);
+  });
   staking.command("set-operator [validator] [operator]").description("Change the operator address for a validator wallet").option("--validator <address>", "Validator wallet address (deprecated, use positional arg)").option("--operator <address>", "New operator address (deprecated, use positional arg)").option("--account <name>", "Account to use (must be validator owner)").option("--network <network>", "Network to use (localnet, testnet-asimov)").option("--rpc <rpcUrl>", "RPC URL for the network").action(async (validatorArg, operatorArg, options) => {
     const validator = validatorArg || options.validator;
     const operator = operatorArg || options.operator;
@@ -53130,7 +53250,7 @@ function initializeStakingCommands(program2) {
     const action = new DelegatorClaimAction();
     await action.execute({ ...options, validator });
   });
-  staking.command("validator-info [validator]").description("Get information about a validator").option("--validator <address>", "Validator address (deprecated, use positional arg)").option("--account <name>", "Account to use (for default validator address)").option("--network <network>", "Network to use (localnet, testnet-asimov)").option("--rpc <rpcUrl>", "RPC URL for the network").option("--staking-address <address>", "Staking contract address (overrides chain config)").action(async (validatorArg, options) => {
+  staking.command("validator-info [validator]").description("Get information about a validator").option("--validator <address>", "Validator address (deprecated, use positional arg)").option("--account <name>", "Account to use (for default validator address)").option("--network <network>", "Network to use (localnet, testnet-asimov)").option("--rpc <rpcUrl>", "RPC URL for the network").option("--staking-address <address>", "Staking contract address (overrides chain config)").option("--debug", "Show raw unfiltered pending deposits/withdrawals").action(async (validatorArg, options) => {
     const validator = validatorArg || options.validator;
     const action = new StakingInfoAction();
     await action.getValidatorInfo({ ...options, validator });
@@ -53164,7 +53284,7 @@ function initializeStakingCommands(program2) {
     const action = new StakingInfoAction();
     await action.listValidators(options);
   });
-  staking.command("validator-history [validator]").description("Show slash and reward history for a validator").option("--validator <address>", "Validator address (deprecated, use positional arg)").option("--from-block <block>", "Start from this block number").option("--limit <count>", "Maximum number of events to show (default: 50)").option("--account <name>", "Account to use (for default validator address)").option("--network <network>", "Network to use (localnet, testnet-asimov)").option("--rpc <rpcUrl>", "RPC URL for the network").option("--staking-address <address>", "Staking contract address (overrides chain config)").action(async (validatorArg, options) => {
+  staking.command("validator-history [validator]").description("Show slash and reward history for a validator (default: last 10 epochs)").option("--validator <address>", "Validator address (deprecated, use positional arg)").option("--epochs <count>", "Number of recent epochs to fetch (default: 10)").option("--from-epoch <epoch>", "Start from this epoch number").option("--from-block <block>", "Start from this block number (advanced)").option("--all", "Fetch complete history from genesis (slow)").option("--limit <count>", "Maximum number of events to show (default: 50)").option("--account <name>", "Account to use (for default validator address)").option("--network <network>", "Network to use (localnet, testnet-asimov)").option("--rpc <rpcUrl>", "RPC URL for the network").option("--staking-address <address>", "Staking contract address (overrides chain config)").action(async (validatorArg, options) => {
     const validator = validatorArg || options.validator;
     const action = new ValidatorHistoryAction();
     await action.execute({ ...options, validator });

package/docs/validator-guide.md

@@ -235,6 +235,23 @@ Output will include:
 
 ## Managing Your Validator
 
+### Priming Your Validator
+
+Validators must be "primed" each epoch to participate in consensus. Priming updates the validator's stake record for the upcoming epoch.
+
+```bash
+# Prime your validator
+genlayer staking validator-prime 0xYourValidator...
+
+# Or prime all validators at once (anyone can do this)
+genlayer staking prime-all
+```
+
+The `validators` command shows priming status:
+- **Green** `e11` - Primed for current epoch
+- **Yellow** `e10` - Needs priming before next epoch
+- **Red** `e9!` - Urgently needs priming (behind)
+
 ### Add More Stake
 
 ```bash
@@ -247,6 +264,16 @@ genlayer staking validator-deposit --validator 0xYourValidatorWallet... --amount
 genlayer staking active-validators
 ```
 
+### View Validator Set
+
+```bash
+# Show all validators with stake, primed status, and weight
+genlayer staking validators
+
+# Include banned validators
+genlayer staking validators --all
+```
+
 ### Exit as Validator
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genlayer",
-  "version": "0.32.6",
+  "version": "0.33.0",
   "description": "GenLayer Command Line Tool",
   "main": "src/index.ts",
   "type": "module",

package/src/commands/staking/StakingAction.ts

@@ -2,10 +2,21 @@ import {BaseAction, BUILT_IN_NETWORKS, resolveNetwork} from "../../lib/actions/B
 import {createClient, createAccount, formatStakingAmount, parseStakingAmount, abi} from "genlayer-js";
 import type {GenLayerClient, GenLayerChain, Address} from "genlayer-js/types";
 import {readFileSync, existsSync} from "fs";
-import {ethers} from "ethers";
+import {ethers, ZeroAddress} from "ethers";
 import {createPublicClient, createWalletClient, http, type PublicClient, type WalletClient, type Chain, type Account} from "viem";
 import {privateKeyToAccount} from "viem/accounts";
 
+// Extended ABI for tree traversal (not in SDK)
+const STAKING_TREE_ABI = [
+  {
+    name: "validatorsRoot",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{name: "", type: "address"}],
+  },
+] as const;
+
 // Re-export for use by other staking commands
 export {BUILT_IN_NETWORKS};
 
@@ -132,7 +143,7 @@ export class StakingAction extends BaseAction {
     // Stop spinner before prompting for password
     this.stopSpinner();
     const password = await this.promptPassword(`Enter password to unlock account '${accountName}':`);
-    this.startSpinner("Continuing...");
+    this.startSpinner("Unlocking account...");
 
     const wallet = await ethers.Wallet.fromEncryptedJson(keystoreJson, password);
     return wallet.privateKey;
@@ -193,4 +204,64 @@ export class StakingAction extends BaseAction {
       signerAddress: account.address as Address,
     };
   }
+
+  /**
+   * Get all validators by traversing the validator tree.
+   * This finds ALL validators including those not yet active/primed.
+   */
+  protected async getAllValidatorsFromTree(config: StakingConfig): Promise<Address[]> {
+    const network = this.getNetwork(config);
+    const rpcUrl = config.rpc || network.rpcUrls.default.http[0];
+    const stakingAddress = config.stakingAddress || network.stakingContract?.address;
+
+    if (!stakingAddress) {
+      throw new Error("Staking contract address not configured");
+    }
+
+    const publicClient = createPublicClient({
+      chain: network,
+      transport: http(rpcUrl),
+    });
+
+    // Get the root of the validator tree
+    const root = await publicClient.readContract({
+      address: stakingAddress as `0x${string}`,
+      abi: STAKING_TREE_ABI,
+      functionName: "validatorsRoot",
+    });
+
+    if (root === ZeroAddress) {
+      return [];
+    }
+
+    const validators: Address[] = [];
+    const stack: string[] = [root as string];
+    const visited = new Set<string>();
+
+    // Use validatorView from SDK's ABI (has left/right fields)
+    while (stack.length > 0) {
+      const addr = stack.pop()!;
+
+      if (addr === ZeroAddress || visited.has(addr.toLowerCase())) continue;
+      visited.add(addr.toLowerCase());
+
+      validators.push(addr as Address);
+
+      const info = await publicClient.readContract({
+        address: stakingAddress as `0x${string}`,
+        abi: abi.STAKING_ABI,
+        functionName: "validatorView",
+        args: [addr as `0x${string}`],
+      }) as {left: string; right: string};
+
+      if (info.left !== ZeroAddress) {
+        stack.push(info.left);
+      }
+      if (info.right !== ZeroAddress) {
+        stack.push(info.right);
+      }
+    }
+
+    return validators;
+  }
 }

package/src/commands/staking/index.ts

@@ -116,6 +116,18 @@ export function initializeStakingCommands(program: Command) {
       await action.execute({...options, validator});
     });
 
+  staking
+    .command("prime-all")
+    .description("Prime all validators that need priming")
+    .option("--account <name>", "Account to use (pays gas)")
+    .option("--network <network>", "Network to use (localnet, testnet-asimov)")
+    .option("--rpc <rpcUrl>", "RPC URL for the network")
+    .option("--staking-address <address>", "Staking contract address (overrides chain config)")
+    .action(async (options: StakingConfig) => {
+      const action = new ValidatorPrimeAction();
+      await action.primeAll(options);
+    });
+
   staking
     .command("set-operator [validator] [operator]")
     .description("Change the operator address for a validator wallet")
@@ -228,6 +240,7 @@ export function initializeStakingCommands(program: Command) {
     .option("--network <network>", "Network to use (localnet, testnet-asimov)")
     .option("--rpc <rpcUrl>", "RPC URL for the network")
     .option("--staking-address <address>", "Staking contract address (overrides chain config)")
+    .option("--debug", "Show raw unfiltered pending deposits/withdrawals")
     .action(async (validatorArg: string | undefined, options: StakingInfoOptions) => {
       const validator = validatorArg || options.validator;
       const action = new StakingInfoAction();
@@ -312,9 +325,12 @@ export function initializeStakingCommands(program: Command) {
 
   staking
     .command("validator-history [validator]")
-    .description("Show slash and reward history for a validator")
+    .description("Show slash and reward history for a validator (default: last 10 epochs)")
     .option("--validator <address>", "Validator address (deprecated, use positional arg)")
-    .option("--from-block <block>", "Start from this block number")
+    .option("--epochs <count>", "Number of recent epochs to fetch (default: 10)")
+    .option("--from-epoch <epoch>", "Start from this epoch number")
+    .option("--from-block <block>", "Start from this block number (advanced)")
+    .option("--all", "Fetch complete history from genesis (slow)")
     .option("--limit <count>", "Maximum number of events to show (default: 50)")
     .option("--account <name>", "Account to use (for default validator address)")
     .option("--network <network>", "Network to use (localnet, testnet-asimov)")

package/src/commands/staking/stakingInfo.ts

@@ -9,6 +9,7 @@ const UNBONDING_PERIOD_EPOCHS = 7n;
 
 export interface StakingInfoOptions extends StakingConfig {
   validator?: string;
+  debug?: boolean;
 }
 
 export class StakingInfoAction extends StakingAction {
@@ -38,6 +39,7 @@ export class StakingInfoAction extends StakingAction {
       const currentEpoch = epochInfo.currentEpoch;
 
       const result: Record<string, any> = {
+        ...(options.debug && {currentEpoch: currentEpoch.toString()}),
         validator: info.address,
         owner: info.owner,
         operator: info.operator,
@@ -52,22 +54,27 @@ export class StakingInfoAction extends StakingAction {
         live: info.live,
         banned: info.banned ? info.bannedEpoch?.toString() : "Not banned",
         selfStakePendingDeposits: (() => {
-          // Filter to only truly pending deposits (not yet active)
-          const pending = info.pendingDeposits.filter(d => d.epoch + ACTIVATION_DELAY_EPOCHS > currentEpoch);
-          return pending.length > 0
-            ? pending.map(d => {
+          // In debug mode, show all deposits; otherwise filter to truly pending only
+          const deposits = options.debug
+            ? info.pendingDeposits
+            : info.pendingDeposits.filter(d => d.epoch + ACTIVATION_DELAY_EPOCHS > currentEpoch);
+          return deposits.length > 0
+            ? deposits.map(d => {
                 const depositEpoch = d.epoch;
                 const activationEpoch = depositEpoch + ACTIVATION_DELAY_EPOCHS;
                 const epochsUntilActive = activationEpoch - currentEpoch;
+                const isActivated = epochsUntilActive <= 0n;
                 return {
                   epoch: depositEpoch.toString(),
                   stake: d.stake,
                   shares: d.shares.toString(),
                   activatesAtEpoch: activationEpoch.toString(),
-                  epochsRemaining: epochsUntilActive.toString(),
+                  ...(options.debug
+                    ? {status: isActivated ? "ACTIVATED" : `pending (${epochsUntilActive} epochs)`}
+                    : {epochsRemaining: epochsUntilActive.toString()}),
                 };
               })
-            : "None";
+            : options.debug ? `None (raw count: ${info.pendingDeposits.length})` : "None";
         })(),
         selfStakePendingWithdrawals:
           info.pendingWithdrawals.length > 0
@@ -362,7 +369,10 @@ export class StakingInfoAction extends StakingAction {
         // No account configured, that's fine
       }
 
-      // Fetch all data in parallel
+      // Use tree traversal to get ALL validators (including not-yet-primed)
+      const allTreeAddresses = await this.getAllValidatorsFromTree(options);
+
+      // Also fetch status lists in parallel
       const [activeAddresses, quarantinedList, bannedList, epochInfo] = await Promise.all([
         client.getActiveValidators(),
         client.getQuarantinedValidatorsDetailed(),
@@ -373,15 +383,14 @@ export class StakingInfoAction extends StakingAction {
       // Build set of quarantined/banned for status lookup
       const quarantinedSet = new Map(quarantinedList.map(v => [v.validator.toLowerCase(), v]));
       const bannedSet = new Map(bannedList.map(v => [v.validator.toLowerCase(), v]));
+      const activeSet = new Set(activeAddresses.map(a => a.toLowerCase()));
 
-      // Combine all validators
-      const allAddresses = new Set([
-        ...activeAddresses,
-        ...quarantinedList.map(v => v.validator),
-        ...(options.all ? bannedList.map(v => v.validator) : []),
-      ]);
+      // Filter out banned if not --all
+      const allAddresses = options.all
+        ? allTreeAddresses
+        : allTreeAddresses.filter(addr => !bannedSet.has(addr.toLowerCase()));
 
-      this.setSpinnerText(`Fetching details for ${allAddresses.size} validators...`);
+      this.setSpinnerText(`Fetching details for ${allAddresses.length} validators...`);
 
       // Fetch detailed info in batches to avoid rate limiting
       const BATCH_SIZE = 5;
@@ -411,7 +420,7 @@ export class StakingInfoAction extends StakingAction {
         const addrLower = info.address.toLowerCase();
         const isQuarantined = quarantinedSet.has(addrLower);
         const isBanned = bannedSet.has(addrLower);
-        const isActive = activeAddresses.some(a => a.toLowerCase() === addrLower);
+        const isActive = activeSet.has(addrLower);
 
         let status = "";
         if (isBanned) {
@@ -420,8 +429,6 @@ export class StakingInfoAction extends StakingAction {
         } else if (isQuarantined) {
           const qInfo = quarantinedSet.get(addrLower)!;
           status = `quarant(e${qInfo.untilEpoch})`;
-        } else if (info.needsPriming) {
-          status = "prime!";
         } else if (isActive) {
           status = "active";
         } else {
@@ -485,6 +492,7 @@ export class StakingInfoAction extends StakingAction {
           chalk.cyan("Self"),
           chalk.cyan("Deleg"),
           chalk.cyan("Pending"),
+          chalk.cyan("Primed"),
           chalk.cyan("Weight"),
           chalk.cyan("Status"),
         ],
@@ -533,13 +541,22 @@ export class StakingInfoAction extends StakingAction {
           ? `${moniker}${roleTag}\n${chalk.gray(info.address)}`
           : `${chalk.gray(info.address)}${roleTag}`;
 
+        // Primed status - color based on how current it is
+        let primedStr: string;
+        if (info.ePrimed >= currentEpoch) {
+          primedStr = chalk.green(`e${info.ePrimed}`);
+        } else if (info.ePrimed === currentEpoch - 1n) {
+          primedStr = chalk.yellow(`e${info.ePrimed}`);
+        } else {
+          primedStr = chalk.red(`e${info.ePrimed}!`);
+        }
+
         // Status coloring
         let statusStr = status;
         if (status === "active") statusStr = chalk.green(status);
         else if (status === "BANNED") statusStr = chalk.red(status);
         else if (status.startsWith("quarant")) statusStr = chalk.yellow(status);
         else if (status.startsWith("banned")) statusStr = chalk.red(status);
-        else if (status === "prime!") statusStr = chalk.magenta(status);
         else if (status === "pending") statusStr = chalk.gray(status);
 
         table.push([
@@ -548,6 +565,7 @@ export class StakingInfoAction extends StakingAction {
           formatStake(info.vStake),
           formatStake(info.dStake),
           pendingStr,
+          primedStr,
           weightStr,
           statusStr,
         ]);

package/src/commands/staking/validatorHistory.ts

@@ -30,7 +30,10 @@ const REWARD_EVENT_ABI = {
 export interface ValidatorHistoryOptions extends StakingConfig {
   validator?: string;
   fromBlock?: string;
+  fromEpoch?: string;
+  epochs?: string;
   limit?: string;
+  all?: boolean;
 }
 
 interface SlashEvent {
@@ -107,7 +110,30 @@ export class ValidatorHistoryAction extends StakingAction {
         transport: http(chain.rpcUrls.default.http[0]),
       });
 
-      const fromBlock = options.fromBlock ? BigInt(options.fromBlock) : 0n;
+      // Determine epoch range for filtering
+      const epochInfo = await client.getEpochInfo();
+      const currentEpoch = epochInfo.currentEpoch;
+      const defaultEpochs = 10n;
+
+      let minEpoch: bigint | null = null;
+      let fromBlock: bigint | "earliest" = "earliest";
+
+      if (options.fromBlock) {
+        // Explicit block takes precedence
+        fromBlock = BigInt(options.fromBlock);
+      } else if (options.fromEpoch) {
+        // Filter by starting epoch
+        minEpoch = BigInt(options.fromEpoch);
+      } else if (options.all) {
+        // Fetch all history (warn user)
+        console.log(chalk.yellow("Warning: Fetching all history from genesis. This may be slow for long-lived validators."));
+        console.log(chalk.yellow("Consider using --epochs <n> or --from-epoch <n> for faster queries.\n"));
+      } else {
+        // Default: last N epochs
+        const numEpochs = options.epochs ? BigInt(options.epochs) : defaultEpochs;
+        minEpoch = currentEpoch > numEpochs ? currentEpoch - numEpochs : 0n;
+      }
+
       const limit = options.limit ? parseInt(options.limit) : 50;
 
       this.setSpinnerText("Fetching slash events...");
@@ -156,7 +182,7 @@ export class ValidatorHistoryAction extends StakingAction {
       }
 
       // Transform to typed events
-      const slashEvents: SlashEvent[] = slashLogs.map(log => ({
+      let slashEvents: SlashEvent[] = slashLogs.map(log => ({
         type: "slash" as const,
         epoch: (log.args as any).epoch as bigint,
         txId: (log.args as any).txId as string,
@@ -165,7 +191,7 @@ export class ValidatorHistoryAction extends StakingAction {
         timestamp: blockTimestamps.get(log.blockNumber) || new Date(0),
       }));
 
-      const rewardEvents: RewardEvent[] = filteredRewardLogs.map(log => ({
+      let rewardEvents: RewardEvent[] = filteredRewardLogs.map(log => ({
         type: "reward" as const,
         epoch: (log.args as any).epoch as bigint,
         validatorRewards: (log.args as any).validatorRewards as bigint,
@@ -174,6 +200,12 @@ export class ValidatorHistoryAction extends StakingAction {
         timestamp: blockTimestamps.get(log.blockNumber) || new Date(0),
       }));
 
+      // Filter by epoch if specified
+      if (minEpoch !== null) {
+        slashEvents = slashEvents.filter(e => e.epoch >= minEpoch!);
+        rewardEvents = rewardEvents.filter(e => e.epoch >= minEpoch!);
+      }
+
       // Combine and sort by block number descending
       const allEvents: HistoryEvent[] = [...slashEvents, ...rewardEvents];
       allEvents.sort((a, b) => Number(b.blockNumber - a.blockNumber));
@@ -243,7 +275,13 @@ export class ValidatorHistoryAction extends StakingAction {
       console.log("");
 
       // Summary
+      const epochRangeInfo = minEpoch !== null
+        ? `epochs ${minEpoch}-${currentEpoch}`
+        : options.fromBlock
+          ? `from block ${options.fromBlock}`
+          : "all epochs";
       console.log(chalk.gray("Summary:"));
+      console.log(chalk.gray(`  Range: ${epochRangeInfo}`));
       console.log(chalk.gray(`  Slash events: ${slashEvents.length}`));
       console.log(chalk.gray(`  Reward events: ${rewardEvents.length}`));
       console.log(chalk.gray(`  Total validator rewards: ${client.formatStakingAmount(totalValidatorRewards)}`));
@@ -251,6 +289,7 @@ export class ValidatorHistoryAction extends StakingAction {
       if (allEvents.length > limit) {
         console.log(chalk.gray(`  (showing ${limit} of ${allEvents.length} events)`));
       }
+      console.log(chalk.gray(`  Use --all to fetch complete history, --epochs <n> for last N epochs`));
       console.log("");
     } catch (error: any) {
       this.failSpinner("Failed to get validator history", error.message || error);

package/src/commands/staking/validatorPrime.ts

@@ -1,5 +1,6 @@
 import {StakingAction, StakingConfig} from "./StakingAction";
 import type {Address} from "genlayer-js/types";
+import chalk from "chalk";
 
 export interface ValidatorPrimeOptions extends StakingConfig {
   validator: string;
@@ -32,4 +33,41 @@ export class ValidatorPrimeAction extends StakingAction {
       this.failSpinner("Failed to prime validator", error.message || error);
     }
   }
+
+  async primeAll(options: StakingConfig): Promise<void> {
+    this.startSpinner("Fetching validators...");
+
+    try {
+      const client = await this.getStakingClient(options);
+
+      // Get all validators from tree
+      this.setSpinnerText("Fetching validators...");
+      const allValidators = await this.getAllValidatorsFromTree(options);
+
+      this.stopSpinner();
+      console.log(`\nPriming ${allValidators.length} validators:\n`);
+
+      let succeeded = 0;
+      let skipped = 0;
+
+      for (const addr of allValidators) {
+        process.stdout.write(`  ${addr} ... `);
+
+        try {
+          const result = await client.validatorPrime({validator: addr});
+          console.log(chalk.green(`primed ${result.transactionHash}`));
+          succeeded++;
+        } catch (error: any) {
+          const msg = error.message || String(error);
+          const shortErr = msg.length > 60 ? msg.slice(0, 57) + "..." : msg;
+          console.log(chalk.gray(`skipped: ${shortErr}`));
+          skipped++;
+        }
+      }
+
+      console.log(`\n${chalk.green(`${succeeded} primed`)}, ${chalk.gray(`${skipped} skipped`)}\n`);
+    } catch (error: any) {
+      this.failSpinner("Failed to prime validators", error.message || error);
+    }
+  }
 }