Antseed Explorer MCP Server

AntSeed Demand Explorer

Live at antfeed.org

An open-source, on-chain index of buyer activity on the AntSeed P2P AI services network. Provider/seller activity is already surfaced on antseed.com/network; this app fills the gap on the demand side: who is spending USDC on inference, with which providers, and how reliably.

Not affiliated with the AntSeed team.

---

What it does

1. Funded buyers — per-depositor volume, sessions, unique sellers, ghost-session count, and a derived Buyer Trust Score (0–100).
2. Network leaderboard — sortable, filterable buyer ranking.
3. Network overview — daily settlement volume, active buyers, last 30 days.
4. Token usage detail — input/output tokens and request count from AntseedStats.MetadataRecorded, with legacy settled-session metadata decoded only after validation.
5. Public scoring API — GET /api/score/[address] returns the trust score JSON for any address.

---

Stack

• Next.js 15 (App Router) + TypeScript
• viem for Base reads (no wallet, read-only)
• Neon Postgres + Drizzle ORM (HTTP driver, serverless-friendly)
• Tailwind CSS, Recharts

---

Getting started locally

cp .env.example .env       # fill DATABASE_URL with a Neon DB or a local Postgres
npm install
npm run db:push            # apply schema to your DB
npm run dev

---

Environment variables

---

Contract integration

Core settlement contract: AntseedChannels on Base mainnet, 0xBA66d3b4fbCf472F6F11D6F9F96aaCE96516F09d, deployed at block 45,667,842. Auxiliary indexers also read AntseedStats, ANTS, staking, deposits, and identity events for token accounting, holder state, DAU, and address enrichment.

Per-buyer aggregates are recomputed in SQL on every sync — no event replay needed for score recomputes. The indexer runs reconcileDrift() after each pass to catch rare partial-sync races.

---

Buyer Trust Score

lib/score.ts, 0–100, four sub-scores:

• Volume (0–30) — log10(USDC + 1) / log10(100) × 30. $100 settled = 30.
• Consistency (0–25) — log10(sessions + 1) / log10(50) × 25.
• Diversity (0–25) — <3 unique sellers = 0; 3 = 10; 10+ = 25.
• Reliability (0–20) — settled / (settled + ghost) × 20.

A buyer with ≥3 distinct settled sellers earns the Qualified Proven Sign badge.

---

Public APIs

GET  /api/stats                      Network aggregates + 30d daily series
GET  /api/buyers?limit=&offset=&qualified=&minScore=&sort=
GET  /api/buyers/{address}           Buyer detail + sessions + top sellers
GET  /api/score/{address}            Trust score JSON
POST /api/sync?force=1               Manual indexer pass (Bearer sync secret required)

/api/score/{address} example:

{
  "address": "0x…",
  "score": 73,
  "tier": "trusted",
  "qualified": true,
  "breakdown": {
    "total": 73,
    "volume": 24.1,
    "consistency": 18.0,
    "diversity": 18.6,
    "reliability": 12.0,
    "qualified": true
  },
  "stats": { "…": "raw indexed counters" }
}

---

Operations

• Vercel cron is the scheduled indexer owner. vercel.json runs /api/cron/sync every five minutes; do not add an external minute-level cron for the same endpoint.
• /api/cron/hero is an authenticated manual repair endpoint only. Call it with ?repair=1 after confirming /api/cron/sync cannot refresh the hero snapshot.
• Runtime contract checks require an explicit target: API_RUNTIME_BASE_URL=http://localhost:3000 npm run test:api-runtime and CSP_RUNTIME_URL=http://localhost:3000 npm run test:csp-runtime.
• Verify shared public API rate-limit storage after migrations with npm run check:rate-limit-storage; otherwise the app falls back to per-instance limits until the table exists.

---

Project layout

antseed-explorer/
  app/
    layout.tsx                  # nav + Sync button
    page.tsx                    # / overview + top 10
    buyers/page.tsx             # /buyers leaderboard
    buyers/[address]/page.tsx   # buyer detail
    api/
      cron/sync/route.ts        # cron-driven indexer pass
      sync/route.ts             # authenticated manual sync endpoint
      buyers/route.ts
      buyers/[address]/route.ts
      stats/route.ts
      score/[address]/route.ts
    components/                 # Charts, Badges, CopyButton, UI helpers
  lib/
    schema.ts                   # Drizzle Postgres schema
    db.ts                       # Neon HTTP client + state helpers
    queries.ts                  # all reads used by pages/APIs
    indexer.ts                  # getLogs loop, ghost detection, recompute, reconcile
    antseed.ts                  # contract addresses + ABI
    chain.ts                    # viem client
    score.ts                    # Buyer Trust Score
    format.ts
  scripts/
    sync-cli.ts                 # local CLI sync against DATABASE_URL
  drizzle/                      # generated migrations
  vercel.json                   # cron config + maxDuration

---

Contributing

Issues and PRs are welcome. The most useful contributions right now:

• Improved scoring models or new score dimensions
• Additional on-chain event types or contract support
• UI improvements and new views (e.g. seller-side explorer)
• Better RPC resilience / retry logic in the indexer

Open an issue to discuss before submitting a large change.