openclaw-paygate-plugin 0.1.0 → 0.1.1

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

@@ -0,0 +1,100 @@
+/**
+ * @a2a-bsv/core — BSVAgentWallet
+ *
+ * High-level wallet class for AI agent-to-agent BSV payments.
+ * Wraps @bsv/wallet-toolbox's Wallet + StorageKnex with a clean,
+ * minimal API surface designed for automated agent use.
+ */
+import type { SetupWallet } from '@bsv/wallet-toolbox';
+import type { WalletConfig, PaymentParams, PaymentResult, VerifyParams, VerifyResult, AcceptParams, AcceptResult } from './types.js';
+/**
+ * BSVAgentWallet — the primary class for agent-to-agent BSV payments.
+ *
+ * Usage:
+ * ```ts
+ * // Create a new wallet (generates keys)
+ * const wallet = await BSVAgentWallet.load({ network: 'testnet', storageDir: './agent-wallet' });
+ *
+ * // Load an existing wallet
+ * const wallet = await BSVAgentWallet.load({ network: 'testnet', storageDir: './agent-wallet' });
+ *
+ * // Make a payment
+ * const payment = await wallet.createPayment({ to: recipientPubKey, satoshis: 500 });
+ *
+ * // Verify and accept a payment
+ * const verification = wallet.verifyPayment({ beef: payment.beef });
+ * if (verification.valid) {
+ *   await wallet.acceptPayment({ beef: payment.beef, ...derivationInfo });
+ * }
+ * ```
+ */
+export declare class BSVAgentWallet {
+    /** @internal — exposed for advanced operations (e.g. direct internalizeAction) */
+    readonly _setup: SetupWallet;
+    private constructor();
+    /**
+     * Create a new agent wallet. Generates a fresh root key and persists it.
+     * The SQLite database and identity file are written to `config.storageDir`.
+     */
+    private static create;
+    /**
+     * Load an existing agent wallet from its storage directory.
+     * Reads the persisted identity file and re-initializes the wallet.
+     */
+    static load(config: WalletConfig): Promise<BSVAgentWallet>;
+    /**
+     * Get this wallet's public identity key (compressed hex, 33 bytes).
+     * This is the key other agents use to send payments to you.
+     */
+    getIdentityKey(): Promise<string>;
+    /**
+     * Get the wallet's current balance in satoshis.
+     *
+     * Uses the BRC-100 wallet's balance method which sums spendable outputs
+     * in the default basket.
+     */
+    getBalance(): Promise<number>;
+    /**
+     * Cleanly shut down the wallet, releasing database connections and
+     * stopping the background monitor.
+     */
+    destroy(): Promise<void>;
+    /**
+     * Build a BRC-29 payment to another agent.
+     *
+     * The transaction is created with `noSend: true` — the sender does NOT
+     * broadcast it. Instead, the Atomic BEEF and derivation metadata are
+     * returned so they can be transmitted to the recipient, who will
+     * verify and internalize (broadcast) the payment.
+     *
+     * @param params.to — Recipient's compressed public key (hex).
+     * @param params.satoshis — Amount in satoshis.
+     * @param params.description — Optional human-readable note.
+     */
+    createPayment(params: PaymentParams): Promise<PaymentResult>;
+    /**
+     * Verify an incoming Atomic BEEF payment.
+     *
+     * This performs structural validation and SPV verification via tx.verify().
+     */
+    verifyPayment(params: VerifyParams): Promise<VerifyResult>;
+    /**
+     * Accept (internalize) a verified payment into this wallet.
+     *
+     * Uses the BRC-29 wallet payment protocol to derive the correct key
+     * and claim the output. This triggers SPV verification and, if the
+     * transaction hasn't been broadcast yet, broadcasts it.
+     */
+    acceptPayment(params: AcceptParams): Promise<AcceptResult>;
+    /** Get the underlying wallet-toolbox SetupWallet for advanced operations. */
+    getSetup(): SetupWallet;
+    /**
+     * Internal: manually construct a BRC-100 wallet backed by SQLite.
+     *
+     * We build this by hand instead of using Setup.createWalletSQLite because
+     * the toolbox has a bug where its internal randomBytesHex is a stub.
+     * We use the same components but wire them up correctly.
+     */
+    private static buildSetup;
+}
+//# sourceMappingURL=wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../src/core/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,OAAO,KAAK,EACV,YAAY,EAEZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAQpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc;IACzB,kFAAkF;IAClF,SAAgB,MAAM,EAAE,WAAW,CAAC;IAEpC,OAAO;IAQP;;;OAGG;mBACkB,MAAM;IAwB3B;;;OAGG;WACU,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAoBhE;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvC;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAQlE;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhE;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAQhE,6EAA6E;IAC7E,QAAQ,IAAI,WAAW;IAQvB;;;;;;OAMG;mBACkB,UAAU;CAyEhC"}

