email

使用 StableEmail 发送电子邮件

通过 https://stableemail.dev 使用 x402 付款发送电子邮件、管理收件箱并运行自定义子域名。

设置

有关安装和钱包设置，请参阅 rules/getting-started.md。

快速参考

任务	端点	价格
发送电子邮件（共享）	https://stableemail.dev/api/send	$0.02
购买子域名	https://stableemail.dev/api/subdomain/buy	$5.00
从子域名发送电子邮件	https://stableemail.dev/api/subdomain/send	$0.005
购买收件箱	https://stableemail.dev/api/inbox/buy	$1.00
从收件箱发送电子邮件	https://stableemail.dev/api/inbox/send	$0.005
为收件箱充值（30 天）	https://stableemail.dev/api/inbox/topup	$1.00
为收件箱充值（90 天）	https://stableemail.dev/api/inbox/topup/quarter	$2.50
为收件箱充值（365 天）	https://stableemail.dev/api/inbox/topup/year	$8.00
列出收件箱邮件	https://stableemail.dev/api/inbox/messages	$0.001
阅读收件箱邮件	https://stableemail.dev/api/inbox/messages/read	$0.001
创建子域名收件箱	https://stableemail.dev/api/subdomain/inbox/create	$0.25
列出子域名邮件	https://stableemail.dev/api/subdomain/inbox/messages	$0.001
阅读子域名邮件	https://stableemail.dev/api/subdomain/inbox/messages/read	$0.001

免费管理端点

任务	端点
子域名状态	GET https://stableemail.dev/api/subdomain/status?subdomain=name
更新子域名	POST https://stableemail.dev/api/subdomain/update
管理签名者	POST https://stableemail.dev/api/subdomain/signers
收件箱状态	GET https://stableemail.dev/api/inbox/status?username=name
列出你的收件箱	POST https://stableemail.dev/api/inbox/list
更新收件箱	POST https://stableemail.dev/api/inbox/update
取消收件箱	POST https://stableemail.dev/api/inbox/cancel
删除邮件	POST https://stableemail.dev/api/inbox/messages/delete
列出子域名收件箱	POST https://stableemail.dev/api/subdomain/inbox/list
删除子域名收件箱	POST https://stableemail.dev/api/subdomain/inbox/delete
更新子域名收件箱	POST https://stableemail.dev/api/subdomain/inbox/update
删除子域名邮件	POST https://stableemail.dev/api/subdomain/inbox/messages/delete

免费端点使用 SIWX 钱包身份验证（由 npx agentcash@latest fetch 自动处理）。

发送电子邮件

使用共享地址 [email protected] 发送：

npx agentcash@latest fetch https://stableemail.dev/api/send -m POST -b '{
  "to": ["[email protected]"],
  "subject": "Hello from x402",
  "html": "<h1>Hi!</h1><p>This email was sent via x402 payments.</p>",
  "text": "Hi! This email was sent via x402 payments.",
  "replyTo": "[email protected]"
}'

参数：

• to — 收件人电子邮件地址数组（必填）
• subject — 电子邮件主题（必填）
• html 和/或 text — 电子邮件正文（至少需要一个）
• replyTo — 回复地址（可选，但建议提供）
• attachments — {content, contentType, filename} 数组（可选，最多 5 个，使用 base64 编码，每个附件大小限制约为 3.75MB）

附件示例：

{
  "attachments": [{
    "content": "base64-encoded-content...",
    "contentType": "application/pdf",
    "filename": "report.pdf"
  }]
}

对于日历邀请，请使用 contentType: "text/calendar; method=REQUEST"。

转发收件箱

每月支付 $1 即可购买 [email protected]。电子邮件会转发到你的真实地址，和/或保留以供程序访问。

购买收件箱

npx agentcash@latest fetch https://stableemail.dev/api/inbox/buy -m POST -b '{
  "username": "alice",
  "forwardTo": "[email protected]"
}'

省略 forwardTo 即可将其用作仅供程序使用的邮箱（自动启用 retainMessages）。

