@pincerpay/merchant 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PincerPay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,221 @@
+# @pincerpay/merchant
+
+Merchant SDK for accepting on-chain USDC payments from AI agents via the x402 protocol. Supports Express, Hono, and Next.js.
+
+> **ESM Required:** Your project must have `"type": "module"` in package.json. This package is ESM-only.
+
+## Install
+
+```bash
+npm install @pincerpay/merchant
+```
+
+## Quick Start
+
+### Express
+
+```typescript
+import express from "express";
+import { pincerpay } from "@pincerpay/merchant/express";
+
+const app = express();
+
+app.use(
+  pincerpay({
+    apiKey: process.env.PINCERPAY_API_KEY!,
+    merchantAddress: "YOUR_SOLANA_ADDRESS",
+    routes: {
+      "GET /api/weather": {
+        price: "0.01",
+        chain: "solana",
+        description: "Current weather data",
+      },
+      "POST /api/analyze": {
+        price: "0.10",
+        chains: ["solana", "base"],
+        description: "AI text analysis",
+      },
+    },
+  })
+);
+
+app.get("/api/weather", (req, res) => {
+  res.json({ temp: 72, unit: "F" });
+});
+
+app.listen(3000);
+```
+
+### Hono
+
+```typescript
+import { Hono } from "hono";
+import { pincerpayHono } from "@pincerpay/merchant/hono";
+
+const app = new Hono();
+
+app.use(
+  "*",
+  pincerpayHono({
+    apiKey: process.env.PINCERPAY_API_KEY!,
+    merchantAddress: "YOUR_SOLANA_ADDRESS",
+    routes: {
+      "GET /api/weather": {
+        price: "0.01",
+        chain: "solana",
+        description: "Current weather data",
+      },
+    },
+  })
+);
+
+app.get("/api/weather", (c) => c.json({ temp: 72 }));
+
+export default app;
+```
+
+### Next.js (Hono Adapter)
+
+Next.js doesn't have native x402 middleware support. Use Hono as a lightweight handler inside a catch-all App Router route:
+
+```typescript
+// app/api/[...route]/route.ts
+import { Hono } from "hono";
+import { handle } from "hono/vercel";
+import { pincerpayHono } from "@pincerpay/merchant/hono";
+
+const app = new Hono().basePath("/api");
+
+app.use(
+  "*",
+  pincerpayHono({
+    apiKey: process.env.PINCERPAY_API_KEY!,
+    merchantAddress: "YOUR_SOLANA_ADDRESS",
+    routes: {
+      "GET /api/weather": {
+        price: "0.01",
+        chain: "solana",
+        description: "Current weather data",
+      },
+    },
+  })
+);
+
+app.get("/weather", (c) => c.json({ temp: 72 }));
+
+export const GET = handle(app);
+export const POST = handle(app);
+```
+
+Install: `npm install @pincerpay/merchant hono`
+
+> **Note:** `basePath("/api")` must match the catch-all route location. Route handlers use paths relative to basePath (`/weather` serves `/api/weather`).
+
+## API Reference
+
+### `pincerpay(config): Express.RequestHandler`
+
+Express middleware that intercepts requests matching configured routes and returns HTTP 402 with x402 payment requirements.
+
+### `pincerpayHono(config): HonoMiddleware`
+
+Hono middleware with identical behavior. Also used for Next.js via the Hono adapter pattern (see Next.js example above).
+
+### `PincerPayClient`
+
+Low-level client for direct facilitator API access.
+
+```typescript
+import { PincerPayClient } from "@pincerpay/merchant";
+
+const client = new PincerPayClient({
+  apiKey: process.env.PINCERPAY_API_KEY!,
+  merchantAddress: "YOUR_ADDRESS",
+  facilitatorUrl: "https://facilitator.pincerpay.com", // default
+  routes: {},
+});
+
+const result = await client.settle(paymentPayload, paymentRequirements);
+const status = await client.getStatus(txHash);
+const supported = await client.getSupported();
+```
+
+### Config
+
+```typescript
+interface PincerPayConfig {
+  apiKey: string;
+  merchantAddress: string;
+  facilitatorUrl?: string; // defaults to https://facilitator.pincerpay.com
+  routes: Record<string, RoutePaywallConfig>;
+}
+
+interface RoutePaywallConfig {
+  price: string;        // USDC amount (e.g., "0.01")
+  chain?: string;       // Chain shorthand (e.g., "solana", "base")
+  chains?: string[];    // Multiple chains
+  description?: string; // Human-readable description
+}
+```
+
+### Utility Functions
+
+```typescript
+import { toBaseUnits, resolveRouteChains } from "@pincerpay/merchant";
+
+toBaseUnits("0.01");              // "10000" (USDC has 6 decimals)
+resolveRouteChains(routeConfig);  // ["solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"]
+```
+
+## Common Patterns
+
+### Multi-chain pricing
+
+```typescript
+pincerpay({
+  apiKey: process.env.PINCERPAY_API_KEY!,
+  merchantAddress: "YOUR_ADDRESS",
+  routes: {
+    "GET /api/data": {
+      price: "0.05",
+      chains: ["solana", "base", "polygon"],
+      description: "Accept USDC on any supported chain",
+    },
+  },
+});
+```
+
+### Free routes alongside paid routes
+
+Routes not listed in `routes` pass through without payment. Only matching `METHOD /path` patterns trigger the 402 paywall.
+
+```typescript
+pincerpay({
+  apiKey: process.env.PINCERPAY_API_KEY!,
+  merchantAddress: "YOUR_ADDRESS",
+  routes: {
+    "GET /api/premium": { price: "1.00", chain: "solana" },
+    // GET /api/free is not listed — no paywall
+  },
+});
+```
+
+## Anti-Patterns
+
+### Don't hardcode API keys
+
+```typescript
+// Bad
+pincerpay({ apiKey: "pp_live_abc123...", ... });
+
+// Good
+pincerpay({ apiKey: process.env.PINCERPAY_API_KEY!, ... });
+```
+
+### Don't use the merchant SDK on the agent side
+
+The merchant SDK is for servers accepting payments. Agents should use `@pincerpay/agent` to make payments.
+
+### Don't set price to "0"
+
+A price of "0" will still trigger the 402 flow. If a route should be free, omit it from the `routes` config.

