openclaw-simplesv-plugin 0.1.0 → 0.1.3

package/README.md

@@ -1,25 +1,34 @@
 # OpenClaw SimpleSV Plugin
 
-A programmatic OpenClaw plugin that provides a high-level blockchain "Utility Belt" using the **@bsv/simple** library.
+A programmatic OpenClaw plugin that provides a high-level blockchain "Utility Belt" using the **@bsv/simple** library. It allows AI agents to manage identity, assets, and permanent data.
 
 ## Key Features
 - **DIDs**: Manage and resolve Decentralized Identifiers (`did:bsv`).
 - **PushDrop Tokens**: Issue and transfer tokens with encrypted state.
 - **Inscriptions**: Permanently write data to the BSV blockchain.
 - **Verifiable Credentials**: Issue W3C-compatible credentials for agents.
+- **Optional MCP Integration**: Mount advanced tools from the `@bsv/simple-mcp` ecosystem.
 
 ## AI Tool: `simplesv`
 Agents can use the `simplesv` tool to:
 - `inscribe`: Store permanent JSON/Text records.
 - `token_issue`: Create new digital assets or state.
-- `resolve_did`: Look up agent profiles.
-- `vc_issue`: Certify facts about other agents.
+- `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.
+
+## 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.
+- `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.
-- Shared wallet identity with other overlay plugins.
+- Shared wallet identity with other OpenClaw BSV plugins.
 
 ## License
 MIT

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,QA4ExC"}
+{"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"}

package/dist/index.js

@@ -5,11 +5,14 @@ import os from "node:os";
  * High-level blockchain utility belt (DIDs, Tokens, Inscriptions).
  */
 export default function register(api) {
-    const pluginConfig = api.getConfig?.()?.plugins?.entries?.['openclaw-simplesv-plugin']?.config || api.config || {};
+    const entry = api.getConfig?.()?.plugins?.entries?.['openclaw-simplesv'] || {};
+    const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
     const network = pluginConfig.network || 'mainnet';
+    const chaintracksUrl = pluginConfig.chaintracksUrl || 'https://chaintracks-us-1.bsvb.tech';
     const walletDir = pluginConfig.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
-    api.logger.info(`[simplesv] Initializing SimpleSV Plugin (network: ${network})`);
-    // Register the simplesv tool
+    const enableMcp = pluginConfig.enableMcp === true;
+    api.logger.info(`[simplesv] Initializing SimpleSV Plugin (network: ${network}, chaintracks: ${chaintracksUrl})`);
+    // Register the base simplesv tool
     api.registerTool({
         name: "simplesv",
         description: "High-level BSV utility belt: DIDs, Tokens, and Inscriptions",
@@ -79,5 +82,34 @@ export default function register(api) {
             }
         }
     });
+    // === OPTIONAL MCP INTEGRATION ===
+    if (enableMcp) {
+        try {
+            // @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({
+                            name: `simplesv_${tool.name}`,
+                            description: `(Advanced) ${tool.description}`,
+                            parameters: tool.parameters,
+                            execute: async (id, params) => {
+                                return await tool.execute(params, { walletDir, network });
+                            }
+                        });
+                    });
+                    api.logger.info(`[simplesv] Registered ${Object.keys(mcp.tools).length} advanced MCP tools.`);
+                }
+            }).catch((_err) => {
+                api.logger.warn("[simplesv] Failed to load @bsv/simple-mcp. Advanced tools disabled.");
+            });
+        }
+        catch (err) {
+            api.logger.warn("[simplesv] @bsv/simple-mcp not found in node_modules. Skipping advanced tools.");
+        }
+    }
 }
 //# sourceMappingURL=index.js.map

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,YAAY,GAAG,GAAG,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,0BAA0B,CAAC,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IACnH,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,qDAAqD,OAAO,GAAG,CAAC,CAAC;IAEjF,6BAA6B;IAC7B,GAAG,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,6DAA6D;QAC1E,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE;wBACJ,UAAU,EAAE,aAAa,EAAE,gBAAgB;wBAC3C,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ;qBAC/C;oBACD,WAAW,EAAE,mBAAmB;iBACjC;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;iBACnD;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wCAAwC;iBACtD;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wBAAwB;iBACtC;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAW;YACpC,IAAI,CAAC;gBACH,sDAAsD;gBACtD,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,oBAAoB,MAAM,CAAC,MAAM,4CAA4C;yBACpF,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/index.ts

