npm - openclaw-simplesv-plugin - Versions diffs - 0.1.0 → 0.1.2 - Mend

openclaw-simplesv-plugin 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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~~"}
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,QA2GxC"}

package/dist/index.js CHANGED Viewed

@@ -8,8 +8,9 @@ export default function register(api) {
     const pluginConfig = api.getConfig?.()?.plugins?.entries?.['openclaw-simplesv-plugin']?.config || api.config || {};
     const network = pluginConfig.network || 'mainnet';
     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})`);
-    // Register the simplesv tool
+    // Register the base simplesv tool
     api.registerTool({
         name: "simplesv",
         description: "High-level BSV utility belt: DIDs, Tokens, and Inscriptions",
@@ -79,5 +80,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 CHANGED Viewed

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

package/index.ts CHANGED Viewed

@@ -9,10 +9,11 @@ export default function register(api: any) {
   const pluginConfig = api.getConfig?.()?.plugins?.entries?.['openclaw-simplesv-plugin']?.config || api.config || {};
   const network = pluginConfig.network || 'mainnet';
   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})`);
-  // 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 +82,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 CHANGED Viewed

@@ -1,8 +1,8 @@
 {
   "id": "openclaw-simplesv-plugin",
   "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"
   ],
@@ -18,6 +18,11 @@
       "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 +30,10 @@
     "network": {
       "label": "Blockchain Network"
     },
+    "enableMcp": {
+      "label": "Enable Advanced MCP Tools",
+      "help": "Requires @bsv/simple-mcp to be installed"
+    },
     "walletDir": {
       "label": "Wallet Directory",
       "advanced": true

package/package.json CHANGED Viewed

@@ -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.2",
+  "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 ADDED Viewed

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