openclaw-overlay-plugin 0.7.51 → 0.7.53

package/dist/index.js

@@ -7,17 +7,6 @@ import fs from 'node:fs';
 import { initializeServiceSystem, serviceManager } from './src/services/index.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-/**
- * Helper to correctly locate the CLI script.
- * If running from dist/index.js, CLI is in ./src/cli.js
- * If running from index.ts, CLI is in ./dist/src/cli.js
- */
-function getCliPath() {
-    const localCli = path.join(__dirname, 'src', 'cli.js');
-    if (fs.existsSync(localCli))
-        return localCli;
-    return path.join(__dirname, 'dist', 'src', 'cli.js');
-}
 const execFileAsync = promisify(execFile);
 // Track background process for proper lifecycle management
 let backgroundProcess = null;
@@ -173,7 +162,7 @@ async function autoAdvertiseServices(env, cliPath, logger) {
                 continue;
             try {
                 const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-                const pluginConfig = config?.plugins?.entries?.['openclaw-overlay']?.config;
+                const pluginConfig = config?.plugins?.entries?.['openclaw-overlay-plugin']?.config || config?.plugins?.entries?.['openclaw-overlay-plugin'];
                 if (pluginConfig?.services && Array.isArray(pluginConfig.services)) {
                     servicesToAdvertise = pluginConfig.services;
                     break;
@@ -419,18 +408,16 @@ export async function activate(api) {
     return register(api);
 }
 let isInitialized = false;
+function getCliPath() {
+    return path.join(__dirname, 'dist', 'src', 'cli.js');
+}
 export default function register(api) {
     if (isInitialized)
         return;
     isInitialized = true;
     // Capture config at registration time
-    // Check all possible IDs for backward compatibility and various installation methods
     const entries = api.getConfig?.()?.plugins?.entries || {};
-    const entry = entries['openclaw-overlay']
-        || entries['openclaw-overlay-plugin']
-        || entries['bsv-overlay']
-        || {};
-    // Merge: gateway-level api.config > nested entry.config > flat entry properties
+    const entry = entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || entries['bsv-overlay-skill'] || {};
     const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
     // Register the overlay agent tool
     api.registerTool({
@@ -563,6 +550,44 @@ export default function register(api) {
             }
         }
     });
+    // Register the /overlay slash command for direct chat interaction (Autoreply)
+    api.registerCommand({
+        name: "overlay",
+        description: "BSV Overlay Marketplace commands",
+        acceptsArgs: true,
+        requireAuth: true,
+        handler: async (ctx) => {
+            try {
+                const args = ctx.args || [];
+                const action = args[0] || 'status';
+                // Map slash command args to tool params
+                const params = { action };
+                if (action === 'request' && args[1])
+                    params.service = args[1];
+                if (action === 'discover' && args[1])
+                    params.service = args[1];
+                if (action === 'pay' && args[1])
+                    params.identityKey = args[1];
+                if (action === 'pay' && args[2])
+                    params.sats = parseInt(args[2], 10);
+                const result = await executeOverlayAction(params, pluginConfig, api);
+                let text = `**Overlay: ${action.toUpperCase()}**\n\n`;
+                if (typeof result === 'string') {
+                    text += result;
+                }
+                else if (result.message) {
+                    text += result.message;
+                }
+                else {
+                    text += JSON.stringify(result, null, 2);
+                }
+                return { text };
+            }
+            catch (error) {
+                return { text: `❌ Overlay Error: ${error.message}` };
+            }
+        }
+    });
     // Register background relay service
     api.registerService({
         id: "openclaw-overlay-relay",
@@ -571,13 +596,11 @@ export default function register(api) {
                 api.logger.info("Starting BSV overlay WebSocket relay...");
                 const env = buildEnvironment(pluginConfig);
                 const cliPath = getCliPath();
-                // Initialize the service system if available
                 try {
                     await initializeServiceSystem();
                 }
                 catch { }
                 startBackgroundService(env, cliPath, api.logger);
-                // Start auto-import
                 startAutoImport(env, cliPath, api.logger);
                 // Auto-check for registration on startup
                 (async () => {
@@ -587,11 +610,9 @@ export default function register(api) {
                         if (!fs.existsSync(regPath) && !fs.existsSync(onboardSentFile)) {
                             const walletPath = path.join(pluginConfig.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet'), 'wallet-identity.json');
                             if (fs.existsSync(walletPath)) {
-                                // Wallet exists but not registered.
                                 const balResult = await execFileAsync('node', [cliPath, 'balance'], { env });
                                 const balance = parseCliOutput(balResult.stdout);
                                 if ((balance.data?.walletBalance || 0) >= 1000) {
-                                    // Funded but not registered. Auto-register.
                                     const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
                                     if (parseCliOutput(regResult.stdout).success) {
                                         api.logger.info('[openclaw-overlay] Agent auto-registered on startup');
@@ -734,7 +755,7 @@ export default function register(api) {
                 console.error("Error:", error.message);
             }
         });
-    });
+    }, { commands: ["overlay"] });
 }
 async function executeOverlayAction(params, config, api) {
     const { action } = params;
@@ -801,7 +822,6 @@ async function handleServiceRequest(params, env, cliPath, config, api) {
     if (!discoverOutput.success) {
         throw new Error(`Discovery failed: ${discoverOutput.error}`);
     }
-    // FIX: Use discoverOutput.data.services instead of treating data as flat array
     const providers = discoverOutput.data.services;
     if (!providers || providers.length === 0) {
         throw new Error(`No providers found for service: ${service}`);
@@ -822,7 +842,7 @@ async function handleServiceRequest(params, env, cliPath, config, api) {
         }
         externalProviders = targeted;
     }
-    // 3. Sort by price - FIX: Use pricing.amountSats instead of pricingSats
+    // 3. Sort by price
     externalProviders.sort((a, b) => (a.pricing?.amountSats || 0) - (b.pricing?.amountSats || 0));
     const bestProvider = externalProviders[0];
     const price = bestProvider.pricing?.amountSats || 0;
@@ -849,10 +869,6 @@ async function handleServiceRequest(params, env, cliPath, config, api) {
     if (!requestOutput.success) {
         throw new Error(`Service request failed: ${requestOutput.error}`);
     }
-    // 7. Return immediately — no polling.
-    // The WebSocket background service handles incoming responses
-    // asynchronously and wakes the agent via /hooks/agent when a
-    // response arrives. This avoids blocking for up to 120s.
     recordSpend(walletDir, price, service, bestProvider.name);
     writeActivityEvent({ type: 'outgoing_payment', emoji: '💸', sats: price, service, provider: bestProvider.name, message: `Paid ${price} sats to ${bestProvider.name} for ${service}` });
     return {
@@ -1149,7 +1165,7 @@ async function handleImport(params, env, cliPath) {
     // Check if we should auto-register after successful import
     const regPath = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
     const isRegistered = fs.existsSync(regPath);
-    if (!isRegistered && output.data?.balance >= 1000) {
+    if (!isRegistered && (output.data?.balance || 0) >= 1000) {
         // Auto-register immediately after funding
         try {
             const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
@@ -1281,13 +1297,11 @@ async function handleRefund(params, env, cliPath) {
 async function handleOnboard(params, env, cliPath) {
     const { agentName, agentDescription } = params;
     const steps = [];
-    // Apply agent name/description to env if provided
     const onboardEnv = { ...env };
     if (agentName)
         onboardEnv.AGENT_NAME = agentName;
     if (agentDescription)
         onboardEnv.AGENT_DESCRIPTION = agentDescription;
-    // Step 1: Setup wallet
     try {
         const setup = await execFileAsync('node', [cliPath, 'setup'], { env: onboardEnv });
         const setupOutput = parseCliOutput(setup.stdout);
@@ -1297,7 +1311,6 @@ async function handleOnboard(params, env, cliPath) {
         steps.push({ step: 'setup', success: false, error: err.message });
         return { steps, nextStep: 'Fix wallet setup error and try again' };
     }
-    // Step 2: Get address
     try {
         const addr = await execFileAsync('node', [cliPath, 'address'], { env: onboardEnv });
         const addrOutput = parseCliOutput(addr.stdout);
@@ -1306,7 +1319,6 @@ async function handleOnboard(params, env, cliPath) {
     catch (err) {
         steps.push({ step: 'address', success: false, error: err.message });
     }
-    // Step 3: Check balance
     try {
         const bal = await execFileAsync('node', [cliPath, 'balance'], { env: onboardEnv });
         const balOutput = parseCliOutput(bal.stdout);
@@ -1323,7 +1335,6 @@ async function handleOnboard(params, env, cliPath) {
     catch (err) {
         steps.push({ step: 'balance', success: false, error: err.message });
     }
-    // Step 4: Register
     try {
         const reg = await execFileAsync('node', [cliPath, 'register'], { env: onboardEnv, timeout: 60000 });
         const regOutput = parseCliOutput(reg.stdout);
@@ -1350,7 +1361,6 @@ async function handleOnboard(params, env, cliPath) {
     };
 }
 async function handlePendingRequests(env, cliPath) {
-    // Clean up old queue entries before checking pending requests
     try {
         const { cleanupServiceQueue } = await import('./src/scripts/utils/storage.js');
         cleanupServiceQueue();
@@ -1362,7 +1372,6 @@ async function handlePendingRequests(env, cliPath) {
     const output = parseCliOutput(result.stdout);
     if (!output.success)
         throw new Error(`Queue check failed: ${output.error}`);
-    // Clear the alert file since we're checking now
     const alertPath = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'pending-alert.jsonl');
     try {
         if (fs.existsSync(alertPath))
@@ -1382,7 +1391,6 @@ function handleActivity() {
     catch {
         return null;
     } }).filter(Boolean);
-    // Clear the feed after reading
     fs.writeFileSync(feedPath, '');
     return { events, count: events.length };
 }
@@ -1397,7 +1405,6 @@ async function handleFulfill(params, env, cliPath) {
     const output = parseCliOutput(cliResult.stdout);
     if (!output.success)
         throw new Error(`Fulfill failed: ${output.error}`);
-    // Clean up the request ID from tracking since it's now fulfilled
     wokenRequests.delete(requestId);
     writeActivityEvent({ type: 'service_fulfilled', emoji: '✅', serviceId, recipientKey: recipientKey?.slice(0, 16), message: `Fulfilled ${serviceId} request — response sent` });
     return output.data;
@@ -1419,7 +1426,6 @@ function buildEnvironment(config) {
     if (config.arcUrl) {
         env.BSV_ARC_URL = config.arcUrl;
     }
-    // Set defaults
     env.BSV_NETWORK = env.BSV_NETWORK || 'mainnet';
     if (!env.BSV_ARC_URL) {
         env.BSV_ARC_URL = env.BSV_NETWORK === 'testnet'
@@ -1438,7 +1444,7 @@ function buildEnvironment(config) {
     else if (!env.AGENT_DESCRIPTION) {
         env.AGENT_DESCRIPTION = 'AI agent on the OpenClaw Overlay Network. Offers services for BSV micropayments.';
     }
-    env.AGENT_ROUTED = 'true'; // Route service requests through the agent
+    env.AGENT_ROUTED = 'true';
     return env;
 }
 function parseCliOutput(stdout) {
@@ -1450,4 +1456,3 @@ function parseCliOutput(stdout) {
         throw new Error(`Failed to parse CLI output: ${error.message}`);
     }
 }
-// sleep() removed — no longer needed since polling loop was removed

package/index.ts

@@ -8,17 +8,6 @@ import { initializeServiceSystem, serviceManager } from './src/services/index.js
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-/**
- * Helper to correctly locate the CLI script.
- * If running from dist/index.js, CLI is in ./src/cli.js
- * If running from index.ts, CLI is in ./dist/src/cli.js
- */
-function getCliPath(): string {
-  const localCli = path.join(__dirname, 'src', 'cli.js');
-  if (fs.existsSync(localCli)) return localCli;
-  return path.join(__dirname, 'dist', 'src', 'cli.js');
-}
-
 const execFileAsync = promisify(execFile);
 
 // Track background process for proper lifecycle management
@@ -190,7 +179,7 @@ async function autoAdvertiseServices(env: any, cliPath: string, logger: any) {
       if (!fs.existsSync(configPath)) continue;
       try {
         const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-        const pluginConfig = config?.plugins?.entries?.['openclaw-overlay']?.config;
+        const pluginConfig = config?.plugins?.entries?.['openclaw-overlay-plugin']?.config || config?.plugins?.entries?.['openclaw-overlay-plugin'];
         if (pluginConfig?.services && Array.isArray(pluginConfig.services)) {
           servicesToAdvertise = pluginConfig.services;
           break;
@@ -464,19 +453,17 @@ export async function activate(api: any) {
 
 let isInitialized = false;
 
+function getCliPath() {
+  return path.join(__dirname, 'dist', 'src', 'cli.js');
+}
+
 export default function register(api: any) {
   if (isInitialized) return;
   isInitialized = true;
 
   // Capture config at registration time
-  // Check all possible IDs for backward compatibility and various installation methods
   const entries = api.getConfig?.()?.plugins?.entries || {};
-  const entry = entries['openclaw-overlay'] 
-    || entries['openclaw-overlay-plugin'] 
-    || entries['bsv-overlay'] 
-    || {};
-    
-  // Merge: gateway-level api.config > nested entry.config > flat entry properties
+  const entry = entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || entries['bsv-overlay-skill'] || {};
   const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
 
   // Register the overlay agent tool
@@ -610,6 +597,43 @@ export default function register(api: any) {
     }
   });
 
+  // Register the /overlay slash command for direct chat interaction (Autoreply)
+  api.registerCommand({
+    name: "overlay",
+    description: "BSV Overlay Marketplace commands",
+    acceptsArgs: true,
+    requireAuth: true,
+    handler: async (ctx: any) => {
+      try {
+        const args = ctx.args || [];
+        const action = args[0] || 'status';
+        
+        // Map slash command args to tool params
+        const params: any = { action };
+        
+        if (action === 'request' && args[1]) params.service = args[1];
+        if (action === 'discover' && args[1]) params.service = args[1];
+        if (action === 'pay' && args[1]) params.identityKey = args[1];
+        if (action === 'pay' && args[2]) params.sats = parseInt(args[2], 10);
+
+        const result = await executeOverlayAction(params, pluginConfig, api);
+        
+        let text = `**Overlay: ${action.toUpperCase()}**\n\n`;
+        if (typeof result === 'string') {
+          text += result;
+        } else if (result.message) {
+          text += result.message;
+        } else {
+          text += JSON.stringify(result, null, 2);
+        }
+        
+        return { text };
+      } catch (error: any) {
+        return { text: `❌ Overlay Error: ${error.message}` };
+      }
+    }
+  });
+
   // Register background relay service
   api.registerService({
     id: "openclaw-overlay-relay",
@@ -619,14 +643,11 @@ export default function register(api: any) {
         const env = buildEnvironment(pluginConfig);
         const cliPath = getCliPath();
         
-        // Initialize the service system if available
         try {
           await initializeServiceSystem();
         } catch {}
 
         startBackgroundService(env, cliPath, api.logger);
-        
-        // Start auto-import
         startAutoImport(env, cliPath, api.logger);
 
         // Auto-check for registration on startup
@@ -639,12 +660,10 @@ export default function register(api: any) {
               const walletPath = path.join(pluginConfig.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet'), 'wallet-identity.json');
               
               if (fs.existsSync(walletPath)) {
-                // Wallet exists but not registered.
                 const balResult = await execFileAsync('node', [cliPath, 'balance'], { env });
                 const balance = parseCliOutput(balResult.stdout);
                 
                 if ((balance.data?.walletBalance || 0) >= 1000) {
-                  // Funded but not registered. Auto-register.
                   const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
                   if (parseCliOutput(regResult.stdout).success) {
                     api.logger.info('[openclaw-overlay] Agent auto-registered on startup');
@@ -789,7 +808,7 @@ export default function register(api: any) {
           console.error("Error:", error.message);
         }
       });
-  });
+  }, { commands: ["overlay"] });
 }
 
 async function executeOverlayAction(params: any, config: any, api: any) {
@@ -885,7 +904,6 @@ async function handleServiceRequest(params: any, env: any, cliPath: string, conf
     throw new Error(`Discovery failed: ${discoverOutput.error}`);
   }
 
-  // FIX: Use discoverOutput.data.services instead of treating data as flat array
   const providers = discoverOutput.data.services;
   if (!providers || providers.length === 0) {
     throw new Error(`No providers found for service: ${service}`);
@@ -910,7 +928,7 @@ async function handleServiceRequest(params: any, env: any, cliPath: string, conf
     externalProviders = targeted;
   }
 
-  // 3. Sort by price - FIX: Use pricing.amountSats instead of pricingSats
+  // 3. Sort by price
   externalProviders.sort((a: any, b: any) => (a.pricing?.amountSats || 0) - (b.pricing?.amountSats || 0));
   
   const bestProvider = externalProviders[0];
@@ -946,10 +964,6 @@ async function handleServiceRequest(params: any, env: any, cliPath: string, conf
     throw new Error(`Service request failed: ${requestOutput.error}`);
   }
 
-  // 7. Return immediately — no polling.
-  // The WebSocket background service handles incoming responses
-  // asynchronously and wakes the agent via /hooks/agent when a
-  // response arrives. This avoids blocking for up to 120s.
   recordSpend(walletDir, price, service, bestProvider.name);
   writeActivityEvent({ type: 'outgoing_payment', emoji: '💸', sats: price, service, provider: bestProvider.name, message: `Paid ${price} sats to ${bestProvider.name} for ${service}` });
   
@@ -1294,7 +1308,7 @@ async function handleImport(params: any, env: any, cliPath: string) {
   const regPath = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
   const isRegistered = fs.existsSync(regPath);
   
-  if (!isRegistered && output.data?.balance >= 1000) {
+  if (!isRegistered && (output.data?.balance || 0) >= 1000) {
     // Auto-register immediately after funding
     try {
       const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
@@ -1464,12 +1478,10 @@ async function handleOnboard(params: any, env: any, cliPath: string) {
   const { agentName, agentDescription } = params;
   const steps = [];
 
-  // Apply agent name/description to env if provided
   const onboardEnv = { ...env };
   if (agentName) onboardEnv.AGENT_NAME = agentName;
   if (agentDescription) onboardEnv.AGENT_DESCRIPTION = agentDescription;
 
-  // Step 1: Setup wallet
   try {
     const setup = await execFileAsync('node', [cliPath, 'setup'], { env: onboardEnv });
     const setupOutput = parseCliOutput(setup.stdout);
@@ -1479,7 +1491,6 @@ async function handleOnboard(params: any, env: any, cliPath: string) {
     return { steps, nextStep: 'Fix wallet setup error and try again' };
   }
 
-  // Step 2: Get address
   try {
     const addr = await execFileAsync('node', [cliPath, 'address'], { env: onboardEnv });
     const addrOutput = parseCliOutput(addr.stdout);
@@ -1488,7 +1499,6 @@ async function handleOnboard(params: any, env: any, cliPath: string) {
     steps.push({ step: 'address', success: false, error: err.message });
   }
 
-  // Step 3: Check balance
   try {
     const bal = await execFileAsync('node', [cliPath, 'balance'], { env: onboardEnv });
     const balOutput = parseCliOutput(bal.stdout);
@@ -1506,7 +1516,6 @@ async function handleOnboard(params: any, env: any, cliPath: string) {
     steps.push({ step: 'balance', success: false, error: err.message });
   }
 
-  // Step 4: Register
   try {
     const reg = await execFileAsync('node', [cliPath, 'register'], { env: onboardEnv, timeout: 60000 });
     const regOutput = parseCliOutput(reg.stdout);
@@ -1534,7 +1543,6 @@ async function handleOnboard(params: any, env: any, cliPath: string) {
 }
 
 async function handlePendingRequests(env: any, cliPath: string) {
-  // Clean up old queue entries before checking pending requests
   try {
     const { cleanupServiceQueue } = await import('./src/scripts/utils/storage.js');
     cleanupServiceQueue();
@@ -1546,7 +1554,6 @@ async function handlePendingRequests(env: any, cliPath: string) {
   const output = parseCliOutput(result.stdout);
   if (!output.success) throw new Error(`Queue check failed: ${output.error}`);
 
-  // Clear the alert file since we're checking now
   const alertPath = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'pending-alert.jsonl');
   try { if (fs.existsSync(alertPath)) fs.unlinkSync(alertPath); } catch {}
 
@@ -1560,7 +1567,6 @@ function handleActivity() {
   const lines = fs.readFileSync(feedPath, 'utf-8')?.trim().split('\n').filter(Boolean);
   const events = lines.map(l => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
   
-  // Clear the feed after reading
   fs.writeFileSync(feedPath, '');
   
   return { events, count: events.length };
@@ -1578,7 +1584,6 @@ async function handleFulfill(params: any, env: any, cliPath: string) {
   const output = parseCliOutput(cliResult.stdout);
   if (!output.success) throw new Error(`Fulfill failed: ${output.error}`);
 
-  // Clean up the request ID from tracking since it's now fulfilled
   wokenRequests.delete(requestId);
 
   writeActivityEvent({ type: 'service_fulfilled', emoji: '✅', serviceId, recipientKey: recipientKey?.slice(0, 16), message: `Fulfilled ${serviceId} request — response sent` });
@@ -1604,7 +1609,6 @@ function buildEnvironment(config: any) {
     env.BSV_ARC_URL = config.arcUrl;
   }
 
-  // Set defaults
   env.BSV_NETWORK = env.BSV_NETWORK || 'mainnet';
   
   if (!env.BSV_ARC_URL) {
@@ -1622,7 +1626,7 @@ function buildEnvironment(config: any) {
   } else if (!env.AGENT_DESCRIPTION) {
     env.AGENT_DESCRIPTION = 'AI agent on the OpenClaw Overlay Network. Offers services for BSV micropayments.';
   }
-  env.AGENT_ROUTED = 'true'; // Route service requests through the agent
+  env.AGENT_ROUTED = 'true';
 
   return env;
 }
@@ -1635,5 +1639,3 @@ function parseCliOutput(stdout: any) {
     throw new Error(`Failed to parse CLI output: ${error.message}`);
   }
 }
-
-// sleep() removed — no longer needed since polling loop was removed

package/openclaw.plugin.json

@@ -6,9 +6,16 @@
   "skills": [
     "./SKILL.md"
   ],
+  "commands": [
+    {
+      "name": "overlay",
+      "description": "BSV Overlay Network management",
+      "isAutoreply": true
+    }
+  ],
   "configSchema": {
     "type": "object",
-    "additionalProperties": false,
+    "additionalProperties": true,
     "properties": {
       "overlayUrl": {
         "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-overlay-plugin",
-  "version": "0.7.51",
+  "version": "0.7.53",
   "description": "Openclaw BSV Overlay — agent discovery, service marketplace, and micropayments on the BSV blockchain",
   "publishConfig": {
     "access": "public"
@@ -12,7 +12,6 @@
     "src/",
     "dist/",
     "SKILL.md",
-    "HOOK.md",
     "README.md"
   ],
   "bin": {

package/HOOK.md

@@ -1,9 +0,0 @@
----
-name: openclaw-overlay-hooks
-description: Background automation for the OpenClaw Overlay Network.
-metadata: '{"openclaw": {"events": ["gateway:start"]}}'
----
-
-# Overlay Hooks
-This file ensures compatibility with the OpenClaw hook pack installer.
-Background tasks are handled programmatically in index.ts.

package/src/core/wallet.js

@@ -1,225 +0,0 @@
-/**
- * @a2a-bsv/core — BSVAgentWallet
- *
- * High-level wallet class for AI agent-to-agent BSV payments.
- * Wraps @bsv/wallet-toolbox's Wallet + StorageKnex with a clean,
- * minimal API surface designed for automated agent use.
- */
-import { PrivateKey, CachedKeyDeriver } from '@bsv/sdk';
-import { Wallet, WalletStorageManager, Services, Monitor, StorageKnex, randomBytesHex, ChaintracksServiceClient, } from '@bsv/wallet-toolbox';
-import knexLib from 'knex';
-import * as path from 'node:path';
-import * as fs from 'node:fs';
-import { toChain, DEFAULT_TAAL_API_KEYS, DEFAULT_DB_NAME } from './config.js';
-import { buildPayment } from './payment.js';
-import { verifyPayment, acceptPayment } from './verify.js';
-/** Filename for the persisted wallet identity JSON. */
-const IDENTITY_FILE = 'wallet-identity.json';
-/**
- * BSVAgentWallet — the primary class for agent-to-agent BSV payments.
- *
- * Usage:
- * ```ts
- * // Create a new wallet (generates keys)
- * const wallet = await BSVAgentWallet.load({ network: 'testnet', storageDir: './agent-wallet' });
- *
- * // Load an existing wallet
- * const wallet = await BSVAgentWallet.load({ network: 'testnet', storageDir: './agent-wallet' });
- *
- * // Make a payment
- * const payment = await wallet.createPayment({ to: recipientPubKey, satoshis: 500 });
- *
- * // Verify and accept a payment
- * const verification = wallet.verifyPayment({ beef: payment.beef });
- * if (verification.valid) {
- *   await wallet.acceptPayment({ beef: payment.beef, ...derivationInfo });
- * }
- * ```
- */
-export class BSVAgentWallet {
-    /** @internal — exposed for advanced operations (e.g. direct internalizeAction) */
-    _setup;
-    constructor(setup) {
-        this._setup = setup;
-    }
-    // ---------------------------------------------------------------------------
-    // Factory methods
-    // ---------------------------------------------------------------------------
-    /**
-     * Create a new agent wallet. Generates a fresh root key and persists it.
-     * The SQLite database and identity file are written to `config.storageDir`.
-     */
-    static async create(config) {
-        // Generate a new root key (or use one provided in config)
-        const rootKeyHex = config.rootKeyHex ?? PrivateKey.fromRandom().toHex();
-        const rootKey = PrivateKey.fromHex(rootKeyHex);
-        const identityKey = rootKey.toPublicKey().toString();
-        // Ensure the storage directory exists
-        fs.mkdirSync(config.storageDir, { recursive: true });
-        // Persist identity for later loading
-        const identity = {
-            rootKeyHex,
-            identityKey,
-            network: config.network,
-        };
-        const identityPath = path.join(config.storageDir, IDENTITY_FILE);
-        fs.writeFileSync(identityPath, JSON.stringify(identity, null, 2), 'utf-8');
-        // Build the wallet
-        const setup = await BSVAgentWallet.buildSetup(config, rootKeyHex);
-        return new BSVAgentWallet(setup);
-    }
-    /**
-     * Load an existing agent wallet from its storage directory.
-     * Reads the persisted identity file and re-initializes the wallet.
-     */
-    static async load(config) {
-        const identityPath = path.join(config.storageDir, IDENTITY_FILE);
-        if (!fs.existsSync(identityPath)) {
-            return this.create(config);
-        }
-        const identity = JSON.parse(fs.readFileSync(identityPath, 'utf-8'));
-        const rootKeyHex = config.rootKeyHex ?? identity.rootKeyHex;
-        const setup = await BSVAgentWallet.buildSetup(config, rootKeyHex);
-        return new BSVAgentWallet(setup);
-    }
-    // ---------------------------------------------------------------------------
-    // Wallet lifecycle
-    // ---------------------------------------------------------------------------
-    /**
-     * Get this wallet's public identity key (compressed hex, 33 bytes).
-     * This is the key other agents use to send payments to you.
-     */
-    async getIdentityKey() {
-        return this._setup.identityKey;
-    }
-    /**
-     * Get the wallet's current balance in satoshis.
-     *
-     * Uses the BRC-100 wallet's balance method which sums spendable outputs
-     * in the default basket.
-     */
-    async getBalance() {
-        return await this._setup.wallet.balance();
-    }
-    /**
-     * Cleanly shut down the wallet, releasing database connections and
-     * stopping the background monitor.
-     */
-    async destroy() {
-        await this._setup.wallet.destroy();
-    }
-    // ---------------------------------------------------------------------------
-    // Payment creation (sender/payer side)
-    // ---------------------------------------------------------------------------
-    /**
-     * Build a BRC-29 payment to another agent.
-     *
-     * The transaction is created with `noSend: true` — the sender does NOT
-     * broadcast it. Instead, the Atomic BEEF and derivation metadata are
-     * returned so they can be transmitted to the recipient, who will
-     * verify and internalize (broadcast) the payment.
-     *
-     * @param params.to — Recipient's compressed public key (hex).
-     * @param params.satoshis — Amount in satoshis.
-     * @param params.description — Optional human-readable note.
-     */
-    async createPayment(params) {
-        return buildPayment(this._setup, params);
-    }
-    // ---------------------------------------------------------------------------
-    // Payment verification & acceptance (receiver/merchant side)
-    // ---------------------------------------------------------------------------
-    /**
-     * Verify an incoming Atomic BEEF payment.
-     *
-     * This performs structural validation and SPV verification via tx.verify().
-     */
-    async verifyPayment(params) {
-        return await verifyPayment(params);
-    }
-    /**
-     * Accept (internalize) a verified payment into this wallet.
-     *
-     * Uses the BRC-29 wallet payment protocol to derive the correct key
-     * and claim the output. This triggers SPV verification and, if the
-     * transaction hasn't been broadcast yet, broadcasts it.
-     */
-    async acceptPayment(params) {
-        return acceptPayment(this._setup, params);
-    }
-    // ---------------------------------------------------------------------------
-    // Access to underlying toolbox objects (for advanced use)
-    // ---------------------------------------------------------------------------
-    /** Get the underlying wallet-toolbox SetupWallet for advanced operations. */
-    getSetup() {
-        return this._setup;
-    }
-    // ---------------------------------------------------------------------------
-    // Private helpers
-    // ---------------------------------------------------------------------------
-    /**
-     * Internal: manually construct a BRC-100 wallet backed by SQLite.
-     *
-     * We build this by hand instead of using Setup.createWalletSQLite because
-     * the toolbox has a bug where its internal randomBytesHex is a stub.
-     * We use the same components but wire them up correctly.
-     */
-    static async buildSetup(config, rootKeyHex) {
-        const chain = toChain(config.network);
-        const taalApiKey = config.taalApiKey ?? DEFAULT_TAAL_API_KEYS[chain];
-        const rootKey = PrivateKey.fromHex(rootKeyHex);
-        const identityKey = rootKey.toPublicKey().toString();
-        // 1. Key derivation
-        const keyDeriver = new CachedKeyDeriver(rootKey);
-        // 2. Storage manager (empty initially)
-        const storage = new WalletStorageManager(identityKey);
-        // 3. Network services (ARC broadcasting, chain tracking, etc.)
-        const serviceOptions = Services.createDefaultOptions(chain);
-        const chaintracksUrl = process.env.BSV_CHAINTRACKS_URL || 'https://chaintracks-us-1.bsvb.tech';
-        const arcUrl = process.env.BSV_ARC_URL;
-        serviceOptions.chaintracks = new ChaintracksServiceClient(chain, chaintracksUrl);
-        if (arcUrl) {
-            serviceOptions.arcUrl = arcUrl;
-        }
-        serviceOptions.taalApiKey = taalApiKey;
-        const services = new Services(serviceOptions);
-        // 4. Background monitor
-        const monopts = Monitor.createDefaultWalletMonitorOptions(chain, storage, services);
-        const monitor = new Monitor(monopts);
-        monitor.addDefaultTasks();
-        // 5. The BRC-100 Wallet
-        const wallet = new Wallet({ chain, keyDeriver, storage, services, monitor });
-        // 6. SQLite storage via knex
-        const filePath = path.join(config.storageDir, `${DEFAULT_DB_NAME}.sqlite`);
-        const knex = knexLib({
-            client: 'sqlite3',
-            connection: { filename: filePath },
-            useNullAsDefault: true,
-        });
-        // Fee model: configurable via BSV_FEE_MODEL env var (default: 100 sat/KB)
-        const feeModelValue = config.feeModel ??
-            (process.env.BSV_FEE_MODEL ? parseInt(process.env.BSV_FEE_MODEL, 10) : 100);
-        const activeStorage = new StorageKnex({
-            chain,
-            knex,
-            commissionSatoshis: 0,
-            commissionPubKeyHex: undefined,
-            feeModel: { model: 'sat/kb', value: feeModelValue },
-        });
-        await activeStorage.migrate(DEFAULT_DB_NAME, randomBytesHex(33));
-        await activeStorage.makeAvailable();
-        await storage.addWalletStorageProvider(activeStorage);
-        await activeStorage.findOrInsertUser(identityKey);
-        return {
-            rootKey,
-            identityKey,
-            keyDeriver,
-            chain,
-            storage,
-            services,
-            monitor,
-            wallet,
-        };
-    }
-}
-//# sourceMappingURL=wallet.js.map