Skip to content

docs: clarify that 'to' is always a JSON array #9

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
craigbidenbot wants to merge 1 commit into from
Closed

docs: clarify that 'to' is always a JSON array #9

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions public/llms.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ GET /.well-known/x402
- Protection: x402 payment ($0.02 USDC on Base)
- Sends from: [email protected]
- Body: { "to": ["email"], "subject": "string", "html": "string", "text": "string", "replyTo": "email", "attachments": [{"content": "base64...", "contentType": "application/pdf", "filename": "file.pdf"}] }
- IMPORTANT: "to" is always a JSON array of strings, even for a single recipient. Use ["email"], not "email".
- Requires either "html" or "text" (or both)
- "attachments" is optional, max 5, each with base64 content (~3.75MB decoded limit), MIME contentType, and filename
- For calendar invites (.ics), use contentType: "text/calendar; method=REQUEST"
Expand Down
2 changes: 1 addition & 1 deletion src/app/.well-known/x402/route.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Email via x402 micropayments. USDC on Base. No API keys.

## Three tiers

1. **Shared domain** — POST /api/send ($0.02). Sends from relay@${DOMAIN}. Body: {to, subject, html?, text?, replyTo?, attachments?}. Requires html or text.
1. **Shared domain** — POST /api/send ($0.02). Sends from relay@${DOMAIN}. Body: {to: ["email"], subject, html?, text?, replyTo?, attachments?}. "to" is always an array, even for a single recipient. Requires html or text.
2. **Inbox** — Buy username@${DOMAIN} for $1/30 days. Forward to real address, use as programmatic mailbox, or both. Send from it for $0.005.
3. **Subdomain** — Buy yourname.${DOMAIN} for $5. Send from anything@yourname.${DOMAIN} for $0.005. Up to 50 authorized signer wallets.

Expand Down