aether-hub 1.1.4 → 1.1.6

package/commands/rewards.js

@@ -397,6 +397,85 @@ async function rewardsSummary(args) {
 // Rewards claim command
 // ---------------------------------------------------------------------------
 
+async function rewardsPending(args) {
+  const rpc = args.rpc || getDefaultRpc();
+  const isJson = args.json || false;
+  let address = args.address || null;
+
+  const config = loadConfig();
+  const rl = createRl();
+
+  if (!address) {
+    const ans = await question(rl, `\n${C.cyan}Enter wallet address: ${C.reset}`);
+    address = ans.trim();
+  }
+
+  if (!address) {
+    console.log(`\n${C.red}✗ No address provided.${C.reset}\n`);
+    rl.close();
+    return;
+  }
+
+  rl.close();
+
+  const stakeAccounts = await fetchWalletStakeAccounts(address);
+  if (stakeAccounts.length === 0) {
+    if (isJson) {
+      console.log(JSON.stringify({ address, pending: [], total_pending: '0' }, null, 2));
+    } else {
+      console.log(`\n${C.red}✗ No stake accounts found for ${address}${C.reset}\n`);
+    }
+    return;
+  }
+
+  const results = [];
+  let totalPending = BigInt(0);
+
+  for (const sa of stakeAccounts) {
+    const rd = await fetchStakeRewards(rpc, sa);
+    if (!rd.error) {
+      const pending = BigInt(rd.estimatedRewards || 0);
+      totalPending += pending;
+      results.push({
+        stake_account: sa,
+        validator: rd.validator || 'unknown',
+        delegated_stake: rd.delegatedStakeFormatted || '0',
+        pending_rewards: rd.estimatedRewardsFormatted || '0',
+        pending_lamports: pending.toString(),
+        apy_bps: rd.apyBps || 0,
+      });
+    }
+  }
+
+  if (isJson) {
+    console.log(JSON.stringify({
+      address,
+      total_pending: totalPending.toString(),
+      total_pending_formatted: formatAether(totalPending.toString()),
+      accounts: results,
+    }, null, 2));
+    return;
+  }
+
+  console.log(`\n${C.bright}${C.cyan}╔══════════════════════════════════════════════════════════════╗${C.reset}`);
+  console.log(`${C.bright}${C.cyan}║              Pending Staking Rewards                           ║${C.reset}`);
+  console.log(`${C.bright}${C.cyan}╚══════════════════════════════════════════════════════════════╝${C.reset}\n`);
+  console.log(`  ${C.dim}Wallet:${C.reset} ${C.bright}${address}${C.reset}`);
+  console.log();
+  console.log(`  ${C.yellow}Stake Account${C.reset.padEnd(48)} ${C.yellow}Pending${C.reset}      ${C.yellow}APY${C.reset}`);
+  console.log(`  ${C.dim}${'─'.repeat(72)}${C.reset}`);
+
+  for (const r of results) {
+    const shortSa = r.stake_account.substring(0, 12) + '...' + r.stake_account.slice(-6);
+    console.log(`  ${C.cyan}${shortSa}${C.reset.padEnd(52)} ${C.green}${r.pending_rewards.padStart(12)}${C.reset}  ${(r.apy_bps / 100).toFixed(2)}%`);
+  }
+
+  console.log(`  ${C.dim}${'─'.repeat(72)}${C.reset}`);
+  console.log(`  ${C.bright}TOTAL PENDING${C.reset.padEnd(52)} ${C.green}${formatAethFull(totalPending.toString()).padStart(12)}${C.reset}`);
+  console.log();
+  console.log(`  ${C.dim}Run ${C.cyan}aether rewards claim${C.dim} to claim.${C.reset}\n`);
+}
+
 async function rewardsClaim(args) {
   const rpc = args.rpc || getDefaultRpc();
   const isJson = args.json || false;
@@ -579,6 +658,9 @@ async function main() {
     case 'summary':
       await rewardsSummary(parsed);
       break;
+    case 'pending':
+      await rewardsPending(parsed);
+      break;
     case 'claim':
       await rewardsClaim(parsed);
       break;
@@ -586,6 +668,7 @@ async function main() {
       console.log(`\n${C.cyan}Usage:${C.reset}`);
       console.log(`  aether rewards list    --address <addr>  List all staking rewards`);
       console.log(`  aether rewards summary --address <addr>  One-line rewards summary`);
+      console.log(`  aether rewards pending --address <addr>  Show pending (unclaimed) rewards`);
       console.log(`  aether rewards claim   --address <addr>  [--account <stakeAcct>]  Claim rewards`);
       console.log();
       console.log(`  ${C.dim}--json   Output as JSON`);

package/commands/wallet.js

@@ -1107,6 +1107,100 @@ async function txHistory(rl) {
 }
 
 // ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// EXPORT WALLET
+// Export wallet data for backup — public data by default, mnemonic with --mnemonic flag
+// ---------------------------------------------------------------------------
+
+async function exportWallet(rl) {
+  console.log(`\n${C.bright}${C.cyan}── Wallet Export ─────────────────────────────────────────${C.reset}\n`);
+
+  const args = process.argv.slice(4);
+  let address = null;
+  let asJson = false;
+  let includeMnemonic = false;
+
+  const addrIdx = args.findIndex((a) => a === '--address' || a === '-a');
+  if (addrIdx !== -1 && args[addrIdx + 1]) {
+    address = args[addrIdx + 1];
+  }
+
+  asJson = args.includes('--json') || args.includes('-j');
+  includeMnemonic = args.includes('--mnemonic') || args.includes('-m');
+
+  if (!address) {
+    const cfg = loadConfig();
+    address = cfg.defaultWallet;
+  }
+
+  if (!address) {
+    console.log(`  ${C.red}✗ No wallet address specified and no default wallet set.${C.reset}`);
+    console.log(`  ${C.dim}Usage: aether wallet export --address <addr> [--mnemonic] [--json]${C.reset}\n`);
+    return;
+  }
+
+  const walletData = loadWallet(address);
+  if (!walletData) {
+    console.log(`  ${C.red}✗ Wallet not found:${C.reset} ${address}`);
+    console.log(`  ${C.dim}  Available wallets: ${C.cyan}aether wallet list${C.reset}\n`);
+    return;
+  }
+
+  const exportData = {
+    version: walletData.version || 1,
+    address: walletData.address,
+    public_key: walletData.public_key,
+    derivation_path: walletData.derivation_path,
+    created_at: walletData.created_at,
+    source: 'aether-cli',
+  };
+
+  // Mnemonic export requires interactive confirmation for security
+  if (includeMnemonic) {
+    console.log(`  ${C.yellow}⚠ WARNING: You are about to export your SECRET MNEMONIC.${C.reset}`);
+    console.log(`  ${C.dim}  Anyone with this phrase can access your funds.${C.reset}\n`);
+    const confirmed = await question(rl, `  Type ${C.bright}EXPORT${C.reset} to confirm: `);
+    if (confirmed.trim().toUpperCase() !== 'EXPORT') {
+      console.log(`\n  ${C.dim}Aborted. Mnemonic not exported.${C.reset}\n`);
+      return;
+    }
+    console.log(`  ${C.green}✓ Confirmed${C.reset}\n`);
+
+    // Re-derive mnemonic from keypair is NOT possible — we must ask for it
+    console.log(`  ${C.dim}The CLI cannot retrieve your mnemonic from the stored keypair.${C.reset}`);
+    console.log(`  ${C.dim}If you have a backup of your mnemonic, enter it below to include it.${C.reset}`);
+    console.log(`  ${C.dim}Otherwise, press Enter to export public data only.${C.reset}\n`);
+    const mnemonicInput = await question(rl, `  ${C.cyan}Mnemonic (or Enter to skip):${C.reset} `);
+    const mnemonic = mnemonicInput.trim();
+    if (mnemonic && bip39.validateMnemonic(mnemonic)) {
+      exportData.mnemonic = mnemonic;
+    } else if (mnemonic) {
+      console.log(`  ${C.red}✗ Invalid mnemonic phrase. Skipping.${C.reset}`);
+    }
+  }
+
+  if (asJson) {
+    console.log(JSON.stringify(exportData, null, 2));
+    return;
+  }
+
+  // Human-readable output
+  console.log(`  ${C.green}★${C.reset} Wallet exported successfully\n`);
+  console.log(`  ${C.dim}Address:${C.reset}        ${exportData.address}`);
+  console.log(`  ${C.dim}Public key:${C.reset}     ${exportData.public_key}`);
+  console.log(`  ${C.dim}Derivation path:${C.reset} ${exportData.derivation_path}`);
+  console.log(`  ${C.dim}Created:${C.reset}        ${exportData.created_at ? new Date(exportData.created_at).toLocaleString() : 'unknown'}`);
+  if (exportData.mnemonic) {
+    console.log();
+    console.log(`  ${C.yellow}★ MNEMONIC (keep this secret!):${C.reset}`);
+    console.log(`  ${C.bright}${exportData.mnemonic}${C.reset}`);
+  }
+  console.log();
+  console.log(`  ${C.dim}Export saved to stdout in JSON format with:${C.reset}`);
+  console.log(`    ${C.cyan}aether wallet export --address ${address} --json${C.reset}`);
+  console.log();
+}
+
 // STAKE POSITIONS
 // Query and display current stake positions/delegations for a wallet
 // ---------------------------------------------------------------------------
@@ -1437,6 +1531,8 @@ async function walletCommand() {
       await stakeWallet(rl);
     } else if (subcmd === 'stake-positions') {
       await stakePositions(rl);
+    } else if (subcmd === 'export') {
+      await exportWallet(rl);
     } else if (subcmd === 'unstake') {
       await unstakeWallet(rl);
     } else if (subcmd === 'transfer') {
@@ -1449,6 +1545,7 @@ async function walletCommand() {
       console.log(`    ${C.cyan}aether wallet create${C.reset}   Create new or import wallet`);
       console.log(`    ${C.cyan}aether wallet list${C.reset}     List all wallets`);
       console.log(`    ${C.cyan}aether wallet import${C.reset}   Import wallet from mnemonic`);
+      console.log(`    ${C.cyan}aether wallet export${C.reset}     Export wallet data (pubkey, address) — --mnemonic to include phrase`);
       console.log(`    ${C.cyan}aether wallet default${C.reset}  Show/set default wallet`);
       console.log(`    ${C.cyan}aether wallet connect${C.reset}  Connect wallet via browser verification`);
       console.log(`    ${C.cyan}aether wallet balance${C.reset}  Query chain balance for an address`);

package/index.js

@@ -208,6 +208,16 @@ const COMMANDS = {
       process.argv = originalArgv;
     },
   },
+  export: {
+    description: 'Export wallet data — aether export --address <addr> [--mnemonic] [--json]',
+    handler: () => {
+      const { walletCommand } = require('./commands/wallet');
+      const originalArgv = process.argv;
+      process.argv = [...originalArgv.slice(0, 2), 'wallet', 'export', ...originalArgv.slice(3)];
+      walletCommand();
+      process.argv = originalArgv;
+    },
+  },
   transfer: {
     description: 'Transfer AETH to another address — aether transfer --to <addr> --amount <aeth>',
     handler: () => {
@@ -282,7 +292,7 @@ const COMMANDS = {
     },
   },
   rewards: {
-    description: 'View staking rewards — aether rewards list --address <addr> | rewards summary | rewards claim',
+    description: 'View staking rewards — aether rewards list | rewards summary | rewards pending | rewards claim',
     handler: () => {
       rewardsCommand();
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aether-hub",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "AeTHer Validator CLI — tiered validators (Full/Lite/Observer), system checks, onboarding, and node management",
   "main": "index.js",
   "bin": {