ENS Integration FAQ

General Questions

What is ENS Integration?

ENS Integration allows your HNS.ID domain to be used across the Ethereum ecosystem, including wallets, dApps, and exchanges that support ENS.

Which method should I choose?

• Choose On-Chain if you have a .eth domain
• Choose Off-Chain if you have a Web2 domain (like .com, .org, etc.)

On-Chain Integration

How much does on-chain integration cost?

The cost varies with Ethereum gas prices. You'll need to pay for:

• Setting the resolver (one transaction)
• Adding the text record (one transaction)

Why does my .eth domain need to be active?

The ENS system requires domains to be active to maintain their records. If your domain expires, the integration will stop working.

Can I change the target TLD later?

Yes, you can update the "hns-target" text record at any time by paying for a new transaction.

Off-Chain Integration

Why aren't my DNS records working?

Common issues include:

• DNS propagation delay (wait 5-30 minutes)
• Incorrect TXT record format
• Missing either "*" or "@" record
• DNS provider using NSEC/NSEC3

What does "NSEC/NSEC3 not supported" mean?

NSEC and NSEC3 are DNS security extensions that some DNS providers use for negative proof responses. These extensions prevent the wildcard record lookups that ENS requires for off-chain integration.

Known DNS provider compatibility:

• ✅ Cloudflare DNS (recommended)
• ❌ Namecheap
• ❌ DNS providers using NSEC/NSEC3 for negative proofs

If your DNS provider doesn't work, consider switching to Cloudflare or another compatible provider.

How quickly do changes take effect?

Changes to DNS records typically propagate within 5-30 minutes, depending on your DNS provider and caching settings.

Technical Details

How does the resolution work?

• For on-chain: The ENS resolver contract redirects queries to your HNS.ID domain
• For off-chain: DNS TXT records tell ENS-compatible services to query the HNS.ID API

What data types are supported?

Both methods support all standard ENS record types:

• Cryptocurrency addresses
• Text records
• Content hashes
• DNS records
• Avatar images
• And more

Support

Where can I get help?

• Check our documentation
• Join our Discord community
• Contact support@hns.id
• Follow troubleshooting guides in setup docs