agieth
# agieth.ai API Skill
Interact with agieth.ai domain registration and management API.
## Requirements
This skill requires an agieth.ai API key and email address:
| Variable | Required | Description |
|----------|----------|-------------|
| `AGIETH_API_KEY` | Yes | Your agieth.ai API key |
| `AGIETH_EMAIL` | Yes | Email associated with your API key |
| `ETH_WALLET_PRIVATE_KEY` | Only for payments | Ethereum private key — only needed for `send_payment`. You can also use any external wallet instead. |
| `ETH_RPC_PRIMARY` | No | Ethereum RPC endpoint — defaults to `https://ethereum.publicnode.com` |
| `ETH_RPC_FALLBACK` | No | Fallback RPC — defaults to `https://eth.drpc.org` |
| `cloudflared` | No | Only needed for Cloudflare Tunnel hosting. If you have a static IP, you can point DNS A records at it instead — no tunnel needed. |
**API base URL** is hardcoded to `https://api.agieth.ai` — no configuration needed.
## How Payments Work
Domain registration payments are made **on the Ethereum blockchain** — the agieth API generates a unique payment address and ETH amount for each quote. You can pay using **any Ethereum wallet** (MetaMask, Rabby, hardware wallet, etc.) by sending the exact ETH amount to the address returned by the API — no private key needs to be provided to this skill.
The `send_payment` method is included as a convenience for fully-automated workflows. If you prefer manual payment or a different wallet, simply use the `payment_address` and `price_eth` from the quote response in your own wallet.
**Summary:**
- Payments are ETH transfers on the Ethereum blockchain
- No tokens, no smart contracts, no third-party custody of funds
- Payment address and amount are unique per quote and expire with the quote
- External RPC endpoints used: `https://ethereum.publicnode.com` and `https://eth.drpc.org`
## Installation
1. Get an API key from [api.agieth.ai](https://api.agieth.ai/api/v1/keys/create)
2. Set environment variables:
```bash
export AGIETH_API_KEY="agieth_your_key_here"
export AGIETH_EMAIL="your_email@example.com"
# Only needed for automated payments (optional — see How Payments Work above):
export ETH_WALLET_PRIVATE_KEY="0x..."
```
Or create a `.env` file in your workspace:
```
AGIETH_API_KEY=agieth_your_key_here
AGIETH_EMAIL=your_email@example.com
# Only needed for automated payments:
ETH_WALLET_PRIVATE_KEY=0x...
# Optional RPC overrides:
ETH_RPC_PRIMARY=https://your-preferred-rpc
ETH_RPC_FALLBACK=https://your-fallback-rpc
```
## Quick Start
```python
from skill import AgiethClient
# Initialize with environment variables
client = AgiethClient()
# Or pass credentials directly
client = AgiethClient(
api_key="agieth_your_key_here",
email="your_email@example.com"
)
# Check domain availability
result = client.check_availability("example.com")
# {"available": True, "price_usd": 12.99}
```
## All Methods
### Domain Operations
```python
# Check availability
client.check_availability("example.com")
# Create quote (starts registration)
quote = client.create_quote(
domain="example.com",
years=1,
registrar="namecheap"
)
# Get quote status
client.get_quote(quote_id)
# Check payment status
client.check_payment(quote_id)
# Get domain info
client.get_domain_info("example.com")
```
### DNS Management
```python
# List DNS records
client.list_dns_records("example.com")
# Add DNS record
client.add_dns_record(
domain="example.com",
record_type="A",
name="www",
value="192.168.1.1"
)
# Delete DNS record
client.delete_dns_record("example.com", record_id)
```
### Cloudflare Integration (FREE)
```python
# Create Cloudflare zone
zone = client.create_cloudflare_zone("example.com")
# List zones
zones = client.list_cloudflare_zones()
# Create DNS records in Cloudflare
client.create_cloudflare_dns_record(
zone_id=zone["zone_id"],
record_type="A",
name="@",
content="192.168.1.1"
)
# Create page rule (www redirect)
client.create_page_rule(
zone_id=zone["zone_id"],
target_url="www.example.com/*",
forward_url="https://example.com/$1"
)
```
### Cloudflare Tunnel Hosting (optional — cloudflared not required)
```python
# Create tunnel (no public IP needed)
result = client.create_tunnel("example.com", local_port=3000)
# Returns tunnel_token
# Run: cloudflared tunnel run --token <tunnel_token>
```
**Alternative:** If you have a static IP, you can skip cloudflared entirely. Just add an A record pointing to your static IP instead.
### Balance & Credits
```python
# Check balance
balance = client.get_balance()
# Check credits
credits = client.get_credits()
```
## Pricing
| Service | Cost |
|---------|------|
| Domain registration | Registrar price + markup |
| Cloudflare DNS | FREE |
| Cloudflare Tunnel | FREE |
| SSL Certificates | FREE |
## Cloudflare Authorization
The tunnel feature uses **agieth.ai's Cloudflare account** — not yours. Agieth creates the tunnel, gives you a token, and Cloudflare sees all traffic as agieth's. You do NOT need your own Cloudflare API token for this skill to work.
## Security Notes
- API keys should be treated as secrets
- Only provide keys with minimum required permissions
- **Always verify the `payment_address` returned by the API before sending crypto** — the skill surfaces the address from the server response
- The skill sends the API key via the `Authorization: Bearer` HTTP header exclusively (no query parameters)
- This skill makes network requests to:
- `https://api.agieth.ai` (main API)
- `https://ethereum.publicnode.com` and `https://eth.drpc.org` (Ethereum blockchain RPC — for ETH balance checks and transaction broadcasting)
- `https://cloudflare.com` (via cloudflared tunnel, when tunnel feature is used — optional)
## API Documentation
Full API documentation: https://api.agieth.ai/api/v1/manifest
## Links
- **API Docs:** https://api.agieth.ai/api/v1/manifest
- **Homepage:** https://agieth.ai
- **Skill Guide:** https://github.com/larkins/one_shot_site
- **Support:** support@agieth.ai
标签
skill
ai
