You may want to share a filtered list of domains with a friend or colleague. If for example you are looking for a new ENS domain for your product you might tag those domains 'possible-domains', and create a saved search based on that tag.

Sharing the list

When you create a saved search it is by default not publicly visible.

You can modify the visibility of the search from the 'Saved Search' settings page. This page can be accessed from your Account Settings (linked at the top of the manager) or from the modal that is displayed when you create a 'Saved Search'.

You can also update the name and permalink for your saved search from this page.

Using the example above you might set the name to 'Possible domains' and the permalink to 'possible-domains'.

The name is displayed to the search owner at the top of the 'Filter Options' section of the manager. It is also shown to the people who you share your search with.

The permalink is the URL through which other entities can access your search. You can change this from the default generated string of alphanumeric characters to something more clear/descriptive.

Saving a search

When you are filtering domain names in your account you will notice that there is an additional button: 'Save Search'. Click this button to save your search - it really is that simple.

On success you will see a modal. This modal displays the direct link for your saved search and links to your saved search settings page where you can modify the name/permalink/visibility settings for your search.

You can access your saved search by visiting the search link directly or by clicking the link that you will now see at the top of the 'Filter options' section.

Editing your saved search

If you want to modify your search simply edit the filter parameters as required and click the 'Update saved search' button that will now be visible.

LabelHash started life as a project for a single entity - they wanted a platform to help them purchase and manage their domain names. We onboarded a few more clients, and they liked it.. a lot. We had a chat, and came to the conclusion that we could (and should) offer the product to the public.

What we offer?

Lots.

Tags

We offer a flexible tool for researching ENS domain names, and managing registrations. Our tagging system allows you complete control to organise the names in your account as you wish.

You can:

• Monitor domain names that you have registered across any number of addresses.
• Monitor the domains that specific addresses (or combinations of addresses) are registering.
• Find out which 3 letter word names are available on OpenSea for less than 3 ETH, are owned by 0xcool and have the tags 'cool' and 'want'.
• etc etc

Filters

Our extensive filter options allow you to drill down into the domain names into your account based on all manner of criteria:

• name
• domain length
• expiration date,
• for sale status
• owner, controller, resolver, or resolves to address
• etc etc

Notifications

You can setup notifications to:

• receive emails when specific names are available for registration/purchase at specific prices.
• receive emails when specific name are going to expire.

For more details check out: How to get notifications when an ENS name is expiring.

Bulk registration and renewal

You can register and/or renew (in bulk) any number of domain names.

We add no additional fees. You pay the registration/renewal fees (as dictated by the ENS smart contracts), and nothing more.

Here are some guides:

• Registering Ethereum Name Service (ENS) domains using LabelHash
• Renewing Ethereum Name Service (ENS) domains using LabelHash

Guides

web3 is complex. Smart Contracts are a whole new metaphorical world. Scams are pervasive in the web3 ecosystem because interacting with smart contracts is a little more technical than what we are used to in the web2 world.

During the process of building LabelHash I was asked on numerous occasions 'How does this work?', 'What does this do behind the scenes?' etc

I figured it would be nice to document how the site works in a series of guides that you'll be able to find on this blog.

There is not an abundance of content right now, but I am hoping to build out the LabelHash blog across two core categories:

• ENS Explainers - Articles outlining core Ethereum Name Service concepts
• Inside LabelHash - Articles outlining how LabelHash works, and how it interacts with the ENS smart contracts.

In addition to those categories there are a number of posts detailing how one can get started using LabelHash.

Who are we?

I'm Thomas. I built the majority of the LabelHash offering with the help of a number of freelancers friends who I have had the pleasure of working with over the years.

I'm a software guy with an extensive background in domain names. I helped build DomainNameSales.com/Uniregistry back in the day, have bought and sold domain names (for myself and others), and have worked with a number of corporate clients (in domain name related activities) as a consultant.

I've been involved in the ENS ecosystem for years. Back in 2017 I built out ETHTools.com (and its sister product ENSTools.com). We built out tooling for the original ENS Vickrey auctions (throwback Thursday). Unfortunately I didn't have the foresight to register loads of them myself :/

I have a degree in Economics (and actually wrote my dissertation on the Economics of Domain Names), and have a particular interest in behavioural economics. It's of no surprise that ENS interests me.

Feedback

I am always open to constructive feedback. Feel free to contact us on Twitter, or via email (feedback [at] labelhash [dot] com).

I am a firm believer in transparency, and like to maintain a public roadmap of feature development. That said, (as mentioned) the product has been built to a core specification for a specific use case - research tooling and management.

The tool was developed for two common use cases:

• Receiving notifications when domain names that you own are expiring.
• Receiving notifications when domain names that you are interested in become available for registration or become available for purchase.

Filter options

Filter by tag

The ENS notifications tools integrates with out tagging system. It allows the user to only send notifications related to domain names that have a specific combination of tags.

If for example you have a set of domain names that you are interested in owning you can add a tag (e.g 'wants') to these ENS names and set up a notification to email you when any of these names become available.

Filter by address

