solana-tui-explorer 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +64 -0
  2. package/index.js +5 -5
  3. package/package.json +4 -3
package/README.md ADDED
@@ -0,0 +1,64 @@
1
+ # ⬡ Solana TUI Explorer (`sol-tui`)
2
+
3
+ [![npm version](https://img.shields.io/npm/v/solana-tui-explorer?color=00FF88&style=flat-square)](https://www.npmjs.com/package/solana-tui-explorer)
4
+ [![License: ISC](https://img.shields.io/badge/License-ISC-00FFFF.svg)](https://opensource.org/licenses/ISC)
5
+ [![Solana](https://img.shields.io/badge/Solana-Mainnet%20%7C%20Devnet%20%7C%20Localnet-purple)](https://solana.com)
6
+
7
+ > **The Ultimate Information Layer for the Solana Ecosystem inside a Beautifully Designed Terminal.**
8
+ > *Never break context or switch tabs to Solscan, DexScreener, or RugCheck again while developing or debugging Anchor programs.*
9
+
10
+ ---
11
+
12
+ ## ⚡ Quick Start (Run Instantly via NPM)
13
+
14
+ No installation required! Run directly from your command line with `npx`:
15
+
16
+ ```bash
17
+ # Launch using shortcut command alias:
18
+ npx sol-tui
19
+
20
+ # Or full name:
21
+ npx solana-tui-explorer
22
+ ```
23
+
24
+ ### Global Installation (Recommended for Daily Dev Use)
25
+
26
+ ```bash
27
+ npm install -g solana-tui-explorer
28
+
29
+ # Now run anywhere in your workspace:
30
+ sol-tui
31
+ ```
32
+
33
+ ---
34
+
35
+ ## 🛠️ Core Features & Key Map
36
+
37
+ The explorer is organized into six dedicated panels accessible via function keys **F1 through F6**:
38
+
39
+ * **F1 Network Gossip & Validator Map**: Live ASCII world radar mapping active validator node locations across the globe via gossip IP geolocation.
40
+ * **F2 Account & Wallet Insights**: Type auto-detection, token balance breakdown with real-time USD values, FairScale reputation scoring, and recent transaction history.
41
+ * **F3 Token Analytics & RugCheck**: Real-time spot prices, interactive candlestick charting (`5M`, `1H`, `1D`), RugCheck security audit (LP locking, warning flags, mintable/freezable checks), and DEX liquidity pools.
42
+ * **F4 Ask AI Debugger**: Powered by Groq Llama-3.3-70b, acting as an expert Solana systems developer and Anchor error code translator.
43
+ * **F5 Transaction Inspector**: Decodes instruction call hierarchies (including inner CPI invocations), balance delta auditor, compute unit profiler, and dry-run pre-flight simulator.
44
+ * **F6 LiteSVM Local Testing**: Intercepts and formats transactions executed during `cargo test` runs using our LiteSVM Rust wrapper.
45
+
46
+ ---
47
+
48
+ ## ⌨️ Global Keyboard Shortcuts
49
+
50
+ | Key | Action |
51
+ | --- | --- |
52
+ | `F1` – `F6` | Switch between panels (Network, Account, Token, Ask AI, Explorer, LiteSVM) |
53
+ | `I` | Open input modal (enter wallet address, token symbol/mint, signature, or AI prompt) |
54
+ | `R` | Force refresh active panel data |
55
+ | `T` | Toggle token candlestick chart timeframe (`5M`, `1H`, `1D`) |
56
+ | `↑` / `↓` or `J` / `K` | Scroll lists and detailed view panels |
57
+ | `TAB` / `←` / `→` | Switch pane focus inside split views |
58
+ | `ESC` / `Q` | Close active modal or exit application |
59
+
60
+ ---
61
+
62
+ ## 📄 License
63
+
64
+ Distributed under the **ISC License**.
package/index.js CHANGED
@@ -13,9 +13,9 @@ const { renderToken } = require('./panels/token');
13
13
  const { startDashboard } = require('./panels/dashboard');
14
14
 
15
15
  program
16
- .name('st')
17
- .description(chalk.hex('#00FF88').bold('Solana TUI Explorer (ST) — On-Chain Developer TUI for Solana'))
18
- .version('1.0.0');
16
+ .name('sol-tui')
17
+ .description(chalk.hex('#00FF88').bold('Solana TUI Explorer — On-Chain Developer TUI for Solana'))
18
+ .version('1.0.1');
19
19
 
20
20
  // Dashboard command (Full layout)
21
21
  program
@@ -35,7 +35,7 @@ program.hook('preAction', (thisCommand, actionCommand) => {
35
35
  console.log(chalk.hex('#00FF88')('==========================================================='));
36
36
  });
37
37
 
38
- // st wallet <ADDRESS>
38
+ // sol-tui wallet <ADDRESS>
39
39
  program
40
40
  .command('wallet [address]')
41
41
  .alias('w')
@@ -44,7 +44,7 @@ program
44
44
  renderWallet(address);
45
45
  });
46
46
 
47
- // st token <SYMBOL>
47
+ // sol-tui token <SYMBOL>
48
48
  program
49
49
  .command('token [symbol]')
50
50
  .alias('t')
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "solana-tui-explorer",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "main": "index.js",
5
5
  "bin": {
6
6
  "solana-tui-explorer": "bin/st.js",
7
- "st": "bin/st.js"
7
+ "sol-tui": "bin/st.js"
8
8
  },
9
9
  "files": [
10
10
  "bin",
@@ -12,7 +12,8 @@
12
12
  "api.js",
13
13
  "config.js",
14
14
  "data.js",
15
- "index.js"
15
+ "index.js",
16
+ "README.md"
16
17
  ],
17
18
  "repository": {
18
19
  "type": "git",