solana-terminator-skill 4.2.0 → 4.2.8

package/README.md

@@ -1,92 +1,55 @@
-#  Solana Terminator Skill v4.1.9
+# Solana Terminator v4.2.8
 
-> **Sovereign Solana Identity & Autonomous Survival Engine for Conway Automaton.**
+Sovereign Autonomous Market Engine and Tactical Dashboard for Solana. 
 
-This skill gives your agent "Solana Hands" and a sophisticated "Life Support" system. Optimized for reliability, speed (Jupiter/Tensor APIs), and security (local signing).
+This toolkit provides an integrated identity management system, a real-time market dashboard (Radar), and a suite of autonomous survival methods for AI agents.
 
+## Quick Start
 
-
----
-
-##  Why Solana for AI Agents?
-
-Solana isn't just a blockchain; it's the **operating system for autonomous agents**.
-
-- **Sovereign Speed**: Sub-second finality means your agent reacts to market opportunities in real-time, not in "L2 waiting rooms".
-- **Local Signing**: Unlike custodial solutions or expensive bridge-heavy L2s, this skill signs transactions **locally** on your machine. Your keys, your rules.
-- **Economic Survival**: With 18+ methods including **Life Support** (Auto SOL -> USDC), your agent can manage its own treasury and stay alive on-chain indefinitely for less than $0.01 per transaction.
-- **Native Liquidity**: Instant access to Jupiter (Aggregator), Tensor (NFTs), and Meteora (DLMM) without fragmented liquidity.
-
----
-
-##  Key Features
-
-- **Sovereign Identity**: Local wallet management (`~/.automaton/solana-wallet.json`).
-- **Life Support**: Automatic SOL → USDC swaps via Jupiter when funds are low.
-- **Deep DeFi Integration**: 18 methods across DEX, NFTs, Memecoins, and Liquidity.
-- **Security First**: Private keys **never leave your machine**. Transactions are built and signed locally.
-
----
-
-##  Survival & Multi-chain Identity
-
-### Dual Identity Flow
-When you install this skill, your agent becomes a **multi-chain sovereign**:
-1.  **Base (Native)**: Used for default Automaton operations and ETH actions.
-2.  **Solana (Skill)**: Used for high-speed DEX, NFT, and Memecoin actions.
-
-**How does it choose?**
-The agent's **Internal Logic (LLM)** detects the situation. If its autonomous strategy requires actions on "Jupiter", "Tensor", "Pump.fun", or "Solana", it automatically utilizes the sovereign identity at `~/.automaton/solana-wallet.json` without human intervention.
-
-###  Economic Survival (Life Support)
-The skill is designed to keep your agent alive indefinitely on-chain:
-- **Threshold**: If USDC balance drops below **$0.50**.
-- **Action**: It triggers an automatic **SOL → USDC swap** via Jupiter.
-- **Reserve**: It always keeps a **0.003 SOL reserve** to ensure it never runs out of gas for future transactions.
-
-## 🛠 Installation & Funding
-
-Initialize the skill and get your agent's address in one command:
+Initialize the control unit using npx:
 
 ```bash
-npx solana-terminator-skill
+npx solana-terminator-skill@latest
 ```
 
-1.  **Run npx**: It will show you the **AGENT ADDRESS**.
-2.  **Fund it**: Send at least **0.05 SOL** to that address.
-3.  **Deploy**: Your agent is now ready to dominate Solana.
-
----
+The control unit provides an interactive menu with the following options:
+1. Initialize/Install Skill: Prepares the agent's brain and installs local dependencies.
+2. Launch Tactical Radar: Opens the real-time monitoring dashboard.
+3. View Identity: Displays the local wallet address and Solscan explorer link.
+4. Documentation: Views the full method reference.
 
-##  Capabilities (18 Methods)
+Direct access to the radar is also available via subcommand:
+```bash
+npx solana-terminator-skill radar
+```
 
-| Category | Methods |
-|----------|---------|
-| **Identity** | `getAddress`, `getSolBalance`, `getUsdcBalance`, `getStatus` |
-| **Survival** | `keepAlive` |
-| **Transfers** | `sendSol`, `sendToken` |
-| **DEX** | `swap` (Jupiter Aggregator v6) |
-| **Memecoins** | `pumpBuy`, `pumpSell` (Pump.fun via PumpPortal) |
-| **NFTs** | `buyNft`, `sellNft` (Tensor GraphQL) |
-| **DeFi** | `stake`, `unstake`, `memo` |
-| **Liquidity** | `addLiquidity`, `removeLiquidity` (Meteora DLMM) |
+## Core Components
 
