Getting Started with ENS

Mailchain users can use their ENS domain to send and receive messages. It’s simple to get started…

Introduction

The Ethereum Name Service (ENS) is a distributed, open, and extensible naming system based on the Ethereum blockchain. ENS’s job is to map human-readable names like ‘alice.eth’ to machine-readable identifiers such as Ethereum addresses, other cryptocurrency addresses, content hashes, and metadata. ENS also supports ‘reverse resolution’, making it possible to associate metadata such as canonical names or interface descriptions with Ethereum addresses. — Source: ENS Documentation

---

How To Add Your ENS Name To Mailchain

Prerequisites:

• You have an ENS name registered to your address (see here)
• You have configured the ENS Primary Resolver (see here)
• You have a Mailchain account (see here)

Step 1: Connect your wallet

Follow these steps to connect and register an existing blockchain wallet address:

1. Once you have signed into Mailchain, head to your Inbox (https://app.mailchain.com/inbox)

2. Click 'Register your wallet'

   

3. Select a wallet provider which supports the wallet address you are registering (e.g. Metamask for Ethereum and all other EVM addresses)

   

4. Click 'Connect'

   

5. Select the address you would like to register, then click 'Next'

   

6. Click 'Connect' to confirm Mailchain should be able to read your address

   

Your wallet is now connected.

Step 2: Verify your address

1. You can now register your wallet address with Mailchain. To do this click 'Verify Address'.

   advanced option

   By default, Mailchain is able to receive messages for your existing blockchain wallet address before you sign up. If you do not wish to retrieve these messages, un-check the option to 'Retrieve messages sent to my address prior to registering'.

   

2. A 'Signature Request' will appear in your wallet. It contains the following text:

   Message:
   Welcome to Mailchain!
   

   Please sign to start using this address with Mailchain. This will not trigger a blockchain transaction or cost any gas fees.
   

   What's happening?
   A messaging key will be registered with this address and used only for messaging. It will replace any existing registered messaging keys.
   

   Technical Details:
   Address: your_address
   Messaging key: a_generated_messaging_key
   Nonce: a_number

   Review the request

3. Click 'Sign'

   

Your wallet is now verified.

Step 3: Adding your .eth ENS name

1. The next step checks for any supported Web3 domain names that resolve to your wallet address, including .eth names.

   

   The example below found epistola.eth

   

   Manual search for a web3 domain

   If your name is not automatically found, you can manually search for it using the search box.

   
   note

   If your name still cannot be resolved, please see ENS FAQs for troubleshooting tips.

2. Click 'Apply' to save your changes.

   

Step 4: Disconnect your wallet

1. Click 'Disconnect' to disconnect your wallet from Mailchain.

   

   You have successfully registered your wallet address with a set of messaging keys that belong to your Mailchain account. You no longer need to have wallet connected to send and receive messages.

2. You now have the option to 'Go To Inbox' or to 'Register Another Address'.

   

   You will see your new sub-inbox in the left sidebar.

   

How To Send A Message Using Your ENS Name

With Mailchain you can send Mailchain message from your ENS name to other Mailchain users.

Prerequisites

• You have an ENS name registered to your address (see here)
• You have configured the ENS Primary Resolver (see here)
• You have a Mailchain account (see here)
• You have added your ENS name to Mailchain (see above)

Compose And Send A Message From Your ENS Name

1. Log into your Mailchain account.

2. Click 'Compose' in the sidebar.

3. In the New Message window, click the “From” dropdown menu.

4. Select your ENS name.

5. Fill out the rest of the message, then click Send

6. Your message should be successfully sent.

Done! Your recipient will receive your message from your ENS name.