x402-mantle-sdk 0.1.0 → 0.2.2

package/dist/server/index.d.cts

@@ -47,7 +47,7 @@ declare const NETWORKS: Record<NetworkId, NetworkConfig>;
 /** Token addresses by network */
 declare const TOKENS: Record<NetworkId, Record<string, TokenConfig>>;
 /** Default platform URL (for project config) */
-declare const DEFAULT_PLATFORM_URL = "https://api.x402.dev";
+declare const DEFAULT_PLATFORM_URL = "https://mantle-x402.vercel.app";
 /**
  * Register a custom network configuration
  *
@@ -128,6 +128,12 @@ interface X402Options {
     customNetwork?: CustomNetworkConfig;
     /** Custom token configurations for this network */
     customTokens?: CustomTokenConfig;
+    /** API endpoint path for tracking (e.g., "/api/premium-data") */
+    endpoint?: string;
+    /** HTTP method for tracking (e.g., "GET", "POST") */
+    method?: string;
+    /** Enable analytics tracking (default: true) */
+    enableAnalytics?: boolean;
 }
 /** HTTP 402 Payment Required response */
 interface PaymentRequiredResponse {
@@ -160,7 +166,7 @@ interface MiddlewareResult {
  * 3. Returns 402 if no payment
  * 4. Verifies payment on blockchain if present
  */
-declare function processPaymentMiddleware(options: X402Options, headers: Headers | Record<string, string | string[] | undefined>): Promise<MiddlewareResult>;
+declare function processPaymentMiddleware(options: X402Options, headers: Headers | Record<string, string | string[] | undefined>, requestPath?: string, requestMethod?: string): Promise<MiddlewareResult>;
 
 /**
  * Hono Framework Integration
@@ -179,6 +185,9 @@ declare function processPaymentMiddleware(options: X402Options, headers: Headers
 interface HonoContext {
     req: {
         header(): Record<string, string>;
+        url?: string;
+        path?: string;
+        method?: string;
     };
     json(data: unknown, status?: number, headers?: Record<string, string>): Response;
 }
@@ -289,4 +298,72 @@ interface BlockchainVerification {
  */
 declare function verifyPaymentOnChain(transactionHash: string, config: ProjectConfig, requiredAmount: string, requiredToken: string, customRpcUrl?: string): Promise<BlockchainVerification>;
 
-export { type BlockchainVerification, type CustomNetworkConfig, type CustomTokenConfig, DEFAULT_PLATFORM_URL, type MiddlewareResult, NETWORKS, type NetworkConfig, type NetworkEnvironment, type NetworkId, type PaymentReceipt, type PaymentRequiredResponse, type PaymentVerification, type ProjectConfig, TOKENS, type TokenConfig, type X402Options, clearCache, extractPaymentReceipt, getAvailableNetworks, getChainId, getNetworkConfig, getNetworksByEnvironment, getProjectConfig, getRpcUrl, getTokenConfig, initializePlatform, isMainnet, isTestnet, processPaymentMiddleware, registerCustomNetwork, registerCustomTokens, verifyPayment, verifyPaymentOnChain, x402 };
+/**
+ * Analytics & Payment Tracking
+ *
+ * Optional utility to log payment events to the platform for dashboard tracking
+ */
+/** Payment event data */
+interface PaymentEvent {
+    transactionHash: string;
+    amount: string;
+    token: string;
+    network: string;
+    endpoint?: string;
+    method?: string;
+    fromAddress?: string;
+    toAddress: string;
+    blockNumber?: number;
+    status?: 'SUCCESS' | 'FAILED' | 'PENDING';
+}
+/**
+ * Log a payment event to the platform
+ *
+ * This is optional - call this after successful payment verification
+ * to track endpoint usage in the dashboard.
+ *
+ * @param event - Payment event data
+ * @param requestPath - Optional: Request path (e.g., "/api/premium-data")
+ * @param requestMethod - Optional: HTTP method (e.g., "GET", "POST")
+ *
+ * @example
+ * ```typescript
+ * import { logPayment } from '@x402-devkit/sdk/server'
+ *
+ * // After successful payment verification
+ * await logPayment({
+ *   transactionHash: receipt.transactionHash,
+ *   amount: '0.001',
+ *   token: 'MNT',
+ *   network: 'mantle',
+ *   toAddress: config.payTo,
+ * }, '/api/premium-data', 'GET')
+ * ```
+ */
+declare function logPayment(event: PaymentEvent, requestPath?: string, requestMethod?: string): Promise<void>;
+
+/**
+ * Endpoint Registry
+ *
+ * Automatically registers endpoints when x402 middleware is used
+ * This allows endpoints to appear in the dashboard even before payments are made
+ */
+/** Endpoint registration data */
+interface EndpointRegistration {
+    endpoint: string;
+    method?: string;
+    price: string;
+    token: string;
+    network: string;
+}
+/**
+ * Register an endpoint with the platform
+ *
+ * This is called automatically when x402 middleware is first invoked for an endpoint.
+ * Endpoints appear in the dashboard even before any payments are made.
+ *
+ * @param registration - Endpoint registration data
+ */
+declare function registerEndpoint(registration: EndpointRegistration): Promise<void>;
+
+export { type BlockchainVerification, type CustomNetworkConfig, type CustomTokenConfig, DEFAULT_PLATFORM_URL, type EndpointRegistration, type MiddlewareResult, NETWORKS, type NetworkConfig, type NetworkEnvironment, type NetworkId, type PaymentEvent, type PaymentReceipt, type PaymentRequiredResponse, type PaymentVerification, type ProjectConfig, TOKENS, type TokenConfig, type X402Options, clearCache, extractPaymentReceipt, getAvailableNetworks, getChainId, getNetworkConfig, getNetworksByEnvironment, getProjectConfig, getRpcUrl, getTokenConfig, initializePlatform, isMainnet, isTestnet, logPayment, processPaymentMiddleware, registerCustomNetwork, registerCustomTokens, registerEndpoint, verifyPayment, verifyPaymentOnChain, x402 };

package/dist/server/index.d.ts

@@ -47,7 +47,7 @@ declare const NETWORKS: Record<NetworkId, NetworkConfig>;
 /** Token addresses by network */
 declare const TOKENS: Record<NetworkId, Record<string, TokenConfig>>;
 /** Default platform URL (for project config) */
-declare const DEFAULT_PLATFORM_URL = "https://api.x402.dev";
+declare const DEFAULT_PLATFORM_URL = "https://mantle-x402.vercel.app";
 /**
  * Register a custom network configuration
  *
@@ -128,6 +128,12 @@ interface X402Options {
     customNetwork?: CustomNetworkConfig;
     /** Custom token configurations for this network */
     customTokens?: CustomTokenConfig;
+    /** API endpoint path for tracking (e.g., "/api/premium-data") */
+    endpoint?: string;
+    /** HTTP method for tracking (e.g., "GET", "POST") */
+    method?: string;
+    /** Enable analytics tracking (default: true) */
+    enableAnalytics?: boolean;
 }
 /** HTTP 402 Payment Required response */
 interface PaymentRequiredResponse {
@@ -160,7 +166,7 @@ interface MiddlewareResult {
  * 3. Returns 402 if no payment
  * 4. Verifies payment on blockchain if present
  */
-declare function processPaymentMiddleware(options: X402Options, headers: Headers | Record<string, string | string[] | undefined>): Promise<MiddlewareResult>;
+declare function processPaymentMiddleware(options: X402Options, headers: Headers | Record<string, string | string[] | undefined>, requestPath?: string, requestMethod?: string): Promise<MiddlewareResult>;
 
 /**
  * Hono Framework Integration
@@ -179,6 +185,9 @@ declare function processPaymentMiddleware(options: X402Options, headers: Headers
 interface HonoContext {
     req: {
         header(): Record<string, string>;
+        url?: string;
+        path?: string;
+        method?: string;
     };
     json(data: unknown, status?: number, headers?: Record<string, string>): Response;
 }
@@ -289,4 +298,72 @@ interface BlockchainVerification {
  */
 declare function verifyPaymentOnChain(transactionHash: string, config: ProjectConfig, requiredAmount: string, requiredToken: string, customRpcUrl?: string): Promise<BlockchainVerification>;
 
-export { type BlockchainVerification, type CustomNetworkConfig, type CustomTokenConfig, DEFAULT_PLATFORM_URL, type MiddlewareResult, NETWORKS, type NetworkConfig, type NetworkEnvironment, type NetworkId, type PaymentReceipt, type PaymentRequiredResponse, type PaymentVerification, type ProjectConfig, TOKENS, type TokenConfig, type X402Options, clearCache, extractPaymentReceipt, getAvailableNetworks, getChainId, getNetworkConfig, getNetworksByEnvironment, getProjectConfig, getRpcUrl, getTokenConfig, initializePlatform, isMainnet, isTestnet, processPaymentMiddleware, registerCustomNetwork, registerCustomTokens, verifyPayment, verifyPaymentOnChain, x402 };
+/**
+ * Analytics & Payment Tracking
+ *
+ * Optional utility to log payment events to the platform for dashboard tracking
+ */
+/** Payment event data */
+interface PaymentEvent {
+    transactionHash: string;
+    amount: string;
+    token: string;
+    network: string;
+    endpoint?: string;
+    method?: string;
+    fromAddress?: string;
+    toAddress: string;
+    blockNumber?: number;
+    status?: 'SUCCESS' | 'FAILED' | 'PENDING';
+}
+/**
+ * Log a payment event to the platform
+ *
+ * This is optional - call this after successful payment verification
+ * to track endpoint usage in the dashboard.
+ *
+ * @param event - Payment event data
+ * @param requestPath - Optional: Request path (e.g., "/api/premium-data")
+ * @param requestMethod - Optional: HTTP method (e.g., "GET", "POST")
+ *
+ * @example
+ * ```typescript
+ * import { logPayment } from '@x402-devkit/sdk/server'
+ *
+ * // After successful payment verification
+ * await logPayment({
+ *   transactionHash: receipt.transactionHash,
+ *   amount: '0.001',
+ *   token: 'MNT',
+ *   network: 'mantle',
+ *   toAddress: config.payTo,
+ * }, '/api/premium-data', 'GET')
+ * ```
+ */
+declare function logPayment(event: PaymentEvent, requestPath?: string, requestMethod?: string): Promise<void>;
+
+/**
+ * Endpoint Registry
+ *
+ * Automatically registers endpoints when x402 middleware is used
+ * This allows endpoints to appear in the dashboard even before payments are made
+ */
+/** Endpoint registration data */
+interface EndpointRegistration {
+    endpoint: string;
+    method?: string;
+    price: string;
+    token: string;
+    network: string;
+}
+/**
+ * Register an endpoint with the platform
+ *
+ * This is called automatically when x402 middleware is first invoked for an endpoint.
+ * Endpoints appear in the dashboard even before any payments are made.
+ *
+ * @param registration - Endpoint registration data
+ */
+declare function registerEndpoint(registration: EndpointRegistration): Promise<void>;
+
+export { type BlockchainVerification, type CustomNetworkConfig, type CustomTokenConfig, DEFAULT_PLATFORM_URL, type EndpointRegistration, type MiddlewareResult, NETWORKS, type NetworkConfig, type NetworkEnvironment, type NetworkId, type PaymentEvent, type PaymentReceipt, type PaymentRequiredResponse, type PaymentVerification, type ProjectConfig, TOKENS, type TokenConfig, type X402Options, clearCache, extractPaymentReceipt, getAvailableNetworks, getChainId, getNetworkConfig, getNetworksByEnvironment, getProjectConfig, getRpcUrl, getTokenConfig, initializePlatform, isMainnet, isTestnet, logPayment, processPaymentMiddleware, registerCustomNetwork, registerCustomTokens, registerEndpoint, verifyPayment, verifyPaymentOnChain, x402 };

package/dist/server/index.js

@@ -196,7 +196,7 @@ var init_constants = __esm({
       }
     };
     ERC20_TRANSFER_SIGNATURE = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
-    DEFAULT_PLATFORM_URL = "https://api.x402.dev";
+    DEFAULT_PLATFORM_URL = "https://mantle-x402.vercel.app";
     AMOUNT_TOLERANCE = BigInt(1e15);
     customNetworks = /* @__PURE__ */ new Map();
     customTokens = /* @__PURE__ */ new Map();
@@ -204,15 +204,12 @@ var init_constants = __esm({
 });
 
 // src/server/platform.ts
-init_constants();
-var cachedConfig = null;
-var validationPromise = null;
 function getPlatformBaseUrl() {
   return process.env.X402_PLATFORM_URL || process.env.NEXT_PUBLIC_X402_PLATFORM_URL || DEFAULT_PLATFORM_URL;
 }
 async function validateProject(appId) {
   const baseUrl = getPlatformBaseUrl();
-  const url = `${baseUrl}/v1/validate?appId=${encodeURIComponent(appId)}`;
+  const url = `${baseUrl}/api/v1/validate?appId=${encodeURIComponent(appId)}`;
   const response = await fetch(url, {
     method: "GET",
     headers: { "Content-Type": "application/json" }
@@ -271,6 +268,111 @@ function clearCache() {
   cachedConfig = null;
   validationPromise = null;
 }
+var cachedConfig, validationPromise;
+var init_platform = __esm({
+  "src/server/platform.ts"() {
+    "use strict";
+    init_constants();
+    cachedConfig = null;
+    validationPromise = null;
+  }
+});
+
+// src/server/analytics.ts
+var analytics_exports = {};
+__export(analytics_exports, {
+  logPayment: () => logPayment
+});
+function getPlatformBaseUrl2() {
+  return process.env.X402_PLATFORM_URL || process.env.NEXT_PUBLIC_X402_PLATFORM_URL || DEFAULT_PLATFORM_URL;
+}
+async function logPayment(event, requestPath, requestMethod) {
+  try {
+    const config = getProjectConfig();
+    const baseUrl = getPlatformBaseUrl2();
+    const url = `${baseUrl}/api/payments`;
+    const payload = {
+      appId: config.appId,
+      transactionHash: event.transactionHash,
+      amount: event.amount,
+      token: event.token,
+      network: event.network || config.network,
+      endpoint: event.endpoint || requestPath || null,
+      method: event.method || requestMethod || null,
+      fromAddress: event.fromAddress || null,
+      toAddress: event.toAddress || config.payTo,
+      blockNumber: event.blockNumber || null,
+      status: event.status || "SUCCESS"
+    };
+    fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload)
+    }).catch((error) => {
+      console.warn("Failed to log payment event:", error);
+    });
+  } catch (error) {
+    console.warn("Failed to log payment event:", error);
+  }
+}
+var init_analytics = __esm({
+  "src/server/analytics.ts"() {
+    "use strict";
+    init_platform();
+    init_constants();
+  }
+});
+
+// src/server/endpoint-registry.ts
+var endpoint_registry_exports = {};
+__export(endpoint_registry_exports, {
+  registerEndpoint: () => registerEndpoint
+});
+function getPlatformBaseUrl3() {
+  return process.env.X402_PLATFORM_URL || process.env.NEXT_PUBLIC_X402_PLATFORM_URL || DEFAULT_PLATFORM_URL;
+}
+async function registerEndpoint(registration) {
+  try {
+    const config = getProjectConfig();
+    const baseUrl = getPlatformBaseUrl3();
+    const endpointKey = `${config.appId}:${registration.endpoint}:${registration.method || "ANY"}`;
+    if (registeredEndpoints.has(endpointKey)) {
+      return;
+    }
+    registeredEndpoints.add(endpointKey);
+    const url = `${baseUrl}/api/endpoints/register`;
+    const payload = {
+      appId: config.appId,
+      endpoint: registration.endpoint,
+      method: registration.method || null,
+      price: registration.price,
+      token: registration.token,
+      network: registration.network || config.network
+    };
+    fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload)
+    }).catch((error) => {
+      console.warn("Failed to register endpoint:", error);
+      registeredEndpoints.delete(endpointKey);
+    });
+  } catch (error) {
+    console.warn("Failed to register endpoint:", error);
+  }
+}
+var registeredEndpoints;
+var init_endpoint_registry = __esm({
+  "src/server/endpoint-registry.ts"() {
+    "use strict";
+    init_platform();
+    init_constants();
+    registeredEndpoints = /* @__PURE__ */ new Set();
+  }
+});
+
+// src/server/middleware.ts
+init_platform();
 
 // src/server/blockchain.ts
 init_constants();
