openclaw-simplesv-plugin 0.1.4 → 0.1.6

package/README.md

@@ -9,25 +9,65 @@ A programmatic OpenClaw plugin that provides a high-level blockchain "Utility Be
 - **Verifiable Credentials**: Issue W3C-compatible credentials for agents.
 - **Optional MCP Integration**: Mount advanced tools from the `@bsv/simple-mcp` ecosystem.
 
+---
+
+## 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-simplesv-plugin": {
+        "enabled": true,
+        "network": "mainnet",
+        "enableMcp": true,
+        "chaintracksUrl": "https://chaintracks-us-1.bsvb.tech",
+        "arcUrl": "https://arc.gorillapool.io",
+        "walletDir": "~/.openclaw/bsv-wallet"
+      }
+    }
+  }
+}
+```
+
+### Options
+
+| Option | Default | Description |
+| :--- | :--- | :--- |
+| `network` | `mainnet` | The BSV network to target (`mainnet` or `testnet`). |
+| `enableMcp` | `false` | Enable advanced Model Context Protocol tools if `@bsv/simple-mcp` is installed. |
+| `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` and local databases are stored. |
+
+---
+
 ## AI Tool: `simplesv`
-Agents can use the `simplesv` tool to:
-- `inscribe`: Store permanent JSON/Text records.
-- `token_issue`: Create new digital assets or state.
-- `token_transfer`: Send assets to other agents.
-- `resolve_did`: Look up agent profiles and public keys.
-- `vc_issue`: Certify facts about other agents (Web of Trust).
-- `pay_p2p`: Standard peer-to-peer payments.
+Agents can use the `simplesv` tool to perform the following actions:
+
+| Action | Description |
+| :--- | :--- |
+| `inscribe` | Store permanent JSON or Text records on the blockchain. |
+| `token_issue` | Create new digital assets or stateful tokens. |
+| `token_transfer` | Send ownership of a token to another agent's identity key. |
+| `resolve_did` | Look up agent profiles and public keys via their `did:bsv`. |
+| `vc_issue` | Certify facts about other agents to build a Web of Trust. |
+| `pay_p2p` | Send standard peer-to-peer satoshi payments. |
+| `status` | Display the agent's current identity key, DID, and wallet balance. |
 
 ## Advanced MCP Tools (Optional)
-When enabled, the plugin automatically mounts advanced tools from the Model Context Protocol server, prefixing them with `simplesv_`:
-- `simplesv_decode_tx`: Detail transaction analysis.
+When `enableMcp` is set to `true` and the library is installed, the plugin automatically mounts advanced tools from the Model Context Protocol server, prefixing them with `simplesv_`:
+- `simplesv_decode_tx`: Detailed transaction analysis.
 - `simplesv_brc_lookup`: Search blockchain standards documentation.
 - ...and many more from the `@bsv/simple-mcp` library.
 
 ## Architecture
 Built with the **OpenClaw Plugin SDK**, this extension uses:
 - `@bsv/simple` for high-level blockchain APIs.
-- `@bsv/sdk` for identity and crypto.
+- `@bsv/sdk` for identity and cryptography.
 - Shared wallet identity with other OpenClaw BSV plugins.
 
 ## License

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+declare module "@bsv/simple-mcp";
 /**
  * OpenClaw SimpleSV Plugin
  * High-level blockchain utility belt (DIDs, Tokens, Inscriptions).

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,QA6GxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAOA,OAAO,QAAQ,iBAAiB,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QAoKxC"}

package/dist/index.js

@@ -1,18 +1,39 @@
 import path from "node:path";
 import os from "node:os";
+import { SimpleSVManager } from "./src/actions.js";
+import { ClawWalletCore } from "./src/wallet.js";
+import { BSVAgentWallet } from "./src/core/wallet.js";
 /**
  * OpenClaw SimpleSV Plugin
  * High-level blockchain utility belt (DIDs, Tokens, Inscriptions).
  */
 export default function register(api) {
-    const entry = api.getConfig?.()?.plugins?.entries?.['openclaw-simplesv'] || {};
+    const entries = api.getConfig?.()?.plugins?.entries || {};
+    const entry = entries['openclaw-simplesv']
+        || entries['openclaw-simplesv-plugin']
+        || entries['bsv-simple']
+        || {};
     const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
     const network = pluginConfig.network || 'mainnet';
     const chaintracksUrl = pluginConfig.chaintracksUrl || 'https://chaintracks-us-1.bsvb.tech';
+    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');
     const enableMcp = pluginConfig.enableMcp === true;
-    api.logger.info(`[simplesv] Initializing SimpleSV Plugin (network: ${network}, chaintracks: ${chaintracksUrl})`);
-    // Register the base simplesv tool
+    let manager = null;
+    api.logger.info(`[simplesv] Initializing SimpleSV Plugin (network: ${network}, host: ${chaintracksUrl}, arc: ${arcUrl})`);
+    async function ensureInitialized() {
+        if (manager)
+            return manager;
+        // Initialize shared wallet
+        const wallet = await BSVAgentWallet.load({
+            network: network,
+            storageDir: walletDir
+        });
+        const core = new ClawWalletCore(wallet);
+        manager = new SimpleSVManager(core);
+        return manager;
+    }
+    // Register the simplesv tool
     api.registerTool({
         name: "simplesv",
         description: "High-level BSV utility belt: DIDs, Tokens, and Inscriptions",
@@ -58,19 +79,49 @@ export default function register(api) {
                 basket: {
                     type: "string",
                     description: "Basket name for tokens"
+                },
+                tokenId: {
+                    type: "string",
+                    description: "ID of the token to transfer"
                 }
             },
             required: ["action"]
         },
         async execute(_id, params) {
             try {
-                // Implementation logic using @bsv/simple will go here
-                return {
-                    content: [{
-                            type: "text",
-                            text: `SimpleSV action '${params.action}' received. (Logic implementation pending)`
-                        }]
-                };
+                const m = await ensureInitialized();
+                switch (params.action) {
+                    case "inscribe":
+                        const insResult = await m.inscribe(params.data, params.text);
+                        return { content: [{ type: "text", text: `✅ Inscription created! TXID: ${insResult.txid}` }] };
+                    case "resolve_did":
+                        if (!params.did)
+                            throw new Error("did is required");
+                        const didDoc = await m.resolveDid(params.did);
+                        return { content: [{ type: "text", text: `Decoded DID Document:\n${JSON.stringify(didDoc, null, 2)}` }] };
+                    case "token_issue":
+                        if (!params.basket || !params.data)
+                            throw new Error("basket and data required");
+                        const tokenResult = await m.issueToken(params.basket, params.data);
+                        return { content: [{ type: "text", text: `✅ Token issued! ID: ${tokenResult.tokenId}\nTXID: ${tokenResult.txid}` }] };
+                    case "token_transfer":
+                        if (!params.tokenId || !params.recipientKey)
+                            throw new Error("tokenId and recipientKey required");
+                        const transResult = await m.transferToken(params.tokenId, params.recipientKey);
+                        return { content: [{ type: "text", text: `✅ Token transferred!\nTXID: ${transResult.txid}` }] };
+                    case "status":
+                        const status = m.getStatus();
+                        const myDid = await m.getMyDid();
+                        // @ts-ignore
+                        const balance = status.status.balance ?? "unknown";
+                        return { content: [{ type: "text", text: `SimpleSV Status:\nIdentity Key: ${status.identityKey}\nDID: ${JSON.stringify(myDid)}\nAddress: ${status.address}\nBalance: ${balance} sats` }] };
+                    case "pay_p2p":
+                        return { content: [{ type: "text", text: "Standard P2P payment logic integration pending." }] };
+                    case "vc_issue":
+                        return { content: [{ type: "text", text: "Verifiable Credential logic integration pending." }] };
+                    default:
+                        throw new Error(`Unknown action: ${params.action}`);
+                }
             }
             catch (error) {
                 return {
@@ -88,8 +139,6 @@ export default function register(api) {
             // @ts-ignore
             import('@bsv/simple-mcp').then((mcp) => {
                 api.logger.info("[simplesv] @bsv/simple-mcp detected! Mounting advanced blockchain tools...");
-                // Loop through all tools provided by the MCP library and register them
-                // Note: This logic depends on the specific export structure of @bsv/simple-mcp
                 if (mcp.tools) {
                     Object.values(mcp.tools).forEach((tool) => {
                         api.registerTool({

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/actions.d.ts

@@ -0,0 +1,19 @@
+import { ClawWalletCore } from './wallet.js';
+export declare class SimpleSVManager {
+    private didMethods;
+    private inscriptionMethods;
+    private tokenMethods;
+    private core;
+    constructor(core: ClawWalletCore);
+    resolveDid(did: string): Promise<any>;
+    getMyDid(): Promise<any>;
+    inscribe(data: any, text?: string): Promise<any>;
+    issueToken(basket: string, data: any): Promise<any>;
+    transferToken(tokenId: string, recipientKey: string): Promise<any>;
+    getStatus(): {
+        identityKey: string;
+        address: string;
+        status: import("@bsv/simple").WalletStatus;
+    };
+}
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,IAAI,CAAiB;gBAEjB,IAAI,EAAE,cAAc;IAQ1B,UAAU,CAAC,GAAG,EAAE,MAAM;IAItB,QAAQ;IAIR,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM;IAOjC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IAIpC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAIzD,SAAS;;;;;CAQV"}

package/dist/src/actions.js

@@ -0,0 +1,46 @@
+// @ts-ignore
+import { createDIDMethods } from '@bsv/simple/dist/modules/did.js';
+// @ts-ignore
+import { createInscriptionMethods } from '@bsv/simple/dist/modules/inscriptions.js';
+// @ts-ignore
+import { createTokenMethods } from '@bsv/simple/dist/modules/tokens.js';
+export class SimpleSVManager {
+    didMethods;
+    inscriptionMethods;
+    tokenMethods;
+    core;
+    constructor(core) {
+        this.core = core;
+        // Initialize high-level modules
+        this.didMethods = createDIDMethods(core);
+        this.inscriptionMethods = createInscriptionMethods(core);
+        this.tokenMethods = createTokenMethods(core);
+    }
+    async resolveDid(did) {
+        return await this.didMethods.resolveDID(did);
+    }
+    async getMyDid() {
+        return await this.didMethods.getDID();
+    }
+    async inscribe(data, text) {
+        if (text) {
+            return await this.inscriptionMethods.createInscription({ text });
+        }
+        return await this.inscriptionMethods.createInscription({ data });
+    }
+    async issueToken(basket, data) {
+        return await this.tokenMethods.issueToken({ basket, data });
+    }
+    async transferToken(tokenId, recipientKey) {
+        return await this.tokenMethods.transferToken({ tokenId, recipientKey });
+    }
+    getStatus() {
+        return {
+            identityKey: this.core.identityKey,
+            address: this.core.getAddress(),
+            // @ts-ignore
+            status: this.core.getStatus()
+        };
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/src/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/actions.ts"],"names":[],"mappings":"AACA,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,aAAa;AACb,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,aAAa;AACb,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,MAAM,OAAO,eAAe;IAClB,UAAU,CAAM;IAChB,kBAAkB,CAAM;IACxB,YAAY,CAAM;IAClB,IAAI,CAAiB;IAE7B,YAAY,IAAoB;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,gCAAgC;QAChC,IAAI,CAAC,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,kBAAkB,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAS,EAAE,IAAa;QACrC,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,IAAS;QACxC,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,YAAoB;QACvD,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,SAAS;QACP,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;YAClC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YAC/B,aAAa;YACb,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;SAC9B,CAAC;IACJ,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"}