On-Chain ENS Integration

On-chain ENS integration provides the highest level of compatibility with existing ENS infrastructure and dApps. While it requires some initial setup costs in the form of gas fees, it offers the most robust integration with the Ethereum ecosystem.

Prerequisites

• You must own an .eth domain
• You need some ETH for gas fees
• Your domain should be active (not expired)

Setup Process

The easiest way to set up on-chain ENS integration is through the HNS.ID app:

1. Navigate to HNS.ID (opens in a new tab)
2. Go to "Domains" >> "TLDs"
3. Select "ENS Alias"
4. Follow the in-app instructions to:
   • Update your ENS resolver
   • Set your target TLD
   • Complete both transactions

Both required transactions can be completed directly through the HNS.ID interface, making the setup process straightforward.

How It Works

Once configured, your ENS domain will resolve to the corresponding HNS.ID records:

• If you link example.eth to cool-tld/
• Then user.example.eth will resolve to the same data as user.cool-tld
• This includes addresses, text records, content hashes, and other ENS-compatible data

Gas Optimization

To minimize costs, consider:

• Checking gas prices (opens in a new tab) before transactions
• Performing setup during low-activity periods
• Bundling multiple record updates in one transaction if possible

Limitations

• Requires two on-chain transactions for initial setup
• Changes to resolution settings require additional transactions
• Gas fees apply for all modifications

Benefits

• Highest compatibility with ENS ecosystem
• Works with all ENS-supporting applications
• No dependency on DNS infrastructure
• Permanent setup (until changed)
• Clear on-chain proof of ownership and settings

Support

If you encounter any issues during setup, please:

1. Verify your .eth domain is active and you're the owner
2. Confirm you have sufficient ETH for gas fees
3. Double-check the resolver address
4. Contact our support team if problems persist