aether-hub 1.2.6 → 1.2.8

package/commands/balance.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+/**
+ * aether-cli balance
+ *
+ * Query account balance from the Aether blockchain — real HTTP RPC calls,
+ * real data. No stubs, no mocks.
+ *
+ * Usage:
+ *   aether balance <address>            Query balance for an address
+ *   aether balance                      Query default wallet balance
+ *   aether balance --json               JSON output for scripting
+ *   aether balance --rpc <url>          Query a specific RPC endpoint
+ *   aether balance --lamports           Show balance in lamports (not AETH)
+ *
+ * Requires AETHER_RPC env var (default: http://127.0.0.1:8899)
+ * SDK: @jellylegsai/aether-sdk — makes REAL HTTP RPC calls to the chain
+ */
+
+const os = require('os');
+const path = require('path');
+
+// ANSI colours
+const C = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m',
+};
+
+// Import SDK — REAL blockchain RPC calls to http://127.0.0.1:8899
+const sdkPath = path.join(__dirname, '..', 'sdk', 'index.js');
+const aether = require(sdkPath);
+
+const DEFAULT_RPC = process.env.AETHER_RPC || aether.DEFAULT_RPC_URL || 'http://127.0.0.1:8899';
+const CLI_VERSION = '1.0.0';
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function getDefaultRpc() {
+  return process.env.AETHER_RPC || aether.DEFAULT_RPC_URL || 'http://127.0.0.1:8899';
+}
+
+function createClient(rpc) {
+  return new aether.AetherClient({ rpcUrl: rpc });
+}
+
+function lamportsToAeth(lamports) {
+  return (Number(lamports) / 1e9).toFixed(6);
+}
+
+function loadConfig() {
+  const fs = require('fs');
+  const aetherDir = path.join(os.homedir(), '.aether');
+  const cfgPath = path.join(aetherDir, 'config.json');
+  if (!fs.existsSync(cfgPath)) return { defaultWallet: null };
+  try { return JSON.parse(fs.readFileSync(cfgPath, 'utf8')); }
+  catch { return { defaultWallet: null }; }
+}
+
+function shortenAddress(addr) {
+  if (!addr) return 'unknown';
+  if (addr.length <= 10) return addr;
+  return `${addr.substring(0, 6)}...${addr.substring(addr.length - 4)}`;
+}
+
+// ---------------------------------------------------------------------------
+// Argument parsing
+// ---------------------------------------------------------------------------
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const options = {
+    rpc: getDefaultRpc(),
+    address: null,
+    asJson: false,
+    showLamports: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--rpc' || arg === '-r') {
+      options.rpc = args[++i];
+    } else if (arg === '--json' || arg === '-j') {
+      options.asJson = true;
+    } else if (arg === '--lamports' || arg === '-l') {
+      options.showLamports = true;
+    } else if (arg === '--help' || arg === '-h') {
+      showHelp();
+      process.exit(0);
+    } else if (!arg.startsWith('-') && !options.address) {
+      options.address = arg;
+    }
+  }
+
+  // If no address provided, try to load default wallet
+  if (!options.address) {
+    const config = loadConfig();
+    if (config.defaultWallet) {
+      options.address = config.defaultWallet;
+    }
+  }
+
+  return options;
+}
+
+function showHelp() {
+  console.log(`
+${C.bright}${C.cyan}aether-cli balance${C.reset} - Query Account Balance
+
+${C.bright}Usage:${C.reset}
+  aether balance [address] [options]
+
+${C.bright}Arguments:${C.reset}
+  address         Account public key (base58). If omitted, uses default wallet.
+
+${C.bright}Options:${C.reset}
+  --rpc <url>     Query a specific RPC endpoint (default: ${DEFAULT_RPC})
+  --json, -j      Output raw JSON for scripting
+  --lamports, -l  Show balance in lamports (not AETH)
+  --help, -h      Show this help message
+
+${C.bright}Description:${C.reset}
+  Queries the Aether blockchain for an account's balance.
+  Every call makes a REAL HTTP RPC request to the configured
+  Aether node — no caching, no stubs, no mocks.
+
+  RPC Endpoint: GET /v1/account/<address>
+
+${C.bright}Examples:${C.reset}
+  aether balance                           # Default wallet
+  aether balance 8xPt...3nQ                  # Specific address
+  aether balance --json                    # JSON output
+  aether balance --lamports                # Show lamports
+  AETHER_RPC=https://my-node:8899 aether balance
+`);
+}
+
+// ---------------------------------------------------------------------------
+// Balance query - REAL RPC call via SDK
+// ---------------------------------------------------------------------------
+
+async function fetchBalance(rpc, address) {
+  const client = createClient(rpc);
+  
+  // Real RPC call: GET /v1/account/<address>
+  const account = await client.getAccountInfo(address);
+  
+  return {
+    address,
+    lamports: account.lamports !== undefined ? account.lamports : 0,
+    owner: account.owner || null,
+    executable: account.executable || false,
+    rentEpoch: account.rent_epoch !== undefined ? account.rent_epoch : null,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Output formatters
+// ---------------------------------------------------------------------------
+
+function printBalance(data, options) {
+  const { address, lamports, owner, executable, rentEpoch } = data;
+  const { showLamports, rpc } = options;
+
+  const aeth = lamportsToAeth(lamports);
+
+  console.log(`\n${C.bright}${C.cyan}── Aether Account Balance ───────────────────────────────${C.reset}\n`);
+  console.log(`  ${C.bright}Address:${C.reset}    ${C.magenta}${address}${C.reset}`);
+  
+  if (showLamports) {
+    console.log(`  ${C.bright}Balance:${C.reset}    ${C.green}${lamports.toLocaleString()} lamports${C.reset}`);
+  } else {
+    console.log(`  ${C.bright}Balance:${C.reset}    ${C.green}${aeth} AETH${C.reset}`);
+    console.log(`  ${C.dim}             (${lamports.toLocaleString()} lamports)${C.reset}`);
+  }
+  
+  if (owner) {
+    console.log(`  ${C.bright}Owner:${C.reset}      ${C.dim}${shortenAddress(owner)}${C.reset}`);
+  }
+  
+  if (executable !== undefined) {
+    const execStr = executable ? `${C.yellow}yes${C.reset}` : `${C.dim}no${C.reset}`;
+    console.log(`  ${C.bright}Executable:${C.reset} ${execStr}`);
+  }
+  
+  if (rentEpoch !== null) {
+    console.log(`  ${C.bright}Rent Epoch:${C.reset} ${C.dim}${rentEpoch}${C.reset}`);
+  }
+  
+  console.log(`  ${C.dim}RPC: ${rpc}${C.reset}\n`);
+}
+
+function printJson(data, rpc) {
+  console.log(JSON.stringify({
+    address: data.address,
+    lamports: data.lamports,
+    aeth: lamportsToAeth(data.lamports),
+    owner: data.owner,
+    executable: data.executable,
+    rentEpoch: data.rentEpoch,
+    rpc,
+    cli_version: CLI_VERSION,
+    timestamp: new Date().toISOString(),
+  }, null, 2));
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function balanceCommand() {
+  const options = parseArgs();
+  const { rpc, address, asJson } = options;
+
+  // Validate address
+  if (!address) {
+    if (asJson) {
+      console.log(JSON.stringify({
+        error: 'No address provided and no default wallet configured',
+        hint: 'Run "aether init" to set up a wallet, or provide an address',
+      }));
+    } else {
+      console.log(`\n${C.red}✗ No address provided${C.reset}`);
+      console.log(`  ${C.dim}Provide an address or run "aether init" to set up a default wallet.${C.reset}`);
+      console.log(`  ${C.dim}Usage: aether balance <address>${C.reset}\n`);
+    }
+    process.exit(1);
+  }
+
+  if (!asJson) {
+    console.log(`${C.dim}Querying balance for ${C.cyan}${shortenAddress(address)}${C.dim}...${C.reset}`);
+  }
+
+  try {
+    // Real blockchain RPC call
+    const data = await fetchBalance(rpc, address);
+    
+    if (asJson) {
+      printJson(data, rpc);
+    } else {
+      printBalance(data, options);
+    }
+  } catch (err) {
+    if (asJson) {
+      console.log(JSON.stringify({
+        error: err.message,
+        address,
+        rpc,
+      }));
+    } else {
+      console.log(`\n${C.red}✗ Failed to fetch balance: ${err.message}${C.reset}`);
+      console.log(`  ${C.dim}Address: ${address}${C.reset}`);
+      console.log(`  ${C.dim}RPC: ${rpc}${C.reset}\n`);
+    }
+    process.exit(1);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+
+module.exports = { balanceCommand };
+
+if (require.main === module) {
+  balanceCommand().catch(err => {
+    console.error(`${C.red}✗ Balance command failed: ${err.message}${C.reset}`);
+    process.exit(1);
+  });
+}

package/commands/blockhash.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * aether-cli blockhash
+ *
+ * Fetches the latest recent blockhash from the Aether blockchain — required
+ * as a prerequisite for signing and submitting any transaction.
+ *
+ * Usage:
+ *   aether-cli blockhash                  Show latest blockhash
+ *   aether-cli blockhash --json           JSON output for scripting
+ *   aether-cli blockhash --rpc <url>      Query a specific RPC endpoint
+ *   aether-cli blockhash --watch          Poll every 5 seconds
+ *
+ * Requires AETHER_RPC env var (default: http://127.0.0.1:8899)
+ * SDK: @jellylegsai/aether-sdk — makes REAL HTTP RPC calls to the chain
+ */
+
+const path = require('path');
+
+// ANSI colours
+const C = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m',
+};
+
+// Import SDK — REAL blockchain RPC calls to http://127.0.0.1:8899
+const sdkPath = path.join(__dirname, '..', 'sdk', 'index.js');
+const aether = require(sdkPath);
+
+const DEFAULT_RPC = process.env.AETHER_RPC || aether.DEFAULT_RPC_URL || 'http://127.0.0.1:8899';
+
+// ---------------------------------------------------------------------------
+// Argument parsing
+// ---------------------------------------------------------------------------
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const options = {
+    rpc: DEFAULT_RPC,
+    asJson: false,
+    watch: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--rpc' || args[i] === '-r') {
+      options.rpc = args[++i];
+    } else if (args[i] === '--json' || args[i] === '-j') {
+      options.asJson = true;
+    } else if (args[i] === '--watch' || args[i] === '-w') {
+      options.watch = true;
+    } else if (args[i] === '--help' || args[i] === '-h') {
+      showHelp();
+      process.exit(0);
+    }
+  }
+
+  return options;
+}
+
+function showHelp() {
+  console.log(`
+${C.bright}${C.cyan}aether-cli blockhash${C.reset} - Get Latest Blockhash
+
+${C.bright}Usage:${C.reset}
+  aether-cli blockhash [options]
+
+${C.bright}Options:${C.reset}
+  --rpc <url>     Query a specific RPC endpoint (default: http://127.0.0.1:8899)
+  --json, -j      Output raw JSON for scripting
+  --watch, -w     Poll every 5 seconds
+  --help, -h      Show this help message
+
+${C.bright}Description:${C.reset}
+  Fetches the most recent blockhash from the Aether blockchain.
+  Blockhashes are required as a recent-ref entry when building
+  signed transactions (Transfer, Stake, Unstake, etc.).
+
+  Every call makes a REAL HTTP RPC request to the configured
+  Aether node — no caching, no stubs.
+
+${C.bright}Examples:${C.reset}
+  aether blockhash
+  aether blockhash --json
+  aether blockhash --watch
+  AETHER_RPC=https://my-node:8899 aether blockhash
+`);
+}
+
+// ---------------------------------------------------------------------------
+// Fetch and display blockhash from REAL chain via SDK
+// ---------------------------------------------------------------------------
+
+async function fetchBlockhash(rpc) {
+  const client = new aether.AetherClient({ rpcUrl: rpc });
+  const result = await client.getRecentBlockhash();
+  return result;
+}
+
+function printBlockhash(result, rpc) {
+  const { blockhash, lastValidBlockHeight } = result;
+
+  console.log(`\n${C.bright}${C.cyan}── Aether Blockhash ─────────────────────────────────────${C.reset}\n`);
+  console.log(`  ${C.bright}Blockhash:${C.reset}              ${C.magenta}${blockhash}${C.reset}`);
+  if (lastValidBlockHeight !== undefined) {
+    console.log(`  ${C.bright}Last Valid Block Height:${C.reset}  ${C.cyan}${lastValidBlockHeight.toLocaleString()}${C.reset}`);
+  }
+  console.log(`  ${C.dim}RPC: ${rpc}${C.reset}\n`);
+}
+
+function printJson(result, rpc) {
+  console.log(JSON.stringify({
+    blockhash: result.blockhash,
+    lastValidBlockHeight: result.lastValidBlockHeight,
+    rpc,
+    cli_version: '1.0.0',
+    timestamp: new Date().toISOString(),
+  }));
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function main() {
+  const opts = parseArgs();
+  const { rpc, asJson, watch } = opts;
+
+  if (watch && !asJson) {
+    console.log(`${C.dim}Watching for new blockhashes every 5s (Ctrl+C to stop)…${C.reset}`);
+    console.log();
+  }
+
+  async function tick() {
+    try {
+      const result = await fetchBlockhash(rpc);
+      if (asJson) {
+        printJson(result, rpc);
+      } else if (!watch) {
+        printBlockhash(result, rpc);
+      } else {
+        process.stdout.write(`\r${C.dim}[${new Date().toISOString()}]${C.reset} blockhash: ${C.magenta}${result.blockhash}${C.reset}  `);
+      }
+    } catch (err) {
+      if (asJson) {
+        console.log(JSON.stringify({ error: err.message, rpc }));
+      } else if (!watch) {
+        console.log(`${C.red}✗ Failed to fetch blockhash: ${err.message}${C.reset}`);
+      } else {
+        process.stdout.write(`\r${C.red}✗ ${err.message}${C.reset}  `);
+      }
+    }
+  }
+
+  if (watch) {
+    await tick(); // immediate first run
+    // eslint-disable-next-line no-unmodified-loop-condition
+    while (true) {
+      await new Promise(r => setTimeout(r, 5000));
+      await tick();
+    }
+  } else {
+    await tick();
+  }
+}
+
+main().catch(err => {
+  console.error(`${C.red}✗ Blockhash command failed:${C.reset} ${err.message}`);
+  process.exit(1);
+});
+
+module.exports = { blockhashCommand: main };
+
+if (require.main === module) {
+  main();
+}