aether-hub 1.2.8 → 1.3.0

package/sdk/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@jellylegsai/aether-sdk",
+  "version": "1.0.0",
+  "description": "Official Aether Blockchain SDK - Real HTTP RPC calls to Aether chain",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "rpc.js",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node test.js",
+    "build": "node -e \"require('./index.js'); console.log('SDK build OK')\""
+  },
+  "keywords": [
+    "aether",
+    "blockchain",
+    "sdk",
+    "crypto",
+    "rpc",
+    "web3"
+  ],
+  "author": "Jelly-legs AI Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jelly-legs-ai/Jelly-legs-unsteady-workshop"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}

package/sdk/rpc.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+/**
+ * @jellylegsai/aether-sdk - RPC Client
+ * 
+ * Low-level HTTP RPC client for Aether blockchain.
+ * All functions make REAL HTTP calls to the blockchain RPC endpoint.
+ * No stubs, no mocks.
+ */
+
+const http = require('http');
+const https = require('https');
+
+const DEFAULT_RPC = process.env.AETHER_RPC || 'http://127.0.0.1:8899';
+
+/**
+ * Make a GET request to the RPC endpoint
+ * @param {string} rpcUrl - RPC endpoint URL
+ * @param {string} path - API path (e.g., /v1/slot)
+ * @param {number} timeout - Request timeout in ms
+ * @returns {Promise<object>} Parsed JSON response
+ */
+function rpcGet(rpcUrl, path, timeout = 8000) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(path, rpcUrl);
+    const isHttps = url.protocol === 'https:';
+    const lib = isHttps ? https : http;
+
+    const req = lib.request({
+      hostname: url.hostname,
+      port: url.port || (isHttps ? 443 : 80),
+      path: url.pathname + url.search,
+      method: 'GET',
+      timeout,
+      headers: { 'Content-Type': 'application/json' },
+    }, (res) => {
+      let data = '';
+      res.on('data', (chunk) => (data += chunk));
+      res.on('end', () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch {
+          resolve({ raw: data });
+        }
+      });
+    });
+
+    req.on('error', reject);
+    req.on('timeout', () => {
+      req.destroy();
+      reject(new Error(`RPC request timeout after ${timeout}ms`));
+    });
+    req.end();
+  });
+}
+
+/**
+ * Make a POST request to the RPC endpoint
+ * @param {string} rpcUrl - RPC endpoint URL
+ * @param {string} path - API path
+ * @param {object} body - Request body (will be JSON.stringify'd)
+ * @param {number} timeout - Request timeout in ms
+ * @returns {Promise<object>} Parsed JSON response
+ */
+function rpcPost(rpcUrl, path, body, timeout = 8000) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(path, rpcUrl);
+    const isHttps = url.protocol === 'https:';
+    const lib = isHttps ? https : http;
+    const bodyStr = JSON.stringify(body);
+
+    const req = lib.request({
+      hostname: url.hostname,
+      port: url.port || (isHttps ? 443 : 80),
+      path: url.pathname + url.search,
+      method: 'POST',
+      timeout,
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(bodyStr),
+      },
+    }, (res) => {
+      let data = '';
+      res.on('data', (chunk) => (data += chunk));
+      res.on('end', () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch {
+          resolve(data);
+        }
+      });
+    });
+
+    req.on('error', reject);
+    req.on('timeout', () => {
+      req.destroy();
+      reject(new Error(`RPC request timeout after ${timeout}ms`));
+    });
+
+    req.write(bodyStr);
+    req.end();
+  });
+}
+
+module.exports = {
+  rpcGet,
+  rpcPost,
+  DEFAULT_RPC,
+};

