Skip to content

Conversation

@alextnetto
Copy link
Member

Summary

New microservice (apps/address-enrichment) that enriches Ethereum addresses with identity data from Arkham Intel API.

Features

  • REST API to lookup address labels, entity info, and contract/EOA type
  • Permanent PostgreSQL storage (fetch once, store forever - protects against API access loss)
  • Batch endpoint for resolving up to 100 addresses at once
  • CLI sync command to pre-populate top delegates and token holders from Anticapture API
  • Gateway integration - exposed via GraphQL Mesh

Endpoints

  • GET /address/:address - Single address lookup
  • POST /addresses - Batch lookup (max 100)

Tech Stack

Hono, Drizzle ORM, viem, Arkham Intel API

New Environment Variables

- Hono REST API with GET /address/:address endpoint
- Arkham Intel API integration for entity/label data
- EOA/contract detection (Arkham fallback to RPC)
- PostgreSQL permanent storage via Drizzle ORM
- CLI sync command to batch-fetch top delegates and holders
- OpenAPI/Swagger documentation at /docs
- Fix GraphQL BigInt values (use strings instead of numbers)
- Show voting power and balance with K/M/B formatting
- Display Arkham data (entity, label, type) for all addresses
- Show contract indicator for contract addresses
- POST /addresses accepts array of up to 100 addresses
- Processes in parallel with concurrency limit of 10
- Returns results array and errors array for partial failures
- Deduplicates addresses automatically
- Add address-enrichment as OpenAPI source in GraphQL Mesh
- Exposes getAddressEnrichment and batchAddressEnrichment queries
- Service is optional (only loaded if ADDRESS_ENRICHMENT_API_URL is set)
@vercel
Copy link

vercel bot commented Jan 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
anticapture Error Error Jan 23, 2026 1:49am
1 Skipped Deployment
Project Deployment Review Updated (UTC)
anticapture-storybook Skipped Skipped Jan 23, 2026 1:49am

Request Review

@pikonha pikonha marked this pull request as draft January 26, 2026 20:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants