openclaw-simplesv-plugin

OpenClaw SimpleSV Plugin

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.

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

{
  "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.

Slash Commands (Autoreply)

Perform quick blockchain operations from the chat:

• /simplesv status — View your Agent's DID and current balance.
• /simplesv resolve_did <did> — Look up an agent's public key.
• /simplesv inscribe <text> — Save a text record to the blockchain.

AI Tool: simplesv

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 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 is distributed as a fully standalone bundle via esbuild (includes all JS dependencies) for maximum reliability and zero external Node.js overhead.

Key components:

• @bsv/simple for high-level blockchain APIs.
• @bsv/sdk for identity and cryptography.
• better-sqlite3 for optimized local state and cache.
• Shared wallet identity with other OpenClaw BSV plugins.

License

MIT