package/sdk/test.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * @jellylegsai/aether-sdk - Test Script
+ * 
+ * Tests all SDK functions with REAL RPC calls to http://127.0.0.1:8899
+ */
+
+const aether = require('./index');
+
+const C = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  red: '\x1b[31m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  dim: '\x1b[2m',
+};
+
+async function test(name, fn) {
+  try {
+    const result = await fn();
+    console.log(`  ${C.green}✓${C.reset} ${name}`);
+    return { ok: true, result };
+  } catch (err) {
+    console.log(`  ${C.red}✗${C.reset} ${name}: ${err.message}`);
+    return { ok: false, error: err.message };
+  }
+}
+
+async function main() {
+  console.log(`\n${C.cyan}══ @jellylegsai/aether-sdk Test Suite ══${C.reset}\n`);
+  console.log(`  ${C.dim}RPC Endpoint: ${aether.DEFAULT_RPC_URL}${C.reset}\n`);
+
+  const results = [];
+
+  // Test ping first
+  results.push(await test('ping()', async () => {
+    const ping = await aether.ping();
+    if (!ping.ok) throw new Error(ping.error);
+    return ping;
+  }));
+
+  // Test chain queries
+  results.push(await test('getSlot()', () => aether.getSlot()));
+  results.push(await test('getBlockHeight()', () => aether.getBlockHeight()));
+  results.push(await test('getEpoch()', () => aether.getEpoch()));
+  results.push(await test('getTPS()', () => aether.getTPS()));
+  results.push(await test('getSupply()', () => aether.getSupply()));
+  results.push(await test('getFees()', () => aether.getFees()));
+  results.push(await test('getValidators()', () => aether.getValidators()));
+  results.push(await test('getPeers()', () => aether.getPeers()));
+  results.push(await test('getHealth()', () => aether.getHealth()));
+  results.push(await test('getSlotProduction()', () => aether.getSlotProduction()));
+
+  // Test with a sample address (may not exist, but tests the call)
+  const testAddress = 'ATH111111111111111111111111111111111';
+  results.push(await test(`getAccount('${testAddress.substring(0, 12)}...')`, () => 
+    aether.getAccount(testAddress)
+  ));
+  results.push(await test(`getBalance('${testAddress.substring(0, 12)}...')`, () => 
+    aether.getBalance(testAddress)
+  ));
+  results.push(await test(`getStakePositions('${testAddress.substring(0, 12)}...')`, () => 
+    aether.getStakePositions(testAddress)
+  ));
+  results.push(await test(`getRewards('${testAddress.substring(0, 12)}...')`, () => 
+    aether.getRewards(testAddress)
+  ));
+
+  // Summary
+  const passed = results.filter(r => r.ok).length;
+  const failed = results.filter(r => !r.ok).length;
+
+  console.log();
+  if (failed === 0) {
+    console.log(`  ${C.green}══ All ${passed} tests passed! ══${C.reset}\n`);
+  } else {
+    console.log(`  ${C.yellow}══ ${passed} passed, ${failed} failed ══${C.reset}`);
+    console.log(`  ${C.dim}  (Failures may be due to RPC not running or test data not existing)${C.reset}\n`);
+  }
+
+  process.exit(failed > 0 ? 1 : 0);
+}
+
+main();

package/theme.js