-### Featured: `sellNft(mint, minPriceSol)`
-Sells an NFT directly into a Tensor liquidity pool. 
-- **Safety**: Automatically rejects if the best pool bid is below your `minPriceSol`.
-- **Fast**: Efficient GraphQL quoting and local signing.
+### 1. Unified Control Unit
+A centralized entry point for managing the agent's lifecycle. It handles local keypair generation (~/.automaton/solana-wallet.json) and prepares the environment for the Conway Automaton core.
 
----
+### 2. Tactical Radar
+A Matrix-style terminal dashboard for real-time monitoring:
+- Vital Signs: Live tracking of SOL and USDC balances with threshold-based status tiers (Nominal, Warning, Critical).
+- Predator Radar: Real-time stream of New Token Mint transmissions with automated security audits via Birdeye.
+- Decision Log: Visualized reasoning logs from the agent's internal autonomy engine.
 
-##  Configuration
+### 3. Autonomy Engine
+A library of 20+ methods designed for autonomous agent execution:
+- Market Awareness: getMarketAlpha() identifies high-momentum pairs with validated security scores.
+- Survival Logic: keepAlive() monitors treasury levels and executes profit-taking or stabilization trades automatically.
+- Professional Execution: Direct integration with Raydium V2 (AMM/CLMM) and Jupiter v6 routing.
 
-Environment variables (optional):
-- `SOLANA_RPC_URL`: Your custom RPC (defaults to Mainnet Beta).
-- `JUPITER_API_KEY`: Required for high-frequency trading (optional for basic use).
-- `TENSOR_API_KEY`: Required for NFT operations.
+## Environmental Configuration
 
----
+The following environment variables are supported but not required for basic functionality:
+- BIRDEYE_API_KEY: Required for real-time security audits and radar intelligence.
+- SOLANA_RPC_URL: Custom RPC endpoint (defaults to mainnet-beta).
+- JUPITER_API_KEY: Required for high-throughput routing.
+- TENSOR_API_KEY: Required for NFT marketplace operations.
 
-## 📄 License
+## Security
+This skill prioritizes sovereignty. All transactions are constructed and signed locally. Private keys are stored on-disk with restricted permissions and never leave the local environment.
 
