# Halowerk Onchain Identity - EAS Attestation Reader

> Halowerk Onchain Identity - EAS Attestation Reader is a paid API for AI agents from ident.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches and categorizes Ethereum Attestation Service (EAS) records for a given address, separating attestations into valid, revoked, expired, and self-issued states.

## Facts

- Endpoint: POST https://ident.halowerk.com/v1/onchain-identity
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-onchain-identity-eas-attestation-reader-ea1c58d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oSMq4HvAHD7mJ6kE27Gsv

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 halowerk-onchain-identity-eas-attestation-reader-ea1c58d3 -d '<json body>'
```

Example prompt: Pull all the Ethereum Attestation Service records for wallet address 0xAbCd...1234 and break them down by state — tell me which ones are currently valid, which have been revoked, which expired, and which the address issued to itself.

## When to prefer this

Choose this endpoint when you need to assess the onchain identity credibility of an Ethereum address based on EAS attestations, especially when the distinction between valid, revoked, expired, and self-issued attestations matters. It is preferable to raw EAS queries because it pre-categorizes attestation states and decodes schema fields, saving the agent from doing that processing. Useful for DeFi access control, DAO membership checks, reputation scoring, and due diligence on wallets.

## Known failure modes

- Invalid or malformed Ethereum address returns a validation error
- Address with zero attestations returns empty categorized lists
- Network or RPC issues may cause timeouts when fetching onchain data
- Schema decoding may fail for non-standard or deprecated EAS schemas
- Rate limiting or payment failure prevents the call from executing

## How this service works

Reads Ethereum Attestation Service records for an address and sorts them by what they are actually worth. Each attestation carries its issuer, schema, decoded field values, issue time and expiry. The result separates four states that look identical in a raw list: currently valid, revoked by the issuer, expired, and self-issued — an attestation someone wrote about themselves proves nothing and is counted apart rather than mixed into the total.

## Output

A structured list of EAS attestation records for the queried address, each with issuer address, schema identifier, decoded field values, issue time, and expiry. Records are partitioned into four named categories: currently valid, revoked by issuer, expired, and self-issued — making the trust value of each attestation immediately interpretable rather than requiring manual filtering of a raw list.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "optimism",
    "arbitrum",
    "sepolia"
   ],
   "type": "string",
   "default": "base",
   "description": "Which chain to read."
  },
  "limit": {
   "type": "integer",
   "default": 25,
   "maximum": 100,
   "minimum": 1,
   "description": "How many to read."
  },
  "address": {
   "type": "string",
   "maxLength": 64,
   "description": "The address to look up."
  },
  "direction": {
   "enum": [
    "received",
    "issued"
   ],
   "type": "string",
   "default": "received",
   "description": "received = attestations about this address, issued = attestations it made."
  },
  "schema_id": {
   "type": "string",
   "maxLength": 80,
   "description": "Only attestations of this schema."
  },
  "include_revoked": {
   "type": "boolean",
   "default": true,
   "description": "Include revoked attestations (they stay in the count either way)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-onchain-identity-eas-attestation-reader-ea1c58d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ident.halowerk.com](https://www.zero.xyz/host/ident.halowerk.com/llms.txt)