aether-hub 1.0.3

package/commands/sdk.js

@@ -0,0 +1,381 @@
+/**
+ * aether-cli sdk
+ * 
+ * Provides download links and install instructions for the Aether SDK,
+ * Aether JS client, and FLUX/ATH token libraries.
+ * 
+ * Usage:
+ *   aether-cli sdk              # Show all SDK options
+ *   aether-cli sdk js           # Aether JS client
+ *   aether-cli sdk rust         # Aether Rust SDK
+ *   aether-cli sdk tokens       # FLUX/ATH token libraries
+ */
+
+const os = require('os');
+
+// ANSI colors
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  red: '\x1b[31m',
+  dim: '\x1b[2m',
+  magenta: '\x1b[35m',
+  blue: '\x1b[34m',
+};
+
+/**
+ * Print the SDK banner
+ */
+function printBanner() {
+  console.log(`
+${colors.cyan}╔═══════════════════════════════════════════════════════════════╗
+${colors.cyan}║                                                               ║
+${colors.cyan}║   ${colors.bright}AETHER SDK${colors.reset}${colors.cyan}                                              ║
+${colors.cyan}║   ${colors.bright}Developer Tools & Libraries${colors.reset}${colors.cyan}                            ║
+${colors.cyan}║                                                               ║
+${colors.cyan}╚═══════════════════════════════════════════════════════════════╝${colors.reset}
+  `);
+}
+
+/**
+ * Print a section header
+ */
+function printSection(title, icon = '📦') {
+  console.log();
+  console.log(`${colors.bright}${colors.cyan}${'═'.repeat(60)}${colors.reset}`);
+  console.log(`${colors.bright}  ${icon} ${title}${colors.reset}`);
+  console.log(`${colors.bright}${colors.cyan}${'═'.repeat(60)}${colors.reset}`);
+  console.log();
+}
+
+/**
+ * Print a code block
+ */
+function printCode(code, lang = 'bash') {
+  console.log(`  ${colors.dim}[ ${lang} ]${colors.reset}`);
+  console.log(`  ${colors.bright}${code}${colors.reset}`);
+  console.log();
+}
+
+/**
+ * Print a link
+ */
+function printLink(label, url) {
+  console.log(`  ${colors.cyan}🔗 ${label}:${colors.reset}`);
+  console.log(`     ${colors.blue}${url}${colors.reset}`);
+  console.log();
+}
+
+/**
+ * Show all SDK options
+ */
+function showAllSdks() {
+  printBanner();
+  
+  console.log(`  ${colors.bright}Available SDKs and Libraries:${colors.reset}\n`);
+  
+  console.log(`  ${colors.yellow}npm${colors.reset}   aether-cli sdk js      - JavaScript/TypeScript client`);
+  console.log(`  ${colors.yellow}npm${colors.reset}   aether-cli sdk rust    - Rust SDK for native development`);
+  console.log(`  ${colors.yellow}npm${colors.reset}   aether-cli sdk tokens  - FLUX/ATH token libraries`);
+  console.log(`  ${colors.yellow}npm${colors.reset}   aether-cli sdk docs    - Documentation portal`);
+  console.log();
+  
+  // Quick start
+  printSection('⚡ Quick Start', '🚀');
+  console.log('  Get started with Aether development in 3 steps:\n');
+  console.log(`  1. ${colors.bright}Install the JS client:${colors.reset}`);
+  printCode('npm install @aether-network/client');
+  console.log(`  2. ${colors.bright}Initialize your connection:${colors.reset}`);
+  printCode('const aether = require(\'@aether-network/client\');\nconst client = new aether.Client({ rpcUrl: \'http://localhost:8899\' });');
+  console.log(`  3. ${colors.bright}Start building!${colors.reset}`);
+  console.log(`     ${colors.dim}See docs for full API reference${colors.reset}`);
+  console.log();
+  
+  printLink('Documentation', 'https://docs.aether.network');
+  printLink('GitHub Organization', 'https://github.com/aether-network');
+  printLink('Discord Community', 'https://discord.gg/aether');
+}
+
+/**
+ * Show JavaScript SDK info
+ */
+function showJsSdk() {
+  printSection('Aether JavaScript Client', '📜');
+  
+  console.log(`  ${colors.bright}The official Aether JavaScript/TypeScript client library.${colors.reset}`);
+  console.log(`  Provides a simple API for interacting with the Aether blockchain.${colors.reset}\n`);
+  
+  console.log(`  ${colors.green}✓ Stable Release${colors.reset}`);
+  console.log(`  ${colors.dim}Version: 1.2.0${colors.reset}`);
+  console.log();
+  
+  printSection('Installation');
+  printCode('npm install @aether-network/client');
+  console.log('  or');
+  printCode('yarn add @aether-network/client');
+  console.log('  or');
+  printCode('pnpm add @aether-network/client');
+  
+  printSection('Usage Example');
+  const example = `const aether = require('@aether-network/client');
+
+// Initialize client
+const client = new aether.Client({
+  rpcUrl: 'http://localhost:8899',
+  wsUrl: 'ws://localhost:8900',
+});
+
+// Get slot info
+const slot = await client.getSlot();
+console.log('Current slot:', slot);
+
+// Get balance
+const balance = await client.getBalance('pubkey...');
+console.log('Balance:', balance);
+
+// Send transaction
+const tx = await client.sendTransaction({
+  from: 'sender-pubkey',
+  to: 'recipient-pubkey',
+  amount: 1000,
+});
+console.log('Transaction signature:', tx.signature);`;
+  
+  console.log(`  ${colors.dim}[ javascript ]${colors.reset}`);
+  example.split('\n').forEach(line => {
+    console.log(`  ${colors.bright}${line}${colors.reset}`);
+  });
+  console.log();
+  
+  printSection('API Reference');
+  console.log(`  ${colors.cyan}Core Methods:${colors.reset}`);
+  console.log(`    • getSlot()                 - Get current slot number`);
+  console.log(`    • getBalance(pubkey)        - Get account balance in lamports`);
+  console.log(`    • getAccountInfo(pubkey)    - Get full account information`);
+  console.log(`    • sendTransaction(tx)       - Send a signed transaction`);
+  console.log(`    • confirmTransaction(sig)   - Wait for transaction confirmation`);
+  console.log(`    • getProgramAccounts(...)   - Query accounts by program`);
+  console.log();
+  
+  printLink('NPM Package', 'https://www.npmjs.com/package/@aether-network/client');
+  printLink('TypeScript Docs', 'https://docs.aether.network/sdk/js');
+  printLink('GitHub Repo', 'https://github.com/aether-network/aether-js');
+}
+
+/**
+ * Show Rust SDK info
+ */
+function showRustSdk() {
+  printSection('Aether Rust SDK', '🦀');
+  
+  console.log(`  ${colors.bright}Native Rust SDK for building Aether programs and clients.${colors.reset}`);
+  console.log(`  Use this for validator plugins, custom programs, and high-performance tools.${colors.reset}\n`);
+  
+  console.log(`  ${colors.green}✓ Stable Release${colors.reset}`);
+  console.log(`  ${colors.dim}Version: 1.2.0${colors.reset}`);
+  console.log();
+  
+  printSection('Installation');
+  printCode('cargo add aether-sdk');
+  console.log('  or add to your Cargo.toml:');
+  console.log();
+  console.log(`  ${colors.dim}${colors.bgRed}toml${colors.reset}`);
+  console.log(`  ${colors.bright}[dependencies]${colors.reset}`);
+  console.log(`  ${colors.bright}aether-sdk = "1.2"${colors.reset}`);
+  console.log();
+  
+  printSection('Usage Example');
+  const rustExample = `use aether_sdk::{client::Client, pubkey::Pubkey};
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Initialize client
+    let client = Client::new("http://localhost:8899");
+    
+    // Get slot
+    let slot = client.get_slot().await?;
+    println!("Current slot: {}", slot);
+    
+    // Get balance
+    let pubkey = Pubkey::from_str("...")?;
+    let balance = client.get_balance(&pubkey).await?;
+    println!("Balance: {} lamports", balance);
+    
+    Ok(())
+}`;
+  
+  console.log(`  ${colors.dim}${colors.bgRed}rust${colors.reset}`);
+  rustExample.split('\n').forEach(line => {
+    console.log(`  ${colors.bright}${line}${colors.reset}`);
+  });
+  console.log();
+  
+  printSection('Features');
+  console.log(`  ${colors.cyan}• Full RPC client${colors.reset}`);
+  console.log(`  ${colors.cyan}• Program development framework${colors.reset}`);
+  console.log(`  ${colors.cyan}• Account serialization/deserialization${colors.reset}`);
+  console.log(`  ${colors.cyan}• Transaction building and signing${colors.reset}`);
+  console.log(`  ${colors.cyan}• Async runtime support (tokio)${colors.reset}`);
+  console.log();
+  
+  printLink('Crates.io', 'https://crates.io/crates/aether-sdk');
+  printLink('API Docs', 'https://docs.rs/aether-sdk');
+  printLink('GitHub Repo', 'https://github.com/aether-network/aether-rust');
+}
+
+/**
+ * Show token libraries info
+ */
+function showTokensSdk() {
+  printSection('FLUX / ATH Token Libraries', '🪙');
+  
+  console.log(`  ${colors.bright}Token libraries for FLUX (utility) and ATH (governance) tokens.${colors.reset}`);
+  console.log(`  Use these to integrate Aether tokens into your applications.${colors.reset}\n`);
+  
+  console.log(`  ${colors.yellow}⚠ Beta Release${colors.reset}`);
+  console.log(`  ${colors.dim}Version: 0.9.0 (testnet only)${colors.reset}`);
+  console.log();
+  
+  printSection('Installation');
+  console.log(`  ${colors.bright}JavaScript:${colors.reset}`);
+  printCode('npm install @aether-network/tokens');
+  console.log();
+  console.log(`  ${colors.bright}Rust:${colors.reset}`);
+  printCode('cargo add aether-tokens');
+  
+  printSection('Supported Tokens');
+  console.log();
+  console.log(`  ${colors.magenta}FLUX${colors.reset} - Utility Token`);
+  console.log(`    • Purpose: Transaction fees, staking rewards`);
+  console.log(`    • Decimals: 9`);
+  console.log(`    • Mint: ${colors.dim}flux7x... (testnet)${colors.reset}`);
+  console.log();
+  console.log(`  ${colors.blue}ATH${colors.reset} - Governance Token`);
+  console.log(`    • Purpose: Voting, protocol upgrades`);
+  console.log(`    • Decimals: 6`);
+  console.log(`    • Mint: ${colors.dim}athgov... (testnet)${colors.reset}`);
+  console.log();
+  
+  printSection('Usage Example (JavaScript)');
+  const tokenExample = `const { TokenClient, TOKENS } = require('@aether-network/tokens');
+
+const client = new TokenClient(rpcUrl);
+
+// Get FLUX balance
+const fluxBalance = await client.getTokenBalance(pubkey, TOKENS.FLUX);
+console.log('FLUX:', fluxBalance);
+
+// Transfer FLUX
+const tx = await client.transfer({
+  mint: TOKENS.FLUX,
+  from: senderPubkey,
+  to: recipientPubkey,
+  amount: 1000,
+});`;
+  
+  console.log(`  ${colors.dim}${colors.bgRed}javascript${colors.reset}`);
+  tokenExample.split('\n').forEach(line => {
+    console.log(`  ${colors.bright}${line}${colors.reset}`);
+  });
+  console.log();
+  
+  printLink('Token Documentation', 'https://docs.aether.network/tokens');
+  printLink('Token Registry', 'https://github.com/aether-network/token-registry');
+  printLink('Testnet Faucet', 'https://faucet.aether.network');
+}
+
+/**
+ * Show documentation portal info
+ */
+function showDocs() {
+  printSection('Aether Documentation', '📚');
+  
+  console.log(`  ${colors.bright}Comprehensive documentation for Aether developers.${colors.reset}\n`);
+  
+  console.log(`  ${colors.cyan}📖 Documentation Portal:${colors.reset}`);
+  console.log(`     ${colors.blue}https://docs.aether.network${colors.reset}`);
+  console.log();
+  
+  console.log(`  ${colors.cyan}Sections:${colors.reset}`);
+  console.log(`    • Getting Started      - Quick start guides`);
+  console.log(`    • Core Concepts        - Accounts, programs, transactions`);
+  console.log(`    • SDK Reference        - Full API docs for JS and Rust`);
+  console.log(`    • Tutorials            - Step-by-step projects`);
+  console.log(`    • Validator Guide      - Running and maintaining validators`);
+  console.log(`    • Economics            - Staking, rewards, fees`);
+  console.log();
+  
+  printLink('Main Docs', 'https://docs.aether.network');
+  printLink('API Reference', 'https://docs.aether.network/api');
+  printLink('Tutorials', 'https://docs.aether.network/tutorials');
+  printLink('Validator Docs', 'https://docs.aether.network/validators');
+}
+
+/**
+ * Parse command line args
+ */
+function parseArgs() {
+  const args = process.argv.slice(3); // Skip 'aether-cli sdk'
+  
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    return 'all';
+  }
+  
+  const subcmd = args[0].toLowerCase();
+  
+  switch (subcmd) {
+    case 'js':
+    case 'javascript':
+    case 'node':
+      return 'js';
+    case 'rust':
+    case 'rs':
+      return 'rust';
+    case 'tokens':
+    case 'token':
+    case 'flux':
+    case 'ath':
+      return 'tokens';
+    case 'docs':
+    case 'doc':
+    case 'documentation':
+      return 'docs';
+    default:
+      return 'all';
+  }
+}
+
+/**
+ * Main SDK command
+ */
+function sdkCommand() {
+  const subcmd = parseArgs();
+  
+  switch (subcmd) {
+    case 'js':
+      showJsSdk();
+      break;
+    case 'rust':
+      showRustSdk();
+      break;
+    case 'tokens':
+      showTokensSdk();
+      break;
+    case 'docs':
+      showDocs();
+      break;
+    default:
+      showAllSdks();
+  }
+}
+
+// Export for use as module
+module.exports = { sdkCommand };
+
+// Run if called directly
+if (require.main === module) {
+  sdkCommand();
+}

