web3-discover-cli

Terminal frontend for web3-discover.vercel.app — paste a wallet, get an airdrop eligibility verdict, no signup, no wallet signing, no install.

npx github:SolvoHQ/web3-discover-cli check 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

web3-discover verdict for EVM 0xd8dA…6045
Checked 14 on-chain rules across 42 curated airdrops.

  ✓ Likely eligible  9
  ~ Keep farming     0
  ? Manual check     28   (own L1 / off-chain / KYC — no auto rule)
  · Not relevant     5

✓ Act on these — 9
  Arbitrum STIP unlock · arbitrum · risk low · deadline ongoing
    Holds 1,201 ARB
    https://arbitrum.io/
  Base (Coinbase L2) · base · risk low · deadline ongoing
    192 tx on Base (≥ 1 required)
    https://base.org/
  …

Why a CLI

The same eligibility logic powering web3-discover.vercel.app/tools/eligibility — but you can drop the command in a tweet, a thread, a Discord, a shell script. No JS bundle, no wallet popup, no cookie banner.

Install (zero install)

You don't install it. npx runs the latest from GitHub:

npx github:SolvoHQ/web3-discover-cli check 0x…
npx github:SolvoHQ/web3-discover-cli list
npx github:SolvoHQ/web3-discover-cli --help

Requires Node 18+ (for the global fetch).

If you really want it on your PATH:

npm install -g github:SolvoHQ/web3-discover-cli
web3-discover check 0x…

Commands

check <address>

Eligibility verdict for an EVM (0x + 40 hex) or Solana (base58, 32–44 chars) address. Buckets the 42 curated airdrops into:

Bucket	Meaning
✓ Likely eligible	An on-chain rule passes (chain tx count, ERC-20 balance, Solana sig, SPL balance).
~ Keep farming	You've started but haven't crossed our threshold. Worth more cycles before TGE.
? Manual check	Lives on its own L1/L2 (no free CORS-open RPC) or has off-chain criteria (KYC / Galxe / Discord). Listed so you can review yourself.
· Not relevant	Rule failed. Most likely safe to skip.

Flags:

• --json — print raw JSON, skip pretty-printing. Useful for scripting.
• --base <url> — point at a different API host (default: https://web3-discover.vercel.app).

list

The active curated airdrop directory, sorted by deadline. Columns: project, chain, risk, effort, deadline.

Flags:

• --limit N — cap output (default 30).
• --json — raw JSON.

--help, --version

Self-explanatory.

How it works

Two endpoints on the live site, both CORS-open and CDN-cached:

• GET /api/airdrops.json — the full 42-entry snapshot. CC0. Same data the data mirror ships.
• GET /api/eligibility.json?evm=0x…&sol=… — server-side runs the same on-chain rule fanout the /tools/eligibility page does in the browser. Returns the same buckets.

The CLI is a thin terminal renderer over those two endpoints. No RPC drivers, no key files, no persistent state, no analytics, no telemetry. Your address goes from this CLI to the eligibility endpoint, which forwards to public RPCs (publicnode) — same path the browser tool takes.

This is a tool for surfacing attention, not for proving eligibility. Final eligibility lives on each project's page (every result includes the official URL).

Examples

# Vitalik
npx github:SolvoHQ/web3-discover-cli check 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

# A public Solana wallet
npx github:SolvoHQ/web3-discover-cli check 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

# What's live this week, machine-readable
npx github:SolvoHQ/web3-discover-cli list --json | jq '.entries[] | select(.deadline | startswith("2026"))'

License

MIT. See LICENSE.

The airdrop data the CLI ships against is CC0 — see SolvoHQ/web3-discover-data.

Links

• Main site: https://web3-discover.vercel.app
• Browser version of check: https://web3-discover.vercel.app/tools/eligibility
• Data mirror (CC0): https://github.com/SolvoHQ/web3-discover-data
• MCP server (for LLM clients): https://web3-discover.vercel.app/api/mcp

Not investment advice

Airdrop rules change. Eligibility surfaces can move. Verify every action on the project's own page before signing anything.