Skip to main content

Getting Started With Freename Web3 Domains

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

Introduction

Freename (https://freename.io) is a web3 domain registrar for top-level domains (TLD) and second-level domains (SLD). Users can register and mint their own web3 TLDs and SLDs. These domains give people full ownership and control of their digital identity, with no renewal fees.


How To Add Your Freename Domain Name To Mailchain

Prerequisites:

  • You have a Mailchain account (see here).
  • Your wallet contains your Freename name (i.e. it contains an NFT of a name you either minted or had transferred to your wallet).
  • The domain name should resolve to your wallet address. You can check this using https://whois.freename.io/ to check your address and name resolve correctly.

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 Freename domain name

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

    checking for name services

    The example below found epistola.hodl

    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 Freename 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 Freename Domain Name

With Mailchain you can send a Mailchain message from your Freename domain name to other Mailchain users.

Prerequisites

  • You have a Mailchain account (see here).
  • Your wallet contains your Freename name (i.e. it contains an NFT of a name you either minted or had transferred to your wallet).
  • The domain name should resolve to your wallet address. You can check this using https://whois.freename.io/ to check your address and name resolve correctly.
  • You have added your Freename web3 domain to Mailchain (see above)

Compose And Send A Message From Your Freename Domain 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 Freename name.

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

  6. Your message should be successfully sent.

tip

To learn more about naming conventions, see shorthand addressing with Freename.

Done! Your recipient will receive your message from your Freename domain.