Skip to main content

Getting Started with IDriss

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

a message with an IDriss name


IDriss Book is a decentralized address book that lets you use a short and familiar identifier like your Twitter name, email, or phone number instead of a wallet address.— Source: IDriss Documentation

How To Add Your IDriss Name To Mailchain


  • You have an IDriss name registered to your address (see here)
  • You have configured the IDriss Reverse Record (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 (

  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:

    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 IDriss .x name

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

    checking for name services

    The example below found allofweb_3.x@idriss

    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

    If your name still cannot be resolved, please see IDriss 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.

    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.

How To Send A Message Using Your IDriss Name

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


  • You have an IDriss name registered to your address (see here)
  • You have configured the IDriss Reverse Record (see here)
  • You have a Mailchain account (see here)
  • You have added your IDriss name to Mailchain (see above)

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