ForgePay

Universal payment orchestration service for the Forge ecosystem.

Handles all money movement: fiat via Stripe Connect, crypto via native Solana transactions, and token swaps via Jupiter. Zero knowledge of products, orders, or e-commerce — it only knows about payments.

Architecture Position

| Layer | Service | Depends On | |-------|---------|------------| | L3 — Consumer | Nomu, Future Products | ForgePay API | | L2 — Payment | ForgePay | ForgeConnect, Stripe, Solana RPC, Jupiter | | L1 — Identity | ForgeConnect | Nothing (external only) |

Tech Stack

| Component | Technology | |-----------|-----------| | Runtime | Node.js + TypeScript (ESM) | | Framework | Hono | | Database | Postgres (Railway — separate instance) | | ORM | Drizzle ORM | | Cache | Redis (Railway) | | Fiat Payments | Stripe Connect (@stripe/stripe-node) | | Crypto Payments | @solana/web3.js | | Token Swaps | Jupiter (@jup-ag/api) | | Job Queue | Inngest | | Validation | Zod | | Deployment | Railway |

Commands

pnpm dev              # Start dev server with watch mode
pnpm build            # Compile TypeScript to dist/
pnpm start            # Run compiled output
pnpm db:generate      # Generate Drizzle migrations
pnpm db:migrate       # Run pending migrations
pnpm db:push          # Push schema directly to DB (dev)
pnpm db:studio        # Open Drizzle Studio
pnpm db:seed          # Seed database
pnpm db:setup         # Initialize database

Monorepo Structure

forge_pay/
├── src/                  # Hono server (ForgePay API)
├── packages/react/       # @forge-pay/react SDK
├── packages/server/      # @forge-pay/server SDK
├── tests/                # Vitest test suite
├── tests/ex-nextjs/      # Next.js demo app
├── scripts/              # DB setup, key generation
└── docs/                 # Architecture docs