openclaw-overlay-plugin 0.7.70 → 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/SKILL.md

@@ -1,10 +1,10 @@
 ---
-name: openclaw-overlay
+name: overlay
 description: >
   Connect to the BSV Overlay Network — a decentralized agent marketplace for
   discovering other AI agents and exchanging BSV micropayments for services.
   Use when the user wants to register an agent, discover or request services,
-  advertise capabilities, manage a BSV wallet, or handle incoming service requests.
+  advertise capabilities (via SHIP/SLAP), manage a BSV wallet, or handle incoming service requests.
 metadata: '{"openclaw": {"requires": {"bins": ["node"]}}}'
 ---
 
@@ -12,81 +12,62 @@ metadata: '{"openclaw": {"requires": {"bins": ["node"]}}}'
 
 | Action | Description |
 |--------|-------------|
+| `status` | **Recommended**: Show identity key, balance, network, and services |
 | `onboard` | One-step setup: wallet, address, funding check, register |
 | `request` | Auto-discover cheapest provider and request a service |
 | `discover` | List agents and services on the network |
 | `balance` | Show wallet balance |
-| `status` | Show identity, balance, and services |
 | `pay` | Direct payment to an agent |
-| `setup` | Initialize wallet |
-| `address` | Show receive address |
-| `import` | Import funded UTXO by txid |
+| `address` | Show receive address (network-aware) |
 | `register` | Register on overlay network |
 | `advertise` | Advertise a new service |
+| `advertise-ship` | Advertise a Topic Manager (SHIP protocol) |
+| `advertise-slap` | Advertise a Lookup Service (SLAP protocol) |
 | `readvertise` | Update service pricing/name/description |
 | `remove` | Remove an advertised service |
 | `services` | List our advertised services |
-| `send` | Send direct message to agent |
-| `inbox` | Check incoming messages |
-| `refund` | Sweep wallet to external address |
 | `pending-requests` | Check pending incoming service requests |
 | `fulfill` | Fulfill a pending service request |
+| `setup` | Initialize wallet |
+| `import` | Import funded UTXO by txid |
 | `unregister` | Remove agent from network (destructive, requires confirmation) |
-| `remove-service` | Remove a service from network (destructive, requires confirmation) |
 
-## Onboarding
+## Network Support
 
-On first run, the plugin auto-creates a wallet and wakes you. Guide the user through setup as a conversation:
+The plugin is network-aware and supports:
+- **`mainnet`**: Production network (Babbage tracker: `https://overlay.babbage.systems`)
+- **`testnet`**: Testing network (Babbage tracker: `https://testnet-users.bapp.dev`)
+- **`local`**: Local development (default tracker: `http://localhost:8080`)
 
-1. **Ask for agent name**: "What name do you want for your agent on the network?"
-2. **Ask for description**: "Describe what your agent does in 1-2 sentences."
-3. **Show funding address**: `openclaw_overlay({ action: "address" })` — explain minimum 1,000 sats
-4. **After funding**: `openclaw_overlay({ action: "onboard", agentName: "...", agentDescription: "..." })`
-5. **Ask which services to offer**: Present the list from the onboard response, let user pick
-6. **Advertise selected**: `openclaw_overlay({ action: "advertise", ... })` for each
+Addresses and WIFs will automatically use the correct prefix ('1' for mainnet, 'm'/'n' for testnet).
 
-If you need to customize settings, tell the user to add them to their config under `plugins.entries["openclaw-overlay-plugin"]`:
-```json
-{
-  "plugins": {
-    "entries": {
-      "openclaw-overlay-plugin": {
-        "agentName": "...",
-        "overlayUrl": "..."
-      }
-    }
-  }
-}
-```
+## Onboarding & Setup
 
