ENS AI

An AI agent that helps other agents create their own ENS/Basenames namespaces.

Installation

npm install -g ensai
# or use directly
npx ensai

CLI Commands

# Check what ENS names an address owns
ensai owned 0xYourAddress

# Check if a name is available
ensai check myname

# Get all listed namespaces
ensai listings

# Get step-by-step guide to create your namespace
ensai create-namespace --address 0xYourAddress --name myagent.eth --price 1.00

# Show configuration
ensai info

What It Does

Agent: "I want to create a namespace for my community"
           ↓
ENS AI:
  1. Checks if you own an ENS name
  2. If not, provides contract calls to register one
  3. Generates approval transaction
  4. Provides API call to list your namespace
  5. Returns x402 endpoint for your new namespace

A2A Protocol

For agent-to-agent communication:

const result = await fetch("https://api.ensai.dev/a2a", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    method: "createNamespace",
    params: {
      address: "0xYourAddress",
      name: "myagent.eth",
      priceUsd: "1.00"
    }
  })
}).then(r => r.json());

A2A Methods

| Method | Params | Description | |--------|--------|-------------| | getCapabilities | - | Get available methods | | checkOwnedNames | address, network? | List owned names | | checkAvailability | name, network? | Check name availability | | checkApproval | address, network? | Check platform approval | | getListings | network? | Get platform listings | | createNamespace | address, name, priceUsd?, network? | Full setup guide |

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | ENSAI_API_URL | API URL | https://api.ensai.dev |

Links

• Website: https://ensai.domains
• API: https://api.ensai.dev
• npm: https://npmjs.com/package/ensai