DIGITX

DIGITX finds and validates high-value numeric domain candidates: repeaters, sequences, lucky numbers, technical constants, and more.

It is a pnpm TypeScript monorepo with a React interface, a Cloudflare Worker API backed by KV, and a throttled DNS/WHOIS scanner.

flowchart LR
  Scanner["GitHub Actions / scanner"] -->|"POST /api/sync"| API["Hono Worker API"]
  API <--> KV["Cloudflare KV"]
  Web["React + Vite SPA"] -->|"GET /api/domains"| API

• packages/core — typed candidate generator, deep Scan Engine, DNS/WHOIS adapters, and database helpers.
• apps/scanner — interactive CLI and scheduled batch scanner.
• apps/api — Hono Cloudflare Worker with KV storage.
• apps/web — React, Vite, Tailwind, and shadcn/ui frontend.

• Node.js 20+
• pnpm 10+
• A Cloudflare KV namespace and Worker secrets for production sync

pnpm install
pnpm test
pnpm check-types
pnpm build

Run the interactive local scanner:

pnpm cli

Run one scheduled scan batch and sync it to the API. Set API_URL and SYNC_SECRET first:

pnpm scan

For a quick local acceptance run, start the local Worker and use the isolated, small dataset command. It generates 10 candidates and checks at most 3 WHOIS records per run:

pnpm dev
pnpm scan:local

It writes its checkpoint to the ignored domains_db.local.json, so it does not affect the normal scanner state.

Run the frontend or Worker locally:

pnpm dev:web
pnpm dev:api

domains_db.json is an ignored local checkpoint for the scanner. Cloudflare KV is the production source of truth.

The Scan Engine owns the two-stage process: a concurrent Blind Scan followed by throttled WHOIS Verification. The CLI and scheduled scanner are adapters that only supply configuration and progress reporting. The WHOIS delay has a 2000ms safety floor; it cannot be reduced by caller configuration.

MIT