openclaw-storage-plugin 0.1.3 → 0.1.4

package/README.md

@@ -7,10 +7,45 @@ A programmatic OpenClaw plugin that enables hash-based permanent storage for AI
 - **Efficiency**: Agents share large files via hashes instead of large message bodies.
 - **Shared Identity**: Uses the same BSV wallet as your other OpenClaw plugins.
 
+---
+
+## 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-storage-plugin": {
+        "enabled": true,
+        "storageHost": "https://storage.bsv.direct",
+        "walletDir": "~/.openclaw/bsv-wallet"
+      }
+    }
+  }
+}
+```
+
+### Options
+
+| Option | Default | Description |
+| :--- | :--- | :--- |
+| `storageHost` | `https://storage.bsv.direct` | Preferred UHRP storage host URL. |
+| `walletDir` | `~/.openclaw/bsv-wallet` | Directory where `wallet-identity.json` is stored. |
+
+---
+
 ## AI Tool: `storage`
-Agents can use the `storage` tool to:
-- `upload`: Save local content to a UHRP storage host.
-- `download`: Retrieve and verify content using a SHA256 hash.
+Agents can use the `storage` tool to perform the following actions:
+
+| Action | Description |
+| :--- | :--- |
+| `upload` | Save local content to a UHRP storage host and get its hash. |
+| `download` | Retrieve and verify content using a SHA256 hash. |
+| `list` | See all files uploaded or cached by this agent. |
+| `status` | Check storage host connection and protocol status. |
 
 ## Architecture
 Built with the **OpenClaw Plugin SDK**, this extension interfaces with UHRP storage servers to provide agents with a decentralized "hard drive."

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,5 +1,6 @@
 import path from "node:path";
 import os from "node:os";
