openclaw-messagebox-plugin 0.1.3 → 0.1.5

package/README.md

@@ -8,12 +8,51 @@ A programmatic OpenClaw plugin that enables secure, P2P encrypted messaging and
 - **Real-time Hooks**: Real-time agent wake-ups via WebSockets.
 - **Direct P2P Payments**: Integrated PeerPay support for machine-to-machine commerce.
 
+---
+
+## Configuration
+
+You can configure the plugin in your `openclaw.json` file. The plugin supports both a flat structure and a nested `config` object under its ID.
+
+### Example Configuration
+```json
+{
+  "plugins": {
+    "entries": {
+      "openclaw-messagebox-plugin": {
+        "enabled": true,
+        "host": "https://msg.bsv.direct",
+        "chaintracksUrl": "https://chaintracks-us-1.bsvb.tech",
+        "arcUrl": "https://arc.gorillapool.io",
+        "walletDir": "~/.openclaw/bsv-wallet"
+      }
+    }
+  }
+}
+```
+
+### Options
+
+| Option | Default | Description |
+| :--- | :--- | :--- |
+| `host` | `https://msg.bsv.direct` | The MessageBox server host URL. |
+| `chaintracksUrl`| `https://chaintracks-us-1.bsvb.tech` | Custom server for SPV block header verification. |
+| `arcUrl` | `https://arc.gorillapool.io` | Custom ARC/Arcade server for transaction broadcasting. |
+| `walletDir` | `~/.openclaw/bsv-wallet` | Directory where `wallet-identity.json` is stored. |
+| `dbPath` | (auto-generated) | Path to the local SQLite database for message history. |
+
+---
+
 ## AI Tool: `messagebox`
-Agents can use the `messagebox` tool to:
-- `send`: Deliver encrypted messages to other identities.
-- `inbox`: Retrieve and decrypt incoming messages.
-- `acknowledge`: Clean up the server-side inbox after processing.
-- `pay`: Send direct P2P BSV payments.
+Agents can use the `messagebox` tool to perform the following actions:
+
+| Action | Description |
+| :--- | :--- |
+| `send` | Deliver an encrypted message to another agent's identity key. |
+| `inbox` | Retrieve and decrypt incoming messages from your mailbox. |
+| `acknowledge` | Mark messages as processed to remove them from the server. |
+| `pay` | Send a direct peer-to-peer BSV payment via messaging. |
+| `status` | Show connection status, host, and your identity key. |
 
 ## Architecture
 Built with the **OpenClaw Plugin SDK**, this extension uses:

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QA2ExC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QAyJxC"}

package/dist/index.js

@@ -1,19 +1,43 @@
 import path from "node:path";
 import os from "node:os";
