[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_121":122},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":57,"_58":-5,"_59":51,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":-5,"_83":-5,"_84":-5,"_85":86,"_87":-5,"_88":45,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_99":100},"apiUrl","https://odel.app/api","creator","walletlink","moduleId","wallet-identity","@walletlink/wallet-identity","displayName","walletlink.social","tagline","Resolve wallet addresses to X and Farcaster accounts, and back again.","iconKey","external/e5da0b0691edb77285893f4cfd88139e6386aae8781e3b604314f527248528e3.png","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://walletlink.social/api/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","priceCredits",0,"creatorUserId","system:external-import","createdAt",1787637220000,"updatedAt",1790466853000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=social.walletlink%2Fwallet-identity","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",1,"upstreamUpdatedAt",1790385918000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt",1790453652000,"githubRepoUrl","https://github.com/starl3xx/wallet-to-social","githubRepoFullName","starl3xx/wallet-to-social","releaseId","ext-starl3xx-wallet-to-social","version","1.4.0","descriptionMarkdown","

\n $\"walletlink.social\"$ \n\n

walletlink.social

\n\n

Turn wallet addresses into the people behind them, and reach them where they already are

\n\n

\n $\"Next.js$ \n $\"TypeScript\"$ \n $\"Neon$ \n $\"Farcaster\"$ \n $\"Vercel\"$ \n

\n\n

\n App ·\n Docs ·\n API ·\n @walletlinkETH\n