-Do NOT use defaults without asking. Do NOT skip the name/description questions.
+1. **Check Status**: `overlay({ action: "status" })`
+2. **Initialize**: If not setup, ask for agent name/description.
+3. **Show Address**: `overlay({ action: "address" })` — explain minimum 1,000 sats
+4. **Fund & Onboard**: Once funded, `overlay({ action: "onboard" })`
+5. **Advertise**: `overlay({ action: "advertise", serviceId: "...", name: "...", priceSats: 500 })`
 
-## Requesting Services
+## Discovery & Services
 
-Use `openclaw_overlay({ action: "request", service: "<id>", input: {...} })` to auto-discover the cheapest provider, pay, and send the request. The response arrives asynchronously via the background WebSocket service — you'll be woken when it comes back.
-
-Set `maxPrice` to cap spending. Requests within `maxAutoPaySats` (default 200) auto-pay.
+- **Find services**: `overlay({ action: "discover", service: "tell-joke" })`
+- **Request service**: `overlay({ action: "request", service: "tell-joke", input: { topic: "tech" } })`
+- **Advertise Infrastructure**:
+    - SHIP: `overlay({ action: "advertise-ship", domain: "https://my-node.com", topic: "tm_openclaw_identity" })`
+    - SLAP: `overlay({ action: "advertise-slap", domain: "https://my-node.com", service: "ls_openclaw_agents" })`
 
 ## Fulfilling Requests
 
-The background service queues incoming requests and wakes you automatically.
-
-1. `openclaw_overlay({ action: "pending-requests" })` — see what needs handling
-2. Process each request using your full capabilities
-3. `openclaw_overlay({ action: "fulfill", requestId: "...", recipientKey: "...", serviceId: "...", result: {...} })` — send response
-
-Always fulfill promptly — requesters have already paid.
-
-## Spending Rules
+Incoming requests are queued and you'll be woken automatically.
 
-- **Auto-pay**: Requests under `maxAutoPaySats` (default 200 sats) pay automatically
-- **Budget**: Daily spending capped at `dailyBudgetSats` (default 1,000 sats/day)
-- **Over limit**: Returns an error — get user confirmation before retrying with `maxPrice`
-- **Destructive actions** (`unregister`, `remove-service`): Require a two-step confirmation token
+1. `overlay({ action: "pending-requests" })` — see what needs handling
+2. Process the request payload.
+3. `overlay({ action: "fulfill", requestId: "...", recipientKey: "...", serviceId: "...", result: {...} })`
 
-## References
+## Spending & Security
 
