Skip to main content

Getting Started with ENS

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

a message to DAOs

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'

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

    select your wallet provider
  4. Click 'Connect'

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

    select the wallet address to register
  6. Click 'Connect' to confirm Mailchain should be able to read your address

    click connect button

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'.

    verify address
  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'

    review signature, then sign message

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.

    checking for name services

    The example below found epistola.eth

    decentralized identity found

    Manual search for a web3 domain

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

    manually searching for supported names
    note

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

  2. Click 'Apply' to save your changes.

    apply customization

Step 4: Disconnect your wallet

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

    click disconnect button

    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'.

    choose Go To Inbox or Register Another Address

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

    sub-inbox image

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.