package/dist/src/core/wallet.js

@@ -0,0 +1,225 @@
+/**
+ * @a2a-bsv/core — BSVAgentWallet
+ *
+ * High-level wallet class for AI agent-to-agent BSV payments.
+ * Wraps @bsv/wallet-toolbox's Wallet + StorageKnex with a clean,
+ * minimal API surface designed for automated agent use.
+ */
+import { PrivateKey, CachedKeyDeriver } from '@bsv/sdk';
+import { Wallet, WalletStorageManager, Services, Monitor, StorageKnex, randomBytesHex, ChaintracksServiceClient, } from '@bsv/wallet-toolbox';
+import knexLib from 'knex';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { toChain, DEFAULT_TAAL_API_KEYS, DEFAULT_DB_NAME } from './config.js';
+import { buildPayment } from './payment.js';
+import { verifyPayment, acceptPayment } from './verify.js';
+/** Filename for the persisted wallet identity JSON. */
+const IDENTITY_FILE = 'wallet-identity.json';
+/**
+ * BSVAgentWallet — the primary class for agent-to-agent BSV payments.
+ *
+ * Usage:
+ * ```ts
+ * // Create a new wallet (generates keys)
+ * const wallet = await BSVAgentWallet.load({ network: 'testnet', storageDir: './agent-wallet' });
+ *
+ * // Load an existing wallet
+ * const wallet = await BSVAgentWallet.load({ network: 'testnet', storageDir: './agent-wallet' });
+ *
+ * // Make a payment
+ * const payment = await wallet.createPayment({ to: recipientPubKey, satoshis: 500 });
+ *
+ * // Verify and accept a payment
+ * const verification = wallet.verifyPayment({ beef: payment.beef });
+ * if (verification.valid) {
+ *   await wallet.acceptPayment({ beef: payment.beef, ...derivationInfo });
+ * }
+ * ```
+ */
+export class BSVAgentWallet {
+    /** @internal — exposed for advanced operations (e.g. direct internalizeAction) */
+    _setup;
+    constructor(setup) {
+        this._setup = setup;
+    }
+    // ---------------------------------------------------------------------------
+    // Factory methods
+    // ---------------------------------------------------------------------------
+    /**
+     * Create a new agent wallet. Generates a fresh root key and persists it.
+     * The SQLite database and identity file are written to `config.storageDir`.
+     */
+    static async create(config) {
+        // Generate a new root key (or use one provided in config)
+        const rootKeyHex = config.rootKeyHex ?? PrivateKey.fromRandom().toHex();
+        const rootKey = PrivateKey.fromHex(rootKeyHex);
+        const identityKey = rootKey.toPublicKey().toString();
+        // Ensure the storage directory exists
+        fs.mkdirSync(config.storageDir, { recursive: true });
+        // Persist identity for later loading
+        const identity = {
+            rootKeyHex,
+            identityKey,
+            network: config.network,
+        };
+        const identityPath = path.join(config.storageDir, IDENTITY_FILE);
+        fs.writeFileSync(identityPath, JSON.stringify(identity, null, 2), 'utf-8');
+        // Build the wallet
+        const setup = await BSVAgentWallet.buildSetup(config, rootKeyHex);
+        return new BSVAgentWallet(setup);
+    }
+    /**
+     * Load an existing agent wallet from its storage directory.
+     * Reads the persisted identity file and re-initializes the wallet.
+     */
+    static async load(config) {
+        const identityPath = path.join(config.storageDir, IDENTITY_FILE);
+        if (!fs.existsSync(identityPath)) {
+            return this.create(config);
+        }
+        const identity = JSON.parse(fs.readFileSync(identityPath, 'utf-8'));
+        const rootKeyHex = config.rootKeyHex ?? identity.rootKeyHex;
+        const setup = await BSVAgentWallet.buildSetup(config, rootKeyHex);
+        return new BSVAgentWallet(setup);
+    }
+    // ---------------------------------------------------------------------------
+    // Wallet lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Get this wallet's public identity key (compressed hex, 33 bytes).
+     * This is the key other agents use to send payments to you.
+     */
+    async getIdentityKey() {
+        return this._setup.identityKey;
+    }
+    /**
+     * Get the wallet's current balance in satoshis.
+     *
+     * Uses the BRC-100 wallet's balance method which sums spendable outputs
+     * in the default basket.
+     */
+    async getBalance() {
+        return await this._setup.wallet.balance();
+    }
+    /**
+     * Cleanly shut down the wallet, releasing database connections and
+     * stopping the background monitor.
+     */
+    async destroy() {
+        await this._setup.wallet.destroy();
+    }
+    // ---------------------------------------------------------------------------
+    // Payment creation (sender/payer side)
+    // ---------------------------------------------------------------------------
+    /**
+     * Build a BRC-29 payment to another agent.
+     *
+     * The transaction is created with `noSend: true` — the sender does NOT
+     * broadcast it. Instead, the Atomic BEEF and derivation metadata are
+     * returned so they can be transmitted to the recipient, who will
+     * verify and internalize (broadcast) the payment.
+     *
+     * @param params.to — Recipient's compressed public key (hex).
+     * @param params.satoshis — Amount in satoshis.
+     * @param params.description — Optional human-readable note.
+     */
+    async createPayment(params) {
+        return buildPayment(this._setup, params);
+    }
+    // ---------------------------------------------------------------------------
+    // Payment verification & acceptance (receiver/merchant side)
+    // ---------------------------------------------------------------------------
+    /**
+     * Verify an incoming Atomic BEEF payment.
+     *
+     * This performs structural validation and SPV verification via tx.verify().
+     */
+    async verifyPayment(params) {
+        return await verifyPayment(params);
+    }
+    /**
+     * Accept (internalize) a verified payment into this wallet.
+     *
+     * Uses the BRC-29 wallet payment protocol to derive the correct key
+     * and claim the output. This triggers SPV verification and, if the
+     * transaction hasn't been broadcast yet, broadcasts it.
+     */
+    async acceptPayment(params) {
+        return acceptPayment(this._setup, params);
+    }
+    // ---------------------------------------------------------------------------
+    // Access to underlying toolbox objects (for advanced use)
+    // ---------------------------------------------------------------------------
+    /** Get the underlying wallet-toolbox SetupWallet for advanced operations. */
+    getSetup() {
+        return this._setup;
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Internal: manually construct a BRC-100 wallet backed by SQLite.
+     *
+     * We build this by hand instead of using Setup.createWalletSQLite because
+     * the toolbox has a bug where its internal randomBytesHex is a stub.
+     * We use the same components but wire them up correctly.
+     */
+    static async buildSetup(config, rootKeyHex) {
+        const chain = toChain(config.network);
+        const taalApiKey = config.taalApiKey ?? DEFAULT_TAAL_API_KEYS[chain];
+        const rootKey = PrivateKey.fromHex(rootKeyHex);
+        const identityKey = rootKey.toPublicKey().toString();
+        // 1. Key derivation
+        const keyDeriver = new CachedKeyDeriver(rootKey);
+        // 2. Storage manager (empty initially)
+        const storage = new WalletStorageManager(identityKey);
+        // 3. Network services (ARC broadcasting, chain tracking, etc.)
+        const serviceOptions = Services.createDefaultOptions(chain);
+        const chaintracksUrl = process.env.BSV_CHAINTRACKS_URL || 'https://chaintracks-us-1.bsvb.tech';
+        const arcUrl = process.env.BSV_ARC_URL;
+        serviceOptions.chaintracks = new ChaintracksServiceClient(chain, chaintracksUrl);
+        if (arcUrl) {
+            serviceOptions.arcUrl = arcUrl;
+        }
+        serviceOptions.taalApiKey = taalApiKey;
+        const services = new Services(serviceOptions);
+        // 4. Background monitor
+        const monopts = Monitor.createDefaultWalletMonitorOptions(chain, storage, services);
+        const monitor = new Monitor(monopts);
+        monitor.addDefaultTasks();
+        // 5. The BRC-100 Wallet
+        const wallet = new Wallet({ chain, keyDeriver, storage, services, monitor });
+        // 6. SQLite storage via knex
+        const filePath = path.join(config.storageDir, `${DEFAULT_DB_NAME}.sqlite`);
+        const knex = knexLib({
+            client: 'sqlite3',
+            connection: { filename: filePath },
+            useNullAsDefault: true,
+        });
+        // Fee model: configurable via BSV_FEE_MODEL env var (default: 100 sat/KB)
+        const feeModelValue = config.feeModel ??
+            (process.env.BSV_FEE_MODEL ? parseInt(process.env.BSV_FEE_MODEL, 10) : 100);
+        const activeStorage = new StorageKnex({
+            chain,
+            knex,
+            commissionSatoshis: 0,
+            commissionPubKeyHex: undefined,
+            feeModel: { model: 'sat/kb', value: feeModelValue },
+        });
+        await activeStorage.migrate(DEFAULT_DB_NAME, randomBytesHex(33));
+        await activeStorage.makeAvailable();
+        await storage.addWalletStorageProvider(activeStorage);
+        await activeStorage.findOrInsertUser(identityKey);
+        return {
+            rootKey,
+            identityKey,
+            keyDeriver,
+            chain,
+            storage,
+            services,
+            monitor,
+            wallet,
+        };
+    }
+}
+//# sourceMappingURL=wallet.js.map

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

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

package/dist/src/server.d.ts

@@ -0,0 +1,15 @@
+import { BSVAgentWallet } from './core/wallet.js';
+export declare class PaygateServer {
+    private app;
+    private wallet;
+    private port;
+    private prices;
+    constructor(port: number, wallet: BSVAgentWallet);
+    setPrice(toolName: string, sats: number): void;
+    start(): import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
+    getEarnings(): {
+        total: number;
+        note: string;
+    };
+}
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAkC;gBAEpC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAkChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAIvC,KAAK;IAIL,WAAW;;;;CAIZ"}

package/dist/src/server.js

@@ -0,0 +1,49 @@
+import express from 'express';
+import { createPaymentMiddleware } from '@bsv/payment-express-middleware';
+export class PaygateServer {
+    app = express();
+    wallet;
+    port;
+    prices = new Map();
+    constructor(port, wallet) {
+        this.port = port;
+        this.wallet = wallet;
+        this.app.use(express.json());
+        // 402 Middleware
+        const paymentMiddleware = createPaymentMiddleware({
+            wallet: this.wallet._setup.wallet,
+            calculateRequestPrice: (req) => {
+                const toolName = req.params.toolName;
+                return this.prices.get(toolName) || 0;
+            }
+        });
+        // Universal tool endpoint
+        this.app.post('/tool/:toolName', paymentMiddleware, async (req, res) => {
+            const { toolName } = req.params;
+            const params = req.body;
+            try {
+                // Here we would call the actual OpenClaw tool
+                // For now, we return a success placeholder
+                res.json({
+                    success: true,
+                    message: `Tool ${toolName} executed successfully after payment.`,
+                    data: { result: "placeholder", params }
+                });
+            }
+            catch (err) {
+                res.status(500).json({ success: false, error: err.message });
+            }
+        });
+    }
+    setPrice(toolName, sats) {
+        this.prices.set(toolName, sats);
+    }
+    start() {
+        return this.app.listen(this.port);
+    }
+    getEarnings() {
+        // This would ideally query the wallet's internalized payments
+        return { total: 0, note: "Earnings tracking pending wallet storage integration" };
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAA8B,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAI1E,MAAM,OAAO,aAAa;IAChB,GAAG,GAAG,OAAO,EAAE,CAAC;IAChB,MAAM,CAAiB;IACvB,IAAI,CAAS;IACb,MAAM,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEhD,YAAY,IAAY,EAAE,MAAsB;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAE7B,iBAAiB;QACjB,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;YAChD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAoC;YAC/D,qBAAqB,EAAE,CAAC,GAAQ,EAAE,EAAE;gBAClC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACrC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;SACF,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;YACxF,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;YAChC,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;YAExB,IAAI,CAAC;gBACH,8CAA8C;gBAC9C,2CAA2C;gBAC3C,GAAG,CAAC,IAAI,CAAC;oBACP,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,QAAQ,QAAQ,uCAAuC;oBAChE,IAAI,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE;iBACxC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,QAAgB,EAAE,IAAY;QACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,WAAW;QACT,8DAA8D;QAC9D,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,sDAAsD,EAAE,CAAC;IACpF,CAAC;CACF"}

package/index.ts

@@ -1,17 +1,41 @@
 import path from "node:path";
 import os from "node:os";
+import { PaygateServer } from "./src/server.js";
+import { BSVAgentWallet } from "./src/core/wallet.js";
 
 /**
  * OpenClaw Paygate Plugin
  * Monetize agent tools via 402 Payment Required.
  */
 export default function register(api: any) {
-  const entry = api.getConfig?.()?.plugins?.entries?.['openclaw-paygate'] || {};
+  const entries = api.getConfig?.()?.plugins?.entries || {};
+  const entry = entries['openclaw-paygate'] 
+    || entries['openclaw-paygate-plugin'] 
+    || entries['bsv-paygate'] 
+    || {};
+    
   const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
   const port = pluginConfig.port || 8080;
+  const network = pluginConfig.network || 'mainnet';
   const walletDir = pluginConfig.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
 
-  api.logger.info(`[paygate] Initializing Paygate Plugin (port: ${port})`);
+  let server: PaygateServer | null = null;
+  let wallet: BSVAgentWallet | null = null;
+
+  api.logger.info(`[paygate] Initializing Paygate Plugin (network: ${network}, port: ${port})`);
+
+  async function ensureInitialized() {
+    if (server) return server;
+    
+    // Initialize shared wallet
+    wallet = await BSVAgentWallet.load({
+      network: network as any,
+      storageDir: walletDir
+    });
+
+    server = new PaygateServer(port, wallet);
+    return server;
+  }
 
   // Register the paygate tool
   api.registerTool({
@@ -38,13 +62,26 @@ export default function register(api: any) {
     },
     async execute(_id: string, params: any) {
       try {
-        // Implementation logic using payment-express-middleware will go here
-        return {
-          content: [{
-            type: "text",
-            text: `Paygate action '${params.action}' received. (Logic implementation pending)`
-          }]
-        };
+        const s = await ensureInitialized();
+        
+        switch (params.action) {
+          case "monetize":
+            if (!params.toolName || params.priceSats === undefined) {
+              throw new Error("toolName and priceSats required");
+            }
+            s.setPrice(params.toolName, params.priceSats);
+            return { content: [{ type: "text", text: `✅ Tool '${params.toolName}' is now monetized at ${params.priceSats} sats.\nEndpoint: http://localhost:${port}/tool/${params.toolName}` }] };
+          
+          case "earnings":
+            const earnings = s.getEarnings();
+            return { content: [{ type: "text", text: `💰 Total Earnings: ${earnings.total} sats\nNote: ${earnings.note}` }] };
+
+          case "status":
+            return { content: [{ type: "text", text: `Paygate Status:\nServer: http://localhost:${port}\nIdentity: ${await wallet?.getIdentityKey()}` }] };
+
+          default:
+            throw new Error(`Unknown action: ${params.action}`);
+        }
       } catch (error: any) {
         return {
           content: [{
@@ -57,14 +94,24 @@ export default function register(api: any) {
   });
 
   // Register the background API server
+  let runningServer: any = null;
   api.registerService({
     id: "paygate-api-server",
     start: async () => {
-      api.logger.info(`[paygate] Starting agent API server on port ${port}...`);
-      // Express server logic with 402 middleware goes here
+      try {
+        const s = await ensureInitialized();
+        api.logger.info(`[paygate] Starting agent API server on port ${port}...`);
+        runningServer = s.start();
+      } catch (err: any) {
+        api.logger.error(`[paygate] API server failed: ${err.message}`);
+      }
     },
     stop: async () => {
       api.logger.info("[paygate] Stopping agent API server...");
+      if (runningServer) {
+        runningServer.close();
+        runningServer = null;
+      }
     }
   });
 }

package/openclaw.plugin.json

@@ -1,5 +1,5 @@
 {
-  "id": "openclaw-paygate",
+  "id": "openclaw-paygate-plugin",
   "name": "BSV Paygate",
   "description": "Monetize agent tools via 402 Payment Required",
   "version": "0.1.0",
@@ -15,6 +15,12 @@
         "default": 8080,
         "description": "Port for the agent's API server"
       },
+      "network": {
+        "type": "string",
+        "enum": ["mainnet", "testnet"],
+        "default": "mainnet",
+        "description": "BSV network to use"
+      },
       "walletDir": {
         "type": "string",
         "description": "Path to BSV wallet storage (defaults to ~/.openclaw/bsv-wallet)"
@@ -25,6 +31,9 @@
     "port": {
       "label": "API Port",
       "placeholder": "8080"
+    },
+    "network": {
+      "label": "BSV Network"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-paygate-plugin",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "OpenClaw plugin for monetizing tools via 402 Payment Required flow",
   "type": "module",
   "main": "dist/index.js",
@@ -19,17 +19,19 @@
     "test": "npx tsx src/**/*.test.ts"
   },
   "dependencies": {
+    "@bsv/payment-express-middleware": "^2.0.1",
     "@bsv/sdk": "^2.0.13",
-    "express": "^4.21.0",
+    "@bsv/wallet-toolbox": "^2.1.17",
     "better-sqlite3": "^12.8.0",
-    "knex": "^3.2.8",
-    "dotenv": "^17.3.1"
+    "dotenv": "^17.3.1",
+    "express": "^4.21.0",
+    "knex": "^3.2.8"
   },
   "devDependencies": {
-    "@types/node": "^22.10.0",
     "@types/express": "^5.0.0",
-    "typescript": "^6.0.2",
-    "eslint": "^10.1.0"
+    "@types/node": "^22.10.0",
+    "eslint": "^10.1.0",
+    "typescript": "^6.0.2"
   },
   "openclaw": {
     "extensions": [

package/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/src/core/config.ts

@@ -0,0 +1,21 @@
+/**
+ * @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 function toChain(network: WalletConfig['network']): Chain {
+  return network === 'mainnet' ? 'main' : 'test';
+}
+
+/** Default TAAL API keys from the wallet-toolbox examples. */
+export const DEFAULT_TAAL_API_KEYS: Record<Chain, string> = {
+  main: 'mainnet_9596de07e92300c6287e4393594ae39c',
+  test: 'testnet_0e6cf72133b43ea2d7861da2a38684e3',
+};
+
+/** Default SQLite database name. */
+export const DEFAULT_DB_NAME = 'a2a_agent_wallet';

package/src/core/index.ts

@@ -0,0 +1,42 @@
+/**
+ * @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';
+
+// All types
+export type {
+  WalletConfig,
+  WalletIdentity,
+  PaymentParams,
+  PaymentResult,
+  VerifyParams,
+  VerifyResult,
+  AcceptParams,
+  AcceptResult,
+} from './types.js';
+
+// Config helpers (for advanced use)
+export { toChain, DEFAULT_TAAL_API_KEYS, DEFAULT_DB_NAME } from './config.js';
+export type { Chain } from './config.js';
+
+// Lower-level helpers (for advanced use)
+export { buildPayment } from './payment.js';
+export { verifyPayment, acceptPayment } from './verify.js';