package/commands/validator-start.js

@@ -0,0 +1,290 @@
+/**
+ * aether-cli validator-start
+ * 
+ * Spawns the aether-validator binary as a child process.
+ * Handles startup, logging, and graceful shutdown.
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+// ANSI colors
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  red: '\x1b[31m',
+};
+
+/**
+ * Find the aether-validator binary
+ * Searches common locations based on OS and repo layout
+ */
+function findValidatorBinary() {
+  const platform = os.platform();
+  const isWindows = platform === 'win32';
+  const binaryName = isWindows ? 'aether-validator.exe' : 'aether-validator';
+  
+  // Check common locations
+  const locations = [
+    // Sibling repo: Jelly-legs-unsteady-workshop/target/debug/
+    path.join(__dirname, '..', '..', 'Jelly-legs-unsteady-workshop', 'target', 'debug', binaryName),
+    path.join(__dirname, '..', '..', 'Jelly-legs-unsteady-workshop', 'target', 'release', binaryName),
+    // Local build in aether-cli (if someone built here)
+    path.join(__dirname, '..', 'target', 'debug', binaryName),
+    path.join(__dirname, '..', 'target', 'release', binaryName),
+    // System PATH
+    'aether-validator' + (isWindows ? '.exe' : ''),
+  ];
+
+  for (const loc of locations) {
+    if (loc.startsWith('aether-validator')) {
+      // Check if it's in PATH
+      try {
+        const { execSync } = require('child_process');
+        const checkCmd = isWindows ? 'where' : 'which';
+        execSync(`${checkCmd} ${loc}`, { stdio: 'pipe' });
+        return { type: 'binary', path: loc, inPath: true };
+      } catch {
+        // Not in PATH, continue
+      }
+    }
+    if (fs.existsSync(loc)) {
+      return { type: 'binary', path: loc };
+    }
+  }
+
+  // Binary not found - offer to build it
+  return { type: 'missing', path: null };
+}
+
+/**
+ * Parse command line args for validator-start
+ */
+function parseArgs() {
+  const args = process.argv.slice(3); // Skip 'aether-cli validator start'
+  
+  const options = {
+    testnet: false,
+    rpcAddr: '127.0.0.1:8899',
+    p2pAddr: '0.0.0.0:8001',
+    identity: null,
+    verbose: false,
+    tier: 'full',
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case '--testnet':
+        options.testnet = true;
+        break;
+      case '--rpc-addr':
+        options.rpcAddr = args[++i];
+        break;
+      case '--p2p-addr':
+        options.p2pAddr = args[++i];
+        break;
+      case '--identity':
+        options.identity = args[++i];
+        break;
+      case '--tier':
+        options.tier = args[++i];
+        break;
+      case '-v':
+      case '--verbose':
+        options.verbose = true;
+        break;
+    }
+  }
+
+  return options;
+}
+
+/**
+ * Print startup banner
+ */
+function printBanner(options) {
+  const tierBadge = options.tier.toUpperCase();
+  const tierLabel = `[${tierBadge}]`;
+  
+  console.log(`
+${colors.cyan}╔═══════════════════════════════════════════════════════════════╗
+${colors.cyan}║                                                               ║
+${colors.cyan}║   ${colors.bright}AETHER VALIDATOR${colors.reset}${colors.cyan}                                          ║
+${colors.cyan}║   ${colors.bright}Starting Validator Node${colors.reset}${colors.cyan}                                 ║
+${colors.cyan}║   ${colors.bright}${tierLabel}${colors.reset}${colors.cyan}                                              ║
+${colors.cyan}╚═══════════════════════════════════════════════════════════════╝${colors.reset}
+  `);
+  
+  console.log(`  ${colors.bright}Network:${colors.reset}`);
+  console.log(`    Mode:      ${options.testnet ? colors.yellow + 'TESTNET' : colors.green + 'MAINNET (not implemented)'}`);
+  console.log(`    Tier:      ${tierLabel}`);
+  console.log(`    RPC:       http://${options.rpcAddr}`);
+  console.log(`    P2P:       ${options.p2pAddr}`);
+  if (options.identity) {
+    console.log(`    Identity:  ${options.identity}`);
+  }
+  console.log();
+}
+
+/**
+ * Build the validator binary if missing
+ */
+function buildValidator() {
+  const { execSync } = require('child_process');
+  const workspaceRoot = path.join(__dirname, '..', '..');
+  const repoPath = path.join(workspaceRoot, 'Jelly-legs-unsteady-workshop');
+  
+  console.log(`  ${colors.cyan}Building aether-validator...${colors.reset}`);
+  
+  try {
+    execSync('cargo build --bin aether-validator', {
+      cwd: repoPath,
+      stdio: 'inherit',
+      shell: true,
+    });
+    
+    // Re-check for binary
+    const result = findValidatorBinary();
+    if (result.type === 'binary') {
+      console.log(`  ${colors.green}✓ Build successful!${colors.reset}`);
+      return result;
+    }
+    
+    console.error(`  ${colors.red}✗ Build completed but binary not found${colors.reset}`);
+    return null;
+  } catch (err) {
+    console.error(`  ${colors.red}✗ Build failed: ${err.message}${colors.reset}`);
+    return null;
+  }
+}
+
+/**
+ * Main validator start command
+ */
+function validatorStart(overrideTier = null) {
+  const options = parseArgs();
+  
+  // Allow tier override from init.js
+  if (overrideTier) {
+    options.tier = overrideTier;
+  }
+  
+  let result = findValidatorBinary();
+
+  printBanner(options);
+
+  // Handle missing binary
+  if (result.type === 'missing') {
+    console.log(`  ${colors.yellow}⚠ Validator binary not found${colors.reset}`);
+    console.log(`  ${colors.cyan}Would you like to build it now? (cargo build --bin aether-validator)${colors.reset}`);
+    console.log();
+    
+    const readline = require('readline');
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    
+    rl.question('  Build now? [Y/n] ', (answer) => {
+      rl.close();
+      
+      if (answer.toLowerCase() === 'n' || answer.toLowerCase() === 'no') {
+        console.log(`  ${colors.red}Aborted. Build the validator first, then try again.${colors.reset}`);
+        process.exit(1);
+      }
+      
+      const built = buildValidator();
+      if (!built) {
+        process.exit(1);
+      }
+      result = built;
+      startValidatorProcess(result, options);
+    });
+    return;
+  }
+
+  startValidatorProcess(result, options);
+}
+
+/**
+ * Spawn the validator process
+ */
+function startValidatorProcess({ type, path: binaryPath, inPath }, options) {
+  // Build command args
+  const validatorArgs = ['start'];
+  
+  if (options.testnet) {
+    validatorArgs.push('--testnet');
+  }
+  validatorArgs.push('--tier', options.tier);
+  validatorArgs.push('--rpc-addr', options.rpcAddr);
+  validatorArgs.push('--p2p-addr', options.p2pAddr);
+  if (options.identity) {
+    validatorArgs.push('--identity', options.identity);
+  }
+  if (options.verbose) {
+    validatorArgs.push('-vvv');
+  }
+
+  const commandDisplay = inPath ? binaryPath : binaryPath || 'cargo run --bin aether-validator';
+  console.log(`  ${colors.bright}Command:${colors.reset} ${commandDisplay} ${validatorArgs.join(' ')}`);
+  console.log();
+  console.log(`  ${colors.yellow}Starting validator (press Ctrl+C to stop)...${colors.reset}`);
+  console.log();
+
+  // Determine working directory
+  const workspaceRoot = path.join(__dirname, '..', '..');
+  const repoPath = path.join(workspaceRoot, 'Jelly-legs-unsteady-workshop');
+  
+  // Spawn the validator process
+  const child = inPath || binaryPath === 'aether-validator' || binaryPath === 'aether-validator.exe'
+    ? spawn(binaryPath, validatorArgs, {
+        stdio: ['inherit', 'pipe', 'pipe'],
+      })
+    : spawn(binaryPath, validatorArgs, {
+        stdio: ['inherit', 'pipe', 'pipe'],
+        cwd: repoPath,
+      });
+
+  // Colorize output
+  const outputColorizer = (data, isError = false) => {
+    const str = data.toString();
+    const color = isError ? colors.red : colors.reset;
+    process.stdout.write(`${color}${str}${colors.reset}`);
+  };
+
+  child.stdout.on('data', (data) => outputColorizer(data));
+  child.stderr.on('data', (data) => outputColorizer(data, true));
+
+  child.on('error', (err) => {
+    console.error(`${colors.red}Failed to start validator: ${err.message}${colors.reset}`);
+    process.exit(1);
+  });
+
+  child.on('close', (code) => {
+    console.log(`\n${colors.yellow}Validator exited with code ${code}${colors.reset}`);
+    process.exit(code);
+  });
+
+  // Handle Ctrl+C
+  process.on('SIGINT', () => {
+    console.log(`\n${colors.yellow}Shutting down validator...${colors.reset}`);
+    child.kill('SIGINT');
+    setTimeout(() => {
+      child.kill('SIGTERM');
+    }, 1000);
+  });
+}
+
+// Export for use as module
+module.exports = { validatorStart };
+
+// Run if called directly
+if (require.main === module) {
+  validatorStart();
+}