@@ -295,11 +397,10 @@ async function callRPC(url, method, params) {
   return data.result;
 }
 async function getTransactionReceipt(rpcUrl, txHash) {
-  const receipt = await callRPC(
-    rpcUrl,
-    "eth_getTransactionReceipt",
-    [txHash]
-  );
+  const [receipt, tx] = await Promise.all([
+    callRPC(rpcUrl, "eth_getTransactionReceipt", [txHash]),
+    callRPC(rpcUrl, "eth_getTransactionByHash", [txHash])
+  ]);
   if (!receipt) {
     return null;
   }
@@ -308,8 +409,8 @@ async function getTransactionReceipt(rpcUrl, txHash) {
     blockNumber: parseInt(receipt.blockNumber, 16),
     status: receipt.status === "0x1" ? "success" : "failed",
     from: receipt.from,
-    to: receipt.to,
-    value: receipt.value || "0x0",
+    to: tx?.to || receipt.to,
+    value: tx?.value || "0x0",
     logs: receipt.logs || []
   };
 }
@@ -364,16 +465,19 @@ async function verifyPaymentOnChain(transactionHash, config, requiredAmount, req
     if (requiredToken.toUpperCase() === "MNT") {
       const valueWei = BigInt(receipt.value);
       const requiredWei2 = parseAmountToWei(requiredAmount, 18);
+      const expectedMerchantAmount = requiredWei2 * 995n / 1000n;
+      const minAcceptable = expectedMerchantAmount - AMOUNT_TOLERANCE;
+      const maxAcceptable = requiredWei2 + AMOUNT_TOLERANCE;
       if (receipt.to?.toLowerCase() !== recipient) {
         return {
           valid: false,
           error: `Recipient mismatch: expected ${config.payTo}, got ${receipt.to}`
         };
       }
-      if (valueWei < requiredWei2 - AMOUNT_TOLERANCE || valueWei > requiredWei2 + AMOUNT_TOLERANCE) {
+      if (valueWei < minAcceptable || valueWei > maxAcceptable) {
         return {
           valid: false,
-          error: `Amount mismatch: expected ${requiredAmount} MNT, got ${weiToTokenUnits(valueWei)} MNT`
+          error: `Amount mismatch: expected ~${requiredAmount} MNT (99.5%-100%), got ${weiToTokenUnits(valueWei)} MNT`
         };
       }
       return {
@@ -499,7 +603,7 @@ function createPaymentRequiredResponse(options, config, chainId) {
     }
   };
 }
-async function processPaymentMiddleware(options, headers) {
+async function processPaymentMiddleware(options, headers, requestPath, requestMethod) {
   try {
     if (options.customNetwork) {
       const networkId = options.network || "custom-network";
@@ -538,6 +642,28 @@ async function processPaymentMiddleware(options, headers) {
         }
       };
     }
+    if (verification.transactionHash && options.enableAnalytics !== false) {
+      Promise.resolve().then(() => (init_analytics(), analytics_exports)).then(({ logPayment: logPayment2 }) => {
+        logPayment2(
+          {
+            transactionHash: verification.transactionHash,
+            amount: verification.amount || options.price,
+            token: verification.token || options.token,
+            network,
+            toAddress: config.payTo,
+            blockNumber: void 0,
+            // Could be extracted from verification if available
+            status: "SUCCESS"
+          },
+          options.endpoint || requestPath,
+          // Use provided endpoint or extracted path
+          options.method || requestMethod
+          // Use provided method or extracted method
+        ).catch(() => {
+        });
+      }).catch(() => {
+      });
+    }
     return { allowed: true };
   } catch (error) {
     return {
@@ -551,6 +677,7 @@ async function processPaymentMiddleware(options, headers) {
 }
 
 // src/server/hono.ts
+init_platform();
 function x402(options) {
   if (!options.price || !options.token) {
     throw new Error("x402 middleware requires price and token options");
@@ -572,7 +699,29 @@ function x402(options) {
   return async (c, next) => {
     try {
       await ensureInitialized();
-      const result = await processPaymentMiddleware(options, c.req.header());
+      const requestPath = c.req.path || (c.req.url ? new URL(c.req.url).pathname : void 0);
+      const requestMethod = c.req.method;
+      if (requestPath && options.enableAnalytics !== false) {
+        Promise.resolve().then(() => (init_endpoint_registry(), endpoint_registry_exports)).then(({ registerEndpoint: registerEndpoint2 }) => {
+          const config = getProjectConfig();
+          const network = options.network || (options.testnet ? "mantle-sepolia" : config.network);
+          registerEndpoint2({
+            endpoint: requestPath,
+            method: requestMethod || options.method,
+            price: options.price,
+            token: options.token,
+            network
+          }).catch(() => {
+          });
+        }).catch(() => {
+        });
+      }
+      const result = await processPaymentMiddleware(
+        options,
+        c.req.header(),
+        requestPath,
+        requestMethod
+      );
       if (!result.allowed) {
         if (result.paymentRequired) {
           return c.json(result.paymentRequired.body, 402, result.paymentRequired.headers);
@@ -590,7 +739,10 @@ function x402(options) {
 }
 
 // src/server/index.ts
+init_platform();
 init_constants();
+init_analytics();
+init_endpoint_registry();
 export {
   DEFAULT_PLATFORM_URL,
   NETWORKS,
@@ -607,9 +759,11 @@ export {
   initializePlatform,
   isMainnet,
   isTestnet,
+  logPayment,
   processPaymentMiddleware,
   registerCustomNetwork,
   registerCustomTokens,
+  registerEndpoint,
   verifyPayment,
   verifyPaymentOnChain,
   x402