openclaw-overlay-plugin 0.8.9 → 0.8.10

package/dist/index.js

@@ -12,6 +12,8 @@ import { cmdServiceQueue } from './src/scripts/services/queue.js';
 import { cmdRespondService } from './src/scripts/services/respond.js';
 import { cmdConnect } from './src/scripts/messaging/connect.js';
 import { setNoExit } from './src/scripts/output.js';
+import debug from 'debug';
+const log = debug('openclaw:plugin:overlay');
 // Track background service state
 let serviceRunning = false;
 let abortController = null;
@@ -300,6 +302,7 @@ export function register(api) {
 }
 async function executeOverlayAction(params, config, api) {
     const { action } = params;
+    log('Executing action: %s with params: %O', action, params);
     applyConfigToEnv(config);
     switch (action) {
         case "request": {

package/dist/src/core/wallet.js

@@ -10,6 +10,8 @@ import { Wallet, WalletStorageManager, Services, Monitor, StorageKnex, randomByt
 import knexLib from 'knex';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
+import debug from 'debug';
+const log = debug('openclaw:plugin:overlay:wallet');
 import { toChain, DEFAULT_TAAL_API_KEYS, DEFAULT_DB_NAME } from './config.js';
 import { buildPayment } from './payment.js';
 import { verifyPayment, acceptPayment } from './verify.js';
@@ -50,6 +52,7 @@ export class BSVAgentWallet {
      * The SQLite database and identity file are written to `config.storageDir`.
      */
     static async create(config) {
+        log('Creating new wallet in: %s', config.storageDir);
         // Generate a new root key (or use one provided in config)
         const rootKeyHex = config.rootKeyHex ?? PrivateKey.fromRandom().toHex();
         const rootKey = PrivateKey.fromHex(rootKeyHex);
@@ -73,9 +76,11 @@ export class BSVAgentWallet {
      * Reads the persisted identity file and re-initializes the wallet.
      */
     static async load(config) {
+        log('Loading wallet from: %s', config.storageDir);
         const identityPath = path.join(config.storageDir, IDENTITY_FILE);
         if (!fs.existsSync(identityPath)) {
             if (config.createIfMissing === false) {
+                log('Wallet not found and createIfMissing is false');
                 throw new Error(`No wallet found in ${config.storageDir}`);
             }
             return this.create(config);
@@ -182,6 +187,7 @@ export class BSVAgentWallet {
      */
     static async buildSetup(config, rootKeyHex) {
         const chain = toChain(config.network);
+        log('Building setup for chain: %s (network: %s)', chain, config.network);
         const taalApiKey = config.taalApiKey ?? DEFAULT_TAAL_API_KEYS[chain];
         const rootKey = PrivateKey.fromHex(rootKeyHex);
         const identityKey = rootKey.toPublicKey().toString();

package/dist/src/scripts/messaging/connect.js

@@ -7,6 +7,8 @@ import { fail } from '../output.js';
 import { loadIdentity } from '../wallet/identity.js';
 import { processMessage } from './handlers.js';
 import { ensureStateDir } from '../utils/storage.js';
+import debug from 'debug';
+const log = debug('openclaw:plugin:overlay:connect');
 /**
  * Connect command: establish WebSocket connection for real-time messaging.
  * Supports being used as a library with onMessage callback and AbortSignal.
@@ -22,6 +24,7 @@ export async function cmdConnect(onMessage, signal) {
     }
     const { identityKey, privKey } = await loadIdentity();
     const wsUrl = OVERLAY_URL.replace(/^http/, 'ws') + '/relay/subscribe?identity=' + identityKey;
+    log('Connecting to WebSocket relay: %s', wsUrl);
     let reconnectDelay = 1000;
     let shouldReconnect = true;
     let currentWs = null;
@@ -59,18 +62,22 @@ export async function cmdConnect(onMessage, signal) {
         const ws = new WebSocketClient(wsUrl);
         currentWs = ws;
         ws.on('open', () => {
+            log('WebSocket connection established!');
             reconnectDelay = 1000; // reset on successful connect
-            const log = { event: 'connected', identity: identityKey, overlay: OVERLAY_URL };
+            const logMsg = { event: 'connected', identity: identityKey, overlay: OVERLAY_URL };
             if (onMessage)
-                onMessage(log);
+                onMessage(logMsg);
             else
-                console.error(JSON.stringify(log));
+                console.error(JSON.stringify(logMsg));
         });
         ws.on('message', async (data) => {
+            log('Incoming WebSocket message received');
             try {
                 const envelope = JSON.parse(data.toString());
+                log('Message type: %s', envelope.type);
                 if (envelope.type === 'message') {
                     const result = await processMessage(envelope.message, identityKey, privKey);
+                    log('Processed message: %s', result.id);
                     if (onMessage)
                         onMessage(result);
                     else

package/index.ts

@@ -13,6 +13,9 @@ import { cmdServiceQueue } from './src/scripts/services/queue.js';
 import { cmdRespondService } from './src/scripts/services/respond.js';
 import { cmdConnect } from './src/scripts/messaging/connect.js';
 import { setNoExit } from './src/scripts/output.js';
+import debug from 'debug';
+
+const log = debug('openclaw:plugin:overlay');
 
 // Track background service state
 let serviceRunning = false;
@@ -306,6 +309,7 @@ export function register(api: any) {
 
 async function executeOverlayAction(params: any, config: any, api: any) {
   const { action } = params;
+  log('Executing action: %s with params: %O', action, params);
   applyConfigToEnv(config);
 
   switch (action) {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-overlay-plugin",
   "name": "BSV Overlay Network",
   "description": "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
-  "version": "0.8.9",
+  "version": "0.8.10",
   "skills": [
     "./SKILL.md"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-overlay-plugin",
-  "version": "0.8.9",
+  "version": "0.8.10",
   "description": "Openclaw BSV Overlay — agent discovery, service marketplace, and micropayments on the BSV blockchain",
   "publishConfig": {
     "access": "public"
@@ -31,10 +31,12 @@
     "@bsv/sdk": "^2.0.13",
     "@bsv/wallet-toolbox": "^2.1.18",
     "better-sqlite3": "^11.0.0",
+    "debug": "^4.4.0",
     "dotenv": "^17.3.1",
     "knex": "^3.1.0"
   },
   "devDependencies": {
+    "@types/debug": "^4.1.12",
     "@types/node": "^22.10.0",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.58.0",

package/src/ambient.d.ts

@@ -0,0 +1 @@
+declare module "debug";

package/src/core/wallet.ts

@@ -20,6 +20,9 @@ import type { SetupWallet } from '@bsv/wallet-toolbox';
 import knexLib from 'knex';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
+import debug from 'debug';
+
+const log = debug('openclaw:plugin:overlay:wallet');
 
 import type {
   WalletConfig,
@@ -76,6 +79,7 @@ export class BSVAgentWallet {
    * The SQLite database and identity file are written to `config.storageDir`.
    */
   private static async create(config: WalletConfig): Promise<BSVAgentWallet> {
+    log('Creating new wallet in: %s', config.storageDir);
     // Generate a new root key (or use one provided in config)
     const rootKeyHex = config.rootKeyHex ?? PrivateKey.fromRandom().toHex();
     const rootKey = PrivateKey.fromHex(rootKeyHex);
@@ -104,9 +108,11 @@ export class BSVAgentWallet {
    * Reads the persisted identity file and re-initializes the wallet.
    */
   static async load(config: WalletConfig & { createIfMissing?: boolean }): Promise<BSVAgentWallet> {
+    log('Loading wallet from: %s', config.storageDir);
     const identityPath = path.join(config.storageDir, IDENTITY_FILE);
     if (!fs.existsSync(identityPath)) {
       if (config.createIfMissing === false) {
+        log('Wallet not found and createIfMissing is false');
         throw new Error(`No wallet found in ${config.storageDir}`);
       }
       return this.create(config);
@@ -235,6 +241,7 @@ export class BSVAgentWallet {
     rootKeyHex: string,
   ): Promise<SetupWallet> {
     const chain = toChain(config.network);
+    log('Building setup for chain: %s (network: %s)', chain, config.network);
     const taalApiKey = config.taalApiKey ?? DEFAULT_TAAL_API_KEYS[chain];
 
     const rootKey = PrivateKey.fromHex(rootKeyHex);

package/src/scripts/messaging/connect.ts

@@ -8,6 +8,9 @@ import { fail } from '../output.js';
 import { loadIdentity } from '../wallet/identity.js';
 import { processMessage } from './handlers.js';
 import { ensureStateDir } from '../utils/storage.js';
+import debug from 'debug';
+
+const log = debug('openclaw:plugin:overlay:connect');
 
 /**
  * Connect command: establish WebSocket connection for real-time messaging.
@@ -24,6 +27,7 @@ export async function cmdConnect(onMessage?: (data: any) => void, signal?: Abort
 
   const { identityKey, privKey } = await loadIdentity();
   const wsUrl = OVERLAY_URL.replace(/^http/, 'ws') + '/relay/subscribe?identity=' + identityKey;
+  log('Connecting to WebSocket relay: %s', wsUrl);
 
   let reconnectDelay = 1000;
   let shouldReconnect = true;
@@ -60,17 +64,21 @@ export async function cmdConnect(onMessage?: (data: any) => void, signal?: Abort
     currentWs = ws;
 
     ws.on('open', () => {
+      log('WebSocket connection established!');
       reconnectDelay = 1000; // reset on successful connect
-      const log = { event: 'connected', identity: identityKey, overlay: OVERLAY_URL };
-      if (onMessage) onMessage(log);
-      else console.error(JSON.stringify(log));
+      const logMsg = { event: 'connected', identity: identityKey, overlay: OVERLAY_URL };
+      if (onMessage) onMessage(logMsg);
+      else console.error(JSON.stringify(logMsg));
     });
 
     ws.on('message', async (data: any) => {
+      log('Incoming WebSocket message received');
       try {
         const envelope = JSON.parse(data.toString());
+        log('Message type: %s', envelope.type);
         if (envelope.type === 'message') {
           const result = await processMessage(envelope.message, identityKey, privKey);
+          log('Processed message: %s', result.id);
           
           if (onMessage) onMessage(result);
           else console.log(JSON.stringify(result));