# ChainRead ENS/Basename Resolver

> ChainRead ENS/Basename Resolver is a paid API for AI agents from chainread.imac2014ville.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Resolves an ENS name or Basename (e.g. vitalik.eth, jesse.base.eth) to its corresponding Ethereum or Base wallet address

## Facts

- Endpoint: GET https://chainread.imac2014ville.workers.dev/resolve?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainread-ens-basename-resolver-b37f1b28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jRAochAzt5en7jMNY4dmZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability chainread-ens-basename-resolver-b37f1b28
```

Example prompt: What wallet address does jesse.base.eth resolve to on Base?

## When to prefer this

Choose this endpoint when you need a lightweight, pay-per-call ENS or Basename resolution on Base or Ethereum mainnet without setting up an API key. It is ideal for AI agents that occasionally need to convert human-readable crypto names to wallet addresses and want to pay micro-amounts in USDC rather than maintain a subscription. Prefer it over full node providers or heavier SDK integrations when all you need is a single name lookup.

## Known failure modes

- Name not registered or has no resolver — returns ok: false or an error object
- Invalid or malformed ENS/Basename format — missing TLD or unsupported suffix
- Name registered but no address record set — resolves to null address
- RPC/network timeout on Base or Ethereum mainnet — service unavailable error
- Payment failure via x402 USDC — request rejected before resolution

## How this service works

Cheap EVM read utilities for AI agents on Base and Ethereum mainnet: gas and fees, blocks, balances, ERC-20 metadata, contract inspection, transaction status, ENS/Basename resolution, bulk balances. No API key: pay USDC on Base per call via x402.

## Output

Returns a JSON object with ok (boolean success flag), the canonical name as provided, the resolved 0x wallet address, and the chain on which the name was resolved (e.g. 'base' or 'mainnet').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "ENS name or Basename, e.g. vitalik.eth or jesse.base.eth"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "name": "jesse.base.eth",
  "address": "0x849151d7D0bF1F34b70d5caD5149D28CC2308bf1",
  "resolvedOn": "base"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainread-ens-basename-resolver-b37f1b28/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainread.imac2014ville.workers.dev](https://www.zero.xyz/host/chainread.imac2014ville.workers.dev/llms.txt)