@verivyx/paywall-express

Express adapter for the Verivyx paywall SDK — gate content from AI bots, charge agents on-chain via x402, let humans read free, and serve search crawlers an SEO preview (verified against published Googlebot/Bingbot IP ranges).

Requires @verivyx/paywall (installed automatically) and express (peer dependency).

Install

npm i @verivyx/paywall-express

Quickstart — one middleware (recommended)

app.use(verivyxMiddleware(...)) gates every matched route: AI bots/agents get a 402 (and can pay via x402), verified humans read for free, crawlers get an SEO preview.

import express from "express";
import { verivyxMiddleware } from "@verivyx/paywall-express";

const app = express();
app.set("trust proxy", true);

app.use(verivyxMiddleware({
  token: process.env.VERIVYX_TOKEN,   // required — your site token (or set VERIVYX_TOKEN env)
  match: ["/articles/*"],
  seoPreview: ({ slug }) => ({ title: titleFor(slug), excerpt: excerptFor(slug) }),
  humanUnlock: {},   // humans solve an in-page PoW → read full content free
}));

app.get("/articles/:slug", (req, res) => res.send(renderArticle(req.params.slug)));
app.listen(3000);

Reads VERIVYX_TOKEN from env when not passed inline.

Per-route alternative

import { verivyxExpress } from "@verivyx/paywall-express";
const vx = verivyxExpress();
app.get("/articles/:slug", vx.protect(async (req, res) => res.json({ content: "..." })));

Config

All options can be passed to verivyxMiddleware(opts) / verivyxExpress(opts) or set via env.

| Option / env var | Required | Description | |---|---|---| | VERIVYX_TOKEN | yes (server-only) | Your site token from the Verivyx dashboard — it alone identifies your site | | VERIVYX_DOMAIN | no | Optional legacy/analytics label, e.g. example.com. Not required and not part of onboarding — the token identifies your site. | | match / VERIVYX_MATCH | no | Glob patterns to gate. Empty = nothing gated. Env accepts a comma-separated list. | | seoPreview | no | ({ slug }) => { title, excerpt } — teaser for crawlers, with anti-cloaking JSON-LD | | humanUnlock | no | { authBase? } — unverified human browsers get an in-page PoW unlock to read full content free | | failMode / VERIVYX_FAIL_MODE | no | Backend unreachable: teaser (default) | open | closed | | timeoutMs / VERIVYX_TIMEOUT_MS | no | Timeout in ms for the quick classify/requirements call (default 800). | | settleTimeoutMs / VERIVYX_SETTLE_TIMEOUT_MS | no | Timeout in ms for the authorize/settle call that awaits on-chain confirmation (default 60000, ~15s settle). No need to raise timeoutMs for agent payments — the settle path uses this. |

Also: trustProxy (default true), clientIp, advertise (RSL/AIPREF discovery headers).

This adapter is 0.7.0 and depends on @verivyx/paywall 0.3.1 (token-only).

Docs

https://docs.verivyx.com/docs/sdk