@graveyardprotocol/gp-cli 1.0.0

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@graveyardprotocol/gp-cli",
+  "version": "1.0.0",
+  "description": "Graveyard Protocol CLI — close empty Solana SPL token accounts and reclaim locked SOL",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "gp": "bin/gp.mjs"
+  },
+  "preferGlobal": true,
+  "files": [
+    "bin/",
+    "src/",
+    "LICENSE.md",
+    "THIRD_PARTY_LICENSES"
+  ],
+  "scripts": {
+    "start": "node bin/gp.mjs"
+  },
+  "dependencies": {
+    "@solana/spl-token": "^0.4.9",
+    "@solana/web3.js": "^1.98.0",
+    "bs58": "^6.0.0",
+    "commander": "^14.0.3",
+    "inquirer": "^13.3.2"
+  },
+  "keywords": [
+    "solana",
+    "spl",
+    "token",
+    "graveyard-protocol",
+    "cli",
+    "reclaim",
+    "rent-exempt",
+    "refund your sol",
+    "unclaimed sol",
+    "claim your sol",
+    "sol incinerator"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Graveyard Protocol <dev@graveyardprotocol.io>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GraveyardProtocol/gp-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/graveyardprotocol/gp-cli/issues"
+  },
+  "homepage": "https://github.com/graveyardprotocol/gp-cli#readme",
+  "devDependencies": {
+    "javascript-obfuscator": "^5.3.1",
+    "license-checker": "^25.0.1"
+  }
+}

package/src/api.mjs

@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Graveyard Protocol CLI
+ * Copyright (c) 2026 Graveyard Protocol. All rights reserved.
+ * This software and its source code are proprietary. 
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ */
+
+import { API_BASE_URL } from './config.mjs';
+
+// ── Internal fetch helper ─────────────────────────────────────────────────────
+
+async function apiFetch(method, path, body) {
+  const url = `${API_BASE_URL}${path}`;
+
+  const options = {
+    method,
+    headers: { 'Content-Type': 'application/json' },
+  };
+  if (body !== undefined) {
+    options.body = JSON.stringify(body);
+  }
+
+  let res;
+  try {
+    res = await fetch(url, options);
+  } catch (err) {
+    throw new Error(`Network error calling ${url}: ${err.message}`);
+  }
+
+  let json;
+  try {
+    json = await res.json();
+  } catch {
+    throw new Error(`Non-JSON response from ${url} (HTTP ${res.status})`);
+  }
+
+  if (!res.ok || json.success === false) {
+    const msg = json.error || json.message || `HTTP ${res.status}`;
+    throw new Error(`API error [${path}]: ${msg}`);
+  }
+
+  return json;
+}
+
+// ── 1. Scan Wallet ────────────────────────────────────────────────────────────
+// GET /v2/wallet/scan/{walletAddress}
+// Returns: { wallet, total_empty_accounts, total_rent_sol,
+//            estimated_ghost_rewards, estimated_fees, scanTimestamp }
+
+export async function scanWallet(walletAddress) {
+  const res = await apiFetch('GET', `/v2/wallet/scan/${walletAddress}`);
+  return res.data;
+}
+
+// ── 2. Get Batch Count ────────────────────────────────────────────────────────
+// GET /v2/wallet/getBatchCount/{walletAddress}
+// Returns: { wallet, totalBatches }
+
+export async function getBatchCount(walletAddress) {
+  const res = await apiFetch('GET', `/v2/wallet/getBatchCount/${walletAddress}`);
+  return res.totalBatches;
+}
+
+// ── 3. Process / Build Batch ──────────────────────────────────────────────────
+// POST /v2/wallet/processBatch
+// Body:    { walletAddress, batchId }
+// Returns: { batches: [{ intentID, instructionsBatch }] }
+
+export async function processBatch(walletAddress, batchId) {
+  const res = await apiFetch('POST', '/v2/wallet/processBatch', {
+    walletAddress,
+    batchId,
+  });
+  return res.data.batches;
+}
+
+// ── 4. Execute Batch ──────────────────────────────────────────────────────────
+// POST /v2/wallet/executeBatch
+// Body:    { walletAddress, transactions: [{ intentID, signedTransaction }] }
+// Returns: { success, results: [{ intentID, txSignature, batchAccountsClosed,
+//                                 batchRentSol, success, error? }] }
+
+export async function executeBatch(walletAddress, transactions) {
+  const res = await apiFetch('POST', '/v2/wallet/executeBatch', {
+    walletAddress,
+    transactions,
+  });
+  return res.results;
+}
+
+// ── 5. Get Latest Blockhash ───────────────────────────────────────────────────
+// GET /api/solana/blockhash
+// Returns: { blockhash, lastValidBlockHeight }
+
+export async function getLatestBlockhash() {
+  const res = await apiFetch('GET', '/api/solana/blockhash');
+  return res.data; // { blockhash, lastValidBlockHeight }
+}

