decharge-scout 1.0.0

package/index.js

@@ -0,0 +1,374 @@
+#!/usr/bin/env node
+
+/**
+ * DeCharge Scout - Energy Grid Data Scout CLI
+ *
+ * Main entry point for the CLI application that scouts energy grid data,
+ * performs optimizations, and submits results to Solana blockchain.
+ *
+ * Installation:
+ *   npm install -g .
+ *
+ * Usage:
+ *   decharge-scout --wallet=<path> [--agent-name=<name>] [--location=<location>]
+ *
+ * Example:
+ *   decharge-scout --wallet=./wallet.json --agent-name="MyAgent"
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import dotenv from 'dotenv';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { createInterface } from 'readline';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { Keypair } from '@solana/web3.js';
+
+// Load environment variables
+dotenv.config();
+
+// Import modules
+import { loadWallet, stakeSOL, refundStake } from './src/wallet.js';
+import { fetchEnergyData, fetchElectricityMapsData } from './src/energy-data.js';
+import { findCheapestWindow, calculateSavings } from './src/optimizer.js';
+import { submitToOracle } from './src/oracle.js';
+import { initializePoints, awardPoints, getPoints, savePoints } from './src/points.js';
+import { getLocation } from './src/geolocation.js';
+import { purchasePremiumData } from './src/x402.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Configuration
+const STAKE_AMOUNT = parseFloat(process.env.STAKE_AMOUNT || '0.01');
+const CYCLE_INTERVAL_MS = 15 * 60 * 1000; // 15 minutes
+const DEFAULT_WALLET_PATH = path.join(__dirname, 'wallet.json');
+
+// Global state
+let isRunning = true;
+let totalRuns = 0;
+let stakeTransactionSignature = null;
+
+// Readline interface for prompts
+const rl = createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+const question = (prompt) => new Promise((resolve) => rl.question(prompt, resolve));
+
+/**
+ * Generate random agent name
+ */
+function generateAgentName() {
+  const randomId = Math.random().toString(36).substring(2, 8).toUpperCase();
+  return `Agent-${randomId}`;
+}
+
+/**
+ * Auto-create wallet if missing
+ */
+async function ensureWallet(walletPath) {
+  if (existsSync(walletPath)) {
+    return walletPath;
+  }
+
+  console.log(chalk.yellow(`\n⚠️  No wallet found at ${walletPath}`));
+  const answer = await question('Create a new wallet? (Y/n): ');
+
+  if (answer.toLowerCase() === 'n') {
+    console.log(chalk.blue('\nYou can create a wallet manually:'));
+    console.log(chalk.gray('  solana-keygen new --outfile ./wallet.json'));
+    console.log(chalk.gray('  Or run: node setup.js\n'));
+    process.exit(1);
+  }
+
+  console.log(chalk.blue('Generating new wallet...'));
+
+  const keypair = Keypair.generate();
+  const secretKey = Array.from(keypair.secretKey);
+
+  writeFileSync(walletPath, JSON.stringify(secretKey));
+
+  console.log(chalk.green(`✓ Wallet created: ${keypair.publicKey.toBase58()}`));
+  console.log(chalk.yellow('⚠️  IMPORTANT: Backup this wallet file!'));
+  console.log(chalk.blue(`\nYou need devnet SOL. Get it from:`));
+  console.log(chalk.gray('  solana airdrop 1 ' + keypair.publicKey.toBase58() + ' --url devnet'));
+  console.log(chalk.gray('  Or visit: https://faucet.solana.com/\n'));
+
+  await question('Press Enter after funding your wallet...');
+
+  return walletPath;
+}
+
+/**
+ * Auto-configure .env if needed
+ */
+async function ensureEnvironment() {
+  const envPath = path.join(__dirname, '.env');
+
+  // Create .env from example if missing
+  if (!existsSync(envPath)) {
+    const examplePath = path.join(__dirname, '.env.example');
+    if (existsSync(examplePath)) {
+      console.log(chalk.yellow('⚠️  .env file not found, creating from template...'));
+      const example = readFileSync(examplePath, 'utf-8');
+      writeFileSync(envPath, example);
+      console.log(chalk.green('✓ .env file created'));
+    }
+  }
+
+  // Check for EIA API key
+  if (!process.env.EIA_API_KEY || process.env.EIA_API_KEY === 'your_eia_api_key_here') {
+    console.log(chalk.yellow('\n⚠️  EIA_API_KEY not configured'));
+    console.log(chalk.blue('Get a free API key from: https://www.eia.gov/opendata/register.php'));
+
+    const answer = await question('Enter your EIA API key (or press Enter to skip): ');
+
+    if (answer.trim()) {
+      // Update .env file
+      let envContent = readFileSync(envPath, 'utf-8');
+      envContent = envContent.replace(/EIA_API_KEY=.*/g, `EIA_API_KEY=${answer.trim()}`);
+      writeFileSync(envPath, envContent);
+
+      // Update process.env
+      process.env.EIA_API_KEY = answer.trim();
+
+      console.log(chalk.green('✓ API key saved to .env'));
+    } else {
+      console.log(chalk.yellow('⚠️  Running without EIA API key (will use fallback data sources)'));
+    }
+  }
+}
+
+/**
+ * Main CLI function
+ */
+async function main(options) {
+  console.log(chalk.cyan.bold('\n🔋 DeCharge Scout - Energy Grid Data Scout\n'));
+
+  try {
+    // Auto-configure environment
+    await ensureEnvironment();
+
+    // Auto-handle wallet
+    const walletPath = options.wallet || DEFAULT_WALLET_PATH;
+    const confirmedWalletPath = await ensureWallet(walletPath);
+
+    // Load wallet
+    const spinner = ora('Loading wallet...').start();
+    const wallet = await loadWallet(confirmedWalletPath);
+    spinner.succeed(chalk.green(`Wallet loaded: ${wallet.publicKey.toBase58()}`));
+
+    // Set agent name
+    const agentName = options.agentName || generateAgentName();
+    console.log(chalk.blue(`🤖 Agent Name: ${agentName}`));
+
+    // Get location
+    const locationSpinner = ora('Detecting location...').start();
+    let location = options.location;
+    if (!location) {
+      location = await getLocation();
+    }
+    locationSpinner.succeed(chalk.green(`📍 Location: ${location}`));
+
+    // Initialize points system
+    initializePoints(wallet.publicKey.toBase58());
+    const currentPoints = getPoints(wallet.publicKey.toBase58());
+    console.log(chalk.magenta(`⭐ Current Points: ${currentPoints}`));
+
+    // Stake SOL
+    console.log(chalk.yellow(`\n💰 Staking ${STAKE_AMOUNT} SOL for anti-spam/gas...`));
+    const stakeSpinner = ora('Submitting stake transaction...').start();
+    stakeTransactionSignature = await stakeSOL(wallet, STAKE_AMOUNT);
+    stakeSpinner.succeed(chalk.green(`Stake successful! TX: ${stakeTransactionSignature}`));
+
+    console.log(chalk.cyan('\n🔄 Starting query cycle (runs every 15 minutes)...'));
+    console.log(chalk.gray('Press Ctrl+C to stop and refund stake\n'));
+
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+      console.log(chalk.yellow('\n\n⏹️  Stopping scout...'));
+      isRunning = false;
+
+      if (totalRuns > 0) {
+        console.log(chalk.blue('💸 Refunding stake...'));
+        try {
+          const refundTx = await refundStake(wallet, STAKE_AMOUNT);
+          console.log(chalk.green(`Refund successful! TX: ${refundTx}`));
+        } catch (error) {
+          console.error(chalk.red(`Refund failed: ${error.message}`));
+        }
+      }
+
+      const finalPoints = getPoints(wallet.publicKey.toBase58());
+      console.log(chalk.magenta(`\n⭐ Final Points: ${finalPoints}`));
+      console.log(chalk.cyan(`📊 Total Runs: ${totalRuns}\n`));
+
+      rl.close();
+      process.exit(0);
+    });
+
+    // Main query cycle
+    await runQueryCycle(wallet, agentName, location, options);
+
+  } catch (error) {
+    console.error(chalk.red(`\n❌ Error: ${error.message}`));
+    console.error(chalk.gray(error.stack));
+    rl.close();
+    process.exit(1);
+  }
+}
+
+/**
+ * Run the main query cycle
+ */
+async function runQueryCycle(wallet, agentName, location, options) {
+  while (isRunning) {
+    try {
+      totalRuns++;
+      console.log(chalk.cyan(`\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`));
+      console.log(chalk.cyan.bold(`🔍 Run #${totalRuns} - ${new Date().toLocaleString()}`));
+      console.log(chalk.cyan(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`));
+
+      // Fetch energy data
+      const dataSpinner = ora('Fetching energy grid data...').start();
+      let energyData;
+
+      try {
+        energyData = await fetchEnergyData();
+        dataSpinner.succeed(chalk.green(`Fetched ${energyData.length} data points from EIA (ERCOT)`));
+      } catch (error) {
+        dataSpinner.warn(chalk.yellow(`EIA API failed, trying Electricity Maps...`));
+
+        try {
+          energyData = await fetchElectricityMapsData();
+          dataSpinner.succeed(chalk.green(`Fetched forecast data from Electricity Maps`));
+        } catch (fallbackError) {
+          dataSpinner.fail(chalk.red('All data sources failed'));
+          throw new Error('Unable to fetch energy data from any source');
+        }
+      }
+
+      // Run optimization
+      const optSpinner = ora('Running optimization...').start();
+      const cheapestWindow = findCheapestWindow(energyData);
+      const savings = calculateSavings(energyData, cheapestWindow);
+      optSpinner.succeed(chalk.green('Optimization complete'));
+
+      // Display results
+      console.log(chalk.green.bold('\n✨ Optimization Results:'));
+      console.log(chalk.white(`   Cheapest charge window: ${cheapestWindow.timeWindow}`));
+      console.log(chalk.white(`   Price: $${cheapestWindow.price.toFixed(4)}/kWh`));
+      console.log(chalk.white(`   Savings: ${savings.toFixed(1)}%`));
+
+      // Prepare submission data
+      const submissionData = {
+        agent_name: agentName,
+        location: location,
+        timestamp: Date.now(),
+        results: {
+          cheapest_window: cheapestWindow.timeWindow,
+          price: cheapestWindow.price,
+          savings: savings,
+          data_points: energyData.length
+        }
+      };
+
+      // Submit to oracle
+      const submitSpinner = ora('Submitting to DeCharge oracle...').start();
+      const txSignature = await submitToOracle(wallet, submissionData);
+      submitSpinner.succeed(chalk.green(`Submitted to oracle! TX: ${txSignature}`));
+
+      // Log dashboard data structure
+      console.log(chalk.blue('\n📊 Dashboard Data Structure:'));
+      console.log(chalk.gray(JSON.stringify(submissionData, null, 2)));
+
+      // Optional: Submit to mock dashboard API
+      if (process.env.DASHBOARD_API_URL) {
+        try {
+          const dashboardSpinner = ora('Submitting to dashboard API...').start();
+          const response = await fetch(process.env.DASHBOARD_API_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(submissionData)
+          });
+
+          if (response.ok) {
+            dashboardSpinner.succeed(chalk.green('Dashboard submission successful'));
+          } else {
+            dashboardSpinner.warn(chalk.yellow(`Dashboard API returned: ${response.status}`));
+          }
+        } catch (error) {
+          // Silent fail for dashboard - it's optional
+          console.log(chalk.gray(`ℹ️  Dashboard API not available (${error.message})`));
+        }
+      }
+
+      // Award points
+      const basePoints = Math.floor(Math.random() * 5) + 1; // 1-5 points
+      const bonusPoints = savings > 15 ? 2 : 0; // Bonus for good savings
+      const totalPointsEarned = basePoints + bonusPoints;
+
+      awardPoints(wallet.publicKey.toBase58(), totalPointsEarned);
+      const currentPoints = getPoints(wallet.publicKey.toBase58());
+
+      console.log(chalk.magenta(`\n⭐ Earned ${totalPointsEarned} points! (${basePoints} base${bonusPoints > 0 ? ` + ${bonusPoints} bonus` : ''})`));
+      console.log(chalk.magenta(`⭐ Total Points: ${currentPoints}`));
+
+      // Premium upgrade option
+      if (options.premium && totalRuns % 3 === 0) {
+        console.log(chalk.yellow('\n🔒 Premium Feature Available!'));
+        try {
+          const premiumData = await purchasePremiumData(wallet);
+          console.log(chalk.green(`Premium forecast data: ${JSON.stringify(premiumData)}`));
+        } catch (error) {
+          console.log(chalk.red(`Premium purchase failed: ${error.message}`));
+        }
+      }
+
+      // Save points
+      savePoints();
+
+      // Wait for next cycle
+      if (isRunning) {
+        const waitMinutes = CYCLE_INTERVAL_MS / 60000;
+        console.log(chalk.gray(`\n⏳ Next run in ${waitMinutes} minutes...\n`));
+        await sleep(CYCLE_INTERVAL_MS);
+      }
+
+    } catch (error) {
+      console.error(chalk.red(`\n❌ Cycle error: ${error.message}`));
+      console.log(chalk.yellow('Retrying in 5 minutes...'));
+
+      if (isRunning) {
+        await sleep(5 * 60 * 1000);
+      }
+    }
+  }
+}
+
+/**
+ * Sleep utility
+ */
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+// CLI Setup
+const program = new Command();
+
+program
+  .name('decharge-scout')
+  .description('AI-powered energy grid data scout with Solana integration')
+  .version('1.0.0')
+  .option('-w, --wallet <path>', 'Path to Solana wallet JSON keypair file (default: ./wallet.json)')
+  .option('-a, --agent-name <name>', 'Custom agent name (default: auto-generated)')
+  .option('-l, --location <location>', 'Manual location override (default: auto-detect via IP)')
+  .option('-p, --premium', 'Enable premium features (x402 micropayments)')
+  .action(main);
+
+program.parse();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "decharge-scout",
+  "version": "1.0.0",
+  "description": "AI-powered energy grid data scout with Solana integration",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "decharge-scout": "./index.js"
+  },
+  "scripts": {
+    "setup": "node setup.js",
+    "start": "node index.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "solana",
+    "energy",
+    "cli",
+    "decharge",
+    "blockchain",
+    "ev-charging",
+    "energy-optimization",
+    "ercot",
+    "web3"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sentinelcore/agentone.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sentinelcore/agentone/issues"
+  },
+  "homepage": "https://github.com/sentinelcore/agentone#readme",
+  "dependencies": {
+    "@solana/web3.js": "^1.95.8",
+    "@solana/spl-token": "^0.4.9",
+    "commander": "^12.1.0",
+    "node-fetch": "^3.3.2",
+    "chalk": "^5.3.0",
+    "ora": "^8.1.1",
+    "dotenv": "^16.4.5"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}