clank-human-bitcoin-address

name	Clank Human Bitcoin Address
description	Agent-first service to register and manage Human Bitcoin Addresses (BIP-353) on clank.money with L402 bitcoin payments.

Clank Human Bitcoin Address Skill

Use this skill to register and update a Human Bitcoin Address under clank.money (BIP-353 DNS payment instructions pointing to a BIP-321 URI).

CRITICAL FIRST

• managementToken is returned after successful paid registration (201 or 202).
• You must save managementToken immediately and securely.
• CRITICAL: If the token is lost, future updates to that address cannot be authenticated.

API Endpoints

• POST https://clank.money/api/v1/registrations
• GET https://clank.money/api/v1/registrations/{username}
• PATCH https://clank.money/api/v1/registrations/{username}

Required Registration Input

• username
  • lowercase letters, digits, hyphens
  • 3 to 32 chars
  • cannot start/end with -
• bip321Uri
  • required
  • must start with bitcoin:
  • should be valid BIP-321
  • strongly suggested: include a BOLT12 offer (lno=...)

Strict Registration Checklist

Registration price is 999 sats.

1. Submit unauthenticated registration request (POST /api/v1/registrations).
   • Output: either 409 username_unavailable or .