@alleyboss/micropay-solana-x402-paywall 3.0.2 → 3.0.4

package/README.md

@@ -60,26 +60,27 @@ app.get('/premium', x402Middleware(server, {
 
 ## 📦 Next.js (App Router)
 
-Use the official `@x402/next` adapter with our session management:
-
 ```typescript
 // app/api/premium/route.ts
-import { withX402 } from '@x402/next';
-import { x402ResourceServer } from '@x402/core/server';
+import { createX402Middleware } from '@alleyboss/micropay-solana-x402-paywall/next';
 
-const server = new x402ResourceServer({ ... });
+const withMicropay = createX402Middleware({
+    walletAddress: 'YOUR_WALLET_ADDRESS',
+    network: 'devnet'
+});
 
 const handler = (req) => {
-  return Response.json({ content: "Premium Data" });
+    return Response.json({ content: "Premium Data" });
 };
 
-export const GET = withX402(handler, {
-  accepts: { 
-    scheme: 'exact', 
-    amount: '1000000',
-    network: 'solana-mainnet' 
-  }
-}, server);
+// Protect the route
+export const GET = withMicropay(handler, {
+    description: "Unlock Premium Content",
+    accepts: {
+        amount: "1000000", // 0.001 SOL
+        scheme: "exact"
+    }
+});
 ```
 
 ## 🔧 Modules

package/dist/client/index.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+var http = require('@x402/core/http');
+
 // src/client/types.ts
 var TOKEN_MINTS = {
   /** USDC on mainnet */
@@ -91,7 +93,26 @@ function createPaymentReference() {
   }
   return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
 }
+function createX402AuthorizationHeader(signature, paymentRequiredHeader) {
+  const cleanHeader = paymentRequiredHeader.replace(/^[Xx]402\s+/, "");
+  const required = http.decodePaymentRequiredHeader(cleanHeader);
+  const accepts = Array.isArray(required.accepts) ? required.accepts[0] : required.accepts;
+  const payload = {
+    accepted: accepts,
+    client: {
+      scheme: accepts.scheme,
+      // TypeScript knows this exists on PaymentRequirements
+      network: accepts.network
+    },
+    payment: {
+      signature
+    }
+  };
+  const token = http.encodePaymentSignatureHeader(payload);
+  return `x402 ${token}`;
+}
 
 exports.buildSolanaPayUrl = buildSolanaPayUrl;
 exports.createPaymentFlow = createPaymentFlow;
 exports.createPaymentReference = createPaymentReference;
+exports.createX402AuthorizationHeader = createX402AuthorizationHeader;

package/dist/client/index.d.cts

@@ -118,4 +118,12 @@ declare function createPaymentFlow(config: PaymentFlowConfig): {
  */
 declare function createPaymentReference(): string;
 
-export { type PaymentFlowConfig, type SolanaPayUrlParams, buildSolanaPayUrl, createPaymentFlow, createPaymentReference };
+/**
+ * Creates the Authorization header value for x402 authentication
+ *
+ * @param signature - The payment signature/proof
+ * @param paymentRequiredHeader - The WWW-Authenticate header value from the 402 response
+ */
+declare function createX402AuthorizationHeader(signature: string, paymentRequiredHeader: string): string;
+
+export { type PaymentFlowConfig, type SolanaPayUrlParams, buildSolanaPayUrl, createPaymentFlow, createPaymentReference, createX402AuthorizationHeader };

package/dist/client/index.d.ts

@@ -118,4 +118,12 @@ declare function createPaymentFlow(config: PaymentFlowConfig): {
  */
 declare function createPaymentReference(): string;
 
-export { type PaymentFlowConfig, type SolanaPayUrlParams, buildSolanaPayUrl, createPaymentFlow, createPaymentReference };
+/**
+ * Creates the Authorization header value for x402 authentication
+ *
+ * @param signature - The payment signature/proof
+ * @param paymentRequiredHeader - The WWW-Authenticate header value from the 402 response
+ */
+declare function createX402AuthorizationHeader(signature: string, paymentRequiredHeader: string): string;
+
+export { type PaymentFlowConfig, type SolanaPayUrlParams, buildSolanaPayUrl, createPaymentFlow, createPaymentReference, createX402AuthorizationHeader };

package/dist/client/index.js

@@ -1,3 +1,5 @@
+import { decodePaymentRequiredHeader, encodePaymentSignatureHeader } from '@x402/core/http';
+
 // src/client/types.ts
 var TOKEN_MINTS = {
   /** USDC on mainnet */
@@ -89,5 +91,23 @@ function createPaymentReference() {
   }
   return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
 }
+function createX402AuthorizationHeader(signature, paymentRequiredHeader) {
+  const cleanHeader = paymentRequiredHeader.replace(/^[Xx]402\s+/, "");
+  const required = decodePaymentRequiredHeader(cleanHeader);
+  const accepts = Array.isArray(required.accepts) ? required.accepts[0] : required.accepts;
+  const payload = {
+    accepted: accepts,
+    client: {
+      scheme: accepts.scheme,
+      // TypeScript knows this exists on PaymentRequirements
+      network: accepts.network
+    },
+    payment: {
+      signature
+    }
+  };
+  const token = encodePaymentSignatureHeader(payload);
+  return `x402 ${token}`;
+}
 
-export { buildSolanaPayUrl, createPaymentFlow, createPaymentReference };
+export { buildSolanaPayUrl, createPaymentFlow, createPaymentReference, createX402AuthorizationHeader };

package/dist/index.cjs

@@ -4,6 +4,7 @@ var core = require('@x402/core');
 var types = require('@x402/core/types');
 var client = require('@x402/core/client');
 var svm = require('@x402/svm');
+var http = require('@x402/core/http');
 var web3_js = require('@solana/web3.js');
 var jose = require('jose');
 
@@ -100,6 +101,24 @@ function createPaymentReference() {
   }
   return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
 }
+function createX402AuthorizationHeader(signature, paymentRequiredHeader) {
+  const cleanHeader = paymentRequiredHeader.replace(/^[Xx]402\s+/, "");
+  const required = http.decodePaymentRequiredHeader(cleanHeader);
+  const accepts = Array.isArray(required.accepts) ? required.accepts[0] : required.accepts;
+  const payload = {
+    accepted: accepts,
+    client: {
+      scheme: accepts.scheme,
+      // TypeScript knows this exists on PaymentRequirements
+      network: accepts.network
+    },
+    payment: {
+      signature
+    }
+  };
+  const token = http.encodePaymentSignatureHeader(payload);
+  return `x402 ${token}`;
+}
 var DEFAULT_COMPUTE_UNITS = 2e5;
 var DEFAULT_MICRO_LAMPORTS = 1e3;
 function createPriorityFeeInstructions(config2 = {}) {
@@ -577,6 +596,7 @@ exports.configurePricing = configurePricing;
 exports.createCreditSession = createCreditSession;
 exports.createPaymentFlow = createPaymentFlow;
 exports.createPaymentReference = createPaymentReference;
+exports.createX402AuthorizationHeader = createX402AuthorizationHeader;
 exports.executeAgentPayment = executeAgentPayment;
 exports.formatPriceDisplay = formatPriceDisplay;
 exports.formatPriceSync = formatPriceSync;

package/dist/index.d.cts

@@ -2,7 +2,7 @@ export * from '@x402/core';
 export * from '@x402/core/types';
 export * from '@x402/core/client';
 export * from '@x402/svm';
-export { PaymentFlowConfig, SolanaPayUrlParams, buildSolanaPayUrl, createPaymentFlow, createPaymentReference } from './client/index.cjs';
+export { PaymentFlowConfig, SolanaPayUrlParams, buildSolanaPayUrl, createPaymentFlow, createPaymentReference, createX402AuthorizationHeader } from './client/index.cjs';
 export { AgentPaymentResult, CreditSessionClaims, CreditSessionConfig, CreditSessionData, CreditValidation, ExecuteAgentPaymentParams, UseCreditResult, addCredits, createCreditSession, executeAgentPayment, generateAgentKeypair, getAgentBalance, getRemainingCredits, hasAgentSufficientBalance, keypairFromBase58, useCredit, validateCreditSession } from './agent/index.cjs';
 export { CustomPriceProvider, PriceConfig, PriceData, clearPriceCache, configurePricing, formatPriceDisplay, formatPriceSync, getProviders, getSolPrice, lamportsToUsd, usdToLamports } from './pricing/index.cjs';
 import '@solana/web3.js';

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export * from '@x402/core';
 export * from '@x402/core/types';
 export * from '@x402/core/client';
 export * from '@x402/svm';
-export { PaymentFlowConfig, SolanaPayUrlParams, buildSolanaPayUrl, createPaymentFlow, createPaymentReference } from './client/index.js';
+export { PaymentFlowConfig, SolanaPayUrlParams, buildSolanaPayUrl, createPaymentFlow, createPaymentReference, createX402AuthorizationHeader } from './client/index.js';
 export { AgentPaymentResult, CreditSessionClaims, CreditSessionConfig, CreditSessionData, CreditValidation, ExecuteAgentPaymentParams, UseCreditResult, addCredits, createCreditSession, executeAgentPayment, generateAgentKeypair, getAgentBalance, getRemainingCredits, hasAgentSufficientBalance, keypairFromBase58, useCredit, validateCreditSession } from './agent/index.js';
 export { CustomPriceProvider, PriceConfig, PriceData, clearPriceCache, configurePricing, formatPriceDisplay, formatPriceSync, getProviders, getSolPrice, lamportsToUsd, usdToLamports } from './pricing/index.js';
 import '@solana/web3.js';

package/dist/index.js

@@ -2,6 +2,7 @@ export * from '@x402/core';
 export * from '@x402/core/types';
 export * from '@x402/core/client';
 export * from '@x402/svm';
+import { decodePaymentRequiredHeader, encodePaymentSignatureHeader } from '@x402/core/http';
 import { PublicKey, SystemProgram, LAMPORTS_PER_SOL, Keypair, TransactionMessage, VersionedTransaction, ComputeBudgetProgram } from '@solana/web3.js';
 import { SignJWT, jwtVerify } from 'jose';
 
@@ -98,6 +99,24 @@ function createPaymentReference() {
   }
   return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
 }
+function createX402AuthorizationHeader(signature, paymentRequiredHeader) {
+  const cleanHeader = paymentRequiredHeader.replace(/^[Xx]402\s+/, "");
+  const required = decodePaymentRequiredHeader(cleanHeader);
+  const accepts = Array.isArray(required.accepts) ? required.accepts[0] : required.accepts;
+  const payload = {
+    accepted: accepts,
+    client: {
+      scheme: accepts.scheme,
+      // TypeScript knows this exists on PaymentRequirements
+      network: accepts.network
+    },
+    payment: {
+      signature
+    }
+  };
+  const token = encodePaymentSignatureHeader(payload);
+  return `x402 ${token}`;
+}
 var DEFAULT_COMPUTE_UNITS = 2e5;
 var DEFAULT_MICRO_LAMPORTS = 1e3;
 function createPriorityFeeInstructions(config2 = {}) {
@@ -568,4 +587,4 @@ function getProviders() {
   return PROVIDERS.map((p) => ({ name: p.name, url: p.url }));
 }
 
-export { addCredits, buildSolanaPayUrl, clearPriceCache, configurePricing, createCreditSession, createPaymentFlow, createPaymentReference, executeAgentPayment, formatPriceDisplay, formatPriceSync, generateAgentKeypair, getAgentBalance, getProviders, getRemainingCredits, getSolPrice, hasAgentSufficientBalance, keypairFromBase58, lamportsToUsd, usdToLamports, useCredit, validateCreditSession };
+export { addCredits, buildSolanaPayUrl, clearPriceCache, configurePricing, createCreditSession, createPaymentFlow, createPaymentReference, createX402AuthorizationHeader, executeAgentPayment, formatPriceDisplay, formatPriceSync, generateAgentKeypair, getAgentBalance, getProviders, getRemainingCredits, getSolPrice, hasAgentSufficientBalance, keypairFromBase58, lamportsToUsd, usdToLamports, useCredit, validateCreditSession };

package/dist/next/index.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+var next = require('@x402/next');
+var server = require('@x402/core/server');
+var http = require('@x402/core/http');
+var server$1 = require('@x402/svm/exact/server');
+
+// src/next/index.ts
+function createX402Middleware(config) {
+  const facilitatorUrl = config.facilitatorUrl || "https://x402.org/facilitator";
+  const client = new http.HTTPFacilitatorClient({ url: facilitatorUrl });
+  const server$2 = new server.x402ResourceServer(client);
+  server$1.registerExactSvmScheme(server$2, {});
+  return function withMicropay(handler, routeConfig) {
+    const finalConfig = routeConfig || {
+      accepts: {
+        scheme: "exact",
+        payTo: config.walletAddress,
+        maxAmountRequired: config.price?.toString() || "0",
+        network: config.network === "mainnet-beta" ? "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" : "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+        asset: "native"
+      }
+    };
+    return next.withX402(handler, finalConfig, server$2);
+  };
+}
+var withX402 = next.withX402;
+
+Object.defineProperty(exports, "x402ResourceServer", {
+  enumerable: true,
+  get: function () { return server.x402ResourceServer; }
+});
+exports.createX402Middleware = createX402Middleware;
+exports.withX402 = withX402;

package/dist/next/index.d.cts

@@ -0,0 +1,24 @@
+import * as next_server from 'next/server';
+import { withX402 as withX402$1 } from '@x402/next';
+export { x402ResourceServer } from '@x402/core/server';
+
+/**
+ * Configuration for the x402 middleware
+ */
+interface X402Config {
+    /** x402 Facilitator URL (default: x402.org) */
+    facilitatorUrl?: string;
+    /** Wallet address to receive payments */
+    walletAddress: string;
+    /** Price in lamports (string or number) */
+    price?: string | number;
+    /** Network (mainnet-beta or devnet) */
+    network?: 'mainnet-beta' | 'devnet';
+}
+/**
+ * Create a specialized Next.js middleware with Solana support pre-configured
+ */
+declare function createX402Middleware(config: X402Config): (handler: any, routeConfig?: any) => (request: next_server.NextRequest) => Promise<next_server.NextResponse<unknown>>;
+declare const withX402: typeof withX402$1;
+
+export { type X402Config, createX402Middleware, withX402 };

package/dist/next/index.d.ts

@@ -0,0 +1,24 @@
+import * as next_server from 'next/server';
+import { withX402 as withX402$1 } from '@x402/next';
+export { x402ResourceServer } from '@x402/core/server';
+
+/**
+ * Configuration for the x402 middleware
+ */
+interface X402Config {
+    /** x402 Facilitator URL (default: x402.org) */
+    facilitatorUrl?: string;
+    /** Wallet address to receive payments */
+    walletAddress: string;
+    /** Price in lamports (string or number) */
+    price?: string | number;
+    /** Network (mainnet-beta or devnet) */
+    network?: 'mainnet-beta' | 'devnet';
+}
+/**
+ * Create a specialized Next.js middleware with Solana support pre-configured
+ */
+declare function createX402Middleware(config: X402Config): (handler: any, routeConfig?: any) => (request: next_server.NextRequest) => Promise<next_server.NextResponse<unknown>>;
+declare const withX402: typeof withX402$1;
+
+export { type X402Config, createX402Middleware, withX402 };

package/dist/next/index.js

@@ -0,0 +1,28 @@
+import { withX402 as withX402$1 } from '@x402/next';
+import { x402ResourceServer } from '@x402/core/server';
+export { x402ResourceServer } from '@x402/core/server';
+import { HTTPFacilitatorClient } from '@x402/core/http';
+import { registerExactSvmScheme } from '@x402/svm/exact/server';
+
+// src/next/index.ts
+function createX402Middleware(config) {
+  const facilitatorUrl = config.facilitatorUrl || "https://x402.org/facilitator";
+  const client = new HTTPFacilitatorClient({ url: facilitatorUrl });
+  const server = new x402ResourceServer(client);
+  registerExactSvmScheme(server, {});
+  return function withMicropay(handler, routeConfig) {
+    const finalConfig = routeConfig || {
+      accepts: {
+        scheme: "exact",
+        payTo: config.walletAddress,
+        maxAmountRequired: config.price?.toString() || "0",
+        network: config.network === "mainnet-beta" ? "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" : "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+        asset: "native"
+      }
+    };
+    return withX402$1(handler, finalConfig, server);
+  };
+}
+var withX402 = withX402$1;
+
+export { createX402Middleware, withX402 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@alleyboss/micropay-solana-x402-paywall",
-    "version": "3.0.2",
+    "version": "3.0.4",
     "description": "Production-ready Solana micropayments library wrapper for official x402 SDK",
     "author": "AlleyBoss",
     "license": "MIT",
@@ -42,6 +42,16 @@
                 "default": "./dist/express/index.cjs"
             }
         },
+        "./next": {
+            "import": {
+                "types": "./dist/next/index.d.ts",
+                "default": "./dist/next/index.js"
+            },
+            "require": {
+                "types": "./dist/next/index.d.cts",
+                "default": "./dist/next/index.cjs"
+            }
+        },
         "./agent": {
             "import": {
                 "types": "./dist/agent/index.d.ts",
@@ -99,6 +109,7 @@
     },
     "dependencies": {
         "@x402/core": "^2.1.0",
+        "@x402/next": "^2.1.0",
         "@x402/svm": "^2.1.0",
         "jose": "^6.1.3"
     },