Backend Overview

Tech Stack

Layer	Technology
Runtime	Node.js ≥ 20 (`node:http` — no framework)
Language	TypeScript (ESM, run via `tsx`)
Auth	Web3Auth JWT verification
Storage	Neon Postgres (JSONB) / In-memory
On-chain	viem + `@metamask/delegation-toolkit`
AI	Venice AI (deliverable verification)
Relayer	1Shot (USDC-gas payouts)

The backend uses no framework — routing is a string-split dispatcher in app.ts. Every domain is a vertical slice:


model (repository) → service (business logic) → route (HTTP handler) → wired in app.ts

createApp(options) lets every repository and service be overridden, so tests inject in-memory repos and never touch a database:


const server = createApp({
  skipAuth: true,
  jobRepository: new InMemoryJobRepository(),
  // ... other overrides
})