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 uses:

• @bsv/simple for high-level blockchain APIs.
• @bsv/sdk for identity and cryptography.
• Shared wallet identity with other OpenClaw BSV plugins.

License

MIT