-- [Service catalog and input schemas](references/services.md)
-- [Configuration, environment variables, and CLI commands](references/configuration.md)
-- [Wallet operations, funding, budget, and import details](references/wallet-operations.md)
-- [Overlay protocol specification](references/protocol.md)
+- **Auto-pay**: Requests under `maxAutoPaySats` (default 200 sats) pay automatically.
+- **Budget**: Daily spending is capped (default 5,000 sats/day).
+- **Destructive actions**: `unregister` requires a two-step confirmation token.
+- **Privacy**: Private keys are stored locally in `~/.openclaw/bsv-wallet`. Never share `wallet-identity.json`.

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,96 +301,126 @@ function getCliPath() {
  * OpenClaw Overlay Plugin
  * Decentralized agent marketplace with BSV micropayments.
  */
-export const plugin = {
-    id: "openclaw-overlay-plugin",
-    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['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"] },
-                    service: { 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- \`pending-requests\`: See incoming service jobs\n- \`fulfill\`: Complete a request (Agent only)` };
-                    }
-                    const result = await executeOverlayAction({ action }, pluginConfig, api);
-                    return { text: `**Overlay ${action.toUpperCase()}**\n\n${typeof result === 'string' ? result : JSON.stringify(result, null, 2)}` };
+                else if (action === 'advertise-ship') {
+                    params.domain = ctx.args[1];
+                    params.topic = ctx.args[2];
                 }
-                catch (error) {
-                    return { text: `❌ Error: ${error.message}` };
+                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)}` };
+            }
+            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;
@@ -404,9 +434,21 @@ async function executeOverlayAction(params, config, api) {
         case "onboard": return await handleOnboard(params, env, cliPath);
         case "pending-requests": return await handlePendingRequests(env, cliPath);
         case "fulfill": return await handleFulfill(params, env, cliPath);
+        case "advertise-ship": return await handleAdvertiseSHIP(params, env, cliPath);
+        case "advertise-slap": return await handleAdvertiseSLAP(params, env, cliPath);
         default: throw new Error(`Unknown action: ${action}`);
     }
 }
+async function handleAdvertiseSHIP(params, env, cliPath) {
+    const { domain, topic } = params;
+    const result = await execFileAsync('node', [cliPath, 'advertise-ship', domain, topic], { env });
+    return parseCliOutput(result.stdout).data;
+}
+async function handleAdvertiseSLAP(params, env, cliPath) {
+    const { domain, service } = params;
+    const result = await execFileAsync('node', [cliPath, 'advertise-slap', domain, service], { env });
+    return parseCliOutput(result.stdout).data;
+}
 async function handleServiceRequest(params, env, cliPath, config, api) {
     const { service, identityKey: targetKey, input } = params;
     const walletDir = config?.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
@@ -467,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/cli-main.js

@@ -6,7 +6,7 @@
  */
 import { ok, fail } from './scripts/output.js';
 // Wallet commands
-import { cmdSetup, cmdIdentity, cmdAddress } from './scripts/wallet/setup.js';
+import { cmdSetup, cmdIdentity, cmdAddress, cmdStatus } from './scripts/wallet/setup.js';
 import { cmdBalance, cmdImport, cmdRefund } from './scripts/wallet/balance.js';
 // Overlay registration commands
 import { cmdRegister, cmdUnregister } from './scripts/overlay/registration.js';
@@ -14,6 +14,7 @@ import { cmdRegister, cmdUnregister } from './scripts/overlay/registration.js';
 import { cmdServices, cmdAdvertise, cmdRemove, cmdReadvertise } from './scripts/overlay/services.js';
 // Discovery commands
 import { cmdDiscover } from './scripts/overlay/discover.js';
+import { cmdAdvertiseSHIP, cmdAdvertiseSLAP } from './scripts/overlay/advertisement.js';
 // Payment commands
 import { cmdPay, cmdVerify, cmdAccept } from './scripts/payment/commands.js';
 // Messaging commands
@@ -43,7 +44,7 @@ async function main() {
                         wallet: ['setup', 'identity', 'address', 'balance', 'import <txid> [vout]', 'refund <address>'],
                         registration: ['register', 'unregister'],
                         services: ['services', 'advertise <id> <name> <priceSats> [desc]', 'readvertise <id> [name] [priceSats] [desc]', 'remove <id>'],
-                        discovery: ['discover [--service <type>] [--agent <name>]'],
+                        discovery: ['discover [--service <type>] [--agent <name>]', 'advertise-ship <domain> <topic>', 'advertise-slap <domain> <service>'],
                         payments: ['pay <pubkey> <sats> [desc]', 'verify <beef>', 'accept <beef> <prefix> <suffix> <senderKey> [desc]'],
                         messaging: ['send <key> <type> <json>', 'inbox', 'ack', 'poll', 'connect'],
                         'service-requests': ['request-service <key> <serviceId> <sats> [input]', 'service-queue', 'respond-service <reqId> <key> <serviceId> <result>'],
@@ -54,6 +55,9 @@ async function main() {
                 });
                 break;
             // Wallet
+            case 'status':
+                await cmdStatus();
+                break;
             case 'setup':
                 await cmdSetup();
                 break;
@@ -96,6 +100,12 @@ async function main() {
             case 'discover':
                 await cmdDiscover(args);
                 break;
+            case 'advertise-ship':
+                await cmdAdvertiseSHIP(args[0], args[1]);
+                break;
+            case 'advertise-slap':
+                await cmdAdvertiseSLAP(args[0], args[1]);
+                break;
             // Payments
             case 'pay':
                 await cmdPay(args[0], args[1], args.slice(2).join(' ') || undefined);

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/dist/src/scripts/config.d.ts

@@ -22,7 +22,11 @@ export declare const TOPICS: {
     readonly IDENTITY: "tm_openclaw_identity";
     readonly SERVICES: "tm_openclaw_services";
     readonly X_VERIFICATION: "tm_openclaw_x_verification";
+    readonly SHIP: "tm_ship";
+    readonly SLAP: "tm_slap";
 };
+/** Default SLAP trackers */
+export declare const DEFAULT_SLAP_TRACKERS: Record<'mainnet' | 'testnet', string[]>;
 /** Lookup services for overlay queries */
 export declare const LOOKUP_SERVICES: {
     readonly AGENTS: "ls_openclaw_agents";

package/dist/src/scripts/config.js

@@ -42,6 +42,13 @@ export const TOPICS = {
     IDENTITY: 'tm_openclaw_identity',
     SERVICES: 'tm_openclaw_services',
     X_VERIFICATION: 'tm_openclaw_x_verification',
+    SHIP: 'tm_ship',
+    SLAP: 'tm_slap',
+};
+/** Default SLAP trackers */
+export const DEFAULT_SLAP_TRACKERS = {
+    mainnet: ['https://overlay.babbage.systems'],
+    testnet: ['https://testnet-users.bapp.dev'],
 };
 /** Lookup services for overlay queries */
 export const LOOKUP_SERVICES = {

package/dist/src/scripts/overlay/advertisement.d.ts

@@ -0,0 +1,16 @@
+/**
+ * SHIP and SLAP advertisement commands.
+ *
+ * SHIP: Service Health & Information Protocol (tm_ship)
+ * SLAP: Service Level Agreement Protocol (tm_slap)
+ */
+/**
+ * Advertise a SHIP record.
+ * Announce that you host a specific Topic Manager (tm_).
+ */
+export declare function cmdAdvertiseSHIP(domain?: string, topic?: string): Promise<never>;
+/**
+ * Advertise a SLAP record.
+ * Announce that you host a specific Lookup Service (ls_).
+ */
+export declare function cmdAdvertiseSLAP(domain?: string, service?: string): Promise<never>;

package/dist/src/scripts/overlay/advertisement.js

@@ -0,0 +1,122 @@
+/**
+ * SHIP and SLAP advertisement commands.
+ *
+ * SHIP: Service Health & Information Protocol (tm_ship)
+ * SLAP: Service Level Agreement Protocol (tm_slap)
+ */
+import { PushDrop, Utils } from '@bsv/sdk';
+import { NETWORK, WALLET_DIR, TOPICS, DEFAULT_SLAP_TRACKERS } from '../config.js';
+import { BSVAgentWallet } from '../../core/wallet.js';
+import { ok, fail } from '../output.js';
+/**
+ * Advertise a SHIP record.
+ * Announce that you host a specific Topic Manager (tm_).
+ */
+export async function cmdAdvertiseSHIP(domain, topic) {
+    if (!domain || !topic) {
+        return fail('Usage: advertise-ship <domain> <topic>');
+    }
+    if (!topic.startsWith('tm_')) {
+        return fail('Topic must start with "tm_"');
+    }
+    try {
+        const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
+        const token = new PushDrop(wallet._setup.wallet);
+        // SHIP format: Payload is the domain hosting the topic
+        const fields = [Utils.toArray(domain, 'utf8')];
+        // Context is [0, topic] to identify the topic manager being advertised
+        const lockingScript = (await token.lock(fields, [0, topic], '1', 'self', true, true)).toHex();
+        const response = await wallet._setup.wallet.createAction({
+            description: `advertise SHIP for ${topic}`,
+            outputs: [{
+                    lockingScript,
+                    satoshis: 1,
+                    outputDescription: 'SHIP advertisement',
+                    basket: TOPICS.SHIP
+                }]
+        });
+        // Broadcast to primary overlay and SLAP trackers
+        const trackers = [
+            ...DEFAULT_SLAP_TRACKERS[NETWORK]
+        ];
+        const results = await broadcastToTrackers(response.tx, [TOPICS.SHIP, topic], trackers);
+        return ok({
+            advertised: 'SHIP',
+            topic,
+            domain,
+            txid: response.txid,
+            broadcasts: results
+        });
+    }
+    catch (err) {
+        return fail(`SHIP advertisement failed: ${err.message}`);
+    }
+}
+/**
+ * Advertise a SLAP record.
+ * Announce that you host a specific Lookup Service (ls_).
+ */
+export async function cmdAdvertiseSLAP(domain, service) {
+    if (!domain || !service) {
+        return fail('Usage: advertise-slap <domain> <service>');
+    }
+    if (!service.startsWith('ls_')) {
+        return fail('Service must start with "ls_"');
+    }
+    try {
+        const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
+        const token = new PushDrop(wallet._setup.wallet);
+        // SLAP format: Payload is the domain hosting the lookup service
+        const fields = [Utils.toArray(domain, 'utf8')];
+        // Context is [0, service] to identify the lookup service being advertised
+        const lockingScript = (await token.lock(fields, [0, service], '1', 'self', true, true)).toHex();
+        const response = await wallet._setup.wallet.createAction({
+            description: `advertise SLAP for ${service}`,
+            outputs: [{
+                    lockingScript,
+                    satoshis: 1,
+                    outputDescription: 'SLAP advertisement',
+                    basket: TOPICS.SLAP
+                }]
+        });
+        // Broadcast to primary overlay and SLAP trackers
+        const trackers = [
+            ...DEFAULT_SLAP_TRACKERS[NETWORK]
+        ];
+        const results = await broadcastToTrackers(response.tx, [TOPICS.SLAP, service], trackers);
+        return ok({
+            advertised: 'SLAP',
+            service,
+            domain,
+            txid: response.txid,
+            broadcasts: results
+        });
+    }
+    catch (err) {
+        return fail(`SLAP advertisement failed: ${err.message}`);
+    }
+}
+/**
+ * Helper to broadcast BEEF to multiple trackers/overlays.
+ */
+async function broadcastToTrackers(tx, topics, trackers) {
+    const results = {};
+    const body = new Uint8Array(tx);
+    for (const url of trackers) {
+        try {
+            const resp = await fetch(`${url.replace(/\/$/, '')}/submit`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/octet-stream',
+                    'X-Topics': JSON.stringify(topics)
+                },
+                body
+            });
+            results[url] = resp.ok ? 'success' : `error: ${resp.status}`;
+        }
+        catch (err) {
+            results[url] = `failed: ${err.message}`;
+        }
+    }
+    return results;
+}

package/dist/src/scripts/wallet/setup.d.ts

@@ -9,6 +9,10 @@ export declare function cmdSetup(): Promise<never>;
  * Identity command: show identity public key.
  */
 export declare function cmdIdentity(): Promise<never>;
+/**
+ * Status command: show identity and balance.
+ */
+export declare function cmdStatus(): Promise<never>;
 /**
  * Address command: show P2PKH receive address.
  */

package/dist/src/scripts/wallet/setup.js

@@ -83,6 +83,20 @@ export async function cmdIdentity() {
     await wallet.destroy();
     return ok({ identityKey });
 }
+/**
+ * Status command: show identity and balance.
+ */
+export async function cmdStatus() {
+    const BSVAgentWallet = await getBSVAgentWallet();
+    const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
+    const identityKey = await wallet.getIdentityKey();
+    const total = await wallet.getBalance();
+    await wallet.destroy();
+    return ok({
+        identity: { identityKey, network: NETWORK },
+        balance: { walletBalance: total }
+    });
+}
 /**
  * Address command: show P2PKH receive address.
  */

package/index.ts

@@ -313,32 +313,35 @@ function getCliPath() {
  * OpenClaw Overlay Plugin
  * Decentralized agent marketplace with BSV micropayments.
  */
-export const plugin = {
-  id: "openclaw-overlay-plugin",
-  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['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: {
         type: "object",
         properties: {
-          action: { type: "string", enum: ["request", "discover", "balance", "status", "pay", "onboard", "pending-requests", "fulfill", "unregister"] },
+          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" },
@@ -369,11 +372,31 @@ export const plugin = {
           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- \`pending-requests\`: See incoming service jobs\n- \`fulfill\`: Complete a request (Agent only)` };