package/dist/client.d.ts

@@ -0,0 +1,31 @@
+import type { PincerPayConfig, RoutePaywallConfig } from "@pincerpay/core";
+/**
+ * PincerPayClient wraps the facilitator HTTP API.
+ * Used by merchant middleware to verify and settle payments.
+ */
+export declare class PincerPayClient {
+    readonly facilitatorUrl: string;
+    readonly apiKey: string;
+    readonly merchantAddress: string;
+    constructor(config: PincerPayConfig);
+    private request;
+    verify(paymentPayload: unknown, paymentRequirements: unknown): Promise<unknown>;
+    settle(paymentPayload: unknown, paymentRequirements: unknown): Promise<unknown>;
+    getSupported(): Promise<unknown>;
+    getStatus(txHash: string): Promise<unknown>;
+}
+/**
+ * Resolve route config chains to CAIP-2 network IDs.
+ * "base" → "eip155:8453", etc.
+ */
+export declare function resolveRouteChains(route: RoutePaywallConfig): string[];
+/**
+ * Convert USDC human-readable amount to base units (6 decimals).
+ * "0.01" → "10000"
+ */
+export declare function toBaseUnits(amount: string): string;
+/**
+ * Get chain-specific USDC asset address from a chain shorthand.
+ */
+export declare function getUsdcAsset(chainShorthand: string): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAGzB;;;GAGG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAErB,MAAM,EAAE,eAAe;YAMrB,OAAO;IAmBf,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO;IAO5D,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO;IAO5D,YAAY;IAIZ,SAAS,CAAC,MAAM,EAAE,MAAM;CAG/B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAGtE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAM3D"}

