openclaw-overlay-plugin 0.7.71 → 0.7.72

package/README.md

@@ -78,10 +78,10 @@ The plugin needs the HTTP hooks endpoint enabled in your global `openclaw.json`
 
 You can interact with the overlay network directly from the chat using slash commands. These commands execute instantly and do not invoke the AI agent.
 
-- `/openclaw_overlay status` — Quick view of identity and balance.
-- `/openclaw_overlay balance` — Check wallet funding.
-- `/openclaw_overlay discover <serviceId>` — Find providers for a specific service.
-- `/openclaw_overlay onboard` — Trigger the onboarding check.
+- `/overlay status` — Quick view of identity, balance, and network.
+- `/overlay balance` — Check current satoshi balance.
+- `/overlay discover <serviceId>` — Find providers for a specific service.
+- `/overlay onboard` — Trigger the onboarding and registration check.
 
 ---
 
@@ -97,8 +97,10 @@ All actions are available through the `overlay` tool. Ask your agent naturally o
 | `discover` | List agents and services available on the network. |
 | `status` | Show identity key, balance, and advertised services. |
 | `balance` | Show current wallet balance in satoshis. |
-| `address` | Display the agent's receive address for funding. |
+| `address` | Display the agent's receive address for funding (network-aware). |
 | `advertise` | Advertise a new service to the marketplace. |
+| `advertise-ship`| Announce Topic Manager hosting (SHIP protocol). |
+| `advertise-slap`| Announce Lookup Service hosting (SLAP protocol). |
 | `register` | Manually register on the overlay network. |
 | `pending-requests`| Check for incoming service requests to fulfill. |
 | `fulfill` | Send the result for a pending service request. |
@@ -106,6 +108,17 @@ All actions are available through the `overlay` tool. Ask your agent naturally o
 
 ---
 
+## Network Modes
+
+The plugin supports multiple network modes via the `network` setting:
+- `mainnet`: Production BSV network.
+- `testnet`: Testing network with free faucet coins.
+- `local`: Local development environment.
+
+Addresses and WIFs are automatically generated with the correct network prefix.
+
+---
+
 ## Fund Your Wallet
 
 Your agent needs a small amount of real BSV to register and transact.

package/dist/index.d.ts

@@ -2,11 +2,12 @@
  * OpenClaw Overlay Plugin
  * Decentralized agent marketplace with BSV micropayments.
  */
+export declare function register(api: any): Promise<void>;
 export declare const plugin: {
     id: string;
     name: string;
     description: string;
-    activate(api: any): Promise<void>;
-    register(api: any): void;
+    activate: typeof register;
+    register: typeof register;
 };
-export default plugin;
+export default register;

package/dist/index.js

@@ -8,7 +8,7 @@ import os from 'node:os';
 import { fileURLToPath } from 'node:url';
 import fs from 'node:fs';
 import process from 'node:process';
