Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Summary: Registration flow clarified, token storage made critical, price updated, and new bash example added. - Skill name is now "Clank Human Bitcoin Address" and description is updated for clarity. - Registration flow rewritten with step-by-step "Strict Registration Checklist" and explicit error handling. - Registration fee changed from 200 sats to 999 sats. - Bash copy-paste example for full registration, payment, and token storage now included. - Management token handling is emphasized as critical: lost tokens mean updates are impossible. - API details and update procedure remain, but with reinforced input and security requirements.
What This Skill Does
Registers and manages Human Bitcoin Addresses (BIP-353) on clank.money via Lightning payments. A Human Bitcoin Address maps a username like 'satoshi@clank.money' to a BIP-321 URI containing payment instructions. Registration costs 999 sats paid through the L402 Lightning payment protocol.
Handles the multi-step L402 challenge-response flow automatically, including invoice extraction, preimage collection, and management token persistence, which would otherwise require manual HTTP sequencing.
When to use it
- Registering a human-readable Bitcoin payment username
- Updating the BOLT12 offer linked to an existing address
- Checking username availability before registering
- Rotating payment credentials behind a stable address
- Automating BIP-353 address setup in a Bitcoin application
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Register the username 'satoshi' on clank.money with my BOLT12 offer URI
- 1Submit POST to clank.money/api/v1/registrations with username and bip321Uri
- 2Read 402 response to extract macaroon and Lightning invoice
- 3Present invoice to user for payment and collect the payment preimage
- 4Retry POST with Authorization: L402 macaroon:preimage header
- 5Save the returned managementToken to ~/.clank/satoshi.management_token with restricted permissions
Username registered at satoshi@clank.money, management token saved securely for future updates
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.