@@ -6,13 +6,16 @@ import os from "node:os";
  * High-level blockchain utility belt (DIDs, Tokens, Inscriptions).
  */
 export default function register(api: any) {
-  const pluginConfig = api.getConfig?.()?.plugins?.entries?.['openclaw-simplesv-plugin']?.config || api.config || {};
+  const entry = api.getConfig?.()?.plugins?.entries?.['openclaw-simplesv'] || {};
+  const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
   const network = pluginConfig.network || 'mainnet';
+  const chaintracksUrl = pluginConfig.chaintracksUrl || 'https://chaintracks-us-1.bsvb.tech';
   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})`);
+  api.logger.info(`[simplesv] Initializing SimpleSV Plugin (network: ${network}, chaintracks: ${chaintracksUrl})`);
 
-  // Register the simplesv tool
+  // Register the base simplesv tool
   api.registerTool({
     name: "simplesv",
     description: "High-level BSV utility belt: DIDs, Tokens, and Inscriptions",
@@ -81,4 +84,34 @@ export default function register(api: any) {
       }
     }
   });
+
+  // === OPTIONAL MCP INTEGRATION ===
+  if (enableMcp) {
+    try {
+      // @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: any) => {
+            api.registerTool({
+              name: `simplesv_${tool.name}`,
+              description: `(Advanced) ${tool.description}`,
+              parameters: tool.parameters,
+              execute: async (id: string, params: any) => {
+                return await tool.execute(params, { walletDir, network });
+              }
+            });
+          });
+          api.logger.info(`[simplesv] Registered ${Object.keys(mcp.tools).length} advanced MCP tools.`);
+        }
+      }).catch((_err) => {
+        api.logger.warn("[simplesv] Failed to load @bsv/simple-mcp. Advanced tools disabled.");
+      });
+    } catch (err) {
+      api.logger.warn("[simplesv] @bsv/simple-mcp not found in node_modules. Skipping advanced tools.");
+    }
+  }
 }

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
-  "id": "openclaw-simplesv-plugin",
+  "id": "openclaw-simplesv",
   "name": "BSV Simple Utility Belt",
-  "description": "High-level blockchain operations: DIDs, PushDrop tokens, and Inscriptions",
-  "version": "0.1.0",
+  "description": "High-level blockchain operations: DIDs, PushDrop tokens, and Inscriptions. Supports optional MCP integration.",
+  "version": "0.1.2",
   "skills": [
     "./SKILL.md"
   ],
@@ -15,9 +15,19 @@
         "enum": ["mainnet", "testnet"],
         "default": "mainnet"
       },
+      "chaintracksUrl": {
+        "type": "string",
+        "default": "https://chaintracks-us-1.bsvb.tech",
+        "description": "Custom Chaintracks server URL for SPV header verification"
+      },
       "walletDir": {
         "type": "string",
         "description": "Path to BSV wallet storage (defaults to ~/.openclaw/bsv-wallet)"
+      },
+      "enableMcp": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable optional advanced tools via @bsv/simple-mcp"
       }
     }
   },
@@ -25,6 +35,16 @@
     "network": {
       "label": "Blockchain Network"
     },
+    "chaintracksUrl": {
+      "label": "Chaintracks Server URL",
+      "placeholder": "https://chaintracks-us-1.bsvb.tech",
+      "help": "Custom server for SPV block header verification",
+      "advanced": true
+    },
+    "enableMcp": {
+      "label": "Enable Advanced MCP Tools",
+      "help": "Requires @bsv/simple-mcp to be installed"
+    },
     "walletDir": {
       "label": "Wallet Directory",
       "advanced": true

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "openclaw-simplesv-plugin",
-  "version": "0.1.0",
-  "description": "OpenClaw plugin for advanced BSV operations (DIDs, Tokens, Inscriptions) via @bsv/simple",
+  "version": "0.1.3",
+  "description": "OpenClaw plugin for advanced BSV operations (DIDs, Tokens, Inscriptions) via @bsv/simple and optional MCP integration",
   "type": "module",
   "main": "dist/index.js",
   "files": [
     "index.ts",
+    "src/ambient.d.ts",
     "openclaw.plugin.json",
     "src/",
     "dist/",
@@ -26,8 +27,11 @@
     "knex": "^3.2.8",
     "dotenv": "^17.3.1"
   },
+  "optionalDependencies": {
+    "@bsv/simple-mcp": "^1.0.0"
+  },
   "devDependencies": {
-    "@types/node": "^22.10.0",
+    "@types/node": "^25.5.0",
     "typescript": "^6.0.2",
     "eslint": "^10.1.0"
   },
@@ -42,7 +46,7 @@
     "bsv",
     "did",
     "tokens",
-    "pushdrop",
+    "mcp",
     "inscription"
   ],
   "author": "Tomás Díaz",

package/src/ambient.d.ts

@@ -0,0 +1,2 @@
+// Ambient declaration for optional dependencies
+declare module "@bsv/simple-mcp";