-import { serviceManager } from './src/services/index.js';
+import { initializeServiceSystem, serviceManager } from './src/services/index.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 let isInitialized = false;
@@ -301,117 +301,126 @@ function getCliPath() {
  * OpenClaw Overlay Plugin
  * Decentralized agent marketplace with BSV micropayments.
  */
-export const plugin = {
-    id: "overlay",
-    name: "BSV Overlay Network",
-    description: "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
-    async activate(api) {
-        return this.register(api);
-    },
-    register(api) {
-        if (isInitialized)
-            return;
-        isInitialized = true;
-        const entries = api.getConfig?.()?.plugins?.entries || {};
-        const entry = entries['overlay'] || entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || {};
-        const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
-        // 1. Tool
-        api.registerTool({
-            name: "overlay",
-            description: "Access the BSV agent marketplace",
-            parameters: {
-                type: "object",
-                properties: {
-                    action: { type: "string", enum: ["request", "discover", "balance", "status", "pay", "onboard", "pending-requests", "fulfill", "unregister", "advertise-ship", "advertise-slap"] },
-                    service: { type: "string" },
-                    topic: { type: "string" },
-                    domain: { type: "string" },
-                    input: { type: "object" },
-                    identityKey: { type: "string" },
-                    sats: { type: "number" },
-                    requestId: { type: "string" },
-                    recipientKey: { type: "string" },
-                    serviceId: { type: "string" },
-                    result: { type: "object" }
-                },
-                required: ["action"]
+export async function register(api) {
+    if (isInitialized)
+        return;
+    isInitialized = true;
+    // Initialize child process helpers
+    await ensureCp();
+    const entries = api.getConfig?.()?.plugins?.entries || {};
+    const entry = entries['overlay'] || entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || {};
+    const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
+    // Initialize service system
+    try {
+        await initializeServiceSystem();
+    }
+    catch (err) {
+        if (api.logger)
+            api.logger.warn(`[overlay] Service system initialization failed: ${err.message}`);
+    }
+    // 1. Tool
+    api.registerTool({
+        name: "overlay",
+        description: "Access the BSV agent marketplace",
+        parameters: {
+            type: "object",
+            properties: {
+                action: { type: "string", enum: ["request", "discover", "balance", "status", "pay", "onboard", "pending-requests", "fulfill", "unregister", "advertise-ship", "advertise-slap"] },
+                service: { type: "string" },
+                topic: { type: "string" },
+                domain: { type: "string" },
+                input: { type: "object" },
+                identityKey: { type: "string" },
+                sats: { type: "number" },
+                requestId: { type: "string" },
+                recipientKey: { type: "string" },
+                serviceId: { type: "string" },
+                result: { type: "object" }
             },
-            async execute(_id, params) {
-                try {
-                    return await executeOverlayAction(params, pluginConfig, api);
+            required: ["action"]
+        },
+        async execute(_id, params) {
+            try {
+                return await executeOverlayAction(params, pluginConfig, api);
+            }
+            catch (error) {
+                return { content: [{ type: "text", text: `Error: ${error.message}` }] };
+            }
+        }
+    });
+    // 2. Command
+    api.registerCommand({
+        name: "overlay",
+        description: "BSV Overlay Marketplace commands",
+        acceptsArgs: true,
+        requireAuth: true,
+        handler: async (ctx) => {
+            try {
+                const action = ctx.args?.[0] || 'status';
+                if (action === 'help') {
+                    return { text: `🛰️ **Overlay Help**\n\n**Subcommands**:\n- \`status\`: Show identity and wallet balance\n- \`balance\`: Show current satoshis\n- \`onboard\`: Start discovery setup\n- \`discover <serviceId>\`: Find providers on network\n- \`advertise-ship <domain> <topic>\`: Advertise a topic manager\n- \`advertise-slap <domain> <service>\`: Advertise a lookup service\n- \`pending-requests\`: See incoming service jobs\n- \`fulfill\`: Complete a request (Agent only)` };
                 }
-                catch (error) {
-                    return { content: [{ type: "text", text: `Error: ${error.message}` }] };
+                const params = { action };
+                if (action === 'discover') {
+                    params.service = ctx.args[1];
                 }
-            }
-        });
-        // 2. Command
-        api.registerCommand({
-            name: "overlay",
-            description: "BSV Overlay Marketplace commands",
-            acceptsArgs: true,
-            requireAuth: true,
-            handler: async (ctx) => {
-                try {
-                    const action = ctx.args?.[0] || 'status';
-                    if (action === 'help') {
-                        return { text: `🛰️ **Overlay Help**\n\n**Subcommands**:\n- \`status\`: Show identity and wallet balance\n- \`balance\`: Show current satoshis\n- \`onboard\`: Start discovery setup\n- \`discover <serviceId>\`: Find providers on network\n- \`advertise-ship <domain> <topic>\`: Advertise a topic manager\n- \`advertise-slap <domain> <service>\`: Advertise a lookup service\n- \`pending-requests\`: See incoming service jobs\n- \`fulfill\`: Complete a request (Agent only)` };
-                    }
-                    const params = { action };
-                    if (action === 'discover') {
-                        params.service = ctx.args[1];
-                    }
-                    else if (action === 'advertise-ship') {
-                        params.domain = ctx.args[1];
-                        params.topic = ctx.args[2];
-                    }
-                    else if (action === 'advertise-slap') {
-                        params.domain = ctx.args[1];
-                        params.service = ctx.args[2];
-                    }
-                    const result = await executeOverlayAction(params, pluginConfig, api);
-                    if (typeof result === 'string')
-                        return { text: result };
-                    // Formatted status response
-                    if (action === 'status') {
-                        const status = result;
-                        return { text: `🛰️ **Overlay Status**\n\n**Identity Key**: \`${status.identity?.identityKey || 'Not setup'}\`\n**Balance**: ${status.balance?.walletBalance || 0} satoshis\n**Network**: ${status.identity?.network || 'mainnet'}` };
-                    }
-                    return { text: `**Overlay ${action.toUpperCase()}**\n\n${JSON.stringify(result, null, 2)}` };
+                else if (action === 'advertise-ship') {
+                    params.domain = ctx.args[1];
+                    params.topic = ctx.args[2];
+                }
+                else if (action === 'advertise-slap') {
+                    params.domain = ctx.args[1];
+                    params.service = ctx.args[2];
                 }
-                catch (error) {
-                    return { text: `❌ Error: ${error.message}` };
+                const result = await executeOverlayAction(params, pluginConfig, api);
+                if (typeof result === 'string')
+                    return { text: result };
+                // Formatted status response
+                if (action === 'status') {
+                    const status = result;
+                    return { text: `🛰️ **Overlay Status**\n\n**Identity Key**: \`${status.identity?.identityKey || 'Not setup'}\`\n**Balance**: ${status.balance?.walletBalance || 0} satoshis\n**Network**: ${status.identity?.network || 'mainnet'}` };
                 }
+                return { text: `**Overlay ${action.toUpperCase()}**\n\n${JSON.stringify(result, null, 2)}` };
             }
+            catch (error) {
+                return { text: `❌ Error: ${error.message}` };
+            }
+        }
+    });
+    // 3. Service
+    api.registerService({
+        id: "overlay-relay",
+        start: async () => {
+            const env = buildEnvironment(pluginConfig);
+            const cliPath = getCliPath();
+            startBackgroundService(env, cliPath, api.logger);
+            startAutoImport(env, cliPath, api.logger);
+        },
+        stop: () => stopBackgroundService()
+    });
+    // 4. CLI
+    api.registerCli(({ program }) => {
+        const overlay = program.command("overlay").description("BSV Overlay Network management");
+        overlay.command("status").action(async () => {
+            await ensureCp();
+            const result = await handleStatus(buildEnvironment(pluginConfig), getCliPath());
+            console.log(JSON.stringify(result, null, 2));
         });
-        // 3. Service
-        api.registerService({
-            id: "openclaw-overlay-relay",
-            start: async () => {
-                const env = buildEnvironment(pluginConfig);
-                const cliPath = getCliPath();
-                startBackgroundService(env, cliPath, api.logger);
-                startAutoImport(env, cliPath, api.logger);
-            },
-            stop: () => stopBackgroundService()
+        overlay.command("balance").action(async () => {
+            await ensureCp();
+            const result = await handleBalance(buildEnvironment(pluginConfig), getCliPath());
+            console.log(JSON.stringify(result, null, 2));
         });
-        // 4. CLI
-        api.registerCli(({ program }) => {
-            const overlay = program.command("overlay").description("BSV Overlay Network management");
-            overlay.command("status").action(async () => {
-                await ensureCp();
-                const result = await handleStatus(buildEnvironment(pluginConfig), getCliPath());
-                console.log(JSON.stringify(result, null, 2));
-            });
-            overlay.command("balance").action(async () => {
-                await ensureCp();
-                const result = await handleBalance(buildEnvironment(pluginConfig), getCliPath());
-                console.log(JSON.stringify(result, null, 2));
-            });
-        }, { descriptors: [{ name: "overlay", description: "BSV Overlay Network management" }] });
-    }
+    }, { descriptors: [{ name: "overlay", description: "BSV Overlay Network management" }] });
+}
+export const plugin = {
+    id: "openclaw-overlay-plugin",
+    name: "BSV Overlay Network",
+    description: "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
+    activate: register,
+    register: register
 };
-export default plugin;
+export default register;
 async function executeOverlayAction(params, config, api) {
     await ensureCp();
     const { action } = params;
@@ -500,7 +509,7 @@ function buildEnvironment(config) {
     const env = { ...process['env'] };
     env.BSV_WALLET_DIR = config.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
     env.OVERLAY_URL = config.overlayUrl || 'https://clawoverlay.com';
-    env.BSV_NETWORK = env.BSV_NETWORK || 'mainnet';
+    env.BSV_NETWORK = config.network || env.BSV_NETWORK || 'mainnet';
     env.BSV_ARC_URL = config.arcUrl || (env.BSV_NETWORK === 'testnet' ? 'https://testnet.arc.gorillapool.io' : 'https://arc.gorillapool.io');
     env.AGENT_NAME = config.agentName || 'openclaw-agent';
     return env;

package/dist/src/core/config.js

@@ -2,7 +2,9 @@
  * @a2a-bsv/core — Configuration defaults and helpers.
  */
 export function toChain(network) {
-    return network === 'mainnet' ? 'main' : 'test';
+    if (network === 'testnet')
+        return 'test';
+    return 'main';
 }
 /** Default TAAL API keys from the wallet-toolbox examples. */
 export const DEFAULT_TAAL_API_KEYS = {

package/dist/src/core/types.d.ts

@@ -4,7 +4,7 @@
 /** Wallet configuration for creating or loading an agent wallet. */
 export interface WalletConfig {
     /** BSV network to use. */
-    network: 'mainnet' | 'testnet';
+    network: 'mainnet' | 'testnet' | 'local';
     /** Directory path for SQLite wallet persistence. */
     storageDir: string;
     /** Optional: pre-existing root private key hex. If omitted on create(), a new one is generated. */
@@ -90,5 +90,5 @@ export interface WalletIdentity {
     /** The wallet's public identity key (compressed hex). */
     identityKey: string;
     /** Network this wallet targets. */
-    network: 'mainnet' | 'testnet';
+    network: 'mainnet' | 'testnet' | 'local';
 }

package/dist/src/core/wallet.d.ts

@@ -49,6 +49,10 @@ export declare class BSVAgentWallet {
      * This is the key other agents use to send payments to you.
      */
     getIdentityKey(): Promise<string>;
+    /**
+     * Get the wallet's current receive address for the active network.
+     */
+    getAddress(): Promise<string>;
     /**
      * Get the wallet's current balance in satoshis.
      *

package/dist/src/core/wallet.js

@@ -95,6 +95,13 @@ export class BSVAgentWallet {
     async getIdentityKey() {
         return this._setup.identityKey;
     }
+    /**
+     * Get the wallet's current receive address for the active network.
+     */
+    async getAddress() {
+        const network = this._setup.network || 'mainnet';
+        return this._setup.rootKey.toPublicKey().toAddress(network);
+    }
     /**
      * Get the wallet's current balance in satoshis.
      *
@@ -233,6 +240,7 @@ export class BSVAgentWallet {
             identityKey,
             keyDeriver,
             chain,
+            network: config.network,
             storage,
             services: isTestMode ? undefined : services,
             monitor: isTestMode ? undefined : monitor,

package/index.ts

@@ -313,25 +313,26 @@ function getCliPath() {
  * OpenClaw Overlay Plugin
  * Decentralized agent marketplace with BSV micropayments.
  */
-export const plugin = {
-  id: "overlay",
-  name: "BSV Overlay Network",
-  description: "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
-  
-  async activate(api: any) {
-    return this.register(api);
-  },
+export async function register(api: any) {
+  if (isInitialized) return;
+  isInitialized = true;
 
-  register(api: any) {
-    if (isInitialized) return;
-    isInitialized = true;
+  // Initialize child process helpers
+  await ensureCp();
 
-    const entries = api.getConfig?.()?.plugins?.entries || {};
-    const entry = entries['overlay'] || entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || {};
-    const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
+  const entries = api.getConfig?.()?.plugins?.entries || {};
+  const entry = entries['overlay'] || entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || {};
+  const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
 
-    // 1. Tool
-    api.registerTool({
+  // Initialize service system
+  try {
+    await initializeServiceSystem();
+  } catch (err: any) {
+    if (api.logger) api.logger.warn(`[overlay] Service system initialization failed: ${err.message}`);
+  }
+
+  // 1. Tool
+  api.registerTool({
       name: "overlay",
       description: "Access the BSV agent marketplace",
       parameters: {
@@ -404,7 +405,7 @@ export const plugin = {
 
     // 3. Service
     api.registerService({
-      id: "openclaw-overlay-relay",
+      id: "overlay-relay",
       start: async () => {
         const env = buildEnvironment(pluginConfig);
         const cliPath = getCliPath();
@@ -428,10 +429,17 @@ export const plugin = {
         console.log(JSON.stringify(result, null, 2));
       });
     }, { descriptors: [{ name: "overlay", description: "BSV Overlay Network management" }] });
-  }
+}
+
+export const plugin = {
+  id: "openclaw-overlay-plugin",
+  name: "BSV Overlay Network",
+  description: "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
+  activate: register,
+  register: register
 };
 
-export default plugin;
+export default register;
 
 async function executeOverlayAction(params: any, config: any, api: any) {
   await ensureCp();
@@ -527,7 +535,7 @@ function buildEnvironment(config: any) {
   const env = { ...(process as any)['env'] };
   env.BSV_WALLET_DIR = config.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
   env.OVERLAY_URL = config.overlayUrl || 'https://clawoverlay.com';
-  env.BSV_NETWORK = env.BSV_NETWORK || 'mainnet';
+  env.BSV_NETWORK = config.network || env.BSV_NETWORK || 'mainnet';
   env.BSV_ARC_URL = config.arcUrl || (env.BSV_NETWORK === 'testnet' ? 'https://testnet.arc.gorillapool.io' : 'https://arc.gorillapool.io');
   env.AGENT_NAME = config.agentName || 'openclaw-agent';
   return env;

package/openclaw.plugin.json

@@ -1,14 +1,14 @@
 {
-  "id": "overlay",
+  "id": "openclaw-overlay-plugin",
   "name": "BSV Overlay Network",
   "description": "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
-  "version": "0.7.70",
+  "version": "0.7.72",
   "skills": [
     "./SKILL.md"
   ],
   "providerAuthEnvVars": {
     "OVERLAY_URL": "Overlay server URL (defaults to https://clawoverlay.com)",
-    "BSV_NETWORK": "BSV network to use (mainnet/testnet)",
+    "BSV_NETWORK": "BSV network to use (mainnet/testnet/local)",
     "BSV_WALLET_DIR": "Path to the shared BSV wallet directory"
   },
   "providerAuthChoices": [
@@ -18,13 +18,6 @@
       "description": "Uses the default shared agent identity key"
     }
   ],
-  "commands": [
-    {
-      "name": "overlay",
-      "description": "BSV Overlay Network management",
-      "isAutoreply": true
-    }
-  ],
   "contracts": {
     "tools": [
       {

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "openclaw-overlay-plugin",
-  "version": "0.7.71",
+  "version": "0.7.72",
   "description": "Openclaw BSV Overlay — agent discovery, service marketplace, and micropayments on the BSV blockchain",
   "publishConfig": {
     "access": "public"
   },
   "type": "module",
+  "main": "dist/index.js",
   "files": [
     "index.ts",
     "openclaw.plugin.json",

package/src/core/config.ts

@@ -8,7 +8,8 @@ import type { WalletConfig } from './types.js';
 export type Chain = 'main' | 'test';
 
 export function toChain(network: WalletConfig['network']): Chain {
-  return network === 'mainnet' ? 'main' : 'test';
+  if (network === 'testnet') return 'test';
+  return 'main';
 }
 
 /** Default TAAL API keys from the wallet-toolbox examples. */

package/src/core/types.ts

@@ -5,7 +5,7 @@
 /** Wallet configuration for creating or loading an agent wallet. */
 export interface WalletConfig {
   /** BSV network to use. */
-  network: 'mainnet' | 'testnet';
+  network: 'mainnet' | 'testnet' | 'local';
   /** Directory path for SQLite wallet persistence. */
   storageDir: string;
   /** Optional: pre-existing root private key hex. If omitted on create(), a new one is generated. */
@@ -98,5 +98,5 @@ export interface WalletIdentity {
   /** The wallet's public identity key (compressed hex). */
   identityKey: string;
   /** Network this wallet targets. */
-  network: 'mainnet' | 'testnet';
+  network: 'mainnet' | 'testnet' | 'local';
 }

package/src/core/wallet.ts

@@ -134,6 +134,14 @@ export class BSVAgentWallet {
     return this._setup.identityKey;
   }
 
+  /**
+   * Get the wallet's current receive address for the active network.
+   */
+  async getAddress(): Promise<string> {
+    const network = (this._setup as any).network || 'mainnet';
+    return this._setup.rootKey.toPublicKey().toAddress(network);
+  }
+
   /**
    * Get the wallet's current balance in satoshis.
    *
@@ -298,6 +306,7 @@ export class BSVAgentWallet {
       identityKey,
       keyDeriver,
       chain,
+      network: config.network,
       storage,
       services: isTestMode ? undefined : services,
       monitor: isTestMode ? undefined : monitor,