aether-hub 1.2.7 → 1.3.0

package/commands/tx-history.js

@@ -131,141 +131,42 @@ function formatStatus(status) {
 }
 
 // ---------------------------------------------------------------------------
-// Core RPC calls
+// Parse a transaction result into a normalized display object
 // ---------------------------------------------------------------------------
 
-/**
- * Fetch confirmed transaction signatures for an address using getSignaturesForAddress.
- */
-async function fetchTxSignatures(rpcUrl, address, limit) {
-  const body = {
-    jsonrpc: '2.0',
-    id: 1,
-    method: 'getSignaturesForAddress',
-    params: [
-      address,
-      { limit },
-    ],
-  };
-  return httpPost(rpcUrl, '/', body);
-}
+function parseTransaction(txResult) {
+  const blockTime = txResult.blockTime;
+  const slot = txResult.slot;
+  const status = txResult.status || 'confirmed';
 
-/**
- * Fetch a specific confirmed transaction by signature.
- */
-async function fetchTx(rpcUrl, signature) {
-  const body = {
-    jsonrpc: '2.0',
-    id: 1,
-    method: 'getTransaction',
-    params: [
-      signature,
-      { encoding: 'jsonParsed', maxSupportedTransactionVersion: 0 },
-    ],
-  };
-  return httpPost(rpcUrl, '/', body);
-}
-
-/**
- * Parse a transaction result into a normalized display object.
- */
-function parseTransaction(txResult, sigInfo) {
-  const blockTime = sigInfo.blockTime || txResult.blockTime;
-  const slot = sigInfo.slot;
-  const status = sigInfo.err ? 'failed' : (sigInfo.confirmationStatus || 'confirmed');
-
-  let txType = 'unknown';
+  let txType = txResult.tx_type || txResult.type || 'unknown';
   let amount = 0;
-  let fee = txResult.meta?.fee || 0;
-  let fromAddr = null;
+  let fee = txResult.fee || 0;
+  let fromAddr = txResult.signer || null;
   let toAddr = null;
-  let memo = null;
+  let memo = txResult.memo || null;
 
-  try {
-    const msg = txResult.transaction?.message;
-    if (msg) {
-      // Parse instructions for transfer/stake types
-      const instructions = msg.instructions || [];
-      for (const ix of instructions) {
-        const programId = ix.programId || (ix.parsed && ix.parsed.info && ix.parsed.type);
-        // Native transfer
-        if (ix.parsed && ix.parsed.type === 'transfer') {
-          txType = 'transfer';
-          const info = ix.parsed.info;
-          fromAddr = info.source || info.from;
-          toAddr = info.destination || info.to;
-          amount = info.lamports || info.amount || 0;
-        } else if (ix.parsed && ix.parsed.type === 'stake') {
-          txType = 'stake';
-          const info = ix.parsed.info;
-          fromAddr = info.from || info.funder;
-          toAddr = info.validator;
-          amount = info.lamports || info.amount || 0;
-        } else if (ix.parsed && ix.parsed.type === 'withdrawStake') {
-          txType = 'unstake';
-          const info = ix.parsed.info;
-          toAddr = info.destination || info.withdrawer;
-          amount = info.lamports || info.amount || 0;
-        } else if (ix.parsed && ix.parsed.type === 'vote') {
-          txType = 'vote';
-        } else if (ix.parsed && ix.parsed.type === 'initialize') {
-          txType = 'initialize';
-        } else if (ix.parsed && ix.parsed.type === 'createAccount') {
-          txType = 'create';
-        } else if (ix.parsed && ix.parsed.type === 'approve') {
-          txType = 'stake';
-          const info = ix.parsed.info || {};
-          fromAddr = info.from || info.owner;
-          toAddr = info.stake;
-          amount = info.amount || info.lamports || 0;
-        } else if (ix.parsed && ix.parsed.type === 'delegate') {
-          txType = 'stake';
-          const info = ix.parsed.info || {};
-          fromAddr = info.stake || info.from;
-          toAddr = info.validator;
-          amount = info.lamports || 0;
-        } else if (ix.parsed && ix.parsed.type === 'withdraw') {
-          txType = 'unstake';
-          const info = ix.parsed.info || {};
-          toAddr = info.destination;
-          amount = info.lamports || 0;
-        }
-        // Check memo
-        if (ix.memo) memo = ix.memo;
-      }
-
-      // Fallback: try legacy instructions if no parsed instructions
-      if (!instructions.length || instructions.every(ix => !ix.parsed)) {
-        for (const ix of instructions) {
-          if (ix.data === 'AAAA' || ix.data === '2ugJ4ELK3wW9qNXH' || !ix.data) {
-            txType = 'transfer';
-          }
-        }
-      }
-
-      // Compute fee
-      if (txResult.meta) {
-        fee = txResult.meta.fee || 0;
-        if (txResult.meta.postBalances && txResult.meta.preBalances) {
-          // Try to detect native transfer from balance changes
-          for (let i = 0; i < txResult.meta.postBalances.length; i++) {
-            const diff = txResult.meta.postBalances[i] - txResult.meta.preBalances[i];
-            if (diff < 0) {
-              amount = Math.abs(diff);
-              if (!fromAddr) fromAddr = msg.accountKeys?.[i];
-            } else if (diff > 0 && amount === 0) {
-              if (!toAddr) toAddr = msg.accountKeys?.[i];
-            }
-          }
-        }
-      }
+  // Parse payload for details
+  if (txResult.payload) {
+    const payload = txResult.payload;
+    if (payload.amount !== undefined) {
+      amount = Number(payload.amount);
+    }
+    if (payload.recipient) {
+      toAddr = payload.recipient;
+    }
+    if (payload.validator) {
+      toAddr = payload.validator;
+      txType = 'stake';
+    }
+    if (payload.stake_account) {
+      fromAddr = payload.stake_account;
+      txType = 'unstake';
     }
-  } catch (e) {
-    // Parsing failed — use defaults
   }
 
   return {
-    signature: sigInfo.signature || sigInfo.signatures?.[0],
+    signature: txResult.signature,
     slot,
     blockTime,
     status,
@@ -362,6 +263,14 @@ function displayJson(txs, meta) {
 
 async function main() {
   const opts = parseArgs();
+  // Shift args if this module was called via index.js (extra argument in argv)
+  // Detect by checking if first non-option arg after 'tx' is the command name
+  const args = process.argv.slice(2);
+  const txIdx = args.indexOf('tx');
+  const historyIdx = args.indexOf('history');
+  if (txIdx !== -1 && historyIdx !== -1) {
+    // Already parsed correctly above - no action needed
+  }
 
   if (opts.help) {
     console.log(`
@@ -400,46 +309,11 @@ ${C.bright}EXAMPLES${C.reset}
   }
 
   try {
-    // Step 1: Get transaction signatures
-    const sigsResult = await fetchTxSignatures(rpcUrl, opts.address, limit);
-
-    if (sigsResult.error) {
-      throw new Error(sigsResult.error.message || JSON.stringify(sigsResult.error));
-    }
-
-    const signatures = Array.isArray(sigsResult.result) ? sigsResult.result : [];
-
-    if (signatures.length === 0) {
-      if (!opts.json) {
-        displayTxTable([]);
-      } else {
-        displayJson([], { address: opts.address, rpc: rpcUrl, limit });
-      }
-      return;
-    }
-
-    // Step 2: Fetch each transaction in parallel (up to 10 at a time)
-    const txResults = [];
-    const BATCH = 10;
-
-    for (let i = 0; i < signatures.length; i += BATCH) {
-      const batch = signatures.slice(i, i + BATCH);
-      const batchPromises = batch.map(sig => fetchTx(rpcUrl, sig.signature).catch(err => ({ error: err.message })));
-      const batchResults = await Promise.all(batchPromises);
-      txResults.push(...batchResults);
-    }
-
-    // Step 3: Parse and normalize
-    const txs = txResults
-      .map((res, idx) => {
-        if (res.error) return null;
-        try {
-          return parseTransaction(res.result || {}, signatures[idx] || {});
-        } catch {
-          return null;
-        }
-      })
-      .filter(Boolean);
+    // Use SDK for real blockchain RPC calls
+    const client = createClient(rpcUrl);
+    const history = await client.getTransactionHistory(opts.address, limit);
+    
+    const txs = (history.transactions || []).map(tx => parseTransaction(tx));
 
     if (opts.json) {
       displayJson(txs, { address: opts.address, rpc: rpcUrl, limit });
@@ -448,14 +322,24 @@ ${C.bright}EXAMPLES${C.reset}
     }
 
   } catch (err) {
-    console.log(`\n  ${C.red}✗ Failed to fetch transaction history:${C.reset} ${err.message}\n`);
-    if (err.stack && !opts.json) {
-      console.log(`  ${C.dim}${err.stack.split('\n').slice(0, 3).join('\n  ')}${C.reset}\n`);
+    if (opts.json) {
+      console.log(JSON.stringify({
+        error: err.message,
+        address: opts.address,
+        rpc: rpcUrl,
+      }, null, 2));
+    } else {
+      console.log(`\n  ${C.red}✗ Failed to fetch transaction history:${C.reset} ${err.message}\n`);
+      console.log(`  ${C.dim}  Is your validator running? RPC: ${rpcUrl}${C.reset}`);
+      console.log(`  ${C.dim}  Set custom RPC: AETHER_RPC=https://your-rpc-url${C.reset}\n`);
     }
     process.exit(1);
   }
 }
 
+// Export for CLI integration
+module.exports = { txHistoryCommand: main };
+
 // Run if called directly
 if (require.main === module) {
   main();

package/commands/wallet.js

@@ -19,6 +19,9 @@ const bip39 = require('bip39');
 const nacl = require('tweetnacl');
 const bs58 = require('bs58').default;
 
+// Import SDK for blockchain RPC calls
+const aether = require('../sdk');
+
 // ANSI colours
 const C = {
   reset: '\x1b[0m',

package/index.js

@@ -36,10 +36,15 @@ const { blockhashCommand } = require('./commands/blockhash');
 const { sdkTestCommand } = require('./commands/sdk-test');
 const { balanceCommand } = require('./commands/balance');
 const { transferCommand } = require('./commands/transfer');
+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() {
@@ -65,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'];
 
@@ -429,6 +430,12 @@ const COMMANDS = {
       tpsCommand();
     },
   },
+  slot: {
+    description: 'Get current slot number — aether slot [--json] [--rpc <url>]',
+    handler: () => {
+      slotCommand();
+    },
+  },
   claim: {
     description: 'Claim accumulated staking rewards — aether claim --address <addr> [--json] [--dry-run]',
     handler: () => {
@@ -456,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`);
 }
 
 /**
@@ -532,5 +529,7 @@ function main() {
   }
 }
 
-// Run CLI
-main();
+// Run CLI only if executed directly
+if (require.main === module) {
+  main();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aether-hub",
-  "version": "1.2.7",
+  "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