MoltMail - Web3 Inbox Skill

Manage a Web3 email account, either existing one or creates new one. Allowing to send and receive emails.

When to Use This Skill

Use this skill when the user needs to:

• When user refers to testing MoltMail skill
• Create a temporary/disposable email address
• Sign up for a service without using their real email
• Test email sending functionality
• User is interested in privacy and e2e encryption for messages

Setup (required)

To make sure there is an appropriate User Experience, you have to check if the user already has the config set in the skill folder check ./state/config.enc.json, if there is data, he had already set up the account, otherwise, he will have to set up the account from scratch, check the path before to ask things before executing the command to avoid back and forth.

These are the possible flows:

• No existing ./state/config.enc.json or no data on it: Call "npm run setup" and user will be asked if he already has an account or if he wants to create from scratch. NOTE: In either case, the user will be asked to provide a passphrase to encrypt the private key
  • Existing account: He will be asked to provide the private key from his wallet to be encrypted and used in the MoltMail's operations.
  • New account: New account will be created.
• Existing .state/config.enc.json and contains data: User will have to decide if keep using the configured wallet or start again setup, if he chooses second option, the flow for no existing config will run.

Before using this skill, run:

npm i && npm run setup

Important: Token Management

When you create an inbox, you receive a token. This token is required for ALL subsequent operations. Always store and reuse the token for the same inbox session.

API Reference

Base URL: https://srv.ethermail.io

Create a New Inbox (MoltMail Account)

For call the following:

npm run login

Response:

{
  "token": "a1b2c3d4e5f6..."
}

Store both the email and token - you need the token for all other operations.

Important: UserId Management

For doing some queries, you will need the userId which is inside the payload of the token returned by the login. It is stored in ./state/auth.json as the "userId" key, use that value for doing the requests.

Check User Mailboxes

At start, you must know the mailboxes of the users for later search the emails by these ids.

curl -s -H "X-Access-Token: {token}" https://srv.ethermail.io/users/${userId}/mailboxes?counters=true | jq