Skip to content

v1.0.0 — Fastify adapter, self-host binary, multi-chain analytics

Choose a tag to compare

@vergex402 vergex402 released this 27 Sep 14:39
· 17 commits to main since this release

v1.0.0 — Complete roadmap: Fastify adapter, self-host binary, multi-chain analytics

All Q4 2026 roadmap items are now shipped. Full open-source stack.


@vergex402/fastify — Fastify v4 adapter

npm install @vergex402/fastify
import Fastify from "fastify";
import { paywall } from "@vergex402/fastify";

const app = Fastify();

app.register(paywall({
  amount: 0.001,                    // USDG per request
  recipient: process.env.WALLET!,
  network: "robinhood-mainnet",
}));

app.get("/api/data", async (req, reply) => {
  return { data: "unlocked" };
});

Uses Fastify v4's onRequest hook. Structural typing — no hard runtime dep on fastify. Dual dialect (x402 v2 + legacy).


Self-host binary

Run the full Verge gateway on your own infra in 3 commands:

git clone https://github.com/vergex402/verge
cd verge
./scripts/setup.sh

Or manually:

cp .env.example .env.local   # fill in your values
docker-compose up -d

Includes:

  • Dockerfile — multi-stage node:22-alpine, non-root nextjs:nodejs user, standalone output
  • docker-compose.yml — verge + postgres:16-alpine, healthchecks, named volumes, restart: unless-stopped
  • scripts/setup.sh — one-command setup with dependency checks and health wait
  • docs/self-host.md — full guide: prerequisites, env var reference, docker commands, upgrading, troubleshooting

Multi-chain analytics dashboard

New Analytics tab in the developer console (/app):

  • 7-chain grid — one card per rail with volume, tx count, and status pill
  • Summary stats — total USDG volume, total settlements, dominant chain
  • Robinhood Chain shows live data from payments_log; other 6 rails show availability status
  • Available at /api/analytics (wallet-scoped)

Full SDK matrix (6 packages)

Package Version Role
@vergex402/express 0.5.0 Express server middleware
@vergex402/hono 0.5.0 Hono adapter (edge-compatible)
@vergex402/fastify 1.0.0 Fastify v4 plugin
@vergex402/fetch 1.0.0 Buyer — payAndFetch()
@vergex402/ai-sdk 1.0.0 Vercel AI SDK v7 gate
@vergex402/core 0.5.0 Shared verifier, CAIP-2

Roadmap status — all Q4 2026 items complete

  • Fastify adapter
  • Self-host facilitator binary
  • Multi-chain analytics
  • ZK batch settlement proofs (Q1 2027)

Live gateway: https://vergesnowy.com
Self-host docs: https://github.com/vergex402/verge/blob/main/docs/self-host.md
npm: https://www.npmjs.com/search?q=%40vergex402