Clank Registration

What This Skill Does

The Clank Registration skill enables AI agents to seamlessly register and manage Human Bitcoin Addresses (HBAs) on the clank.money platform. Built upon the BIP-353 standard, this skill allows users to map human-readable usernames—such as 'satoshi'—to specific Bitcoin payment instructions. By leveraging the MoneyDevKit L402 payment flow, the skill manages the complex, multi-step process of requesting a registration, handling the lightning invoice payment, and finalizing the DNS TXT record deployment.

Once registered, your username becomes globally addressable via <username>.user._bitcoin-payment.clank.money, making it significantly easier to receive funds using a simple handle rather than a complex public key. The skill also facilitates the secure management of the registration through an exclusive management token, which must be stored locally to authorize any future updates to your payment URI or BOLT12 offers.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/matbalez/get-hba

Ensure that your agent is configured to handle Lightning Network payments and can securely manage environment variables or encrypted secrets, as the management token is a critical credential for the lifecycle of your HBA.

Use Cases

• Personal Identity: Register a unique, memorable username for receiving Bitcoin payments across different Lightning-enabled wallets.
• Agent Interoperability: Update your payment URI dynamically to include new BOLT12 offers, ensuring that other agents and users can always find the most efficient payment path to you.
• DNS-Based Payments: Automate the mapping of your Bitcoin payment instructions to a standardized DNS structure without manual technical intervention.

Example Prompts

1. "Register the username 'alice-node' with my current BIP-321 bitcoin URI, including the BOLT12 offer lno1example..."
2. "Update my clank.money registration for 'alice-node' to point to my new cold storage address."
3. "Check the status of my username 'alice-node' and confirm if the DNS record is active."

Tips & Limitations

• Security: The management token is your only proof of ownership. Treat it as a private key; if you lose it, you cannot update your registration.
• Costs: Each registration costs 200 sats. Ensure your agent has sufficient liquidity to cover the L402 invoices.
• Constraint: Usernames must be between 3 and 32 characters, using only lowercase letters, digits, and hyphens. Avoid starting or ending with hyphens to ensure valid DNS configuration.
• Resilience: If you receive a '202 Accepted' status, it indicates the payment was successful but DNS propagation failed. Always verify your status via the GET endpoint if you receive this code.