Alternatively you can filter the domains for which notifications are sent based on address. If for example you know that a particular address owns a number of great names that you are interested in then you could set up a notification to email you when any names owned by that address expire.

The system allows you to filter based on:

• Registrant address
• Controller address
• Resolver address
• Resolves to address

Notification conditions

To minimise the number of unnecessary notifications that you receive you can also specify a number of additional conditional requirements that must be met before you receive a notification for a specific ENS name.

Expiration

If you are setting up domain expiration notifications then you can specify that you only want to received notifications for domain names that expire within a certain number of days.

Availability

If you are setting up domain availability notifications then you can specify that you only want to receive notifications for domains that are available to register/purchase below a certain price (that you can specify in Ether or USD).

This is particularly useful for domain names that expire and become available for registration with a price premium. You can set up a notification so that you receive an email only when the price premium has dropped below a specific point.

If you are interesting in registering domains check out Registering Ethereum Name Service (ENS) domains using LabelHash.

To renew a domain name, you firstly need to add it to your account (see Adding domains to your LabelHash account).

Adding domains to your cart

Any domain in your account that has previously been registered can be renewed.

Did you know? You don't have to be the owner of a domain name to renew it. If you are feeling generous you can renew your friends domains for them.

You can add one (or more) domains to your cart by selecting them using the checkboxes on the right and clicking 'Renew Selected' in the selection controls that appear at the bottom of the screen.

Checking Out

Renewing domain names using the Ethereum Name Service (ENS) smart contracts is a simple, single step process. The LabelHash.com cart interface makes renewing any number of domains as simple as clicking a few buttons.

On the Cart page you will see a section entitled 'Renewals'. This section contains all the domains that you have indicated you would like to renew.

You can specify the duration that you would like to renew each domain name for. When you change the value, we will automatically update the renewal cost.

Once you have specified how long you would like to renew each domain for, simply click 'Renew domains'.

That's it.

To register a domain name, you firstly need to add it to your account (see Adding domains to your LabelHash account).

Adding domains to your cart

Any domain in your account that is available for registration will display the cart icon along with its price. You can simply click the cart icon to add the domain to your cart. Changed your mind? Click again to remove it.

