@itachisol/plugin-x402-swarms 0.1.0

package/dist/schemas/paymentHistory.d.ts

@@ -0,0 +1,284 @@
+export declare const x402PaymentHistory: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "x402_payment_history";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 36;
+        }>;
+        agentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "agent_id";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 36;
+        }>;
+        endpoint: import("drizzle-orm/pg-core").PgColumn<{
+            name: "endpoint";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        domain: import("drizzle-orm/pg-core").PgColumn<{
+            name: "domain";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        method: import("drizzle-orm/pg-core").PgColumn<{
+            name: "method";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        amountUsd: import("drizzle-orm/pg-core").PgColumn<{
+            name: "amount_usd";
+            tableName: "x402_payment_history";
+            dataType: "number";
+            columnType: "PgReal";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        txHash: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tx_hash";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        network: import("drizzle-orm/pg-core").PgColumn<{
+            name: "network";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payer: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payer";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        responseStatus: import("drizzle-orm/pg-core").PgColumn<{
+            name: "response_status";
+            tableName: "x402_payment_history";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        responseTimeMs: import("drizzle-orm/pg-core").PgColumn<{
+            name: "response_time_ms";
+            tableName: "x402_payment_history";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        qualityScore: import("drizzle-orm/pg-core").PgColumn<{
+            name: "quality_score";
+            tableName: "x402_payment_history";
+            dataType: "number";
+            columnType: "PgReal";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        qualityReason: import("drizzle-orm/pg-core").PgColumn<{
+            name: "quality_reason";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        responsePreview: import("drizzle-orm/pg-core").PgColumn<{
+            name: "response_preview";
+            tableName: "x402_payment_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "x402_payment_history";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=paymentHistory.d.ts.map

package/dist/schemas/paymentHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentHistory.d.ts","sourceRoot":"","sources":["../../src/schemas/paymentHistory.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyB9B,CAAC"}

package/dist/schemas/paymentHistory.js

@@ -0,0 +1,24 @@
+import { pgTable, varchar, text, real, integer, timestamp, index } from "drizzle-orm/pg-core";
+export const x402PaymentHistory = pgTable("x402_payment_history", {
+    id: varchar("id", { length: 36 }).primaryKey(),
+    agentId: varchar("agent_id", { length: 36 }).notNull(),
+    endpoint: text("endpoint").notNull(),
+    domain: text("domain").notNull(),
+    method: text("method").default("GET"),
+    amountUsd: real("amount_usd").notNull(),
+    txHash: text("tx_hash").notNull(),
+    network: text("network"),
+    payer: text("payer"),
+    status: text("status").notNull().default("confirmed"),
+    responseStatus: integer("response_status"),
+    responseTimeMs: integer("response_time_ms"),
+    qualityScore: real("quality_score"),
+    qualityReason: text("quality_reason"),
+    responsePreview: text("response_preview"),
+    createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+}, (table) => [
+    index("idx_x402_ph_agent_domain").on(table.agentId, table.domain),
+    index("idx_x402_ph_agent_created").on(table.agentId, table.createdAt),
+    index("idx_x402_ph_domain_quality").on(table.domain, table.qualityScore),
+]);
+//# sourceMappingURL=paymentHistory.js.map

package/dist/schemas/paymentHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentHistory.js","sourceRoot":"","sources":["../../src/schemas/paymentHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE9F,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CACvC,sBAAsB,EACtB;IACE,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE;IAC9C,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACtD,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACpC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACrC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACvC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IACjC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;IACxB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;IACpB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACrD,cAAc,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAC1C,cAAc,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAC3C,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC;IACnC,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;IACrC,eAAe,EAAE,IAAI,CAAC,kBAAkB,CAAC;IACzC,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;CAClF,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;IACjE,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACrE,KAAK,CAAC,4BAA4B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC;CACzE,CACF,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export { X402ServerService } from "./x402ServerService.js";
+export { x402Gate, type X402GateResult, type X402GateOptions } from "./x402Gate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,3 @@
+export { X402ServerService } from "./x402ServerService.js";
+export { x402Gate } from "./x402Gate.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAA6C,MAAM,eAAe,CAAC"}

package/dist/server/x402Gate.d.ts

@@ -0,0 +1,56 @@
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * Result of the x402 payment gate check.
+ */
+export interface X402GateResult {
+    paid: boolean;
+    transaction?: string;
+    network?: string;
+    payer?: string;
+    amountUsd: number;
+    /** Remaining free tier calls (only set when free tier is used). */
+    freeRemaining?: number;
+}
+/**
+ * Options for the x402 payment gate.
+ */
+export interface X402GateOptions {
+    /** Amount in USD (e.g. "0.05") */
+    amountUsd: string;
+    /** Human-readable description of the endpoint */
+    description?: string;
+    /** Full resource URL (constructed from request if not provided) */
+    resourceUrl?: string;
+    /** Enable free tier (3 calls/day per IP + cookie). Default: true in production. */
+    freeTierEnabled?: boolean;
+}
+/**
+ * Register a callback that fires every 100 free tier calls.
+ * Call this from server.ts after import.
+ */
+export declare function onFreeTierMilestone(cb: (stats: FreeTierStats) => void): void;
+/**
+ * Free tier usage statistics.
+ */
+export interface FreeTierStats {
+    totalFreeCallsToday: number;
+    uniqueIPs: number;
+    topIPs: Array<{
+        ip: string;
+        calls: number;
+    }>;
+}
+/**
+ * Returns current free tier usage stats across all tracked IPs.
+ */
+export declare function getFreeTierStats(): FreeTierStats;
+export declare function x402Gate(runtime: IAgentRuntime, req: {
+    headers?: Record<string, string | string[] | undefined>;
+    url?: string;
+    method?: string;
+}, res: {
+    status?: (code: number) => any;
+    json?: (body: any) => void;
+    setHeader?: (name: string, value: string) => void;
+}, options: X402GateOptions): Promise<X402GateResult>;
+//# sourceMappingURL=x402Gate.d.ts.map

package/dist/server/x402Gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402Gate.d.ts","sourceRoot":"","sources":["../../src/server/x402Gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA0CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAE5E;AAUD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAkBhD;AA6DD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/F,GAAG,EAAE;IAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,EACtH,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAqIzB"}

package/dist/server/x402Gate.js

@@ -0,0 +1,240 @@
+/**
+ * Convert USD to USDC atomic units (6 decimals).
+ */
+function usdToAtomic(usd) {
+    const parsed = parseFloat(usd);
+    if (Number.isNaN(parsed) || parsed < 0) {
+        return "0";
+    }
+    return String(Math.round(parsed * 1_000_000));
+}
+/**
+ * x402 payment gate for ElizaOS route handlers.
+ *
+ * Checks for payment in the request. If absent, sends a 402 response.
+ * If present, verifies and settles the payment.
+ *
+ * Usage in a route handler:
+ * ```
+ * const gate = await x402Gate(runtime, req, { amountUsd: "0.05" });
+ * if (!gate.paid) return; // 402 already sent
+ * // Payment verified — proceed with response
+ * ```
+ */
+// ── Free Tier: 5 calls/day per IP + cookie ───────────────────────────────────
+const FREE_TIER_LIMIT = 5;
+const freeTierMap = new Map();
+/** Running total of free tier calls (resets when all IPs expire). */
+let freeTierGlobalCount = 0;
+/** Last milestone that triggered an alert (e.g. 100, 200, 300...). */
+let lastAlertMilestone = 0;
+/**
+ * Optional callback invoked every 100 free tier calls.
+ * Registered by the server to send Telegram alerts without circular imports.
+ */
+let onMilestoneCallback = null;
+/**
+ * Register a callback that fires every 100 free tier calls.
+ * Call this from server.ts after import.
+ */
+export function onFreeTierMilestone(cb) {
+    onMilestoneCallback = cb;
+}
+// Reset daily
+setInterval(() => {
+    const now = Date.now();
+    for (const [ip, entry] of freeTierMap) {
+        if (now >= entry.resetAt)
+            freeTierMap.delete(ip);
+    }
+}, 300_000); // clean every 5 min
+/**
+ * Returns current free tier usage stats across all tracked IPs.
+ */
+export function getFreeTierStats() {
+    let totalFreeCallsToday = 0;
+    const entries = [];
+    for (const [ip, entry] of freeTierMap) {
+        totalFreeCallsToday += entry.count;
+        entries.push({ ip, calls: entry.count });
+    }
+    // Sort descending by calls, take top 20
+    entries.sort((a, b) => b.calls - a.calls);
+    const topIPs = entries.slice(0, 20);
+    return {
+        totalFreeCallsToday,
+        uniqueIPs: freeTierMap.size,
+        topIPs,
+    };
+}
+/**
+ * Parse the swarmx_usage cookie from the cookie header string.
+ * Returns the usage count from the cookie, or 0 if not present.
+ */
+function parseCookieUsage(req) {
+    const headers = req.headers ?? {};
+    const cookieHeader = headers["cookie"];
+    if (!cookieHeader || typeof cookieHeader !== "string")
+        return 0;
+    const match = cookieHeader.match(/swarmx_usage=(\d+)/);
+    if (!match?.[1])
+        return 0;
+    const val = parseInt(match[1], 10);
+    return Number.isNaN(val) ? 0 : val;
+}
+/**
+ * Check free tier eligibility using MAX(cookie_count, ip_count).
+ * Returns remaining calls (>= 0) if allowed, or -1 if exhausted.
+ * When allowed, increments both counters.
+ */
+function checkFreeTier(req) {
+    const headers = req.headers ?? {};
+    const forwarded = headers["x-forwarded-for"];
+    const ip = typeof forwarded === "string" ? forwarded.split(",")[0].trim() : "unknown";
+    const now = Date.now();
+    const dayMs = 86_400_000;
+    let entry = freeTierMap.get(ip);
+    if (!entry || now >= entry.resetAt) {
+        entry = { count: 0, resetAt: now + dayMs };
+        freeTierMap.set(ip, entry);
+    }
+    // Use MAX(cookie_count, ip_count) — both must be under limit
+    const cookieCount = parseCookieUsage(req);
+    const effectiveCount = Math.max(cookieCount, entry.count);
+    if (effectiveCount < FREE_TIER_LIMIT) {
+        entry.count = effectiveCount + 1;
+        freeTierGlobalCount++;
+        // Fire milestone callback every 100 free tier calls
+        const currentMilestone = Math.floor(freeTierGlobalCount / 100) * 100;
+        if (currentMilestone > 0 && currentMilestone > lastAlertMilestone) {
+            lastAlertMilestone = currentMilestone;
+            if (onMilestoneCallback) {
+                try {
+                    onMilestoneCallback(getFreeTierStats());
+                }
+                catch {
+                    // never block the request flow
+                }
+            }
+        }
+        const remaining = FREE_TIER_LIMIT - entry.count;
+        return remaining; // >= 0, free call allowed
+    }
+    return -1; // free tier exhausted
+}
+export async function x402Gate(runtime, req, res, options) {
+    // Step 1: Check if sell-side x402 server is configured
+    const serverService = runtime.getService("X402_SERVER");
+    if (!serverService?.isAvailable()) {
+        // No server configured — let request through for free (graceful degradation)
+        return { paid: false, amountUsd: 0 };
+    }
+    // Step 2: Look for payment signature in request headers
+    const server = serverService.getServer();
+    const headers = req.headers ?? {};
+    // Check for payment signature header (case-insensitive)
+    const paymentHeader = headers["payment-signature"] ??
+        headers["PAYMENT-SIGNATURE"] ??
+        headers["x-payment"] ??
+        null;
+    // Step 2a: Free tier — 3 calls/day per IP + cookie without payment
+    // Enabled by default in production. Disable with freeTierEnabled: false in tests.
+    const freeTierOn = options.freeTierEnabled ?? (typeof process !== "undefined" && process.env.NODE_ENV !== "test");
+    if (!paymentHeader && freeTierOn) {
+        const remaining = checkFreeTier(req);
+        if (remaining >= 0) {
+            // Set cookie and remaining-count header so clients can track usage
+            const newCount = FREE_TIER_LIMIT - remaining;
+            if (res.setHeader) {
+                res.setHeader("Set-Cookie", `swarmx_usage=${newCount}; Path=/; HttpOnly; SameSite=Lax; Max-Age=86400`);
+                res.setHeader("X-SwarmX-Free-Remaining", String(remaining));
+            }
+            return { paid: true, amountUsd: 0, freeRemaining: remaining }; // free call — no payment needed
+        }
+    }
+    // Step 3: No payment and free tier exhausted — send 402
+    if (!paymentHeader) {
+        // No payment — send 402 with requirements
+        try {
+            const resourceUrl = options.resourceUrl ?? req.url ?? "/unknown";
+            const requirements = await server.buildRequirements({
+                amountAtomic: usdToAtomic(options.amountUsd),
+                resourceUrl,
+                description: options.description,
+            });
+            const encoded = server.encodeRequirements(requirements);
+            if (res.setHeader) {
+                res.setHeader("PAYMENT-REQUIRED", encoded);
+            }
+            if (res.status && res.json) {
+                res.status(402).json({
+                    error: "Payment required",
+                    description: options.description,
+                    amount: options.amountUsd,
+                    network: serverService.getNetwork(),
+                    payTo: serverService.getReceiveAddress(),
+                });
+            }
+        }
+        catch (err) {
+            runtime.logger.error({ error: err instanceof Error ? err.message : String(err) }, "[x402Gate] Failed to build payment requirements");
+            if (res.status && res.json) {
+                res.status(500).json({ error: "Payment gate error" });
+            }
+        }
+        return { paid: false, amountUsd: 0 };
+    }
+    // Payment header present — verify and settle
+    try {
+        const accept = await server.getPaymentAccept({
+            amountAtomic: usdToAtomic(options.amountUsd),
+            resourceUrl: options.resourceUrl ?? req.url ?? "/unknown",
+            description: options.description,
+        });
+        const verifyResult = await server.verifyPayment(paymentHeader, accept);
+        if (!verifyResult.isValid && !verifyResult.valid) {
+            if (res.status && res.json) {
+                res.status(402).json({
+                    error: "Payment verification failed",
+                    reason: verifyResult.invalidReason ?? "Unknown",
+                });
+            }
+            return { paid: false, amountUsd: 0 };
+        }
+        const settleResult = await server.settlePayment(paymentHeader, accept);
+        if (!settleResult.success) {
+            if (res.status && res.json) {
+                res.status(402).json({
+                    error: "Payment settlement failed",
+                    reason: settleResult.errorReason ?? "Unknown",
+                });
+            }
+            return { paid: false, amountUsd: 0 };
+        }
+        const amountUsd = parseFloat(options.amountUsd);
+        // Record revenue
+        serverService.recordRevenue({
+            endpoint: req.url ?? "/unknown",
+            amountUsd,
+            txHash: settleResult.transaction ?? "",
+            network: settleResult.network ?? serverService.getNetwork(),
+            payer: settleResult.payer ?? "",
+            timestamp: Date.now(),
+        });
+        return {
+            paid: true,
+            transaction: settleResult.transaction ?? undefined,
+            network: settleResult.network ?? undefined,
+            payer: settleResult.payer ?? undefined,
+            amountUsd,
+        };
+    }
+    catch (err) {
+        runtime.logger.error({ error: err instanceof Error ? err.message : String(err) }, "[x402Gate] Payment verification/settlement error");
+        if (res.status && res.json) {
+            res.status(500).json({ error: "Payment processing error" });
+        }
+        return { paid: false, amountUsd: 0 };
+    }
+}
+//# sourceMappingURL=x402Gate.js.map

package/dist/server/x402Gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402Gate.js","sourceRoot":"","sources":["../../src/server/x402Gate.ts"],"names":[],"mappings":"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"}