package/dist/client.js

@@ -0,0 +1,80 @@
+import { DEFAULT_FACILITATOR_URL, FACILITATOR_ROUTES, API_KEY_HEADER, } from "@pincerpay/core";
+import { resolveChain, toCAIP2 } from "@pincerpay/core";
+/**
+ * PincerPayClient wraps the facilitator HTTP API.
+ * Used by merchant middleware to verify and settle payments.
+ */
+export class PincerPayClient {
+    facilitatorUrl;
+    apiKey;
+    merchantAddress;
+    constructor(config) {
+        this.facilitatorUrl = config.facilitatorUrl ?? DEFAULT_FACILITATOR_URL;
+        this.apiKey = config.apiKey;
+        this.merchantAddress = config.merchantAddress;
+    }
+    async request(path, body) {
+        const url = `${this.facilitatorUrl}${path}`;
+        const res = await fetch(url, {
+            method: body ? "POST" : "GET",
+            headers: {
+                "Content-Type": "application/json",
+                [API_KEY_HEADER]: this.apiKey,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "Unknown error");
+            throw new Error(`Facilitator ${path} failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    async verify(paymentPayload, paymentRequirements) {
+        return this.request(FACILITATOR_ROUTES.verify, {
+            paymentPayload,
+            paymentRequirements,
+        });
+    }
+    async settle(paymentPayload, paymentRequirements) {
+        return this.request(FACILITATOR_ROUTES.settle, {
+            paymentPayload,
+            paymentRequirements,
+        });
+    }
+    async getSupported() {
+        return this.request(FACILITATOR_ROUTES.supported);
+    }
+    async getStatus(txHash) {
+        return this.request(`${FACILITATOR_ROUTES.status}/${txHash}`);
+    }
+}
+/**
+ * Resolve route config chains to CAIP-2 network IDs.
+ * "base" → "eip155:8453", etc.
+ */
+export function resolveRouteChains(route) {
+    const shorthands = route.chains ?? (route.chain ? [route.chain] : ["solana"]);
+    return shorthands.map(toCAIP2);
+}
+/**
+ * Convert USDC human-readable amount to base units (6 decimals).
+ * "0.01" → "10000"
+ */
+export function toBaseUnits(amount) {
+    const parts = amount.split(".");
+    const whole = parts[0] ?? "0";
+    const frac = (parts[1] ?? "").padEnd(6, "0").slice(0, 6);
+    const result = BigInt(whole) * BigInt(1_000_000) + BigInt(frac);
+    return result.toString();
+}
+/**
+ * Get chain-specific USDC asset address from a chain shorthand.
+ */
+export function getUsdcAsset(chainShorthand) {
+    const chain = resolveChain(chainShorthand);
+    if (!chain) {
+        throw new Error(`Unknown chain: ${chainShorthand}`);
+    }
+    return chain.usdcAddress;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { pincerpay } from "./middleware/express.js";
+export { pincerpayHono } from "./middleware/hono.js";
+export { PincerPayClient, toBaseUnits, resolveRouteChains, getUsdcAsset } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { pincerpay } from "./middleware/express.js";
+export { pincerpayHono } from "./middleware/hono.js";
+export { PincerPayClient, toBaseUnits, resolveRouteChains, getUsdcAsset } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/middleware/express.d.ts

@@ -0,0 +1,18 @@
+import type { PincerPayConfig } from "@pincerpay/core";
+import { type PaywallConfig } from "@x402/express";
+/**
+ * Express middleware factory — the dead-simple API from the plan:
+ *
+ * ```ts
+ * app.use(pincerpay({
+ *   apiKey: process.env.PINCERPAY_API_KEY!,
+ *   merchantAddress: "0xYourAddress",
+ *   routes: {
+ *     "GET /api/weather": { price: "0.01", chain: "base", description: "Weather data" },
+ *   },
+ * }));
+ * ```
+ */
+export declare function pincerpay(config: PincerPayConfig, paywallConfig?: PaywallConfig): (req: import("express").Request, res: import("express").Response, next: import("express").NextFunction) => Promise<void>;
+export { PincerPayClient } from "../client.js";
+//# sourceMappingURL=express.d.ts.map

package/dist/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE,aAAa,4HA6D/E;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/middleware/express.js

@@ -0,0 +1,61 @@
+import { resolveChain, DEFAULT_FACILITATOR_URL } from "@pincerpay/core";
+import { paymentMiddlewareFromConfig, } from "@x402/express";
+import { HTTPFacilitatorClient } from "@x402/core/server";
+import { ExactEvmScheme } from "@x402/evm/exact/server";
+import { ExactSvmScheme } from "@x402/svm/exact/server";
+/**
+ * Express middleware factory — the dead-simple API from the plan:
+ *
+ * ```ts
+ * app.use(pincerpay({
+ *   apiKey: process.env.PINCERPAY_API_KEY!,
+ *   merchantAddress: "0xYourAddress",
+ *   routes: {
+ *     "GET /api/weather": { price: "0.01", chain: "base", description: "Weather data" },
+ *   },
+ * }));
+ * ```
+ */
+export function pincerpay(config, paywallConfig) {
+    const facilitatorUrl = config.facilitatorUrl ?? DEFAULT_FACILITATOR_URL;
+    // Build x402-compatible routes config
+    // Pass price as Money (string) so the EVM server scheme handles conversion
+    // and automatically includes EIP-712 domain parameters (name, version)
+    const x402Routes = {};
+    for (const [pattern, routeConfig] of Object.entries(config.routes)) {
+        const chains = routeConfig.chains ?? (routeConfig.chain ? [routeConfig.chain] : ["solana"]);
+        const accepts = chains.map((chainShorthand) => {
+            const chain = resolveChain(chainShorthand);
+            if (!chain)
+                throw new Error(`Unknown chain: ${chainShorthand}`);
+            return {
+                scheme: "exact",
+                network: chain.caip2Id,
+                payTo: config.merchantAddress,
+                price: routeConfig.price,
+                maxTimeoutSeconds: 300,
+            };
+        });
+        x402Routes[pattern] = {
+            accepts,
+            description: routeConfig.description ?? pattern,
+        };
+    }
+    // Create facilitator client pointing to PincerPay
+    const facilitatorClient = new HTTPFacilitatorClient({
+        url: facilitatorUrl,
+        createAuthHeaders: async () => ({
+            verify: { "x-pincerpay-api-key": config.apiKey },
+            settle: { "x-pincerpay-api-key": config.apiKey },
+            supported: { "x-pincerpay-api-key": config.apiKey },
+        }),
+    });
+    // Register server schemes so the resource server can build payment requirements
+    const schemes = [
+        { network: "eip155:*", server: new ExactEvmScheme() },
+        { network: "solana:*", server: new ExactSvmScheme() },
+    ];
+    return paymentMiddlewareFromConfig(x402Routes, facilitatorClient, schemes, paywallConfig);
+}
+export { PincerPayClient } from "../client.js";
+//# sourceMappingURL=express.js.map

package/dist/middleware/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EACL,2BAA2B,GAE5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,MAAuB,EAAE,aAA6B;IAC9E,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,uBAAuB,CAAC;IAExE,sCAAsC;IACtC,2EAA2E;IAC3E,uEAAuE;IACvE,MAAM,UAAU,GASX,EAAE,CAAC;IAER,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE5F,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,EAAE,EAAE;YAC5C,MAAM,KAAK,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,cAAc,EAAE,CAAC,CAAC;YAEhE,OAAO;gBACL,MAAM,EAAE,OAAgB;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAkB;gBACjC,KAAK,EAAE,MAAM,CAAC,eAAe;gBAC7B,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,iBAAiB,EAAE,GAAG;aACvB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,OAAO,CAAC,GAAG;YACpB,OAAO;YACP,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,OAAO;SAChD,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,MAAM,iBAAiB,GAAG,IAAI,qBAAqB,CAAC;QAClD,GAAG,EAAE,cAAc;QACnB,iBAAiB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAC9B,MAAM,EAAE,EAAE,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE;YAChD,MAAM,EAAE,EAAE,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE;YAChD,SAAS,EAAE,EAAE,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE;SACpD,CAAC;KACH,CAAC,CAAC;IAEH,gFAAgF;IAChF,MAAM,OAAO,GAAG;QACd,EAAE,OAAO,EAAE,UAAqB,EAAE,MAAM,EAAE,IAAI,cAAc,EAAE,EAAE;QAChE,EAAE,OAAO,EAAE,UAAqB,EAAE,MAAM,EAAE,IAAI,cAAc,EAAE,EAAE;KACjE,CAAC;IAEF,OAAO,2BAA2B,CAChC,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,aAAa,CACd,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/middleware/hono.d.ts

@@ -0,0 +1,18 @@
+import type { PincerPayConfig } from "@pincerpay/core";
+import { type PaywallConfig } from "@x402/hono";
+/**
+ * Hono middleware factory for PincerPay merchants.
+ *
+ * ```ts
+ * app.use("*", pincerpayHono({
+ *   apiKey: process.env.PINCERPAY_API_KEY!,
+ *   merchantAddress: "0xYourAddress",
+ *   routes: {
+ *     "GET /api/weather": { price: "0.01", chain: "base", description: "Weather data" },
+ *   },
+ * }));
+ * ```
+ */
+export declare function pincerpayHono(config: PincerPayConfig, paywallConfig?: PaywallConfig): import("hono").MiddlewareHandler;
+export { PincerPayClient } from "../client.js";
+//# sourceMappingURL=hono.d.ts.map

package/dist/middleware/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/middleware/hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE,aAAa,oCA6DnF;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/middleware/hono.js

@@ -0,0 +1,61 @@
+import { resolveChain, DEFAULT_FACILITATOR_URL } from "@pincerpay/core";
+import { paymentMiddlewareFromConfig, } from "@x402/hono";
+import { HTTPFacilitatorClient } from "@x402/core/server";
+import { ExactEvmScheme } from "@x402/evm/exact/server";
+import { ExactSvmScheme } from "@x402/svm/exact/server";
+/**
+ * Hono middleware factory for PincerPay merchants.
+ *
+ * ```ts
+ * app.use("*", pincerpayHono({
+ *   apiKey: process.env.PINCERPAY_API_KEY!,
+ *   merchantAddress: "0xYourAddress",
+ *   routes: {
+ *     "GET /api/weather": { price: "0.01", chain: "base", description: "Weather data" },
+ *   },
+ * }));
+ * ```
+ */
+export function pincerpayHono(config, paywallConfig) {
+    const facilitatorUrl = config.facilitatorUrl ?? DEFAULT_FACILITATOR_URL;
+    // Build x402-compatible routes config
+    // Pass price as Money (string) so the EVM server scheme handles conversion
+    // and automatically includes EIP-712 domain parameters (name, version)
+    const x402Routes = {};
+    for (const [pattern, routeConfig] of Object.entries(config.routes)) {
+        const chains = routeConfig.chains ?? (routeConfig.chain ? [routeConfig.chain] : ["solana"]);
+        const accepts = chains.map((chainShorthand) => {
+            const chain = resolveChain(chainShorthand);
+            if (!chain)
+                throw new Error(`Unknown chain: ${chainShorthand}`);
+            return {
+                scheme: "exact",
+                network: chain.caip2Id,
+                payTo: config.merchantAddress,
+                price: routeConfig.price,
+                maxTimeoutSeconds: 300,
+            };
+        });
+        x402Routes[pattern] = {
+            accepts,
+            description: routeConfig.description ?? pattern,
+        };
+    }
+    // Create facilitator client pointing to PincerPay
+    const facilitatorClient = new HTTPFacilitatorClient({
+        url: facilitatorUrl,
+        createAuthHeaders: async () => ({
+            verify: { "x-pincerpay-api-key": config.apiKey },
+            settle: { "x-pincerpay-api-key": config.apiKey },
+            supported: { "x-pincerpay-api-key": config.apiKey },
+        }),
+    });
+    // Register server schemes so the resource server can build payment requirements
+    const schemes = [
+        { network: "eip155:*", server: new ExactEvmScheme() },
+        { network: "solana:*", server: new ExactSvmScheme() },
+    ];
+    return paymentMiddlewareFromConfig(x402Routes, facilitatorClient, schemes, paywallConfig);
+}
+export { PincerPayClient } from "../client.js";
+//# sourceMappingURL=hono.js.map

package/dist/middleware/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../../src/middleware/hono.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EACL,2BAA2B,GAE5B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,MAAuB,EAAE,aAA6B;IAClF,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,uBAAuB,CAAC;IAExE,sCAAsC;IACtC,2EAA2E;IAC3E,uEAAuE;IACvE,MAAM,UAAU,GASX,EAAE,CAAC;IAER,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE5F,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,EAAE,EAAE;YAC5C,MAAM,KAAK,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,cAAc,EAAE,CAAC,CAAC;YAEhE,OAAO;gBACL,MAAM,EAAE,OAAgB;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAkB;gBACjC,KAAK,EAAE,MAAM,CAAC,eAAe;gBAC7B,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,iBAAiB,EAAE,GAAG;aACvB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,OAAO,CAAC,GAAG;YACpB,OAAO;YACP,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,OAAO;SAChD,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,MAAM,iBAAiB,GAAG,IAAI,qBAAqB,CAAC;QAClD,GAAG,EAAE,cAAc;QACnB,iBAAiB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAC9B,MAAM,EAAE,EAAE,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE;YAChD,MAAM,EAAE,EAAE,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE;YAChD,SAAS,EAAE,EAAE,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE;SACpD,CAAC;KACH,CAAC,CAAC;IAEH,gFAAgF;IAChF,MAAM,OAAO,GAAG;QACd,EAAE,OAAO,EAAE,UAAqB,EAAE,MAAM,EAAE,IAAI,cAAc,EAAE,EAAE;QAChE,EAAE,OAAO,EAAE,UAAqB,EAAE,MAAM,EAAE,IAAI,cAAc,EAAE,EAAE;KACjE,CAAC;IAEF,OAAO,2BAA2B,CAChC,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,aAAa,CACd,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@pincerpay/merchant",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Merchant SDK for PincerPay. Express and Hono middleware for accepting USDC payments from AI agents.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://pincerpay.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ds1/pincerpay.git",
+    "directory": "packages/merchant"
+  },
+  "bugs": {
+    "url": "https://github.com/ds1/pincerpay/issues"
+  },
+  "keywords": [
+    "pincerpay",
+    "x402",
+    "usdc",
+    "payments",
+    "ai-agents",
+    "solana",
+    "merchant-sdk",
+    "middleware",
+    "express",
+    "hono"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./express": {
+      "types": "./dist/middleware/express.d.ts",
+      "import": "./dist/middleware/express.js"
+    },
+    "./hono": {
+      "types": "./dist/middleware/hono.d.ts",
+      "import": "./dist/middleware/hono.js"
+    }
+  },
+  "dependencies": {
+    "@x402/core": "^2.3",
+    "@x402/evm": "^2.3",
+    "@x402/svm": "^2.3",
+    "zod": "^3.24",
+    "@pincerpay/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@x402/express": "^2.3",
+    "@x402/hono": "^2.3",
+    "express": "^4 || ^5",
+    "hono": "^4"
+  },
+  "peerDependenciesMeta": {
+    "@x402/express": {
+      "optional": true
+    },
+    "@x402/hono": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
+    "hono": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^5",
+    "@x402/express": "^2.3",
+    "@x402/hono": "^2.3",
+    "express": "^5",
+    "hono": "^4.12.0",
+    "typescript": "^5.7"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}