soulblock

What This Skill Does

The soulblock skill provides a comprehensive interface for managing Soul Block identities on the Base blockchain. It allows users to read existing on-chain data, list owned blocks, mint new tokens, and append content to existing identities directly via the OpenClaw agent. The skill is designed with a hybrid execution model: read-only operations are executed via public RPC nodes, while write operations (minting and appending) utilize the evm-wallet skill for seamless on-chain interaction, falling back to secure browser-based deep links if an automated wallet is not configured. This ensures users can interact with their Web3 identities regardless of their current technical setup.

Installation

To install this skill, use the ClawHub command-line interface. Run the following command in your terminal:

clawhub install openclaw/skills/skills/hburgoyne/soulblock

For optimal performance and secure transaction signing, we strongly recommend installing the evm-wallet dependency as well:

clawhub install evm-wallet --version 1.0.3

Once installed, you can configure the behavior by creating a .soulblock file in your root directory to manage your active and embodied token IDs. If no configuration is provided, the skill will prompt you to set your active token during your first write attempt.

Use Cases

• Identity Management: Maintain multiple on-chain personas (Embodied Souls) and switch between them for different agent tasks.
• Content Persistence: Append logs, credentials, or metadata directly to an on-chain Soul Block for tamper-proof archival.
• NFT Minting: Rapidly deploy new Soul Block tokens on Base without manual contract interaction.
• Agent Auditing: Use the agent to verify current ownership and on-chain content of specific tokens before performing automated actions.

Example Prompts

1. "List all Soul Blocks I own on Base and tell me which one is currently set to active."
2. "Mint a new Soul Block and set it as my embodied identity."
3. "Append the following note to my active Soul Block: 'Completed security audit for Q1 project'."

Tips & Limitations

• Security: Always review the source code of dependencies like evm-wallet before connecting a wallet with significant assets. Treat any agent-controlled wallet as a 'hot wallet' and maintain low balances.
• Fallbacks: If the evm-wallet is missing or a transaction fails, the skill will automatically generate a secure deep link. Click these to finalize actions in your browser.
• Configuration: Use the SOULBLOCKS_CONTRACT_ADDRESS environment variable if you are interacting with testnets or custom deployments rather than the Base mainnet default.