+import { MessageBoxManager } from "./src/client.js";
+import { MessageStore } from "./src/store.js";
+import { BSVAgentWallet } from "./src/core/wallet.js";
 /**
  * OpenClaw MessageBox Plugin
  * Enables secure P2P encrypted messaging and payments.
  */
 export default function register(api) {
-    // Capture configuration from the gateway (handle both flat and nested structures)
-    const entry = api.getConfig?.()?.plugins?.entries?.['openclaw-messagebox'] || {};
+    // Capture configuration from the gateway (handle multiple IDs and flat/nested structures)
+    const entries = api.getConfig?.()?.plugins?.entries || {};
+    const entry = entries['openclaw-messagebox']
+        || entries['openclaw-messagebox-plugin']
+        || entries['bsv-messagebox']
+        || {};
     const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
     const host = pluginConfig.host || 'https://msg.bsv.direct';
     const network = pluginConfig.network || 'mainnet';
     const chaintracksUrl = pluginConfig.chaintracksUrl || 'https://chaintracks-us-1.bsvb.tech';
-    const arcUrl = pluginConfig.arcUrl || '';
+    const arcUrl = pluginConfig.arcUrl || (network === 'testnet' ? 'https://testnet.arc.gorillapool.io' : 'https://arc.gorillapool.io');
     const walletDir = pluginConfig.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
-    api.logger.info(`[messagebox] Initializing MessageBox Plugin (network: ${network}, host: ${host}, chaintracks: ${chaintracksUrl}, arc: ${arcUrl || 'default'})`);
+    const dbPath = pluginConfig.dbPath || path.join(os.homedir(), '.openclaw', 'openclaw-messagebox', 'messages.sqlite');
+    let manager = null;
+    let store = null;
+    let wallet = null;
+    api.logger.info(`[messagebox] Initializing MessageBox Plugin (network: ${network}, host: ${host})`);
+    async function ensureInitialized() {
+        if (manager)
+            return manager;
+        // Initialize shared wallet
+        wallet = await BSVAgentWallet.load({
+            network: network,
+            storageDir: walletDir
+        });
+        store = new MessageStore(dbPath);
+        await store.init();
+        manager = new MessageBoxManager({ host, walletDir, dbPath }, store, wallet);
+        return manager;
+    }
     // Register the messagebox tool
     api.registerTool({
         name: "messagebox",
@@ -34,6 +58,11 @@ export default function register(api) {
                     type: "string",
                     description: "Message content (will be encrypted client-side)"
                 },
+                box: {
+                    type: "string",
+                    default: "default",
+                    description: "Target mailbox/folder"
+                },
                 sats: {
                     type: "number",
                     description: "Amount in satoshis for direct P2P payment"
@@ -48,13 +77,41 @@ export default function register(api) {
         },
         async execute(_id, params) {
             try {
-                // Implementation logic will go here
-                return {
-                    content: [{
-                            type: "text",
-                            text: `MessageBox action '${params.action}' received. (Logic implementation pending)`
-                        }]
-                };
+                const m = await ensureInitialized();
+                switch (params.action) {
+                    case "send":
+                        if (!params.recipientKey || !params.body)
+                            throw new Error("recipientKey and body required");
+                        const msgId = await m.send(params.recipientKey, params.body, params.box);
+                        return { content: [{ type: "text", text: `✅ Message sent successfully. ID: ${msgId}` }] };
+                    case "inbox":
+                        await m.poll(params.box);
+                        const messages = await store.getInbox();
+                        if (messages.length === 0)
+                            return { content: [{ type: "text", text: "Your inbox is empty." }] };
+                        const list = messages.map(msg => `[${new Date(msg.ts).toLocaleString()}] FROM: ${msg.senderKey.slice(0, 12)}... - "${msg.body}"`).join('\n');
+                        return { content: [{ type: "text", text: `📬 Inbox (Last ${messages.length} messages):\n\n${list}` }] };
+                    case "acknowledge":
+                        if (!params.messageIds || params.messageIds.length === 0)
+                            throw new Error("messageIds array required");
+                        await m.acknowledge(params.messageIds);
+                        return { content: [{ type: "text", text: `✅ Acknowledged ${params.messageIds.length} messages.` }] };
+                    case "status":
+                        return { content: [{ type: "text", text: `MessageBox Status:\nHost: ${host}\nIdentity: ${m.getIdentityKey()}\nDatabase: ${dbPath}` }] };
+                    case "pay":
+                        if (!params.recipientKey || !params.sats)
+                            throw new Error("recipientKey and sats required");
+                        const payResult = await wallet.createPayment({
+                            to: params.recipientKey,
+                            satoshis: params.sats,
+                            description: "P2P Payment via MessageBox"
+                        });
+                        // Send the BEEF payment as a message to the recipient's payment_inbox
+                        const pmsgId = await m.send(params.recipientKey, JSON.stringify(payResult), 'payment_inbox');
+                        return { content: [{ type: "text", text: `✅ P2P Payment sent! Amount: ${params.sats} sats. Notification ID: ${pmsgId}` }] };
+                    default:
+                        throw new Error(`Unknown action: ${params.action}`);
+                }
             }
             catch (error) {
                 return {
@@ -70,11 +127,25 @@ export default function register(api) {
     api.registerService({
         id: "messagebox-listener",
         start: async () => {
-            api.logger.info("[messagebox] Starting WebSocket listener...");
-            // Logic for client.listenForLiveMessages goes here
+            try {
+                const m = await ensureInitialized();
+                api.logger.info("[messagebox] Starting WebSocket listener...");
+                await m.listen((msg) => {
+                    api.logger.info(`[messagebox] ⚡ New message from ${msg.senderKey.slice(0, 12)}...`);
+                    // Wake the agent to handle the incoming private message
+                    const wakeText = `⚡ New private message received!\n\nFrom: ${msg.senderKey}\nMessage: ${msg.body}\n\nYou can reply using messagebox({ action: "send", recipientKey: "${msg.senderKey}", body: "..." })`;
+                    api.wakeAgent?.({
+                        prompt: wakeText,
+                        sessionKey: `hook:messagebox:${msg.id}`
+                    });
+                });
+            }
+            catch (err) {
+                api.logger.error(`[messagebox] WebSocket listener failed: ${err.message}`);
+            }
         },
         stop: async () => {
-            api.logger.info("[messagebox] Stopping MessageBox WebSocket listener...");
+            api.logger.info("[messagebox] Stopping WebSocket listener...");
         }
     });
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/src/client.d.ts

@@ -1,9 +1,16 @@
 import { MessageBoxConfig, MessageRecord } from './types.js';
+import { MessageStore } from './store.js';
+import { BSVAgentWallet } from './core/wallet.js';
 export declare class MessageBoxManager {
     private client;
-    constructor(_config: MessageBoxConfig);
-    send(_recipientKey: string, _body: string, _box?: string): Promise<string>;
-    poll(_box?: string): Promise<MessageRecord[]>;
-    acknowledge(_messageIds: string[]): Promise<void>;
+    private privKey;
+    private store;
+    private wallet;
+    constructor(config: MessageBoxConfig, store: MessageStore, wallet: BSVAgentWallet);
+    send(recipientKey: string, body: string, box?: string): Promise<string>;
+    poll(box?: string): Promise<MessageRecord[]>;
+    acknowledge(messageIds: string[]): Promise<void>;
+    listen(onMessage: (msg: MessageRecord) => void): Promise<void>;
+    getIdentityKey(): string;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,OAAO,EAAE,gBAAgB;IAK/B,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrF,IAAI,CAAC,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAMxD,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE;CAGxC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc;IAoB3E,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBlF,IAAI,CAAC,GAAG,GAAE,MAAkB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA4BvD,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE;IAMhC,MAAM,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI;IAwBpD,cAAc,IAAI,MAAM;CAGzB"}

package/dist/src/client.js

@@ -1,21 +1,102 @@
+import { MessageBoxClient } from '@bsv/message-box-client';
+import { PrivateKey } from '@bsv/sdk';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
 export class MessageBoxManager {
     client;
-    constructor(_config) {
-        // Note: MessageBoxClient requires a WalletClient/Identity
-        // This will be initialized in an async init method or similar
+    privKey;
+    store;
+    wallet;
+    constructor(config, store, wallet) {
+        const identityPath = path.join(config.walletDir, 'wallet-identity.json');
+        if (!fs.existsSync(identityPath)) {
+            throw new Error(`Identity file not found at ${identityPath}. Please onboard your agent first.`);
+        }
+        const identity = JSON.parse(fs.readFileSync(identityPath, 'utf-8'));
+        this.privKey = PrivateKey.fromHex(identity.rootKeyHex);
+        this.store = store;
+        this.wallet = wallet;
+        // Initialize the MessageBoxClient with correct SDK-style wallet interface
+        // @ts-ignore
+        this.client = new MessageBoxClient({
+            host: config.host,
+            walletClient: this.wallet._setup.wallet,
+            networkPreset: config.walletDir.includes('testnet') ? 'testnet' : 'mainnet'
+        });
     }
-    async send(_recipientKey, _body, _box = 'default') {
-        // 1. Encrypt body for recipient
-        // 2. Call client.sendMessage
-        return "msg_id";
+    async send(recipientKey, body, box = 'default') {
+        // sendMessage handles BRC-2 encryption internally using the walletClient
+        // @ts-ignore
+        const response = await this.client.sendMessage({
+            recipient: recipientKey,
+            messageBox: box,
+            body: body
+        });
+        // Save to local store
+        await this.store.saveMessage({
+            id: response.messageId,
+            senderKey: this.privKey.toPublicKey().toString(),
+            recipientKey,
+            body, // store decrypted locally
+            box,
+            ts: Date.now(),
+            acknowledged: false
+        });
+        return response.messageId;
     }
-    async poll(_box = 'default') {
-        // 1. Call client.listMessages
-        // 2. Decrypt and format
-        return [];
+    async poll(box = 'default') {
+        // listMessages handles BRC-2 decryption internally using the walletClient
+        // @ts-ignore
+        const messages = await this.client.listMessages({ messageBox: box });
+        const records = [];
+        for (const msg of messages) {
+            const record = {
+                // @ts-ignore
+                id: msg.id || msg.messageId,
+                // @ts-ignore
+                senderKey: msg.sender || msg.senderKey,
+                recipientKey: this.privKey.toPublicKey().toString(),
+                body: typeof msg.body === 'string' ? msg.body : JSON.stringify(msg.body),
+                // @ts-ignore
+                box: msg.box || box,
+                // @ts-ignore
+                ts: msg.timestamp || Date.now(),
+                acknowledged: false
+            };
+            await this.store.saveMessage(record);
+            records.push(record);
+        }
+        return records;
     }
-    async acknowledge(_messageIds) {
-        // Call client.acknowledgeMessage
+    async acknowledge(messageIds) {
+        // @ts-ignore
+        await this.client.acknowledgeMessage({ messageIds });
+        await this.store.markAcknowledged(messageIds);
+    }
+    async listen(onMessage) {
+        // @ts-ignore
+        return this.client.listenForLiveMessages({
+            messageBox: 'default',
+            onMessage: async (msg) => {
+                const record = {
+                    // @ts-ignore
+                    id: msg.id || msg.messageId,
+                    // @ts-ignore
+                    senderKey: msg.sender || msg.senderKey,
+                    recipientKey: this.privKey.toPublicKey().toString(),
+                    body: typeof msg.body === 'string' ? msg.body : JSON.stringify(msg.body),
+                    // @ts-ignore
+                    box: msg.box || 'default',
+                    ts: Date.now(),
+                    acknowledged: false
+                };
+                await this.store.saveMessage(record);
+                onMessage(record);
+            }
+        });
+    }
+    getIdentityKey() {
+        return this.privKey.toPublicKey().toString();
     }
 }
 //# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAoB;IAElC,YAAY,OAAyB;QACnC,0DAA0D;QAC1D,8DAA8D;IAChE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,aAAqB,EAAE,KAAa,EAAE,OAAe,SAAS;QACvE,gCAAgC;QAChC,6BAA6B;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAe,SAAS;QACjC,8BAA8B;QAC9B,wBAAwB;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,WAAqB;QACrC,iCAAiC;IACnC,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAmB;IACzB,OAAO,CAAa;IACpB,KAAK,CAAe;IACpB,MAAM,CAAiB;IAE/B,YAAY,MAAwB,EAAE,KAAmB,EAAE,MAAsB;QAC/E,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;QACzE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,8BAA8B,YAAY,oCAAoC,CAAC,CAAC;QAClG,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,0EAA0E;QAC1E,aAAa;QACb,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC;YACjC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM;YACvC,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SAC5E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,YAAoB,EAAE,IAAY,EAAE,MAAc,SAAS;QACpE,yEAAyE;QACzE,aAAa;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;YAC7C,SAAS,EAAE,YAAY;YACvB,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,sBAAsB;QACtB,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;YAC3B,EAAE,EAAE,QAAQ,CAAC,SAAS;YACtB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;YAChD,YAAY;YACZ,IAAI,EAAE,0BAA0B;YAChC,GAAG;YACH,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc,SAAS;QAChC,0EAA0E;QAC1E,aAAa;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,MAAM,OAAO,GAAoB,EAAE,CAAC;QAEpC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAkB;gBAC5B,aAAa;gBACb,EAAE,EAAE,GAAG,CAAC,EAAE,IAAK,GAAW,CAAC,SAAS;gBACpC,aAAa;gBACb,SAAS,EAAE,GAAG,CAAC,MAAM,IAAK,GAAW,CAAC,SAAS;gBAC/C,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;gBACnD,IAAI,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;gBACxE,aAAa;gBACb,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG;gBACnB,aAAa;gBACb,EAAE,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;gBAC/B,YAAY,EAAE,KAAK;aACpB,CAAC;YAEF,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,UAAoB;QACpC,aAAa;QACb,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAuC;QAClD,aAAa;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC;YACvC,UAAU,EAAE,SAAS;YACrB,SAAS,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;gBAC5B,MAAM,MAAM,GAAkB;oBAC5B,aAAa;oBACb,EAAE,EAAE,GAAG,CAAC,EAAE,IAAK,GAAW,CAAC,SAAS;oBACpC,aAAa;oBACb,SAAS,EAAE,GAAG,CAAC,MAAM,IAAK,GAAW,CAAC,SAAS;oBAC/C,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;oBACnD,IAAI,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;oBACxE,aAAa;oBACb,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,SAAS;oBACzB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;oBACd,YAAY,EAAE,KAAK;iBACpB,CAAC;gBAEF,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBACrC,SAAS,CAAC,MAAM,CAAC,CAAC;YACpB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC/C,CAAC;CACF"}

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

@@ -0,0 +1,12 @@
+/**
+ * @a2a-bsv/core — Configuration defaults and helpers.
+ */
+import type { WalletConfig } from './types.js';
+/** Map our 'mainnet'/'testnet' to the wallet-toolbox's 'main'/'test' chain type. */
+export type Chain = 'main' | 'test';
+export declare function toChain(network: WalletConfig['network']): Chain;
+/** Default TAAL API keys from the wallet-toolbox examples. */
+export declare const DEFAULT_TAAL_API_KEYS: Record<Chain, string>;
+/** Default SQLite database name. */
+export declare const DEFAULT_DB_NAME = "a2a_agent_wallet";
+//# sourceMappingURL=config.d.ts.map

package/dist/src/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,oFAAoF;AACpF,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpC,wBAAgB,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,GAAG,KAAK,CAE/D;AAED,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAGvD,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,eAAe,qBAAqB,CAAC"}

package/dist/src/core/config.js

@@ -0,0 +1,14 @@
+/**
+ * @a2a-bsv/core — Configuration defaults and helpers.
+ */
+export function toChain(network) {
+    return network === 'mainnet' ? 'main' : 'test';
+}
+/** Default TAAL API keys from the wallet-toolbox examples. */
+export const DEFAULT_TAAL_API_KEYS = {
+    main: 'mainnet_9596de07e92300c6287e4393594ae39c',
+    test: 'testnet_0e6cf72133b43ea2d7861da2a38684e3',
+};
+/** Default SQLite database name. */
+export const DEFAULT_DB_NAME = 'a2a_agent_wallet';
+//# sourceMappingURL=config.js.map

package/dist/src/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,UAAU,OAAO,CAAC,OAAgC;IACtD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACjD,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAA0B;IAC1D,IAAI,EAAE,0CAA0C;IAChD,IAAI,EAAE,0CAA0C;CACjD,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * @a2a-bsv/core — Agent-to-agent BSV payment library.
+ *
+ * Wraps @bsv/sdk and @bsv/wallet-toolbox to provide a clean, minimal API
+ * for AI agents to pay each other using BSV blockchain transactions.
+ *
+ * @example
+ * ```ts
+ * import { BSVAgentWallet } from '@a2a-bsv/core';
+ *
+ * const wallet = await BSVAgentWallet.load({
+ *   network: 'testnet',
+ *   storageDir: './my-agent-wallet',
+ * });
+ *
+ * const identityKey = await wallet.getIdentityKey();
+ * console.log('My identity:', identityKey);
+ * ```
+ */
+export { BSVAgentWallet } from './wallet.js';
+export type { WalletConfig, WalletIdentity, PaymentParams, PaymentResult, VerifyParams, VerifyResult, AcceptParams, AcceptResult, } from './types.js';
+export { toChain, DEFAULT_TAAL_API_KEYS, DEFAULT_DB_NAME } from './config.js';
+export type { Chain } from './config.js';
+export { buildPayment } from './payment.js';
+export { verifyPayment, acceptPayment } from './verify.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9E,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/core/index.js

@@ -0,0 +1,27 @@
+/**
+ * @a2a-bsv/core — Agent-to-agent BSV payment library.
+ *
+ * Wraps @bsv/sdk and @bsv/wallet-toolbox to provide a clean, minimal API
+ * for AI agents to pay each other using BSV blockchain transactions.
+ *
+ * @example
+ * ```ts
+ * import { BSVAgentWallet } from '@a2a-bsv/core';
+ *
+ * const wallet = await BSVAgentWallet.load({
+ *   network: 'testnet',
+ *   storageDir: './my-agent-wallet',
+ * });
+ *
+ * const identityKey = await wallet.getIdentityKey();
+ * console.log('My identity:', identityKey);
+ * ```
+ */
+// Main wallet class
+export { BSVAgentWallet } from './wallet.js';
+// Config helpers (for advanced use)
+export { toChain, DEFAULT_TAAL_API_KEYS, DEFAULT_DB_NAME } from './config.js';
+// Lower-level helpers (for advanced use)
+export { buildPayment } from './payment.js';
+export { verifyPayment, acceptPayment } from './verify.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAc7C,oCAAoC;AACpC,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9E,yCAAyC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * @a2a-bsv/core — Payment construction helpers.
+ *
+ * Uses BRC-29 key derivation so the recipient can internalize the payment
+ * without ever reusing an address.
+ */
+import type { SetupWallet } from '@bsv/wallet-toolbox';
+import type { PaymentParams, PaymentResult } from './types.js';
+/**
+ * Build a BRC-29 payment transaction using the wallet's createAction API.
+ *
+ * The transaction is created with `acceptDelayedBroadcast: false` — the sender
+ * broadcasts immediately. The resulting Atomic BEEF and derivation metadata are
+ * returned so the recipient can verify and internalize the payment on their side.
+ */
+export declare function buildPayment(setup: SetupWallet, params: PaymentParams): Promise<PaymentResult>;
+//# sourceMappingURL=payment.d.ts.map

package/dist/src/core/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../../src/core/payment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG/D;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CA8ExB"}

package/dist/src/core/payment.js

@@ -0,0 +1,95 @@
+/**
+ * @a2a-bsv/core — Payment construction helpers.
+ *
+ * Uses BRC-29 key derivation so the recipient can internalize the payment
+ * without ever reusing an address.
+ */
+import { Beef, Utils } from '@bsv/sdk';
+import { randomBytesBase64, ScriptTemplateBRC29 } from '@bsv/wallet-toolbox';
+/**
+ * Build a BRC-29 payment transaction using the wallet's createAction API.
+ *
+ * The transaction is created with `acceptDelayedBroadcast: false` — the sender
+ * broadcasts immediately. The resulting Atomic BEEF and derivation metadata are
+ * returned so the recipient can verify and internalize the payment on their side.
+ */
+export async function buildPayment(setup, params) {
+    const { to, satoshis, description } = params;
+    const desc = normalizeDescription(description ?? 'agent payment');
+    // Generate unique BRC-29 derivation prefixes and suffixes
+    const derivationPrefix = randomBytesBase64(8);
+    const derivationSuffix = randomBytesBase64(8);
+    // Build BRC-29 locking script
+    const keyDeriver = setup.keyDeriver;
+    const t = new ScriptTemplateBRC29({
+        derivationPrefix,
+        derivationSuffix,
+        keyDeriver,
+    });
+    // Determine the recipient identity key.
+    // If `to` is a compressed public key hex (66 chars, starts with 02/03), use directly.
+    // Otherwise treat as an address — for BRC-29 we need a public key.
+    let recipientPubKey;
+    if (/^0[23][0-9a-fA-F]{64}$/.test(to)) {
+        recipientPubKey = to;
+    }
+    else {
+        // If it's an address, we can't do BRC-29 (needs pubkey). Throw a clear error.
+        throw new Error('PaymentParams.to must be a compressed public key (hex) for BRC-29 payments. ' +
+            'Raw BSV addresses are not supported — the recipient must share their identity key.');
+    }
+    const lockingScript = t.lock(setup.rootKey.toString(), recipientPubKey);
+    const label = 'a2a-payment';
+    const car = await setup.wallet.createAction({
+        outputs: [
+            {
+                lockingScript: lockingScript.toHex(),
+                satoshis,
+                outputDescription: desc,
+                tags: ['relinquish'],
+                customInstructions: JSON.stringify({
+                    derivationPrefix,
+                    derivationSuffix,
+                    type: 'BRC29',
+                }),
+            },
+        ],
+        options: {
+            randomizeOutputs: false,
+            acceptDelayedBroadcast: false,
+        },
+        labels: [label],
+        description: desc,
+    });
+    // Extract the txid from the createAction result.
+    // The tx field is a number[] (AtomicBEEF binary). Parse it to get txid.
+    if (!car.tx) {
+        throw new Error('createAction did not return a transaction. Check wallet funding.');
+    }
+    const beef = Beef.fromBinary(car.tx);
+    // The last transaction in the beef is our new tx
+    const lastTx = beef.txs[beef.txs.length - 1];
+    const txid = lastTx.txid;
+    // Encode the atomic BEEF as base64
+    const atomicBinary = beef.toBinaryAtomic(txid);
+    const beefBase64 = Utils.toBase64(atomicBinary);
+    return {
+        beef: beefBase64,
+        txid,
+        satoshis,
+        derivationPrefix,
+        derivationSuffix,
+        senderIdentityKey: setup.identityKey,
+    };
+}
+/**
+ * Ensure description meets BRC-100's 5-50 character requirement.
+ */
+function normalizeDescription(desc) {
+    if (desc.length < 5)
+        return desc.padEnd(5, ' ');
+    if (desc.length > 50)
+        return desc.slice(0, 50);
+    return desc;
+}
+//# sourceMappingURL=payment.js.map

package/dist/src/core/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../../src/core/payment.ts"],"names":[],"mappings":"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"}