aether-hub 1.2.8 → 1.3.0

package/index.js

@@ -40,7 +40,11 @@ const { slotCommand } = require('./commands/slot');
 const readline = require('readline');
 
 // CLI version
-const VERSION = '1.0.5';
+const VERSION = '1.3.0';
+
+// Import shared theme
+const theme = require('./theme');
+const { C, BANNERS, ICONS } = theme;
 
 // Parse args early to support flags on commands
 function getCommandArgs() {
@@ -66,21 +70,17 @@ async function showMenu() {
 
   const prompt = (q) => new Promise((res) => rl.question(q, res));
 
-  console.log(
-    TIER_COLORS.FULL + '\n  ╔═══════════════════════════════════════════════╗\n' +
-    '  ║     AETHER CHAIN — Validator Setup Wizard     ║\n' +
-    '  ╚═══════════════════════════════════════════════╝' + TIER_COLORS.reset + '\n'
-  );
+  console.log(BANNERS.compact + '\n');
 
   console.log('  Welcome to AeTHer Chain. What would you like to do?\n');
-  console.log('  ' + TIER_COLORS.FULL + '1)' + TIER_COLORS.reset + '  🩺  Doctor  — Check if your system meets requirements');
-  console.log('  ' + TIER_COLORS.FULL + '2)' + TIER_COLORS.reset + '  🚀  Start  — Begin validator onboarding (recommended)');
-  console.log('  ' + TIER_COLORS.FULL + '3)' + TIER_COLORS.reset + '  📊  Monitor — Watch live validator stats');
-  console.log('  ' + TIER_COLORS.FULL + '4)' + TIER_COLORS.reset + '  📋  Logs   — Tail and colourise validator logs');
-  console.log('  ' + TIER_COLORS.FULL + '5)' + TIER_COLORS.reset + '  📦  SDK    — Get SDK links and install tools');
-  console.log('  ' + TIER_COLORS.FULL + '6)' + TIER_COLORS.reset + '  🌐  Network — Aether network status (slot, peers, TPS)');
-  console.log('  ' + TIER_COLORS.FULL + '7)' + TIER_COLORS.reset + '  ❓  Help   — Show all commands\n');
-  console.log('  ' + TIER_COLORS.reset + '  Type a number or command name. Press Ctrl+C to exit.\n');
+  console.log(`  ${C.cyan}1)${C.reset}  ${ICONS.active}  ${C.bright}Doctor${C.reset}  — Check if your system meets requirements`);
+  console.log(`  ${C.cyan}2)${C.reset}  🚀  ${C.bright}Start${C.reset}  — Begin validator onboarding (recommended)`);
+  console.log(`  ${C.cyan}3)${C.reset}  📊  ${C.bright}Monitor${C.reset} — Watch live validator stats`);
+  console.log(`  ${C.cyan}4)${C.reset}  📋  ${C.bright}Logs${C.reset}   — Tail and colourise validator logs`);
+  console.log(`  ${C.cyan}5)${C.reset}  📦  ${C.bright}SDK${C.reset}    — Get SDK links and install tools`);
+  console.log(`  ${C.cyan}6)${C.reset}  🌐  ${C.bright}Network${C.reset} — Aether network status (slot, peers, TPS)`);
+  console.log(`  ${C.cyan}7)${C.reset}  ❓  ${C.bright}Help${C.reset}   — Show all commands\n`);
+  console.log(`  ${C.dim}Type a number or command name. Press Ctrl+C to exit.\n`);
 
   const VALID_CHOICES = ['1', '2', '3', '4', '5', '6', '7', 'doctor', 'init', 'monitor', 'logs', 'sdk', 'network', 'help'];
 
@@ -463,37 +463,27 @@ const COMMANDS = {
  * Display help message with ASCII art
  */
 function showHelp() {
-  const header = `
-███╗   ███╗██╗███████╗███████╗██╗ ██████╗ ███╗   ██╗
-████╗ ████║██║██╔════╝██╔════╝██║██╔═══██╗████╗  ██║
-██╔████╔██║██║███████╗███████╗██║██║   ██║██╔██╗ ██║
-██║╚██╔╝██║██║╚════██║╚════██║██║██║   ██║██║╚██╗██║
-██║ ╚═╝ ██║██║███████║███████║██║╚██████╔╝██║ ╚████║
-╚═╝     ╚═╝╚═╝╚══════╝╚══════╝╚═╝ ╚═════╝ ╚═╝  ╚═══╝
-
-Validator CLI v${VERSION}
-`.trim();
-
-  console.log(header);
-  console.log('\nUsage: aether-cli <command> [options]\n');
+  console.log(BANNERS.main);
+  console.log(`${C.bright}Validator CLI v${VERSION}${C.reset}\n`);
+  console.log(`Usage: aether <command> [options]\n`);
   console.log('Commands:');
   Object.entries(COMMANDS).forEach(([cmd, info]) => {
-    console.log(`  ${cmd.padEnd(18)} ${info.description}`);
+    console.log(`  ${C.cyan}${cmd.padEnd(18)}${C.reset} ${info.description}`);
   });
   console.log('\nExamples:');
-  console.log('  aether-cli doctor              # Check system requirements');
-  console.log('  aether-cli init                # Start onboarding wizard');
-  console.log('  aether-cli monitor             # Real-time validator dashboard');
-  console.log('  aether-cli validator start     # Start validator node');
-  console.log('  aether-cli validator status    # Check validator status');
-  console.log('  aether-cli wallet balance      # Query AETH balance');
-  console.log('  aether-cli network             # Network status, peers, slot info');
-  console.log('  aether-cli network --peers     # Detailed peer list');
-  console.log('  aether-cli tx history          # Show transaction history');
-  console.log('  aether-cli price               # AETH/USD price check');
-  console.log('  aether-cli --version           # Show version');
-  console.log('\nDocumentation: https://github.com/jelly-legs-ai/Jelly-legs-unsteady-workshop');
-  console.log('Spec: docs/MINING_VALIDATOR_TOOLS.md\n');
+  console.log(`  ${C.cyan}aether doctor${C.reset}              # Check system requirements`);
+  console.log(`  ${C.cyan}aether init${C.reset}                # Start onboarding wizard`);
+  console.log(`  ${C.cyan}aether monitor${C.reset}             # Real-time validator dashboard`);
+  console.log(`  ${C.cyan}aether validator start${C.reset}     # Start validator node`);
+  console.log(`  ${C.cyan}aether validator status${C.reset}    # Check validator status`);
+  console.log(`  ${C.cyan}aether wallet balance${C.reset}      # Query AETH balance`);
+  console.log(`  ${C.cyan}aether network${C.reset}             # Network status, peers, slot info`);
+  console.log(`  ${C.cyan}aether network --peers${C.reset}     # Detailed peer list`);
+  console.log(`  ${C.cyan}aether tx history${C.reset}          # Show transaction history`);
+  console.log(`  ${C.cyan}aether price${C.reset}               # AETH/USD price check`);
+  console.log(`  ${C.cyan}aether --version${C.reset}           # Show version`);
+  console.log(`\n${C.dim}Documentation: https://github.com/jelly-legs-ai/Jelly-legs-unsteady-workshop${C.reset}`);
+  console.log(`${C.dim}Spec: docs/MINING_VALIDATOR_TOOLS.md\n`);
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aether-hub",
-  "version": "1.2.8",
+  "version": "1.3.0",
   "description": "AeTHer Validator CLI — tiered validators (Full/Lite/Observer), system checks, onboarding, and node management",
   "main": "index.js",
   "bin": {
@@ -9,7 +9,9 @@
   },
   "files": [
     "index.js",
+    "theme.js",
     "commands/",
+    "sdk/",
     "test/",
     "README.md",
     "LICENSE"

package/sdk/README.md

@@ -0,0 +1,210 @@
+# @jellylegsai/aether-sdk
+
+Official Aether Blockchain SDK for Node.js. Every function makes **REAL HTTP RPC calls** to the Aether blockchain at `http://127.0.0.1:8899`. No stubs, no mocks.
+
+## Installation
+
+```bash
+npm install @jellylegsai/aether-sdk
+```
+
+Or use locally from the `sdk/` folder in this repo:
+
+```javascript
+const aether = require('./sdk');
+```
+
+## Quick Start
+
+```javascript
+const aether = require('@jellylegsai/aether-sdk');
+
+// Get current slot
+const slot = await aether.getSlot();
+console.log('Current slot:', slot);
+
+// Get account balance
+const balance = await aether.getBalance('ATH...');
+console.log('Balance:', balance);
+
+// Use custom RPC endpoint
+const client = new aether.AetherClient({ rpcUrl: 'http://127.0.0.1:8899' });
+const epoch = await client.getEpochInfo();
+```
+
+## SDK Architecture
+
+- **`AetherClient`** — Full-featured blockchain client class. All methods make real HTTP calls.
+- **Convenience functions** — Top-level exports for one-off queries using the default RPC.
+- **Low-level RPC helpers** — `rpcGet` / `rpcPost` for custom requests.
+
+Default RPC: `http://127.0.0.1:8899` (override via `AETHER_RPC` env or constructor option).
+
+## AetherClient
+
+```javascript
+const aether = require('@jellylegsai/aether-sdk');
+
+const client = new aether.AetherClient({
+  rpcUrl: 'http://127.0.0.1:8899',  // default
+  timeoutMs: 10000,                  // default: 10s
+});
+```
+
+## API Reference
+
+### Chain Queries
+
+| Method | Returns | RPC Endpoint |
+|--------|---------|--------------|
+| `getSlot()` | `number` — current slot | `GET /v1/slot` |
+| `getBlockHeight()` | `number` — block height | `GET /v1/blockheight` |
+| `getEpochInfo()` | `object` — epoch + slot info | `GET /v1/epoch` |
+| `getAccountInfo(address)` | `object` — lamports, owner, data | `GET /v1/account/:address` |
+| `getBalance(address)` | `number` — lamports | `GET /v1/account/:address` |
+| `getTransaction(signature)` | `object` — tx details | `GET /v1/transaction/:sig` |
+| `getRecentTransactions(address, limit?)` | `array` — recent txs | `GET /v1/transactions/:address` |
+| `getTokenAccounts(address)` | `array` — SPL token accounts | `GET /v1/tokens/:address` |
+| `getStakeAccounts(address)` | `array` — stake accounts | `GET /v1/stake-accounts/:address` |
+| `getStakePositions(address)` | `array` — delegations | `GET /v1/stake/:address` |
+| `getRewards(address)` | `object` — staking rewards | `GET /v1/rewards/:address` |
+| `getValidators()` | `array` — validator list | `GET /v1/validators` |
+| `getValidatorAPY(validatorAddr)` | `object` — APY data | `GET /v1/validator/:addr/apy` |
+| `getTPS()` | `number` — TPS | `GET /v1/tps` |
+| `getSupply()` | `object` — total/circulating/non-circulating | `GET /v1/supply` |
+| `getFees()` | `object` — fee estimates | `GET /v1/fees` |
+| `getSlotProduction()` | `object` — slot production | `POST /v1/slot_production` |
+| `getClusterPeers()` | `array` — peer list | `GET /v1/peers` |
+| `getHealth()` | `string` — "ok" if healthy | `GET /v1/health` |
+| `getVersion()` | `object` — node version | `GET /v1/version` |
+
+### Blockhash (required for signing)
+
+| Method | Returns | RPC Endpoint |
+|--------|---------|--------------|
+| `getRecentBlockhash()` | `{ blockhash, lastValidBlockHeight }` | `GET /v1/recent-blockhash` |
+
+### Transaction Submission
+
+| Method | Returns | RPC Endpoint |
+|--------|---------|--------------|
+| `sendTransaction(tx)` | `object` — receipt | `POST /v1/transaction` |
+
+### Transaction Builders (build + submit)
+
+| Method | Description |
+|--------|-------------|
+| `transfer({ from, to, amount, nonce, signFn })` | Build + send a Transfer TX |
+| `stake({ staker, validator, amount, signFn })` | Build + send a Stake TX |
+| `unstake({ stakeAccount, amount, signFn })` | Build + send an Unstake TX |
+| `claimRewards({ stakeAccount, signFn })` | Build + send a ClaimRewards TX |
+| `createNFT({ creator, metadataUrl, royalties, signFn })` | Build + send a CreateNFT TX |
+| `transferNFT({ from, nftId, to, signFn })` | Build + send a TransferNFT TX |
+| `updateMetadata({ creator, nftId, metadataUrl, signFn })` | Build + send an UpdateMetadata TX |
+
+Each builder fetches a fresh `blockhash` + current `slot` from the chain, then submits the signed transaction via `sendTransaction()`. All steps are real RPC calls.
+
+## Convenience Functions
+
+```javascript
+// All of these use the default RPC (http://127.0.0.1:8899)
+const slot = await aether.getSlot();
+const balance = await aether.getBalance('ATH...');
+const epoch = await aether.getEpoch();
+const tps = await aether.getTPS();
+const supply = await aether.getSupply();
+const fees = await aether.getFees();
+const validators = await aether.getValidators();
+const peers = await aether.getPeers();
+const health = await aether.getHealth();
+const { blockhash } = await aether.getRecentBlockhash();
+const tx = await aether.getTransaction('sig...');
+const txs = await aether.getRecentTransactions('ATH...', 20);
+const stakePos = await aether.getStakePositions('ATH...');
+const rewards = await aether.getRewards('ATH...');
+const tokenAccts = await aether.getTokenAccounts('ATH...');
+const stakeAccts = await aether.getStakeAccounts('ATH...');
+const apy = await aether.getValidatorAPY('validatorAddr');
+const pingResult = await aether.ping(); // { ok, latency, rpc }
+```
+
+## Utilities
+
+| Function | Description |
+|----------|-------------|
+| `createClient(options)` | Factory: create an `AetherClient` instance |
+| `ping(rpcUrl?)` | Ping RPC, returns `{ ok, latency, rpc }` |
+| `rpcGet(rpcUrl, path, timeout?)` | Low-level GET |
+| `rpcPost(rpcUrl, path, body, timeout?)` | Low-level POST |
+| `DEFAULT_RPC_URL` | `"http://127.0.0.1:8899"` |
+| `DEFAULT_TIMEOUT_MS` | `10000` |
+
+## CLI Integration
+
+The SDK is wired into these CLI commands in `aether-cli`:
+
+| CLI Command | SDK Method Used |
+|-------------|----------------|
+| `aether status` | `getEpochInfo`, `getSupply`, `getSlot`, `getBlockHeight`, `getClusterPeers`, `getVersion`, `getStakePositions`, `getRewards` |
+| `aether network` | `getSlot`, `getBlockHeight`, `getClusterPeers`, `getValidators`, `getEpochInfo`, `getSupply`, `getTPS` |
+| `aether blockhash` | `getRecentBlockhash` |
+| `aether fees` | `getFees`, `getRecentBlockhash` |
+| `aether tps` | `getTPS`, `getSlot` |
+| `aether account` | `getAccountInfo`, `getBalance`, `getRecentTransactions`, `getStakePositions`, `getTokenAccounts`, `getStakeAccounts` |
+
+## Configuration
+
+```bash
+# Environment variable
+export AETHER_RPC=http://127.0.0.1:8899
+
+# Or per-call
+const client = new aether.AetherClient({ rpcUrl: 'http://custom:8899' });
+```
+
+## Example: Full Dashboard
+
+```javascript
+const aether = require('@jellylegsai/aether-sdk');
+
+async function dashboard() {
+  const [slot, blockHeight, tps, supply, { blockhash }] = await Promise.all([
+    aether.getSlot(),
+    aether.getBlockHeight(),
+    aether.getTPS(),
+    aether.getSupply(),
+    aether.getRecentBlockhash(),
+  ]);
+
+  console.log('=== Aether Network Dashboard ===');
+  console.log(`Slot:              ${slot}`);
+  console.log(`Block:             ${blockHeight}`);
+  console.log(`TPS:               ${tps}`);
+  console.log(`Total Supply:      ${supply.total}`);
+  console.log(`Blockhash:         ${blockhash}`);
+}
+
+dashboard();
+```
+
+## Example: Check Staking Rewards
+
+```javascript
+const aether = require('@jellylegsai/aether-sdk');
+
+async function checkRewards(walletAddress) {
+  const [stakePositions, rewards] = await Promise.all([
+    aether.getStakePositions(walletAddress),
+    aether.getRewards(walletAddress),
+  ]);
+
+  console.log(`Stake positions: ${stakePositions.length}`);
+  console.log(`Total rewards:   ${rewards.total || rewards.amount} lamports`);
+}
+
+checkRewards('ATH...');
+```
+
+## License
+
+MIT © Jelly-legs AI Team