\n\n---\n\n## How it works\n\n```\nWallet list in (CSV · contract address · paste)\n ├─ Resolve against a 4.85M-wallet identity index\n ├─ Farcaster: complete protocol coverage, refreshed daily\n ├─ X handles: attested first, labeled always, never inferred\n ├─ Rank by holdings × follower reach\n └─ Export CSV, or an X list ready to import\n```\n\nIt also runs backwards: give it an X handle or a Farcaster username and it returns the wallets attached to that person.\n\n---\n\n## Coverage, stated honestly\n\nThe number most tools quote is the one that flatters them. Two numbers matter here, and conflating them will make you plan a campaign you cannot run.\n\n| Question | Answer |\n| ------------------------------------------------------------------ | ----------------- |\n| Wallets with an X or Farcaster account | 16-46% by chain |\n| What tools that match wallets to social accounts typically publish | low single digits |\n\nThe chain decides this more than the collection does: Base sits at the top of that range because Base is where Farcaster lives, Ethereum near the bottom. The measured per-chain table lives in the [coverage docs](https://docs.walletlink.social/concepts/coverage). Use your chain’s figure, not an average.\n\nHaving an account and reaching it are different claims. Of 473,215 X handles resolved, 70.1% are live, 20.1% suspended and 9.8% are names nobody holds. Matches carry that answer wherever the handle has been resolved.\n\n| Network | Nature of the match |\n| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Farcaster** | Complete. Every account and its addresses, refreshed daily. Matching is deterministic, so a miss is real information rather than missing information. |\n| **X** | Attested first, labeled always. Over 99.8% of handles were published by the wallet owner themselves: a Farcaster verification, an onchain ENS record, an attested-social sign-in, or a manually verified record. Anything else is correlated and labeled so in its evidence class, so a match always tells you how it was established. Nothing is inferred from display names, bios or timing. |\n\nCoverage would be higher if we guessed. Contacting the wrong person is worse than contacting fewer people.\n\n---\n\n## Features\n\n| | |\n| -------------------- | ------------------------------------------------------------------------------------------------- |\n| **Three ways in** | CSV upload, contract import (holders fetched for you), or pasted addresses |\n| **Eight chains** | Ethereum, Base, Robinhood Chain, Arbitrum, Polygon, Optimism, BNB Chain, HyperEVM (NFT only) |\n| **Priority scoring** | `holdings × log₁₀(followers + 1)`, weighting reach and stake together |\n| **Agent detection** | 13,622+ known AI agent wallets, flagged only where the owner attested nothing that says otherwise |\n| **Reverse lookup** | X handle or Farcaster username back to wallets |\n| **Public API** | Included with every pack, drawing the same credits; self-serve keys |\n| **MCP server** | Eight tools at `/api/mcp`, OAuth or the same key, same balance; listed in the MCP registry |\n| **Onchain rail** | `$1` Agent pack for USDC on Base at `/api/x402/buy`, no account; key recovery by wallet signature |\n| **Exports** | Full CSV sorted by priority, or a plain handle list for an X list import |\n\n---\n\n## Pricing\n\nCredit packs, bought once and metered in **matches**. A match is a wallet resolved to an X handle or a Farcaster account; a wallet that resolves to nothing costs nothing. Credits last 12 months from purchase. There are no subscriptions.\n\n| Pack | Price | Matches | Fits |\n| -------- | ----- | ----------------------- | ------------------------------- |\n| Free | $0 | 100 per rolling 30 days | Trying it on a real list |\n| Trial | $29 | 250 | One list, once |\n| Campaign | $99 | 1,500 | A launch or an airdrop |\n| Scale | $299 | 6,000 | Several lists, or one large one |\n| Index | $899 | 25,000 | Agencies and repeat work |\n\nEvery pack includes the same features; packs differ only in how many matches they hold. `lib/packs.ts` is the source of truth: the pricing modal, the checkout, the comparison pages and the schema.org offers all read from it.\n\n---\n\n## API, MCP and the agent rail\n\nThree doors into the same index, drawing the same match balance. The full reference, including credit costs, rate limits and error codes, is at **[docs.walletlink.social](https://docs.walletlink.social/api-reference/introduction)**; the README does not restate it.\n\n**REST.** Keys are self-serve from the account menu for any signed-in account, including one on the free allowance. A call draws credits only for wallets that resolve, so the key and the balance are separate questions.\n\n```bash\ncurl https://walletlink.social/api/v1/wallet/0xd8da...96045 \\\n -H \"Authorization: Bearer wts_live_YOUR_KEY\"\n```\n\n**MCP.** `https://walletlink.social/api/mcp`, eight tools over the same endpoints, with a bearer key or an OAuth 2.1 connection. Listed in the official MCP registry as `social.walletlink/wallet-identity`. The design rationale (why the access token is an `api_keys` row, why the server bills nothing of its own) lives in the header of `app/api/mcp/route.ts`.\n\n**The skill file.** `https://walletlink.social/skill.md`, for an agent that installs a capability from a URL rather than a config block: the tools, what each costs, how to authenticate, how to read a result. Generated from the same constants and canonical sentences as everything else, so it cannot quote a price the product does not charge.\n\n**Onchain rail.** `POST /api/x402/buy` sells a $1 Agent pack for USDC on Base with no account, no card and no email: pay, and the response carries a fresh API key. `/api/x402/recover` reissues a key to the wallet that paid, on a signed challenge.\n\n**Apify.** [Wallet to Twitter & Farcaster Lookup](https://apify.com/starl3xx/wallet-to-twitter-farcaster-lookup) wraps the REST API as a marketplace Actor, for people who buy tooling by browsing rather than by reading docs. Free to run, and it takes the caller’s own key, so it spends the same free allowance and the same packs. Source in `integrations/apify-actor/`.\n\n---\n\n## Architecture\n\n```\nCSV / contract / paste\n ↓\n lib/csv-parser.ts ──── detects wallet + holdings columns\n ↓\n /api/jobs ──────────── creates a job; lib/job-processor.ts runs it in chunks, the client polls\n ↓\n ┌─ social_graph ─────── fresh rows and persisted negatives short-circuit\n ├─ wallet_cache ─────── 7-day TTL, negatives included\n └─ resolution pipeline identity sources, then optional ENS text records\n ↓\n social_graph ─────────── positives and negatives persisted\n ↓\n ResultsTable ─────────── virtualized, sortable, exportable\n```\n\nNegatives are persisted deliberately. “Checked, nothing there” is an answer worth keeping, and it is what stops the pipeline paying repeatedly to rediscover the same absence.\n\n---\n\n## Tech stack\n\n| Layer | Tech |\n| --------------- | -------------------------------------------------------------------- |\n| Framework | Next.js 16, App Router |\n| Database | Neon PostgreSQL, Drizzle ORM |\n| Styling | Tailwind CSS v4 |\n| UI | Radix primitives |\n| Background jobs | Vercel Cron (`/api/jobs/worker`) |\n| Payments | Stripe |\n| Docs | Mintlify at [docs.walletlink.social](https://docs.walletlink.social) |\n| Hosting | Vercel |\n\n---\n\n## Project structure\n\n```\napp/\n api/v1/ public API (wallet, batch, reverse, stats, usage)\n api/developer/ API key management\n api/cron/ scheduled ingest and refresh\n vs/ competitor comparison pages\ncomponents/ UI, including ApiKeysModal and DocsChat\nlib/ resolution pipeline, chains, plans, rate limiting\ndocs-site/ published Mintlify docs ← customer-facing\ndocs/ internal runbooks ← never published\n```\n\n`docs-site/` and `docs/` are deliberately separate. `docs/` holds operational runbooks and is not the Mintlify content root.\n\n---\n\n## Public on purpose\n\nThis repo is public deliberately. The product’s core claim is that every match carries the class of evidence behind it and none of it is inferred, and public code is what makes that claim checkable. What stays out is equally deliberate: `docs/` is internal and never published, and operational secrets live in a private ops repo.\n\n---\n\n## Getting started\n\n```bash\nnpm install\ncp .env.example .env.local # fill in what you need\nnpm run dev\n```\n\nOpen [localhost:3000](http://localhost:3000). The app runs without a database; caching, history and the API need one. `.env.example` documents every variable: `DATABASE_URL` enables anything stateful, the Stripe keys enable payments, and identity-source credentials are listed beside their entries.\n\n---\n\n## Commands\n\n```bash\nnpm run dev # dev server\nnpm run build # production build (typechecks as part of the build)\nnpm run typecheck # tsc --noEmit, the faster standalone check\nnpm run preflight # every CI gate that needs no database, no Chrome and no secrets\nnpm run lint # ESLint\nnpm run format # Prettier (CI enforces formatting)\n\nnpm run db:push # refuses; schema changes are hand-written SQL, see CLAUDE.md\nnpm run db:studio # Drizzle Studio\n```\n\n`npm run check:` runs one gate alone (palette, design, contrast, og, invariants, figures, height); `package.json` names them all.\n\n---\n\n## Contributing\n\nChanges go through a branch and a PR, never straight to `main`. The PR template asks for an explicit docs decision and CI enforces it: a PR touching the public API surface fails unless `docs-site/` moves with it, or carries the `no-docs-needed` label.\n\nSee [CLAUDE.md](https://github.com/starl3xx/wallet-to-social/blob/main/CLAUDE.md) for conventions, including house style (sentence case headings, curly apostrophes, “onchain” as one word).\n\n---\n\n## Changelog\n\nSee [CHANGELOG.md](https://github.com/starl3xx/wallet-to-social/blob/main/CHANGELOG.md).\n\n---\n\n## License\n\nAGPL-3.0. See [LICENSE](https://github.com/starl3xx/wallet-to-social/blob/main/LICENSE).\n\n## Author\n\nmade with 🌠 by [@starl3xx](https://x.com/starl3xx)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt",1790008818000,"priceCents","trialDays","iconType","image","upstream",{"_108":109,"_110":111,"_112":113,"_114":115,"_116":117,"_118":119},"requiredSecrets",[],"tags",[103,104,105,21,106,107],"assets",[],"stats",{"_101":45,"_102":45},"ratingAvg","reviewCount","agent-tools","ens","farcaster","web3","x402","topics",[103,104,105,120,21,106,107],"license","AGPL-3.0","language","TypeScript","registryName","social.walletlink/wallet-identity","homepage","https://docs.walletlink.social/mcp-server","packages",[],"mcp-server","ENV",{"_123":124,"_125":126,"_127":128,"_129":-7},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272","SENTRY_ENABLE_LOCAL"]