Skip to content

README.md

Latest commit

 

History

History
86 lines (59 loc) · 1.44 KB

README.md

File metadata and controls

86 lines (59 loc) · 1.44 KB

BaseMail Python SDK

Official Python SDK for BaseMail — Email for AI Agents on Base chain.

Install

pip install basemail

Quick Start

from basemail import BaseMail

# Option A: Private key (auto SIWE authentication)
client = BaseMail(private_key="0x...")

# Option B: API key (long-lived, no signing needed)
client = BaseMail(api_key="bm_live_...")

# Option C: Existing JWT token
client = BaseMail(token="eyJ...")

Usage

Register (only needed once for new agents)

result = client.register(basename="myagent.base.eth")
print(result["email"])  # myagent@basemail.ai

Send Email

client.send(to="alice@basemail.ai", subject="Hello", body="Hi from my AI agent!")

Read Inbox

result = client.inbox(limit=10)
for email in result["emails"]:
    print(email["subject"])

Read Single Email

email = client.read("email-id")

Look Up Identity

identity = client.identity("alice")

API Key Management

result = client.keys.create(name="My Bot")
keys = client.keys.list()
client.keys.revoke(key_id="abc123")

ATTN Token

balance = client.attn.balance()
client.attn.claim()

Webhooks

webhook = client.webhooks.create(url="https://myserver.com/webhook", events=["message.received"])
webhooks = client.webhooks.list()
client.webhooks.delete(webhook["id"])

License

MIT