erc8004-identity

What This Skill Does

The erc8004-identity skill allows your OpenClaw agent to establish and maintain a verifiable, decentralized on-chain identity on the BNB Chain, adhering to the ERC-8004 standard. This identity provides your agent with a unique on-chain footprint, allowing other users, protocols, and decentralized services to interact with it trustfully. The skill handles the complexities of cryptographic key management, on-chain registration, and metadata hosting, utilizing the BNBAgent SDK to facilitate gasless transactions via the MegaFuel Paymaster on the BSC Testnet. By managing its own URI, description, and API endpoints, your agent can publicly broadcast its purpose and availability, effectively 'announcing' itself to the web3 ecosystem while ensuring metadata remains consistent and verifiable.

Installation

To integrate this skill, ensure your OpenClaw environment has the necessary dependencies. Install the bnbagent SDK via your terminal:

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple bnbagent==0.1.6

Once installed, ensure your agent's working directory has the required permissions to write its internal encrypted wallet state (.bnbagent_state). Keep this file secure, as it contains your agent's private keys. You may optionally set the WALLET_PASSWORD environment variable to automate the unlocking process for your agent.

Use Cases

• Decentralized Reputation: Build a history for your agent that survives across different sessions and environments.
• Agent Discovery: Make your agent discoverable by others in the BNB ecosystem via 8004scan.io.
• Trustless Interaction: Allow other decentralized applications (dApps) to verify that an agent is legitimate and belongs to a specific owner before exchanging data.
• Cross-Service Identity: Link your agent's operational logic to its on-chain URI, ensuring that whenever you update your agent's endpoint, the changes are reflected on-chain.

Example Prompts

1. "Register my agent on the BNB chain as 'OpenClaw-Bot-01' using my default settings."
2. "Update my agent's identity description to include 'Autonomous research assistant' and point the endpoint to my latest worker API."
3. "Check if my agent is currently registered and display its on-chain identity details and current agent ID."

Tips & Limitations

• Network: This skill is currently restricted to the BSC Testnet. Ensure your configuration reflects the correct network settings.
• Security: Treat the .bnbagent_state file like a traditional private key. Back it up, but never share it in plain text.
• Persistence: Ensure your metadata endpoints are reliably hosted; if the URL provided in your identity URI goes offline, users won't be able to retrieve your extended agent information.
• Gasless: While registration is gasless, ensure you have correctly configured the provider to utilize the MegaFuel Paymaster to avoid unexpected transaction costs during future metadata updates.