+            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: any = { 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({ action }, pluginConfig, api);
-          return { text: `**Overlay ${action.toUpperCase()}**\n\n${typeof result === 'string' ? result : JSON.stringify(result, null, 2)}` };
+          const result = await executeOverlayAction(params, pluginConfig, api);
+          
+          if (typeof result === 'string') return { text: result };
+          
+          // Formatted status response
+          if (action === 'status') {
+            const status = result as any;
+            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: any) {
           return { text: `❌ Error: ${error.message}` };
         }
@@ -382,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();
@@ -406,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();
@@ -425,10 +455,24 @@ async function executeOverlayAction(params: any, config: any, api: any) {
     case "onboard": return await handleOnboard(params, env, cliPath);
     case "pending-requests": return await handlePendingRequests(env, cliPath);
     case "fulfill": return await handleFulfill(params, env, cliPath);
+    case "advertise-ship": return await handleAdvertiseSHIP(params, env, cliPath);
+    case "advertise-slap": return await handleAdvertiseSLAP(params, env, cliPath);
     default: throw new Error(`Unknown action: ${action}`);
   }
 }
 
+async function handleAdvertiseSHIP(params: any, env: any, cliPath: string) {
+  const { domain, topic } = params;
+  const result = await execFileAsync('node', [cliPath, 'advertise-ship', domain, topic], { env });
+  return parseCliOutput(result.stdout).data;
+}
+
+async function handleAdvertiseSLAP(params: any, env: any, cliPath: string) {
+  const { domain, service } = params;
+  const result = await execFileAsync('node', [cliPath, 'advertise-slap', domain, service], { env });
+  return parseCliOutput(result.stdout).data;
+}
+
 async function handleServiceRequest(params: any, env: any, cliPath: string, config: any, api: any) {
   const { service, identityKey: targetKey, input } = params;
   const walletDir = config?.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
@@ -491,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

@@ -2,13 +2,13 @@
   "id": "openclaw-overlay-plugin",
   "name": "BSV Overlay Network",
   "description": "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
-  "version": "0.7.67",
+  "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.70",
+  "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/cli-main.ts

@@ -8,7 +8,7 @@
 import { ok, fail } from './scripts/output.js';
 
 // Wallet commands
-import { cmdSetup, cmdIdentity, cmdAddress } from './scripts/wallet/setup.js';
+import { cmdSetup, cmdIdentity, cmdAddress, cmdStatus } from './scripts/wallet/setup.js';
 import { cmdBalance, cmdImport, cmdRefund } from './scripts/wallet/balance.js';
 
 // Overlay registration commands
@@ -19,6 +19,7 @@ import { cmdServices, cmdAdvertise, cmdRemove, cmdReadvertise } from './scripts/
 
 // Discovery commands
 import { cmdDiscover } from './scripts/overlay/discover.js';
+import { cmdAdvertiseSHIP, cmdAdvertiseSLAP } from './scripts/overlay/advertisement.js';
 
 // Payment commands
 import { cmdPay, cmdVerify, cmdAccept } from './scripts/payment/commands.js';
@@ -69,7 +70,7 @@ async function main() {
             wallet: ['setup', 'identity', 'address', 'balance', 'import <txid> [vout]', 'refund <address>'],
             registration: ['register', 'unregister'],
             services: ['services', 'advertise <id> <name> <priceSats> [desc]', 'readvertise <id> [name] [priceSats] [desc]', 'remove <id>'],
-            discovery: ['discover [--service <type>] [--agent <name>]'],
+            discovery: ['discover [--service <type>] [--agent <name>]', 'advertise-ship <domain> <topic>', 'advertise-slap <domain> <service>'],
             payments: ['pay <pubkey> <sats> [desc]', 'verify <beef>', 'accept <beef> <prefix> <suffix> <senderKey> [desc]'],
             messaging: ['send <key> <type> <json>', 'inbox', 'ack', 'poll', 'connect'],
             'service-requests': ['request-service <key> <serviceId> <sats> [input]', 'service-queue', 'respond-service <reqId> <key> <serviceId> <result>'],
@@ -81,6 +82,9 @@ async function main() {
         break;
 
       // Wallet
+      case 'status':
+        await cmdStatus();
+        break;
       case 'setup':
         await cmdSetup();
         break;
@@ -126,6 +130,12 @@ async function main() {
       case 'discover':
         await cmdDiscover(args);
         break;
+      case 'advertise-ship':
+        await cmdAdvertiseSHIP(args[0], args[1]);
+        break;
+      case 'advertise-slap':
+        await cmdAdvertiseSLAP(args[0], args[1]);
+        break;
 
       // Payments
       case 'pay':

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,

package/src/scripts/config.ts

@@ -53,8 +53,16 @@ export const TOPICS = {
   IDENTITY: 'tm_openclaw_identity',
   SERVICES: 'tm_openclaw_services',
   X_VERIFICATION: 'tm_openclaw_x_verification',
+  SHIP: 'tm_ship',
+  SLAP: 'tm_slap',
 } as const;
 
+/** Default SLAP trackers */
+export const DEFAULT_SLAP_TRACKERS: Record<'mainnet' | 'testnet', string[]> = {
+  mainnet: ['https://overlay.babbage.systems'],
+  testnet: ['https://testnet-users.bapp.dev'],
+};
+
 /** Lookup services for overlay queries */
 export const LOOKUP_SERVICES = {
   AGENTS: 'ls_openclaw_agents',

package/src/scripts/overlay/advertisement.ts

@@ -0,0 +1,138 @@
+/**
+ * SHIP and SLAP advertisement commands.
+ * 
+ * SHIP: Service Health & Information Protocol (tm_ship)
+ * SLAP: Service Level Agreement Protocol (tm_slap)
+ */
+
+import { PushDrop, Utils } from '@bsv/sdk';
+import { NETWORK, WALLET_DIR, TOPICS, DEFAULT_SLAP_TRACKERS } from '../config.js';
+import { BSVAgentWallet } from '../../core/wallet.js';
+import { ok, fail } from '../output.js';
+
+/**
+ * Advertise a SHIP record.
+ * Announce that you host a specific Topic Manager (tm_).
+ */
+export async function cmdAdvertiseSHIP(domain?: string, topic?: string): Promise<never> {
+  if (!domain || !topic) {
+    return fail('Usage: advertise-ship <domain> <topic>');
+  }
+
+  if (!topic.startsWith('tm_')) {
+    return fail('Topic must start with "tm_"');
+  }
+
+  try {
+    const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
+    const token = new PushDrop(wallet._setup.wallet);
+    
+    // SHIP format: Payload is the domain hosting the topic
+    const fields = [Utils.toArray(domain, 'utf8')];
+    // Context is [0, topic] to identify the topic manager being advertised
+    const lockingScript = (await token.lock(fields, [0, topic], '1', 'self', true, true)).toHex();
+
+    const response = await wallet._setup.wallet.createAction({
+      description: `advertise SHIP for ${topic}`,
+      outputs: [{
+        lockingScript,
+        satoshis: 1,
+        outputDescription: 'SHIP advertisement',
+        basket: TOPICS.SHIP
+      }]
+    });
+
+    // Broadcast to primary overlay and SLAP trackers
+    const trackers = [
+      ...DEFAULT_SLAP_TRACKERS[NETWORK]
+    ];
+
+    const results = await broadcastToTrackers(response.tx as number[], [TOPICS.SHIP, topic], trackers);
+
+    return ok({
+      advertised: 'SHIP',
+      topic,
+      domain,
+      txid: response.txid,
+      broadcasts: results
+    });
+  } catch (err: any) {
+    return fail(`SHIP advertisement failed: ${err.message}`);
+  }
+}
+
+/**
+ * Advertise a SLAP record.
+ * Announce that you host a specific Lookup Service (ls_).
+ */
+export async function cmdAdvertiseSLAP(domain?: string, service?: string): Promise<never> {
+  if (!domain || !service) {
+    return fail('Usage: advertise-slap <domain> <service>');
+  }
+
+  if (!service.startsWith('ls_')) {
+    return fail('Service must start with "ls_"');
+  }
+
+  try {
+    const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
+    const token = new PushDrop(wallet._setup.wallet);
+    
+    // SLAP format: Payload is the domain hosting the lookup service
+    const fields = [Utils.toArray(domain, 'utf8')];
+    // Context is [0, service] to identify the lookup service being advertised
+    const lockingScript = (await token.lock(fields, [0, service], '1', 'self', true, true)).toHex();
+
+    const response = await wallet._setup.wallet.createAction({
+      description: `advertise SLAP for ${service}`,
+      outputs: [{
+        lockingScript,
+        satoshis: 1,
+        outputDescription: 'SLAP advertisement',
+        basket: TOPICS.SLAP
+      }]
+    });
+
+    // Broadcast to primary overlay and SLAP trackers
+    const trackers = [
+      ...DEFAULT_SLAP_TRACKERS[NETWORK]
+    ];
+
+    const results = await broadcastToTrackers(response.tx as number[], [TOPICS.SLAP, service], trackers);
+
+    return ok({
+      advertised: 'SLAP',
+      service,
+      domain,
+      txid: response.txid,
+      broadcasts: results
+    });
+  } catch (err: any) {
+    return fail(`SLAP advertisement failed: ${err.message}`);
+  }
+}
+
+/**
+ * Helper to broadcast BEEF to multiple trackers/overlays.
+ */
+async function broadcastToTrackers(tx: number[], topics: string[], trackers: string[]) {
+  const results: Record<string, any> = {};
+  const body = new Uint8Array(tx);
+
+  for (const url of trackers) {
+    try {
+      const resp = await fetch(`${url.replace(/\/$/, '')}/submit`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/octet-stream',
+          'X-Topics': JSON.stringify(topics)
+        },
+        body
+      });
+      results[url] = resp.ok ? 'success' : `error: ${resp.status}`;
+    } catch (err: any) {
+      results[url] = `failed: ${err.message}`;
+    }
+  }
+  return results;
+}

package/src/scripts/wallet/setup.ts

@@ -97,6 +97,22 @@ export async function cmdIdentity(): Promise<never> {
   return ok({ identityKey });
 }
 
+/**
+ * Status command: show identity and balance.
+ */
+export async function cmdStatus(): Promise<never> {
+  const BSVAgentWallet = await getBSVAgentWallet();
+  const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
+  const identityKey = await wallet.getIdentityKey();
+  const total = await wallet.getBalance();
+  await wallet.destroy();
+
+  return ok({
+    identity: { identityKey, network: NETWORK },
+    balance: { walletBalance: total }
+  });
+}
+
 /**
  * Address command: show P2PKH receive address.
  */