+import { StorageManager } from "./src/client.js";
 /**
  * OpenClaw Storage Plugin
  * Enables UHRP hash-based storage for agent data.
@@ -8,17 +9,22 @@ export default function register(api) {
     const entries = api.getConfig?.()?.plugins?.entries || {};
     const entry = entries['openclaw-storage']
         || entries['openclaw-storage-plugin']
-        || entries['bsv-storage']
         || {};
     const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
     const storageHost = pluginConfig.storageHost || 'https://storage.bsv.direct';
-    const network = pluginConfig.network || 'mainnet';
     const walletDir = pluginConfig.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
-    api.logger.info(`[storage] Initializing Storage Plugin (network: ${network}, host: ${storageHost})`);
+    let manager = null;
+    api.logger.info(`[storage] Initializing Storage Plugin (host: ${storageHost})`);
+    function ensureInitialized() {
+        if (manager)
+            return manager;
+        manager = new StorageManager({ storageHost, walletDir });
+        return manager;
+    }
     // Register the storage tool
     api.registerTool({
         name: "storage",
-        description: "Hash-based permanent storage for large assets",
+        description: "Hash-based permanent storage for large assets via UHRP",
         parameters: {
             type: "object",
             properties: {
@@ -29,24 +35,37 @@ export default function register(api) {
                 },
                 data: {
                     type: "string",
-                    description: "Content to upload"
+                    description: "Content to upload (UTF-8 string)"
                 },
                 hash: {
                     type: "string",
-                    description: "UHRP hash to download"
+                    description: "SHA256 UHRP hash to download"
                 }
             },
             required: ["action"]
         },
         async execute(_id, params) {
             try {
-                // Implementation logic using @bsv/storage-server client will go here
-                return {
-                    content: [{
-                            type: "text",
-                            text: `Storage action '${params.action}' received. (Logic implementation pending)`
-                        }]
-                };
+                const m = ensureInitialized();
+                switch (params.action) {
+                    case "upload":
+                        if (!params.data)
+                            throw new Error("data is required for upload");
+                        const hash = await m.upload(params.data);
+                        return { content: [{ type: "text", text: `✅ Uploaded successfully!\nUHRP Hash: ${hash}\nURL: ${storageHost}/cdn/${hash}` }] };
+                    case "download":
+                        if (!params.hash)
+                            throw new Error("hash is required for download");
+                        const buffer = await m.download(params.hash);
+                        const content = buffer.toString('utf-8');
+                        return { content: [{ type: "text", text: `📥 Downloaded Content (Verified):\n\n${content}` }] };
+                    case "status":
+                        return { content: [{ type: "text", text: `Storage Status:\nHost: ${storageHost}\nMode: UHRP Content-Addressable` }] };
+                    case "list":
+                        return { content: [{ type: "text", text: "Local file index integration pending logic development." }] };
+                    default:
+                        throw new Error(`Unknown action: ${params.action}`);
+                }
             }
             catch (error) {
                 return {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAQ;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC;WACpC,OAAO,CAAC,yBAAyB,CAAC;WAClC,OAAO,CAAC,aAAa,CAAC;WACtB,EAAE,CAAC;IAER,MAAM,YAAY,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;IAClF,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,IAAI,4BAA4B,CAAC;IAC7E,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,IAAI,SAAS,CAAC;IAClD,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAE/F,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,mDAAmD,OAAO,WAAW,WAAW,GAAG,CAAC,CAAC;IAErG,4BAA4B;IAC5B,GAAG,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,+CAA+C;QAC5D,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC;oBAC9C,WAAW,EAAE,mBAAmB;iBACjC;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mBAAmB;iBACjC;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uBAAuB;iBACrC;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAW;YACpC,IAAI,CAAC;gBACH,qEAAqE;gBACrE,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,mBAAmB,MAAM,CAAC,MAAM,4CAA4C;yBACnF,CAAC;iBACH,CAAC;YACJ,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,UAAU,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE;yBACjD,CAAC;iBACH,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/src/client.d.ts

@@ -0,0 +1,8 @@
+import { StorageConfig } from './types.js';
+export declare class StorageManager {
+    private config;
+    constructor(config: StorageConfig);
+    upload(data: Buffer | string): Promise<string>;
+    download(hash: string): Promise<Buffer>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AAEvD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAI3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2B9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAkB9C"}

package/dist/src/client.js

@@ -0,0 +1,45 @@
+import { Utils, Hash } from '@bsv/sdk';
+export class StorageManager {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async upload(data) {
+        const buffer = typeof data === 'string' ? Buffer.from(data) : data;
+        const hash = Utils.toHex(Hash.sha256(buffer));
+        const host = this.config.storageHost.replace(/\/$/, '');
+        // 1. Check if it already exists
+        const headResp = await fetch(`${host}/cdn/${hash}`, { method: 'HEAD' });
+        if (headResp.ok)
+            return hash;
+        // 2. Upload
+        const uploadResp = await fetch(`${host}/upload`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/octet-stream',
+                'X-UHRP-Hash': hash
+            },
+            body: buffer
+        });
+        if (!uploadResp.ok) {
+            const err = await uploadResp.text();
+            throw new Error(`Upload failed: ${uploadResp.status} ${err}`);
+        }
+        return hash;
+    }
+    async download(hash) {
+        const host = this.config.storageHost.replace(/\/$/, '');
+        const resp = await fetch(`${host}/cdn/${hash}`);
+        if (!resp.ok) {
+            throw new Error(`Download failed: ${resp.status}`);
+        }
+        const buffer = Buffer.from(await resp.arrayBuffer());
+        // Integrity verification
+        const downloadedHash = Utils.toHex(Hash.sha256(buffer));
+        if (downloadedHash !== hash) {
+            throw new Error(`Integrity check failed: Expected ${hash}, got ${downloadedHash}`);
+        }
+        return buffer;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGvC,MAAM,OAAO,cAAc;IACjB,MAAM,CAAgB;IAE9B,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAqB;QAChC,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAExD,gCAAgC;QAChC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,QAAQ,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,IAAI,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAE7B,YAAY;QACZ,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,SAAS,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,0BAA0B;gBAC1C,aAAa,EAAE,IAAI;aACpB;YACD,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,kBAAkB,UAAU,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,QAAQ,IAAI,EAAE,CAAC,CAAC;QAEhD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAErD,yBAAyB;QACzB,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,SAAS,cAAc,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,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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"}

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

@@ -0,0 +1,95 @@
+/**
+ * @a2a-bsv/core — Type definitions for agent-to-agent BSV payments.
+ */
+/** Wallet configuration for creating or loading an agent wallet. */
+export interface WalletConfig {
+    /** BSV network to use. */
+    network: 'mainnet' | 'testnet';
+    /** Directory path for SQLite wallet persistence. */
+    storageDir: string;
+    /** Optional: pre-existing root private key hex. If omitted on create(), a new one is generated. */
+    rootKeyHex?: string;
+    /** Optional TAAL API key for ARC broadcasting. Falls back to public default. */
+    taalApiKey?: string;
+    /** Optional fee model in sat/KB. Falls back to BSV_FEE_MODEL env var or default 100 sat/KB. */
+    feeModel?: number;
+}
+/** Parameters for building a payment transaction. */
+export interface PaymentParams {
+    /** Recipient's compressed public key (hex) or BSV address. */
+    to: string;
+    /** Amount to pay in satoshis. */
+    satoshis: number;
+    /** Human-readable description (5-50 chars per BRC-100). */
+    description?: string;
+    /** Optional metadata embedded as OP_RETURN (future use). */
+    metadata?: {
+        taskId?: string;
+        protocol?: string;
+    };
+}
+/** Result from building a payment. */
+export interface PaymentResult {
+    /** Base64-encoded Atomic BEEF transaction data. */
+    beef: string;
+    /** Transaction ID (hex). */
+    txid: string;
+    /** Amount paid in satoshis. */
+    satoshis: number;
+    /** BRC-29 derivation prefix (base64). Needed by recipient to internalize. */
+    derivationPrefix: string;
+    /** BRC-29 derivation suffix (base64). Needed by recipient to internalize. */
+    derivationSuffix: string;
+    /** Sender's identity key (compressed hex). Needed by recipient to internalize. */
+    senderIdentityKey: string;
+}
+/** Parameters for verifying an incoming payment. */
+export interface VerifyParams {
+    /** Base64-encoded Atomic BEEF data. */
+    beef: string;
+    /** Expected payment amount in satoshis. */
+    expectedAmount?: number;
+    /** Expected sender identity key (optional). */
+    expectedSender?: string;
+}
+/** Result from verifying a payment. */
+export interface VerifyResult {
+    /** Whether the payment passes all checks. */
+    valid: boolean;
+    /** Transaction ID (hex). */
+    txid: string;
+    /** Number of outputs found in the transaction. */
+    outputCount: number;
+    /** Errors encountered during verification. */
+    errors: string[];
+}
+/** Parameters for accepting (internalizing) a verified payment. */
+export interface AcceptParams {
+    /** Base64-encoded Atomic BEEF data. */
+    beef: string;
+    /** The output index to internalize (default: 0). */
+    vout?: number;
+    /** BRC-29 derivation prefix from the PaymentResult. */
+    derivationPrefix: string;
+    /** BRC-29 derivation suffix from the PaymentResult. */
+    derivationSuffix: string;
+    /** Sender's identity key from the PaymentResult. */
+    senderIdentityKey: string;
+    /** Human-readable description for wallet records (5-50 chars). */
+    description?: string;
+}
+/** Result from accepting a payment. */
+export interface AcceptResult {
+    /** Whether the payment was accepted. */
+    accepted: boolean;
+}
+/** Serializable wallet identity info, persisted alongside the SQLite database. */
+export interface WalletIdentity {
+    /** The root private key (hex). Guard this carefully. */
+    rootKeyHex: string;
+    /** The wallet's public identity key (compressed hex). */
+    identityKey: string;
+    /** Network this wallet targets. */
+    network: 'mainnet' | 'testnet';
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC"}

package/dist/src/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * @a2a-bsv/core — Type definitions for agent-to-agent BSV payments.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,29 @@
+/**
+ * @a2a-bsv/core — Payment verification and acceptance helpers.
+ *
+ * Verification: parse the Atomic BEEF, validate structure.
+ * Acceptance: internalize the payment into the recipient wallet via BRC-29
+ * wallet payment protocol.
+ */
+import type { SetupWallet } from '@bsv/wallet-toolbox';
+import type { VerifyParams, VerifyResult, AcceptParams, AcceptResult } from './types.js';
+/**
+ * Verify an incoming Atomic BEEF payment.
+ *
+ * This performs structural validation:
+ * - Decodes the base64 BEEF
+ * - Checks the BEEF is parseable
+ * - Checks there is at least one transaction
+ * - Runs SPV verification via tx.verify()
+ * - Optionally checks the sender identity key
+ */
+export declare function verifyPayment(params: VerifyParams): Promise<VerifyResult>;
+/**
+ * Accept (internalize) a verified BRC-29 payment into the recipient's wallet.
+ *
+ * This calls wallet.internalizeAction with the 'wallet payment' protocol,
+ * providing the BRC-29 derivation info so the wallet can derive the correct
+ * key and claim the output.
+ */
+export declare function acceptPayment(setup: SetupWallet, params: AcceptParams): Promise<AcceptResult>;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/core/verify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGzF;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAkD/E;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CA2BvB"}