How Wallet Match works

A short tour of the resolver pipeline, confidence tiers and credit settlement.

The resolver pipeline

For every Twitter handle we run a layered set of resolvers in order from cheapest to most expensive, short-circuiting as soon as we find a high-confidence match:

  1. Local DB — our shared wallet_matches table from previous scans.
  2. web3.bio — aggregates ENS, Farcaster, Lens, Ethereum addresses.
  3. Neynar — Farcaster connected addresses, verified Twitter accounts.
  4. ENS subgraph —com.twitter text record owners.
  5. Bio / URL parse — scans bio, display name, location, URL and pinned tweet for 0x…, .eth, .base.eth, .sol addresses.
  6. OpenSea — link verification for users who added their handle on OpenSea.

Confidence tiers

  • Verified — one of the resolvers returned an explicit verified link (ENS text record, Farcaster verification, Neynar verified Twitter). We trust these by default.
  • Likely — match found by parsing or a single unverified source. Shown but flagged amber. Two independent likely sources automatically promote to verified.
  • Community — three user confirms auto-promotes a match to verified; two rejects hide it.

Credit settlement

When a scan starts, we reserve the estimated credits up front. As each handle resolves, we debit the real cost and refund the difference if we served it from cache. If a scan runs out of credits mid-flight, the remaining resolves pause until you top up — nothing is lost.

FAQ

Are my scan results private?
The list of handles you scanned is. The resolved matches themselves enrich the shared wallet_matches cache — that's what keeps repeat lookups free.
Can I request data deletion?
Yes — email support. We'll remove your scans, ledger history and annotations on request within 30 days.
Do I need a crypto wallet to pay?
No — we use NOWPayments invoices, which generate a deposit address for a coin of your choice. Send funds from any exchange or wallet. No wallet connect required.
What happens when a match is wrong?
Click the thumb-down on the match — two community rejects hide it from everyone's scans. Thumb-up similarly promotes accurate matches.