package/src/commands/addWallet.mjs

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Graveyard Protocol CLI
+ * Copyright (c) 2026 Graveyard Protocol. All rights reserved.
+ * This software and its source code are proprietary. 
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ */
+
+import { addWallet } from '../walletManager.mjs';
+export default addWallet;

package/src/commands/closeEmpty.mjs

@@ -0,0 +1,284 @@
+/**
+ * @license
+ * Graveyard Protocol CLI
+ * Copyright (c) 2026 Graveyard Protocol. All rights reserved.
+ * This software and its source code are proprietary. 
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ */
+
+import inquirer from 'inquirer';
+import { loadWallet, loadWalletFile } from '../walletManager.mjs';
+import { scanWallet, getBatchCount, processBatch, executeBatch, getLatestBlockhash } from '../api.mjs';
+import { buildAndSignAll } from '../solana.mjs';
+import {
+  printBanner,
+  printHeader,
+  printScanSummary,
+  printProgress,
+  createSpinner,
+  printBatchResult,
+  printFinalSummary,
+  printError,
+  printInfo,
+  printWarning,
+  printSuccess,
+} from '../display.mjs';
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+// Detect inquirer's ExitPromptError (thrown on Ctrl+C in v9+)
+function isExitPrompt(err) {
+  return err?.name === 'ExitPromptError';
+}
+
+// Returns a spinner when verbose, or a silent no-op when not.
+// The silent fail is a no-op — the caller's catch block handles the throw.
+function maybeSpinner(verbose, text) {
+  if (verbose) return createSpinner(text);
+  return { start: () => {}, succeed: () => {}, fail: () => {} };
+}
+
+// ── Wallet selection prompt ───────────────────────────────────────────────────
+
+async function selectWallet(walletFile) {
+  if (!walletFile.wallets.length) {
+    throw new Error('No wallets saved. Run `gp add-wallet` first.');
+  }
+
+  let result;
+  try {
+    result = await inquirer.prompt([
+      {
+        type: 'rawlist',
+        name: 'selected',
+        message: 'Select a wallet to use:',
+        choices: walletFile.wallets.map((w) => ({
+          name: `${w.description || 'No description'}  (${w.publicKey})`,
+          value: w.publicKey,
+        })),
+      },
+    ]);
+  } catch (err) {
+    if (isExitPrompt(err)) { console.log('\nAborted.'); process.exit(0); }
+    throw err;
+  }
+
+  return result.selected;
+}
+
+// ── Main close-empty handler ──────────────────────────────────────────────────
+
+export default async function closeEmpty(options) {
+  printBanner();
+
+  try {
+    const walletFile = loadWalletFile();
+    let walletAddresses = [];
+
+    if (options.all) {
+      if (!walletFile.wallets.length) {
+        throw new Error('No wallets saved. Run `gp add-wallet` first.');
+      }
+      walletAddresses = walletFile.wallets.map(w => w.publicKey);
+      printInfo(`Processing all ${walletAddresses.length} wallet(s).\n`);
+    } else {
+      const selected = await selectWallet(walletFile);
+      walletAddresses = [selected];
+    }
+
+    for (const walletAddress of walletAddresses) {
+      await processWallet(walletAddress, options);
+    }
+
+  } catch (err) {
+    printError(err.message);
+    process.exit(1);
+  }
+}
+
+// ── Process a single wallet ───────────────────────────────────────────────────
+
+async function processWallet(walletAddress, options) {
+  const verbose = Boolean(options.verbose);
+  const dryRun  = Boolean(options.dryRun);
+
+  printHeader(`Wallet: ${walletAddress}`);
+
+  // ── Step 1: Scan ─────────────────────────────────────────────────────────
+  const scanSpinner = createSpinner('Scanning for empty token accounts...');
+  scanSpinner.start();
+
+  let scanData;
+  try {
+    scanData = await scanWallet(walletAddress);
+    scanSpinner.succeed('Scan complete.');
+  } catch (err) {
+    scanSpinner.fail('Scan failed.');
+    throw err;
+  }
+
+  if (scanData.total_empty_accounts === 0) {
+    printInfo('No empty token accounts found. Nothing to close.');
+    return;
+  }
+
+  // Always show the scan summary — it's the key info before confirming
+  printScanSummary(scanData);
+
+  // ── Step 2: Confirm with user ─────────────────────────────────────────────
+  const confirmMsg = dryRun
+    ? `Run dry-run for ${scanData.total_empty_accounts} account(s)?`
+    : `Close ${scanData.total_empty_accounts} account(s) and reclaim SOL?`;
+
+  let confirmAnswer;
+  try {
+    confirmAnswer = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'confirm',
+        message: confirmMsg,
+        default: false,
+      },
+    ]);
+  } catch (err) {
+    if (isExitPrompt(err)) { console.log('\nAborted.'); process.exit(0); }
+    throw err;
+  }
+
+  if (!confirmAnswer.confirm) {
+    printWarning('Aborted by user.');
+    return;
+  }
+
+  // ── Step 3: Unlock wallet ─────────────────────────────────────────────────
+  let keypair;
+  try {
+    keypair = await loadWallet(walletAddress);
+  } catch (err) {
+    throw new Error(`Failed to unlock wallet: ${err.message}`);
+  }
+
+  // ── Step 4: Get batch count ───────────────────────────────────────────────
+  const countSpinner = createSpinner('Fetching batch count...');
+  countSpinner.start();
+
+  let totalBatches;
+  try {
+    totalBatches = await getBatchCount(walletAddress);
+    countSpinner.succeed(`${totalBatches} batch(es) to process.`);
+  } catch (err) {
+    countSpinner.fail('Failed to fetch batch count.');
+    throw err;
+  }
+
+  if (totalBatches === 0) {
+    printWarning('Scan cache expired. Please run the command again to rescan.');
+    return;
+  }
+
+  // ── Step 5: Process each DDB batch ───────────────────────────────────────
+  const allResults = [];
+
+  for (let batchId = 1; batchId <= totalBatches; batchId++) {
+
+    // Normal mode: one progress line per batch
+    if (!verbose) {
+      printProgress(`Processing batch ${batchId} of ${totalBatches}...`);
+    } else {
+      console.log('');
+      printProgress(`Processing batch ${batchId} of ${totalBatches}...`);
+    }
+
+    // 5a. Fetch sub-batch instructions from Lambda
+    const buildSpinner = maybeSpinner(verbose, `Fetching instructions (batch ${batchId})...`);
+    buildSpinner.start();
+
+    let subBatches;
+    try {
+      subBatches = await processBatch(walletAddress, batchId);
+      buildSpinner.succeed(`${subBatches.length} transaction(s) built.`);
+    } catch (err) {
+      buildSpinner.fail(`Failed to build batch ${batchId}.`);
+      throw err;
+    }
+
+    // 5b. Fetch ONE blockhash for this entire DDB batch
+    const hashSpinner = maybeSpinner(verbose, 'Fetching latest blockhash...');
+    hashSpinner.start();
+
+    let blockhash;
+    try {
+      ({ blockhash } = await getLatestBlockhash());
+      hashSpinner.succeed('Blockhash ready.');
+    } catch (err) {
+      hashSpinner.fail('Failed to fetch blockhash.');
+      throw err;
+    }
+
+    // 5c. Build + sign ALL sub-batch transactions at once
+    const signSpinner = maybeSpinner(verbose, `Signing ${subBatches.length} transaction(s)...`);
+    signSpinner.start();
+
+    let signedTransactions;
+    try {
+      signedTransactions = buildAndSignAll(subBatches, blockhash, keypair);
+      signSpinner.succeed(`Signed ${signedTransactions.length} transaction(s).`);
+    } catch (err) {
+      signSpinner.fail('Signing failed.');
+      throw err;
+    }
+
+    // 5d. Execute or simulate depending on dry-run flag
+    if (dryRun) {
+      // Dry-run: skip executeBatch, fabricate success results from cache metadata
+      const dryResults = subBatches.map(sub => ({
+        intentID:          sub.intentID,
+        txSignature:       '(dry-run)',
+        batchAccountsClosed: sub.batchAccountsClosed ?? 0,
+        batchRentSol:        sub.batchRentSol        ?? 0,
+        success:           true,
+      }));
+      allResults.push(...dryResults);
+
+      if (!verbose) {
+        printSuccess(`Batch ${batchId} of ${totalBatches} — dry-run complete.`);
+      } else {
+        printSuccess(`Batch ${batchId}: dry-run — ${dryResults.length} transaction(s) would be submitted.`);
+      }
+
+    } else {
+      // Live: send to execute Lambda
+      const execSpinner = maybeSpinner(verbose, 'Submitting to Solana...');
+      execSpinner.start();
+
+      let batchResults;
+      try {
+        batchResults = await executeBatch(walletAddress, signedTransactions);
+        const ok = batchResults.filter(r => r.success).length;
+        execSpinner.succeed(`Executed — ${ok}/${batchResults.length} succeeded.`);
+      } catch (err) {
+        execSpinner.fail('Execution failed.');
+        throw err;
+      }
+
+      allResults.push(...batchResults);
+
+      if (!verbose) {
+        const ok      = batchResults.filter(r => r.success).length;
+        const failed  = batchResults.length - ok;
+        if (failed === 0) {
+          printSuccess(`Batch ${batchId} of ${totalBatches} processed successfully.`);
+        } else {
+          printWarning(`Batch ${batchId} of ${totalBatches} — ${ok} succeeded, ${failed} failed.`);
+        }
+      }
+    }
+  }
+
+  // ── Step 6: Results ───────────────────────────────────────────────────────
+  printHeader(dryRun ? 'Dry-run Results' : 'Results');
+  if (verbose) {
+    allResults.forEach((r, i) => printBatchResult(r, i));
+  }
+  printFinalSummary(allResults, dryRun);
+}

package/src/commands/listWallets.mjs

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Graveyard Protocol CLI
+ * Copyright (c) 2026 Graveyard Protocol. All rights reserved.
+ * This software and its source code are proprietary. 
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ */
+
+import { listWallets } from '../walletManager.mjs';
+export default listWallets;

package/src/commands/removeWallet.mjs

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Graveyard Protocol CLI
+ * Copyright (c) 2026 Graveyard Protocol. All rights reserved.
+ * This software and its source code are proprietary. 
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ */
+
+import { removeWallet } from '../walletManager.mjs';
+export default removeWallet;

package/src/config.mjs

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Graveyard Protocol CLI
+ * Copyright (c) 2026 Graveyard Protocol. All rights reserved.
+ * This software and its source code are proprietary. 
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ */
+
+// ── API ───────────────────────────────────────────────────────────────────────
+export const API_BASE_URL = 'https://api.graveyardprotocol.io';
+
+// ── Protocol constants - FOR INFORMATION ONLY──────────────────────────────────
+// These parameters are handled in the backend.
+// export const BASE_GHOST_POINTS    = 100;
+// export const PROTOCOL_FEE_PERCENT = 0.20;   // 20%
+// export const REAPER_FEE_RECIPIENT = 'GRAVEbqZNUN1K7WBgvwgWUYs69M51eprZbSkeXWbQjjE';

package/src/display.mjs

@@ -0,0 +1,188 @@
+/**
+ * @license
+ * Graveyard Protocol CLI
+ * Copyright (c) 2026 Graveyard Protocol. All rights reserved.
+ * This software and its source code are proprietary. 
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ */
+
+// Lightweight display helpers — no heavy dependencies.
+// Uses ANSI escape codes directly so it works on every platform.
+
+const C = {
+  reset:  '\x1b[0m',
+  bold:   '\x1b[1m',
+  dim:    '\x1b[2m',
+  green:  '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan:   '\x1b[36m',
+  red:    '\x1b[31m',
+  white:  '\x1b[37m',
+  grey:   '\x1b[90m',
+};
+
+function c(color, text) {
+  return `${C[color]}${text}${C.reset}`;
+}
+
+// ── Gradient banner ───────────────────────────────────────────────────────────
+// Applies a per-character 24-bit RGB gradient across each banner line.
+// Purple (128, 0, 255) → Green (0, 220, 100).
+// Degrades gracefully on terminals without true-color support.
+
+const GRADIENT_START = { r: 128, g: 0,   b: 255 };  // purple
+const GRADIENT_END   = { r: 0,   g: 220, b: 100 };  // green
+
+function trueColor(r, g, b, text) {
+  return `\x1b[1m\x1b[38;2;${r};${g};${b}m${text}\x1b[0m`;
+}
+
+function gradientLine(text) {
+  // Count printable characters (skip leading spaces used for indent)
+  const total = text.length || 1;
+  let result = '';
+  for (let i = 0; i < text.length; i++) {
+    const t = i / (total - 1);
+    const r = Math.round(GRADIENT_START.r + (GRADIENT_END.r - GRADIENT_START.r) * t);
+    const g = Math.round(GRADIENT_START.g + (GRADIENT_END.g - GRADIENT_START.g) * t);
+    const b = Math.round(GRADIENT_START.b + (GRADIENT_END.b - GRADIENT_START.b) * t);
+    result += trueColor(r, g, b, text[i]);
+  }
+  return result;
+}
+
+export function printBanner() {
+  const lines = [
+    '  ░██████╗░██████╗ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░',
+    '  ██╔════╝ ██╔══██╗            Graveyard Protocol CLI                 ',
+    '  ██║░░██╗ ██████╔╝                    v1.0.0                         ',
+    '  ██║░░╚═╝ ██╔═══╝                                                    ',
+    '  ╚██████╗ ██║         Close empty SPL token accounts · Reclaim SOL   ',
+    '   ╚═════╝ ╚═╝     ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░',
+    '                                                                      '  
+  ];
+  console.log('');
+  lines.forEach(line => console.log(gradientLine(line)));
+}
+
+// ── Section header ────────────────────────────────────────────────────────────
+export function printHeader(text) {
+  const line = '─'.repeat(50);
+  console.log('');
+  console.log(c('cyan', ` ${line}`));
+  console.log(c('cyan', c('bold', `  ${text}`)));
+  console.log(c('cyan', ` ${line}`));
+}
+
+// ── Scan summary ──────────────────────────────────────────────────────────────
+export function printScanSummary(data) {
+  const solNet = (data.total_rent_sol - data.estimated_fees).toFixed(6);
+  console.log('');
+  console.log(c('bold', '  Scan Results'));
+  console.log(c('grey',  '  ──────────────────────────────────────'));
+  console.log(`  Empty accounts found   : ${c('yellow', data.total_empty_accounts)}`);
+  console.log(`  Total rent locked      : ${c('white',  data.total_rent_sol.toFixed(6))} SOL`);
+  console.log(`  Protocol fee (20%)     : ${c('grey',   data.estimated_fees.toFixed(6))} SOL`);
+  console.log(`  ${c('bold', 'You will receive')}       : ${c('green', solNet)} SOL`);
+  console.log(`  Ghost Points earned    : ${c('cyan',   data.estimated_ghost_rewards.toLocaleString())}`);
+  console.log('');
+}
+
+// ── Dry-run notice ────────────────────────────────────────────────────────────
+export function printDryRunNotice() {
+  console.log(c('yellow', '  ⚠  Dry-run mode — no transactions were submitted.\n'));
+}
+
+// ── Progress line ─────────────────────────────────────────────────────────────
+export function printProgress(text) {
+  process.stdout.write(`  ${c('grey', '→')} ${text}\n`);
+}
+
+// ── Spinner (simple write/clear on same line) ─────────────────────────────────
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const ERASE_LINE = '\x1b[2K'; // ANSI: erase entire current line
+
+export function createSpinner(text) {
+  let i = 0;
+  let timer;
+  const isTTY = process.stdout.isTTY;
+
+  return {
+    start() {
+      if (!isTTY) { process.stdout.write(`  ${text}...\n`); return; }
+      timer = setInterval(() => {
+        process.stdout.write(`\r${ERASE_LINE}  ${c('cyan', SPINNER_FRAMES[i++ % SPINNER_FRAMES.length])} ${text}`);
+      }, 80);
+    },
+    succeed(msg) {
+      clearInterval(timer);
+      if (isTTY) process.stdout.write(`\r${ERASE_LINE}  ${c('green', '✔')} ${msg || text}\n`);
+      else process.stdout.write(`  ✔ ${msg || text}\n`);
+    },
+    fail(msg) {
+      clearInterval(timer);
+      if (isTTY) process.stdout.write(`\r${ERASE_LINE}  ${c('red', '✖')} ${msg || text}\n`);
+      else process.stdout.write(`  ✖ ${msg || text}\n`);
+    },
+  };
+}
+
+// ── Per-batch result row ──────────────────────────────────────────────────────
+export function printBatchResult(result, index) {
+  if (result.success) {
+    console.log(
+      `  ${c('green', '✔')} Batch ${index + 1}` +
+      `  ${c('yellow', result.batchAccountsClosed)} accounts closed` +
+      `  ${c('green', result.batchRentSol?.toFixed(6))} SOL reclaimed`
+    );
+    console.log(`    ${c('grey', 'tx:')} ${c('dim', result.txSignature)}`);
+  } else {
+    console.log(
+      `  ${c('red', '✖')} Batch ${index + 1}  ${c('red', result.error || 'Unknown error')}`
+    );
+  }
+}
+
+// ── Final summary ─────────────────────────────────────────────────────────────
+export function printFinalSummary(results, dryRun = false) {
+  const succeeded  = results.filter(r => r.success);
+  const failed     = results.filter(r => !r.success);
+  const totalAcct  = succeeded.reduce((s, r) => s + (r.batchAccountsClosed || 0), 0);
+  const totalSol   = succeeded.reduce((s, r) => s + (r.batchRentSol || 0), 0);
+
+  console.log('');
+  console.log(c('bold', dryRun ? '  Dry-run Summary' : '  Summary'));
+  console.log(c('grey',  '  ──────────────────────────────────────'));
+  if (dryRun) {
+    console.log(`  Batches simulated      : ${c('cyan',   succeeded.length)}`);
+    console.log(`  Accounts that would close : ${c('yellow', totalAcct)}`);
+    console.log(`  SOL that would be reclaimed (~80%) : ${c('green', totalSol.toFixed(6))} SOL`);
+    console.log(c('yellow', '\n  ⚠  Dry-run — no transactions were submitted.'));
+  } else {
+    console.log(`  Batches succeeded      : ${c('green',  succeeded.length)}`);
+    if (failed.length) {
+      console.log(`  Batches failed         : ${c('red',    failed.length)}`);
+    }
+    console.log(`  Accounts closed        : ${c('yellow', totalAcct)}`);
+    console.log(`  SOL reclaimed (~80%)   : ${c('green',  totalSol.toFixed(6))} SOL`);
+  }
+  console.log('');
+}
+
+// ── Error ─────────────────────────────────────────────────────────────────────
+export function printError(msg) {
+  console.error(`\n  ${c('red', '✖')} ${c('bold', 'Error:')} ${msg}\n`);
+}
+
+// ── Info ──────────────────────────────────────────────────────────────────────
+export function printInfo(msg) {
+  console.log(`  ${c('cyan', 'ℹ')} ${msg}`);
+}
+
+export function printSuccess(msg) {
+  console.log(`  ${c('green', '✔')} ${msg}`);
+}
+
+export function printWarning(msg) {
+  console.log(`  ${c('yellow', '⚠')} ${msg}`);
+}