If you want to bulk register domains (and don't want to select them one by one) then you can use the checkboxes (on the left of each row) to select the domain names you want to register. Then simply click the 'Register Selected' button that will appear in the selection controls that will automatically appear at the bottom of your screen.

Once you have added all the domains that you want to register to your cart, you can visit the cart page by clicking the 'Cart' button in the top right hand corner of the manager.

Checking Out

Registering domain names using the Ethereum Name Service (ENS) smart contracts is a two step process. If you would like to read more about why, check out our 'ENS Explainer', Commit, then register. The two step process for registering ENS domains.

The LabelHash interface makes completing this process quick and simple.

Firstly you must submit a 'commitment' to the blockchain. This is essentially a signed message stating your intention to register the domain(s) in question.

Simply click the 'Submit Commitments' button and sign the commitment transaction using your active wallet provider.

The second (and final) step of the process is submitting the actual registration transaction. Again, the LabelHash interface will make it clear what you need to do..

The first important thing to note is that the Ethereum Name Service smart contracts require at least 1 minute to pass after you have submitted your commitment transaction before you can submit the registration transaction.

If you submit the registration transaction before 1 minute has passed, the registration will fail. Fortunately the LabelHash interface won't allow you to do this. We will display a countdown timer, and will disable the 'Complete Registrations' button until this time limitation has passed.

Once it has, click 'Complete Registrations'...

Behind the scenes we will automatically update the data for your newly registered domain(s). When you go back to the account manager you should see the updated data for the domains indicating that you are now the owner.

These are:

• A commitment step. The user submits a signed transaction indicating that they specifically are interested in registering a particular domain name.
• A registration step. The user submits a signed transaction saying "OK, register that domain name that I previously expressed interest in".

Why? To prevent front running.

Were the registration process to be a single step process where the users transaction says 'Register xyz.eth for me', a front running situation could occur whereby the entity including your transaction in a block instead gives preference to their own transaction to register xyz.eth for themselves instead.

By requiring a commitment step this is not possible.

Well.. the commitment step requires submission of a carefully formed commitment signature. This signature is calculated based on a number of parameters, one of which is the domain name whilst another is a salt (which is essentially a unique passcode that only you know).

This signature does not include a plaintext representation of the domain name that the user is interested in registering - there is no way for a malicious block producer to discern what domain name you are interested in (at this point).

When you submit the registration transaction, one of the parameters is the domain name that you want to register. This value (along with the other parameters submitted in the registration transaction) is used by the ENS smart contract to reconstruct the commitment signature that was previously submitted. It then verifies that a matching signature was previously submitted to the chain. If it was, the domain name is registered.

The block producer can see the domain that you are attempting to register when you submit this second transaction. They can not however front run you because they have not previously submitted a commitment saying that they are interested in registering the domain.

Fun fact: When the current ENS smart contracts were developed back in 2019 the registration commitment didn't include the address of the user who was interested in registering the domain name. Front running was still potentially possible if you had details about the previously submitted commitment - a malicious actor could 'steal' the commitment and submit a registration transaction saying 'register the name to me' instead. This was noted in the audit conducted by Consensys, and remedied by the ENS team.

To add domains to your account click the 'Add Names' toggle at the top of the home screen. You can then enter a list of the names that you want to add to your account in the text area (one per line), and click submit.

Currently LabelHash only supports the .eth namespace. Any lines that do not contain the .eth extension suffix will have it automatically added.

You can optionally add any number of tags. Tags are used across LabelHash.com for organising, monitoring, and managing domain names.

You can find out more here: The LabelHash tagging system.

The system will display the results of your submission. It will outline which names were added to your account as well as any that were not (and why).

To sign a transaction from a specific address you must use your wallet provider. LabelHash pushes utilisation of wallet providers that implement the WalletConnect protocol.

Whilst you may have previously connected an address to your LabelHash account, we require an active connection to your wallet provider to be able to sign transactions.

There will be an indicator next to your currently active address in the 'Your addresses' section visible at the top of each page.

If you attempt to complete an action that requires an active connection to your wallet provider you will see something similar to the below:

If you do not have an active wallet connection simply click 'Connect' from the LabelHash header. You can do this at any time from any screen.

LabelHash was originally built to manage a large portfolio of domains and to provide research tooling for finding new domains to add to the portfolio.

LabelHash allows you to tag a domain name (or group of domain names) with one (or more) tags. A tag is any alphanumeric string and is defined by the user.

For example a user might tag:

• domain names that they own as 'mine'
• domain names that they want as 'wants'
• domain names in arbitrary interest categories with their respective tags - 'animals', 'gods', 'words' etc

Using the examples above, if you owned zeus.eth you would tag it with both 'mine' and 'gods'.

The beauty of this system is that it allows ultimate flexibility. If you have come into some money and want to add an animal domain name to your collection then you can filter the domain names shown in the LabelHash interface to those that you have previously tagged with both 'animals' and 'wants'.

You can also set up notifications based on tags. Want to be notified when any domains with the tags 'animals' and 'wants' become available for less than 3 ETH? No problem !

After a domain name expires the original registrant has a 90 day grace period in which the name is not available for registration by any other entity. After this period the name is released for registration but with an initial price of $1,000,000.

This price then decreases over a period of 30 days.

Any user can register the domain at the current prevailing price. You can wait in the hope that the price decreases further (to save yourself some money) but the risk is that another entity who values the domain name more highly than yourself will register the domain name before hand.

To add domains to your account simply click the 'Add domains' toggle at the top of the manager.

You will then be presented with the 'Add domains' form.

Enter a list of domains that you would like to add to your account. Domains must be listed one per line, and can be added with or without the .eth extension.

You can optionally select any number of tags to be associated with each of the domains being added to your account.

Once complete, click the 'Add names' button.

The status of your request will be displayed on screen.

Click 'Continue' to return to the manager where you can interact with your newly added names.

Normalising names

The Ethereum Name Service has specific formatting requirements for valid domain names. The simplest of which is that capital letters are not allowed.

There is an in depth discussion of the topic here.

We will automatically 'normalise' any domain names that you attempt to add to you account. For example:

• wObBlE will automatically become wobble

Non ASCII Characters

ENS domain names can contain all sorts of characters including (but not limited to) emojis, symbols ($ for example), and foreign language characters.

When interfacing with traditional web2 domain names most users are only used to alphanumeric characters (a-z, and 0-9).

We have opted to highlight any non ASCII characters contained within user inputted domains as part of the process of adding domains. This is to prevent users from accidentally registering unexpected names.

If a domain contains a non ASCII character you will see a screen like the following:

If everything is as expected, simply click 'Continue'. If you notice any issues click 'Go Back' and modify your input.

Our authentication system allows you to 'Connect' any number of addresses to a single LabelHash.com account.

When you scan the QR code with your Wallet Provider you will be asked to authorise the connection to LabelHash.

Once you have connected your address, you will be asked to sign a simple message. This allows us to verify that you have control of this address.

We then create a LabelHash account for you. We do not request any additional information from you.

Connecting another account

From this point onwards, each time you 'Connect' a new address it will be associated with the same LabelHash account. All of your connected addresses will be shown at the top of the manager.

Logging in on another device

If you want to login to LabelHash on another device, simply visit LabelHash.com and click 'Connect'. Follow the steps outlined above utilising any address that you connected to your LabelHash account. We will automatically log you.

You can use LabelHash without connecting an account. Your session will be temporary - you will not be able to see your data on other devices, and it may be lost when you close your browser.

To send Ether or to interact with smart contracts a user needs to have an Ethereum address. For example: 0xb8c2c29ee19d8307cb7255e1cd9cbde883a267d5

When you register a domain using ENS you are sending Ether from your address to the ENS smart contracts. These contracts keep track of the fact that your particular address owns a particular domain.

LabelHash is a web based platform for interacting with the ENS smart contracts. Using LabelHash means that you don't have to understand all of the intricacies of how the ENS smart contracts work and how one goes about interacting with them.

That said, smart contracts are interesting and its always good to understand whats going on behind the scenes. Consider taking a look at our ENS Explained posts.