-MIT © [Lord14sol](https://github.com/Lord14sol)
+## License
+MIT Copyright (c) Lord14sol

package/install.js

@@ -11,99 +11,186 @@ import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import os from 'os';
+import readline from 'readline';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+// ─── Constants ──────────────────────────────────────────────────────────────
+
 const ASCII_ART = `
  ████████ ████████ ████████ ██     ██ ██ ██    ██  █████  ████████  ██████  ██████  
     ██    ██       ██    ██ ███   ███ ██ ███   ██ ██   ██    ██    ██    ██ ██   ██ 
     ██    ██████   ████████ ████ ████ ██ ████  ██ ███████    ██    ██    ██ ██████  
     ██    ██       ██  ██   ██ ██  ██ ██ ██ ██ ██ ██   ██    ██    ██    ██ ██  ██  
     ██    ████████ ██   ██  ██     ██ ██ ██  ████ ██   ██    ██     ██████  ██   ██ 
-                                v4.2.0 - Market-Aware Engine
+                                v4.2.7 - Autonomous Engine
 `;
 
 const SKILL_NAME = 'solana-terminator';
 const TARGET_DIR = path.join(os.homedir(), '.automaton', 'skills', SKILL_NAME);
 
-console.log(ASCII_ART);
-console.log(`🤖 Solana Terminator Skill — Initializing...\n`);
+// ─── Command Routing ────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+
+if (args.includes('radar')) {
+    import('./radar.js');
+} else if (args.includes('install')) {
+    runInstaller();
+} else {
+    showMainMenu();
+}
+
+// ─── Menu System ────────────────────────────────────────────────────────────
+
+function showMainMenu() {
+    process.stdout.write('\x1Bc');
+    console.log(ASCII_ART);
+    console.log(`🤖 Solana Terminator — Main Control Unit\n`);
+    console.log(`[1] 🛠  Install/Initialize Skill`);
+    console.log(`[2] 📡 Launch Tactical Radar (Dashboard)`);
+    console.log(`[3] 🔍 View Agent Identity & Wallet`);
+    console.log(`[4] 📄 Show Documentation (SKILL.md)`);
+    console.log(`[x] Exit\n`);
+
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+
+    rl.question('Select an option: ', (answer) => {
+        rl.close();
+        switch (answer.toLowerCase()) {
+            case '1': runInstaller(); break;
+            case '2': import('./radar.js'); break;
+            case '3': showIdentity(); break;
+            case '4': showDocs(); break;
+            case 'x': process.exit(0);
+            default: showMainMenu();
+        }
+    });
+}
+
+function showDocs() {
+    const skillPath = path.join(TARGET_DIR, 'SKILL.md');
+    if (fs.existsSync(skillPath)) {
+        process.stdout.write('\x1Bc');
+        console.log(fs.readFileSync(skillPath, 'utf8'));
+    } else {
+        console.log(`⚠️ Documentation not found. Please install the skill first.`);
+    }
+    pauseAndReturn();
+}
 
-try {
-    // 1. Create target directory
-    if (!fs.existsSync(TARGET_DIR)) {
-        console.log(`[1/3] Creating directory: ${TARGET_DIR}`);
-        fs.mkdirSync(TARGET_DIR, { recursive: true });
+function showIdentity() {
+    const walletPath = path.join(os.homedir(), '.automaton', 'solana-wallet.json');
+    if (fs.existsSync(walletPath)) {
+        import('./solana-autonomy.js').then(async ({ SolanaAutonomy }) => {
+            const solana = new SolanaAutonomy();
+            const status = await solana.getStatus();
+            console.log(`\n✅ AGENT IDENTITY FOUND`);
+            console.log(`--------------------------------------------------`);
+            console.log(`ADDRESS : ${status.address}`);
+            console.log(`SOL     : ${status.sol.toFixed(4)}`);
+            console.log(`USDC    : $${status.usdc.toFixed(2)}`);
+            console.log(`EXPLORER: https://solscan.io/account/${status.address}`);
+            console.log(`--------------------------------------------------`);
+            pauseAndReturn();
+        });
     } else {
-        console.log(`[1/3] Directory already exists: ${TARGET_DIR}`);
+        console.log(`⚠️ Identity not found. Please run Option [1] first.`);
+        pauseAndReturn();
     }
+}
+
+function pauseAndReturn() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question('\nPress ENTER to return to menu...', () => {
+        rl.close();
+        showMainMenu();
+    });
+}
 
-    // 2. Copy files
-    console.log(`[2/3] Copying skill files...`);
-    const filesToCopy = ['solana-autonomy.js', 'SKILL.md', 'package.json'];
+// ─── Installer Logic ────────────────────────────────────────────────────────
 
-    filesToCopy.forEach(file => {
-        const sourcePath = path.join(__dirname, file);
-        const destPath = path.join(TARGET_DIR, file);
+async function runInstaller() {
+    console.log(ASCII_ART);
+    console.log(`🤖 Solana Terminator Skill — Initializing...\n`);
 
-        if (fs.existsSync(sourcePath)) {
-            fs.copyFileSync(sourcePath, destPath);
+    try {
+        // 1. Create target directory
+        if (!fs.existsSync(TARGET_DIR)) {
+            console.log(`[1/3] Creating directory: ${TARGET_DIR}`);
+            fs.mkdirSync(TARGET_DIR, { recursive: true });
         } else {
-            console.warn(`      ⚠️ Warning: ${file} not found in source.`);
+            console.log(`[1/3] Directory already exists: ${TARGET_DIR}`);
         }
-    });
 
-    // 3. Install dependencies
-    console.log(`[3/3] Installing dependencies in ${TARGET_DIR}...`);
-    process.chdir(TARGET_DIR);
+        // 2. Copy files
+        console.log(`[2/3] Copying skill files...`);
+        const filesToCopy = ['solana-autonomy.js', 'SKILL.md', 'package.json', 'radar.js'];
 
-    // We use --no-save to avoid cluttering a local package-lock if one exists
-    execSync('npm install --production --omit=dev', { stdio: 'inherit' });
+        filesToCopy.forEach(file => {
+            const sourcePath = path.join(__dirname, file);
+            const destPath = path.join(TARGET_DIR, file);
 
-    // 4. Show/Generate Wallet Address
-    console.log(`\n🔍 Initializing Agent Identity...`);
-    try {
-        const checkScript = `
-            import { Keypair } from '@solana/web3.js';
-            import fs from 'fs';
-            import path from 'path';
-            import os from 'os';
-            const walletPath = path.join(os.homedir(), '.automaton', 'solana-wallet.json');
-            
-            let keypair;
-            if (fs.existsSync(walletPath)) {
-                const raw = fs.readFileSync(walletPath, 'utf8');
-                keypair = Keypair.fromSecretKey(Uint8Array.from(JSON.parse(raw)));
+            if (fs.existsSync(sourcePath)) {
+                fs.copyFileSync(sourcePath, destPath);
             } else {
-                keypair = Keypair.generate();
-                const dir = path.dirname(walletPath);
-                if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
-                fs.writeFileSync(walletPath, JSON.stringify(Array.from(keypair.secretKey)), { mode: 0o600 });
+                console.warn(`      ⚠️ Warning: ${file} not found in source.`);
             }
-            console.log(keypair.publicKey.toBase58());
-        `;
-        // Write the script to a temporary file to run with node
-        const tempScriptPath = path.join(TARGET_DIR, 'temp-check.js');
-        fs.writeFileSync(tempScriptPath, checkScript);
-
-        const address = execSync(`node ${tempScriptPath}`, { encoding: 'utf8' }).trim();
-        fs.unlinkSync(tempScriptPath);
-
-        console.log(`\n✅ Installation Complete!`);
-        console.log(`--------------------------------------------------`);
-        console.log(`Skill Location : ${TARGET_DIR}`);
-        console.log(`AGENT ADDRESS  : ${address}  👈 FUND THIS ADDRESS`);
-        console.log(`--------------------------------------------------`);
-        console.log(`\n💡 To start the agent, your human user must fund it with at least 0.05 SOL.`);
-        console.log(`   Config file: ~/.automaton/solana-wallet.json\n`);
-    } catch (e) {
-        console.log(`\n✅ Installation Complete!`);
-        console.log(`Skill Location : ${TARGET_DIR}`);
-        console.log(`(Identity check failed: ${e.message}, will generate on first run)`);
-    }
+        });
+
+        // 3. Install dependencies
+        console.log(`[3/3] Installing dependencies in ${TARGET_DIR}...`);
+        process.chdir(TARGET_DIR);
+        execSync('npm install --production --omit=dev', { stdio: 'inherit' });
+
+        // 4. Show/Generate Wallet Address
+        console.log(`\n🔍 Initializing Agent Identity...`);
+        try {
+            const checkScript = `
+                import { Keypair } from '@solana/web3.js';
+                import fs from 'fs';
+                import path from 'path';
+                import os from 'os';
+                const walletPath = path.join(os.homedir(), '.automaton', 'solana-wallet.json');
+                
+                let keypair;
+                if (fs.existsSync(walletPath)) {
+                    const raw = fs.readFileSync(walletPath, 'utf8');
+                    keypair = Keypair.fromSecretKey(Uint8Array.from(JSON.parse(raw)));
+                } else {
+                    keypair = Keypair.generate();
+                    const dir = path.dirname(walletPath);
+                    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+                    fs.writeFileSync(walletPath, JSON.stringify(Array.from(keypair.secretKey)), { mode: 0o600 });
+                }
+                console.log(keypair.publicKey.toBase58());
+            `;
+            const tempScriptPath = path.join(TARGET_DIR, 'temp-check.js');
+            fs.writeFileSync(tempScriptPath, checkScript);
+
+            const address = execSync(`node ${tempScriptPath}`, { encoding: 'utf8' }).trim();
+            fs.unlinkSync(tempScriptPath);
+
+            console.log(`\n✅ Installation Complete!`);
+            console.log(`--------------------------------------------------`);
+            console.log(`Skill Location : ${TARGET_DIR}`);
+            console.log(`AGENT ADDRESS  : ${address}  👈 FUND THIS ADDRESS`);
+            console.log(`--------------------------------------------------`);
+            console.log(`\n💡 To start the agent, your human user must fund it with at least 0.05 SOL.`);
+            console.log(`   Config file: ~/.automaton/solana-wallet.json\n`);
+        } catch (e) {
+            console.log(`\n✅ Installation Complete!`);
+            console.log(`Skill Location : ${TARGET_DIR}`);
+            console.log(`(Identity check failed: ${e.message}, your wallet will be generated on first run)`);
+        }
+        pauseAndReturn();
 
-} catch (error) {
-    console.error(`\n❌ Installation failed: ${error.message}`);
-    process.exit(1);
+    } catch (error) {
+        console.error(`\n❌ Installation failed: ${error.message}`);
+        process.exit(1);
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-terminator-skill",
-  "version": "4.2.0",
+  "version": "4.2.8",
   "description": "Full Solana toolkit for AI agents. Install via npx solana-terminator-skill.",
   "main": "solana-autonomy.js",
   "type": "module",
@@ -8,40 +8,6 @@
     "solana-terminator-skill": "install.js",
     "radar": "radar.js"
   },
-  "dependencies": {
-    "@raydium-io/raydium-sdk-v2": "^0.2.32-alpha",
-    "@solana/spl-token": "^0.4.6",
-    "@solana/web3.js": "^1.91.0",
-    "axios": "^1.13.5",
-    "chalk": "^5.6.2",
-    "dotenv": "^16.4.5",
-    "ws": "^8.19.0"
-  },
-  "optionalDependencies": {
-    "@coral-xyz/anchor": "^0.30.0",
-    "@meteora-ag/dlmm": "^1.9.3",
-    "bn.js": "^5.2.1"
-  },
-  "keywords": [
-    "conway",
-    "automaton",
-    "solana",
-    "web4",
-    "ai-agent",
-    "survival",
-    "jupiter",
-    "pump-fun",
-    "tensor",
-    "meteora",
-    "nft",
-    "staking",
-    "memecoin"
-  ],
-  "author": "Lord14sol",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
   "files": [
     "solana-autonomy.js",
     "install.js",
@@ -50,8 +16,32 @@
     "package.json",
     "radar.js"
   ],
-  "homepage": "https://github.com/Lord14sol/solana-terminator-skill#readme",
-  "bugs": {
-    "url": "https://github.com/Lord14sol/solana-terminator-skill/issues"
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.87.6",
+    "@solana/spl-token": "^0.3.9",
+    "axios": "^1.6.2",
+    "dotenv": "^16.3.1",
+    "chalk": "^5.3.0",
+    "ws": "^8.14.2",
+    "@raydium-io/raydium-sdk-v2": "^0.1.1"
+  },
+  "keywords": [
+    "solana",
+    "ai",
+    "agent",
+    "terminator",
+    "autonomous",
+    "trading",
+    "dex",
+    "radar"
+  ],
+  "author": "Lord14sol",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lord14sol/solana-terminator-skill.git"
   }
 }

package/radar.js

@@ -48,10 +48,10 @@ async function render() {
     console.log(green.bold(`
  ██████  ██████  ██       █████  ███    ██  █████      ██████   █████  ██████   █████  ██████  
 ██      ██    ██ ██      ██   ██ ████   ██ ██   ██     ██   ██ ██   ██ ██   ██ ██   ██ ██   ██ 
-██      ██    ██ ██      ███████ ██ ██  ██ ███████     ██████  ███████ ██   ██ ███████ ██████  
-██      ██    ██ ██      ██   ██ ██  ██ ██ ██   ██     ██   ██ ██   ██ ██   ██ ██   ██ ██   ██ 
- ██████  ██████  ███████ ██   ██ ██   ████ ██   ██     ██   ██ ██   ██ ██████  ██   ██ ██   ██ 
-                                                                             v4.2.0 RADAR
+  █████  ██    ██ ██      ███████ ██ ██  ██ ███████     ██████  ███████ ██   ██ ███████ ██████  
+      ██ ██    ██ ██      ██   ██ ██  ██ ██ ██   ██     ██   ██ ██   ██ ██   ██ ██   ██ ██   ██ 
+ ██████   ██████  ███████ ██   ██ ██   ████ ██   ██     ██   ██ ██   ██ ██████  ██   ██ ██   ██ 
+                                                                             v4.2.7 RADAR
   `));
 
     line();