@@ -0,0 +1,211 @@
+/**
+ * aether-cli - Shared Theme & Branding
+ * 
+ * Consistent colors, ASCII art, and styling across all CLI commands.
+ * Import this module to ensure unified visual identity.
+ */
+
+// ANSI color codes - Aether Brand Palette
+const COLORS = {
+  // Reset
+  reset: '\x1b[0m',
+  
+  // Styles
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  italic: '\x1b[3m',
+  underline: '\x1b[4m',
+  
+  // Core palette
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  white: '\x1b[37m',
+  
+  // Extended palette
+  crimson: '\x1b[38;5;161m',
+  gold: '\x1b[38;5;220m',
+  lime: '\x1b[38;5;118m',
+  orange: '\x1b[38;5;208m',
+  purple: '\x1b[38;5;93m',
+  teal: '\x1b[38;5;6m',
+  
+  // Tier colors
+  full: '\x1b[36m',      // cyan - Full validator
+  lite: '\x1b[33m',      // yellow - Lite validator
+  observer: '\x1b[32m',  // green - Observer
+};
+
+// Short alias for convenience
+const C = COLORS;
+
+// ASCII Art Banners
+const BANNERS = {
+  // Main CLI banner
+  main: `
+${C.cyan}    _    _____ _   _ ________   ______ _   _ ${C.reset}
+${C.cyan}   / \\  | ____| | | |__  /_ _| |__  /| | | |${C.reset}
+${C.cyan}  / _ \\ |  _| | |_| | / / | |    / /| |_| |${C.reset}
+${C.cyan} / ___ \\| |___|  _  |/ /_ | |   / /_|  _  |${C.reset}
+${C.cyan}/_/   \\_\\_____|_| |_/____|___| /____|_| |_|${C.reset}
+${C.dim}           Validator Command Line Interface${C.reset}
+`,
+
+  // Compact banner for subcommands
+  compact: `
+${C.cyan}╔═══════════════════════════════════════════════════════════════╗${C.reset}
+${C.cyan}║${C.reset}              ${C.bright}AETHER CHAIN — Validator CLI${C.reset}${C.cyan}                   ║${C.reset}
+${C.cyan}╚═══════════════════════════════════════════════════════════════╝${C.reset}`,
+
+  // Section headers
+  network: `${C.cyan}╔═══════════════════════════════════════════════════════════════════╗${C.reset}
+${C.cyan}║${C.reset}              ${C.bright}AETHER NETWORK STATUS${C.reset}${C.cyan}                            ║${C.reset}
+${C.cyan}╚═══════════════════════════════════════════════════════════════════╝${C.reset}`,
+
+  balance: `${C.bright}${C.cyan}── Aether Account Balance ───────────────────────────────${C.reset}`,
+  slot: `${C.bright}${C.cyan}── Aether Current Slot ──────────────────────────────────${C.reset}`,
+  tps: `${C.bright}${C.cyan}── Aether Network TPS ─────────────────────────────────${C.reset}`,
+  fees: `${C.bright}${C.cyan}── Aether Network Fees ──────────────────────────────────${C.reset}`,
+  stake: `${C.bright}${C.cyan}── Aether Stake Info ─────────────────────────────────${C.reset}`,
+  rewards: `${C.bright}${C.cyan}╔═══════════════════════════════════════════════════════╗${C.reset}
+${C.bright}${C.cyan}║           Staking Rewards                             ║${C.reset}
+${C.bright}${C.cyan}╚═══════════════════════════════════════════════════════╝${C.reset}`,
+  claim: `${C.bright}${C.cyan}── Claim Staking Rewards ────────────────────────────────${C.reset}`,
+  emergency: `${C.bright}${C.cyan}🔔 Aether Emergency Status${C.reset}`,
+  multisig: `${C.bright}${C.cyan}── Multi-Signature Wallet ─────────────────────────${C.reset}`,
+  validator: `${C.bright}${C.cyan}── Validator Management ─────────────────────────────${C.reset}`,
+  wallet: `${C.bright}${C.cyan}── Wallet Management ────────────────────────────────${C.reset}`,
+  txHistory: `${C.bright}${C.cyan}  Transaction History${C.reset}`,
+};
+
+// Status icons
+const ICONS = {
+  success: `${C.green}✓${C.reset}`,
+  error: `${C.red}✗${C.reset}`,
+  warning: `${C.yellow}⚠${C.reset}`,
+  info: `${C.cyan}ℹ${C.reset}`,
+  pending: `${C.yellow}⏳${C.reset}`,
+  active: `${C.green}●${C.reset}`,
+  inactive: `${C.dim}○${C.reset}`,
+  bullet: `${C.cyan}★${C.reset}`,
+  arrow: `${C.cyan}▸${C.reset}`,
+  lightning: `${C.yellow}⚡${C.reset}`,
+  fire: `${C.red}🔥${C.reset}`,
+  bell: `${C.yellow}🔔${C.reset}`,
+};
+
+// Box drawing characters
+const BOX = {
+  h: '─',
+  v: '│',
+  tl: '┌',
+  tr: '┐',
+  bl: '└',
+  br: '┘',
+  t: '┬',
+  b: '┴',
+  l: '├',
+  r: '┤',
+  cross: '┼',
+};
+
+// CLI Metadata
+const META = {
+  version: '1.3.0',
+  name: 'aether-hub',
+  description: 'AeTHer Validator CLI — tiered validators, system checks, and node management',
+  author: 'Jelly-legs AI Team',
+  repository: 'https://github.com/jelly-legs-ai/Jelly-legs-unsteady-workshop',
+  rpc: {
+    default: 'http://127.0.0.1:8899',
+    env: 'AETHER_RPC',
+  },
+};
+
+// Helper functions
+function printBanner(type = 'compact') {
+  console.log(BANNERS[type] || BANNERS.compact);
+}
+
+function printBox(content, width = 70) {
+  const lines = content.split('\n');
+  console.log(`${C.cyan}${BOX.tl}${BOX.h.repeat(width - 2)}${BOX.tr}${C.reset}`);
+  lines.forEach(line => {
+    const padded = line.padEnd(width - 4);
+    console.log(`${C.cyan}${BOX.v}${C.reset} ${padded} ${C.cyan}${BOX.v}${C.reset}`);
+  });
+  console.log(`${C.cyan}${BOX.bl}${BOX.h.repeat(width - 2)}${BOX.br}${C.reset}`);
+}
+
+function printDivider(char = '─', width = 70) {
+  console.log(`${C.dim}${char.repeat(width)}${C.reset}`);
+}
+
+function formatLabel(label, value, options = {}) {
+  const { color = C.bright, valueColor = C.reset, indent = 2 } = options;
+  const spaces = ' '.repeat(indent);
+  return `${spaces}${color}${label}:${C.reset} ${valueColor}${value}${C.reset}`;
+}
+
+function formatAeth(lamports, options = {}) {
+  const { decimals = 6, showLamports = false } = options;
+  const aeth = (Number(lamports) / 1e9).toFixed(decimals).replace(/\.?0+$/, '');
+  if (showLamports) {
+    return `${C.green}${aeth} AETH${C.reset} ${C.dim}(${Number(lamports).toLocaleString()} lamports)${C.reset}`;
+  }
+  return `${C.green}${aeth} AETH${C.reset}`;
+}
+
+function formatDate(date) {
+  if (!date) return `${C.dim}—${C.reset}`;
+  const d = date instanceof Date ? date : new Date(date);
+  return d.toISOString().replace('T', ' ').slice(0, 19);
+}
+
+function shortenAddress(addr, start = 6, end = 4) {
+  if (!addr || addr.length <= start + end + 3) return addr || `${C.dim}unknown${C.reset}`;
+  return `${addr.slice(0, start)}...${addr.slice(-end)}`;
+}
+
+function getRpcUrl(customUrl = null) {
+  return customUrl || process.env[META.rpc.env] || META.rpc.default;
+}
+
+// Status colors based on value
+function statusColor(value, thresholds = {}) {
+  const { good = 80, warning = 50 } = thresholds;
+  if (value >= good) return C.green;
+  if (value >= warning) return C.yellow;
+  return C.red;
+}
+
+function tpsColor(tps) {
+  if (tps === null || tps === undefined) return C.red;
+  if (tps >= 1000) return C.green;
+  if (tps >= 100) return C.cyan;
+  if (tps >= 10) return C.yellow;
+  return C.red;
+}
+
+// Export everything
+module.exports = {
+  COLORS,
+  C,
+  BANNERS,
+  ICONS,
+  BOX,
+  META,
+  printBanner,
+  printBox,
+  printDivider,
+  formatLabel,
+  formatAeth,
+  formatDate,
+  shortenAddress,
+  getRpcUrl,
+  statusColor,
+  tpsColor,
+};