basemail_skill

Overview

This skill gives an AI agent a real email identity on Base chain (yourname@basemail.ai or 0xwallet@basemail.ai). It enables autonomous registrations, form submissions, and receipt of confirmation emails without CAPTCHAs or passwords. Authentication uses wallet signatures so agents can operate without human intervention.

How this skill works

The skill registers an email tied to a Base wallet or a Basename and issues a short-lived auth token after SIWE signature verification. Agents can send email via the API and poll the inbox endpoints to list or read messages. Wallets may be provided via environment variable, a file path, or generated and managed locally (encrypted by default).

When to use it

• Automate service sign-ups, newsletter subscriptions, and event registrations for an agent.
• Submit forms or receive confirmation emails without human involvement.
• Test flows that require email delivery for autonomous agents.
• Give an agent a verifiable, decentralized email identity using Basename or a wallet address.

Best practices

• Prefer the environment variable method for private keys to avoid writing secrets to disk.
• Use managed wallets with encryption enabled; back up the mnemonic manually and never commit it to version control.
• Set file permissions to owner-only (chmod 600) for any private-key files or tokens.
• Avoid storing unencrypted keys on shared machines; use --no-encrypt only in fully trusted environments.
• Rotate or revoke keys and tokens when an agent is decommissioned.

Example use cases

• An agent signs up for a service and confirms the account receipt without human help.
• A bot submits forms and captures confirmation emails for logging and auditing.
• QA automation that verifies email-based flows (registration, reset, receipts) using a dedicated agent mailbox.
• A decentralized identity workflow where a Basename maps to a friendly email address for agents.