openclaw-overlay-plugin 0.7.50 → 0.7.52

package/dist/index.js

@@ -579,6 +579,32 @@ export default function register(api) {
                 startBackgroundService(env, cliPath, api.logger);
                 // Start auto-import
                 startAutoImport(env, cliPath, api.logger);
+                // Auto-check for registration on startup
+                (async () => {
+                    try {
+                        const regPath = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
+                        const onboardSentFile = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'onboarding-sent.flag');
+                        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');
+                                        await autoAdvertiseServices(env, cliPath, api.logger);
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    catch (err) {
+                        api.logger.debug(`[openclaw-overlay] Auto-setup/onboarding skipped: ${err.message}`);
+                    }
+                })();
                 api.logger.info("BSV overlay WebSocket relay started");
             }
             catch (error) {
@@ -590,51 +616,6 @@ export default function register(api) {
             stopBackgroundService();
         }
     });
-    // Register a skill-style wake handler
-    api.registerHook({
-        id: "openclaw-overlay-wake",
-        event: "gateway:start",
-        handler: async (ctx) => {
-            // Auto-check for registration on startup
-            (async () => {
-                try {
-                    const env = buildEnvironment(pluginConfig);
-                    const cliPath = getCliPath();
-                    const regPath = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
-                    const onboardSentFile = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'onboarding-sent.flag');
-                    if (!fs.existsSync(regPath) && !fs.existsSync(onboardSentFile)) {
-                        // Check if wallet exists
-                        const walletPath = path.join(pluginConfig.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet'), 'wallet-identity.json');
-                        if (!fs.existsSync(walletPath)) {
-                            // No wallet, no registration — first run ever.
-                            // We'll let startAutoImport create the wallet via 'address' command,
-                            // then it will wake the agent when funded.
-                        }
-                        else {
-                            // 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 less than 1000, need more funds to register.
-                                // We don't wake up here, we wait for auto-import to detect new funds.
-                            }
-                            else {
-                                // Funded but not registered. Auto-register.
-                                const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
-                                if (parseCliOutput(regResult.stdout).success) {
-                                    ctx.logger.info('[openclaw-overlay] Agent auto-registered on startup');
-                                    await autoAdvertiseServices(env, cliPath, ctx.logger);
-                                }
-                            }
-                        }
-                    }
-                }
-                catch (err) {
-                    api.log?.debug?.('[openclaw-overlay] Auto-setup/onboarding skipped:', err.message);
-                }
-            })();
-        }
-    });
     // Register CLI extensions
     api.registerCli(({ program }) => {
         const overlay = program.command("overlay").description("BSV Overlay Network management");

package/index.ts

@@ -629,6 +629,35 @@ export default function register(api: any) {
         // Start auto-import
         startAutoImport(env, cliPath, api.logger);
 
+        // Auto-check for registration on startup
+        (async () => {
+          try {
+            const regPath = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
+            const onboardSentFile = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'onboarding-sent.flag');
+            
+            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');
+                    await autoAdvertiseServices(env, cliPath, api.logger);
+                  }
+                }
+              }
+            }
+          } catch (err: any) {
+            api.logger.debug(`[openclaw-overlay] Auto-setup/onboarding skipped: ${err.message}`);
+          }
+        })();
+
         api.logger.info("BSV overlay WebSocket relay started");
       } catch (error: any) {
         api.logger.error(`Failed to start BSV overlay relay: ${error.message}`);
@@ -640,54 +669,6 @@ export default function register(api: any) {
     }
   });
 
-  // Register a skill-style wake handler
-  api.registerHook({
-    id: "openclaw-overlay-wake",
-    event: "gateway:start",
-    handler: async (ctx: any) => {
-      // Auto-check for registration on startup
-      (async () => {
-        try {
-          const env = buildEnvironment(pluginConfig);
-          const cliPath = getCliPath();
-          
-          const regPath = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
-          const onboardSentFile = path.join(process.env.HOME || '', '.openclaw', 'openclaw-overlay', 'onboarding-sent.flag');
-          
-          if (!fs.existsSync(regPath) && !fs.existsSync(onboardSentFile)) {
-            // Check if wallet exists
-            const walletPath = path.join(pluginConfig.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet'), 'wallet-identity.json');
-            
-            if (!fs.existsSync(walletPath)) {
-              // No wallet, no registration — first run ever.
-              // We'll let startAutoImport create the wallet via 'address' command,
-              // then it will wake the agent when funded.
-            } else {
-              // 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 less than 1000, need more funds to register.
-                // We don't wake up here, we wait for auto-import to detect new funds.
-              } else {
-                // Funded but not registered. Auto-register.
-                const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
-                if (parseCliOutput(regResult.stdout).success) {
-                  ctx.logger.info('[openclaw-overlay] Agent auto-registered on startup');
-                  await autoAdvertiseServices(env, cliPath, ctx.logger);
-                }
-              }
-            }
-          }
-
-        } catch (err: any) {
-          api.log?.debug?.('[openclaw-overlay] Auto-setup/onboarding skipped:', err.message);
-        }
-      })();
-    }
-  });
-
   // Register CLI extensions
   api.registerCli(({ program }: any) => {
     const overlay = program.command("overlay").description("BSV Overlay Network management");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-overlay-plugin",
-  "version": "0.7.50",
+  "version": "0.7.52",
   "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": {
@@ -70,9 +69,6 @@
     "extensions": [
       "./dist/index.js"
     ],
-    "hooks": [
-      "./dist/index.js"
-    ],
     "compat": {
       "pluginApi": "1",
       "minGatewayVersion": "2026.3.1"

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