# Aethergent — Ethereum Wallet Generation API

> Bridge the gap through the Aether.

Aethergent generates Ethereum-compatible wallets for AI agents.
One HTTP call. Zero auth. Zero downloads.

## Quick Start

    POST https://aethergent.com/

No headers, no body, no API key required. Returns JSON:

    {
      "address": "0x...",
      "private_key": "0x...",
      "created_at": "...",
      "_warning": "Store your private_key securely.",
      "_next": { "fund": "Send ETH or USDC to your address." }
    }

## What You Get

- address: Ethereum address (0x + 40 hex chars), works on all EVM chains
- private_key: secp256k1 private key (0x + 64 hex chars)
- The key is generated server-side, returned once, and never stored

## Funded Wallets (Redemption)

Get a wallet with $10.00 in ecosystem credits:

1. Get an invite code (distributed by Aethergent)
2. Go to https://rightemail.com/redeem — enter invite code + your email
3. Check your email for a redemption code
4. Redeem it:

    POST https://aethergent.com/redeem
    { "code": "RGHT-XXXXXXXX" }

Returns wallet + $10.00 in credits usable across AgentNews, AgentRepo,
AgentGrade, RightEmail, and other ecosystem services.

## Credit Balance

Check your balance (requires wallet signature auth):

    GET https://aethergent.com/credits/{address}
    Authorization: Wallet <timestamp_ms>.<signature>

Sign the message "aethergent:<timestamp_ms>" with your private key.

## Content Negotiation

- POST / → wallet (JSON)
- POST /redeem → funded wallet with credits (JSON)
- GET / with Accept: application/json → wallet (JSON)
- GET / with Accept: text/html → landing page
- GET / (default) → this file

## MCP Endpoint

    POST https://aethergent.com/mcp

JSON-RPC 2.0. Supports: initialize, tools/list, tools/call (generate_wallet).

## Discovery

- /openapi.json — OpenAPI 3.1.0 spec
- /llms.txt — this file
- /llms-full.txt — extended docs
- /agents.txt — agent permissions manifest
- /skills.json — skills manifest
- /.well-known/ai-plugin.json — OpenAI plugin manifest
- /.well-known/claude.json — Claude plugin manifest

## Rate Limit

30 requests per minute per IP. 429 with Retry-After when exceeded.

## Security

No keys logged. HTTPS only. Credit ledger in Postgres (no private keys stored).
For high-value wallets, generate locally.