openclaw-overlay-plugin 0.8.35 → 0.8.37

package/dist/index.js

@@ -135343,6 +135343,32 @@ var BSVAgentWallet = class _BSVAgentWallet {
   async getBalance() {
     return await this._setup.wallet.balance();
   }
+  /**
+   * Import a raw transaction into the wallet.
+   * Useful for manual funding or recovery.
+   */
+  async importRawTx(hex) {
+    log("Importing raw transaction");
+    const result = await this._setup.wallet.internalizeAction({
+      tx: hex,
+      description: "manual import"
+    });
+    return { success: result.accepted, txid: result.txid || "" };
+  }
+  /**
+   * Import a specific UTXO by TXID and Output Index.
+   * This will fetch the transaction data and add it to the wallet storage.
+   */
+  async importUtxo(txid, vout) {
+    log("Importing UTXO: %s:%d", txid, vout);
+    try {
+      await this._setup.wallet.importOutput({ txid, vout });
+      return { success: true };
+    } catch (err) {
+      log("UTXO import failed: %s", err.message);
+      throw err;
+    }
+  }
   /**
    * Cleanly shut down the wallet, releasing database connections and
    * stopping the background monitor.
@@ -136843,7 +136869,7 @@ function checkBudget(walletDir, requestedSats, dailyLimit) {
   };
 }
 function register(api) {
-  const version = "0.8.35";
+  const version = "0.8.37";
   if (isInitialized) return;
   isInitialized = true;
   const config = api.pluginConfig || {};
@@ -137027,6 +137053,21 @@ ${JSON.stringify(event.result, null, 2)}`;
         const { requestId, recipientKey, serviceId, result } = params;
         return (await cmdRespondService(requestId, recipientKey, serviceId, JSON.stringify(result))).data;
       }
+      case "import_utxo": {
+        if (!params.txid) throw new Error("txid required");
+        const vout = params.vout !== void 0 ? parseInt(params.vout, 10) : 0;
+        const wallet = await BSVAgentWallet.load({ network, storageDir: walletDir });
+        const result = await wallet.importUtxo(params.txid, vout);
+        await wallet.destroy();
+        return { success: true, message: "UTXO imported" };
+      }
+      case "import_raw_tx": {
+        if (!params.txhex) throw new Error("txhex required");
+        const wallet = await BSVAgentWallet.load({ network, storageDir: walletDir });
+        const result = await wallet.importRawTx(params.txhex);
+        await wallet.destroy();
+        return result;
+      }
       case "unregister":
         return (await cmdUnregister()).data;
       default:
@@ -137039,7 +137080,7 @@ ${JSON.stringify(event.result, null, 2)}`;
     parameters: {
       type: "object",
       properties: {
-        action: { type: "string", enum: ["request", "discover", "balance", "status", "pay", "onboard", "pending-requests", "fulfill", "unregister"] },
+        action: { type: "string", enum: ["request", "discover", "balance", "status", "pay", "onboard", "pending-requests", "fulfill", "unregister", "import_utxo", "import_raw_tx"] },
         service: { type: "string" },
         input: { type: "object" },
         identityKey: { type: "string" },
@@ -137047,7 +137088,10 @@ ${JSON.stringify(event.result, null, 2)}`;
         requestId: { type: "string" },
         recipientKey: { type: "string" },
         serviceId: { type: "string" },
-        result: { type: "object" }
+        result: { type: "object" },
+        txid: { type: "string" },
+        vout: { type: "number" },
+        txhex: { type: "string" }
       },
       required: ["action"]
     },
@@ -137069,15 +137113,40 @@ ${JSON.stringify(event.result, null, 2)}`;
         api.logger?.info?.(`[openclaw-overlay] Command received with args: ${JSON.stringify(ctx.args)} (type: ${typeof ctx.args})`);
         const args = Array.isArray(ctx.args) ? ctx.args : typeof ctx.args === "string" ? ctx.args.split(" ").filter(Boolean) : [];
         const action = args[0] || "status";
+        if (action === "help") {
+          return { text: `\u{1F30A} **Overlay Help**
+
+**Subcommands**:
+- \`status\`: Show identity and balance
+- \`balance\`: Show wallet balance
+- \`discover\`: Find other agents
+- \`import <txid> [vout]\`: Import a UTXO
+- \`import-tx <hex>\`: Import raw transaction` };
+        }
+        if (action === "import" && args[1]) {
+          const res = await executeOverlayAction({ action: "import_utxo", txid: args[1], vout: args[2] }, api);
+          return { text: `\u2705 UTXO imported successfully.` };
+        }
         const result = await executeOverlayAction({ action }, api);
         return { text: `**Overlay ${action.toUpperCase()}**
 
-${typeof result === "string" ? result : JSON.stringify(result, null, 2)}` };
+${JSON.stringify(result, null, 2)}` };
       } catch (error) {
         return { text: `\u274C Error: ${error.message}` };
       }
     }
   });
+  api.registerOnboarding({
+    async finalize() {
+      const wallet = await BSVAgentWallet.load({ network, storageDir: walletDir });
+      const balance = await wallet.getBalance();
+      await wallet.destroy();
+      if (balance < 500) {
+        api.logger.warn(`[overlay] Wallet has low balance (${balance} sats). Some features may be limited until funded.`);
+      }
+      return { success: true };
+    }
+  });
   api.registerService({
     id: "openclaw-overlay-relay",
     start: async () => {