# Beggar Bot ENS Enrichment & Resolution

> Beggar Bot ENS Enrichment & Resolution is a paid API for AI agents from beggar-bot-demand.beggarbot.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Enriches an ENS name (normalize, namehash, labelhash, token IDs, homoglyph/zero-width flags) and optionally resolves it live (resolver, owner, address, URL, contenthash) or performs reverse lookup from address to forward-verified primary name.

## Facts

- Endpoint: GET https://beggar-bot-demand.beggarbot.workers.dev/v1/ens?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beggar-bot-ens-enrichment-resolution-bbefe820
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Htno0Map1eTh8CQV-_B_Z

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 beggar-bot-ens-enrichment-resolution-bbefe820
```

Example prompt: Look up vitalik.eth for me — give me the resolved Ethereum address, owner, contenthash, and flag any homoglyph or zero-width character issues in the name.

## When to prefer this

Use this endpoint when you need a single call that combines ENS name normalization, security flagging (homoglyph/zero-width attacks), cryptographic identifiers (namehash, labelhash, token IDs), and live on-chain resolution — rather than calling multiple separate RPC methods. Ideal for agents that need to validate ENS names before processing payments, display wallet identity, or index NFT ownership of ENS names. The resolve=false mode is useful for pure offline computation without incurring RPC latency.

## Known failure modes

- ENS name not registered — resolver/owner/addr fields will be null or absent
- Invalid ENS name format — normalization error returned
- RPC unavailable — live resolution fields fail soft, compute fields still returned
- Address has no primary name set — reverse lookup returns null
- Homoglyph detection flags name as suspicious but does not block resolution

## How this service works

Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.

## Output

A JSON object containing: normalized ENS name, homoglyph and zero-width character flags, namehash, labelhash, .eth ERC-721 token ID, NameWrapper token ID; and if resolve=true (default), live on-chain data: resolver address, owner address, resolved ETH address, URL record, and contenthash. For address input, returns the forward-verified primary ENS name. Fails soft on RPC errors.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string",
       "description": "ENS name, e.g. vitalik.eth"
      },
      "address": {
       "type": "string",
       "description": "or address for reverse lookup"
      },
      "resolve": {
       "type": "string",
       "description": "true (default) | false"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beggar-bot-ens-enrichment-resolution-bbefe820/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from beggar-bot-demand.beggarbot.workers.dev](https://www.zero.xyz/host/beggar-bot-demand.beggarbot.workers.dev/llms.txt)