Custom TLDs

Use a Handshake-compatible wallet (Bob Wallet, Namebase) to bid on and win a TLD at auction. The winning bid locks HNS on-chain and grants you permanent, uncensorable ownership.

# Example: win the TLD "cool" on Handshake
# After winning, verify ownership:
curl https://xdns.wtf/api/hns/cool
# { "owner": "hs1q4abc...", "status": "available_for_registration" }

Point your HNS TLD's nameservers at xdns and register it with the platform. xdns verifies ownership via the on-chain NS record.

curl -X POST https://xdns.wtf/api/tlds \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "tld": "cool",
    "chain": "handshake",
    "policy": "open"
  }'

# {
#   "tld": "cool",
#   "nameservers": ["ns1.xdns.wtf", "ns2.xdns.wtf"],
#   "status": "verifying"
# }

Check availability and register second-level domains under your TLD. Optionally point each SLD to an origin or zone.

# Check availability
curl https://xdns.wtf/api/tlds/cool/availability/myapp
# { "available": true }

# Register an SLD
curl -X POST https://xdns.wtf/api/tlds/cool/domains \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "sld": "myapp",
    "target": "https://myapp.vercel.app",
    "registrant": "user@example.com",
    "expires_at": "2027-03-13"
  }'

# { "fqdn": "myapp.cool", "status": "active" }