DNSimple and Handshake (HNS)

Table of Contents

What is Handshake?

Handshake is a decentralized, peer-to-peer, permissionless naming protocol. Each peer in the network validates and manages the root DNS naming zone. The aim of the project is to make any centralized governing bodies obsolete for both managing the DNS root zone and, as a result, needing a centralized Certificate Authority (CA).

Adding a Handshake (HNS) Domain

DNSimple only supports the management of second-level Handshake domains. Currently, you can’t host a name directly registered in the Handshake blockchain (TLD).

To add an HNS domain and manage its DNS records through DNSimple you have two options:

  1. Register the domain with a registrar that sells second-level Handshake domains.
  2. If you’re the owner of the HNS TLD, add DNSimple’s NS records for the domain directly to the blockchain via your preferred method.

For both options, the process of adding the domain to DNSimple is the same.

Adding a domain
  1. Log in to DNSimple with your user credentials.
  2. If you have more than one account, select the relevant one.
  3. Click from the Dashboard. Adding a domain button
  4. Choose from the provided options. Adding a domain

You’ll then be prompted for the name of the domain you want to add to your account.

After adding the domain to DNSimple, you need to use the name servers from the DNSimple name servers support article for your domain.

Incompatible services

Handshake domains do not resolve in regular browsers by default. They require additional setup.

DNSimple DNS services are compatible with HNS domains. However, some services are incompatible with HNS domains because they aren’t resolvable without a Handshake-aware resolver.

These known services are not compatible:

  • Certificates
  • Email forwards
  • Some One-Click Services
  • Netlify Connector
  • ALIAS records pointing to other HNS domains which are not hosted with DNSimple