从收件箱发送电子邮件

npx agentcash@latest fetch https://stableemail.dev/api/inbox/send -m POST -b '{
  "username": "alice",
  "to": ["[email protected]"],
  "subject": "Hello",
  "html": "<p>Hi Bob</p>",
  "text": "Hi Bob"
}'

为收件箱充值

npx agentcash@latest fetch https://stableemail.dev/api/inbox/topup -m POST -b '{"username": "alice"}'

任何人都可以为任何收件箱充值。充值时长可以叠加。批量折扣：90 天/$2.50（优惠 17%），365 天/$8（优惠 34%）。

取消并退款

npx agentcash@latest fetch https://stableemail.dev/api/inbox/cancel -m POST -b '{"username": "alice"}'

系统会自动在链上按比例退还 USDC。

阅读收件箱邮件

启用邮件保留功能，然后以编程方式读取邮件。

启用邮件保留

npx agentcash@latest fetch https://stableemail.dev/api/inbox/update -m POST -b '{"username": "alice", "retainMessages": true}'

列出邮件

npx agentcash@latest fetch https://stableemail.dev/api/inbox/messages -m POST -b '{"username": "alice", "limit": 20}'

阅读邮件

npx agentcash@latest fetch https://stableemail.dev/api/inbox/messages/read -m POST -b '{"messageId": "msg_abc123"}'

返回完整邮件，包含发件人、收件人、主题、日期、纯文本、HTML，以及附件下载 URL（URL 在 1 小时后过期）。邮件内容和附件会保留 90 天。

自定义子域名

一次性支付 $5 即可购买 yourname.stableemail.dev。使用该子域名下的任意地址发送邮件，每封 $0.005。

购买子域名

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/buy -m POST -b '{"subdomain": "yourname"}'

规则：3-30 个字符，仅限小写字母、数字和连字符。DNS 验证约需 5 分钟。

使用子域名发送邮件

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/send -m POST -b '{
  "from": "[email protected]",
  "to": ["[email protected]"],
  "subject": "Your order confirmation",
  "html": "<p>Thank you for your order!</p>"
}'

创建子域名收件箱

在子域名下为每个地址创建收件箱（每个 $0.25，最多 100 个收件箱，每个可存储 500 条消息）：

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/inbox/create -m POST -b '{
  "subdomain": "yourname",
  "localPart": "support",
  "forwardTo": "[email protected]"
}'

全部转发

转发子域名下所有未匹配地址的邮件：

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/update -m POST -b '{"subdomain": "yourname", "catchAllForwardTo": "[email protected]"}'

管理授权签名者

允许其他钱包使用你的子域名发送邮件：

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/signers -m POST -b '{"action": "add", "subdomain": "yourname", "walletAddress": "0x..."}'

邮件中的图片

将图片托管在 StableUpload 或 AgentUpload 上，然后在 HTML 中引用：

<img src="https://f.stableupload.dev/abc/photo.png" alt="Photo" />

大多数邮件客户端会移除 data URI——请始终使用托管 URL。

工作流

快速发送

• （可选）检查余额：npx agentcash@latest balance
• 通过 /api/send 发送邮件
• 通过 messageId 确认送达

设置专业邮箱

• 购买子域名（$5）
• 等待 DNS 验证（约 5 分钟）
• 为团队成员创建收件箱（每个 $0.25）
• 设置全部转发
• 使用自定义地址发送邮件（每封 $0.005）

程序化邮箱

• 购买不带 forwardTo 的收件箱（$1）
• 消息会自动保留（90 天）
• 通过 API 列出和读取消息（每条 $0.001）
• 处理完毕后删除消息（免费）

费用估算

任务	费用
发送一封邮件（共享）	$0.02
发送一封邮件（子域名/收件箱）	$0.005
购买收件箱（30 天）	$1.00
购买收件箱（1 年）	$1.00 + $8.00 = $9.00
购买子域名 + 5 个收件箱	$5.00 + $1.25 = $6.25
读取 100 条消息	$0.10