@paynodelabs/sdk-js 2.2.1 → 2.2.2

package/README.md

@@ -104,4 +104,18 @@ To publish a new version of the SDK:
 
 ---
 
+## Versioning Guide
+
+PayNode uses two distinct versioning schemes:
+
+| Version Type | Description | Current Value |
+| :--- | :--- | :--- |
+| **Protocol Version** | On-chain contracts & core x402 data schema. | `1.4.0` |
+| **SDK/Product Version** | Software package version (npm/SemVer). | `2.2.2` |
+
+> [!NOTE]
+> Protocol Version changes imply breaking changes in verification or contract interfaces. SDK Version changes may include features, fixes, or performance improvements without altering protocol logic.
+
+---
+
 _Built for the Autonomous AI Economy by PayNodeLabs._

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,eAAe,EAEhB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAoC;IAErD,OAAO,CAAC,SAAS,CAMf;IAEF,OAAO,CAAC,UAAU,CAAsB;gBAE5B,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,GAAG,MAAM,EAAkB,EAAE,UAAU,GAAE,MAAU;YAepF,eAAe;IAoCvB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;YA+DjE,aAAa;IA6JrB,6BAA6B,CACjC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAC9B,OAAO,CAAC,eAAe,CAAC;IA6CrB,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBpH,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BrJ,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAE,MAAa,EAAE,OAAO,GAAE,MAAY;;;;;;YAyChH,UAAU;CAYzB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,eAAe,EAEhB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAoC;IAErD,OAAO,CAAC,SAAS,CAMf;IAEF,OAAO,CAAC,UAAU,CAAsB;gBAE5B,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,GAAG,MAAM,EAAkB,EAAE,UAAU,GAAE,MAAU;YAepF,eAAe;IAoCvB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;YAuEjE,aAAa;IAkKrB,6BAA6B,CACjC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAC9B,OAAO,CAAC,eAAe,CAAC;IA+CrB,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBpH,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BrJ,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAE,MAAa,EAAE,OAAO,GAAE,MAAY;;;;;;YAyChH,UAAU;CAYzB"}

package/dist/client.js

@@ -63,11 +63,17 @@ class PayNodeAgentClient {
     }
     async requestGate(url, options = {}) {
         const fetchOptions = { ...options };
+        const network = await this.provider.getNetwork();
+        const paynodeNetwork = Number(network.chainId) === 8453 ? 'mainnet' : 'testnet';
+        fetchOptions.headers = {
+            'X-PayNode-Network': paynodeNetwork,
+            ...fetchOptions.headers
+        };
         if (options.json && !fetchOptions.body) {
             fetchOptions.body = JSON.stringify(options.json);
             fetchOptions.headers = {
-                'Content-Type': 'application/json',
-                ...fetchOptions.headers
+                ...fetchOptions.headers,
+                'Content-Type': 'application/json'
             };
         }
         try {
@@ -126,6 +132,7 @@ class PayNodeAgentClient {
         if (!requirement) {
             throw new errors_1.PayNodeException(errors_1.ErrorCode.TransactionFailed, `No compatible payment requirement found for network ${caip2ChainId}`);
         }
+        console.log(`💡 [PayNode-JS] Selected payment method: ${requirement.type || 'onchain'} on ${requirement.network}`);
         // 🛡️ Token Whitelist Check (Case-insensitive)
         const chainTokens = constants_1.ACCEPTED_TOKENS[chainId]?.map(t => t.toLowerCase());
         if (chainTokens && !chainTokens.includes(requirement.asset.toLowerCase())) {
@@ -156,7 +163,7 @@ class PayNodeAgentClient {
                 },
                 payload: authorization,
                 _paynode: {
-                    version: "2.2.1",
+                    version: constants_1.SDK_VERSION,
                     type: 'eip3009',
                     orderId: orderId
                 }
@@ -200,7 +207,7 @@ class PayNodeAgentClient {
                 },
                 payload: { txHash },
                 _paynode: {
-                    version: "2.2.1",
+                    version: constants_1.SDK_VERSION,
                     type: 'onchain',
                     orderId: orderId
                 }
@@ -210,6 +217,7 @@ class PayNodeAgentClient {
         const b64Payload = typeof globalThis.Buffer !== 'undefined'
             ? globalThis.Buffer.from(payloadJson).toString('base64')
             : btoa(payloadJson);
+        const paynodeNetwork = chainId === 8453 ? 'mainnet' : 'testnet';
         const retryOptions = {
             ...options,
             headers: {
@@ -217,7 +225,8 @@ class PayNodeAgentClient {
                 'Content-Type': 'application/json',
                 'PAYMENT-SIGNATURE': b64Payload,
                 'X-402-Payload': b64Payload, // Keep for backward compatibility
-                'X-402-Order-Id': orderId
+                'X-402-Order-Id': orderId,
+                'X-PayNode-Network': paynodeNetwork
             }
         };
         const retryResponse = await this._fetchWithRetry(url, retryOptions);
@@ -253,10 +262,12 @@ class PayNodeAgentClient {
     }
     async signTransferWithAuthorization(tokenAddr, to, amount, validAfter, validBefore, nonce, extra = {}) {
         const network = await this.provider.getNetwork();
+        const chainId = Number(network.chainId);
+        const defaultName = chainId === 8453 ? "USDC" : "USD Coin";
         const domain = {
-            name: extra.name || "USD Coin",
+            name: extra.name || defaultName,
             version: extra.version || "2",
-            chainId: Number(network.chainId),
+            chainId: chainId,
             verifyingContract: tokenAddr
         };
         const types = {

package/dist/constants.d.ts

@@ -1,4 +1,4 @@
-/** Generated by scripts/sync-config.py */
+/** Generated by meta/scripts/sync-config.py */
 export declare const PAYNODE_ROUTER_ADDRESS = "0x4A73696ccF76E7381b044cB95127B3784369Ed63";
 export declare const PAYNODE_ROUTER_ADDRESS_SANDBOX = "0x24cD8b68aaC209217ff5a6ef1Bf55a59f2c8Ca6F";
 export declare const BASE_USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
@@ -6,6 +6,7 @@ export declare const BASE_USDC_ADDRESS_SANDBOX = "0x65c088EfBDB0E03185Dbe8e258Ad
 export declare const PROTOCOL_TREASURY = "0x598bF63F5449876efafa7b36b77Deb2070621C0E";
 export declare const PROTOCOL_FEE_BPS = 100;
 export declare const MIN_PAYMENT_AMOUNT: bigint;
+export declare const SDK_VERSION = "2.2.2";
 export declare const BASE_RPC_URLS: string[];
 export declare const BASE_RPC_URLS_SANDBOX: string[];
 export declare const ACCEPTED_TOKENS: Record<number, string[]>;

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,eAAO,MAAM,sBAAsB,+CAA+C,CAAC;AACnF,eAAO,MAAM,8BAA8B,+CAA+C,CAAC;AAC3F,eAAO,MAAM,iBAAiB,+CAA+C,CAAC;AAC9E,eAAO,MAAM,yBAAyB,+CAA+C,CAAC;AACtF,eAAO,MAAM,iBAAiB,+CAA+C,CAAC;AAC9E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,kBAAkB,QAAe,CAAC;AAE/C,eAAO,MAAM,aAAa,UAAmF,CAAC;AAC9G,eAAO,MAAM,qBAAqB,UAA0E,CAAC;AAE7G,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAGpD,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAA25K,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB,+CAA+C,CAAC;AACnF,eAAO,MAAM,8BAA8B,+CAA+C,CAAC;AAC3F,eAAO,MAAM,iBAAiB,+CAA+C,CAAC;AAC9E,eAAO,MAAM,yBAAyB,+CAA+C,CAAC;AACtF,eAAO,MAAM,iBAAiB,+CAA+C,CAAC;AAC9E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,kBAAkB,QAAe,CAAC;AAC/C,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,aAAa,UAAmF,CAAC;AAC9G,eAAO,MAAM,qBAAqB,UAA0E,CAAC;AAE7G,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAGpD,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAA25K,CAAC"}

package/dist/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAYNODE_ROUTER_ABI = exports.ACCEPTED_TOKENS = exports.BASE_RPC_URLS_SANDBOX = exports.BASE_RPC_URLS = exports.MIN_PAYMENT_AMOUNT = exports.PROTOCOL_FEE_BPS = exports.PROTOCOL_TREASURY = exports.BASE_USDC_ADDRESS_SANDBOX = exports.BASE_USDC_ADDRESS = exports.PAYNODE_ROUTER_ADDRESS_SANDBOX = exports.PAYNODE_ROUTER_ADDRESS = void 0;
-/** Generated by scripts/sync-config.py */
+exports.PAYNODE_ROUTER_ABI = exports.ACCEPTED_TOKENS = exports.BASE_RPC_URLS_SANDBOX = exports.BASE_RPC_URLS = exports.SDK_VERSION = exports.MIN_PAYMENT_AMOUNT = exports.PROTOCOL_FEE_BPS = exports.PROTOCOL_TREASURY = exports.BASE_USDC_ADDRESS_SANDBOX = exports.BASE_USDC_ADDRESS = exports.PAYNODE_ROUTER_ADDRESS_SANDBOX = exports.PAYNODE_ROUTER_ADDRESS = void 0;
+/** Generated by meta/scripts/sync-config.py */
 exports.PAYNODE_ROUTER_ADDRESS = "0x4A73696ccF76E7381b044cB95127B3784369Ed63";
 exports.PAYNODE_ROUTER_ADDRESS_SANDBOX = "0x24cD8b68aaC209217ff5a6ef1Bf55a59f2c8Ca6F";
 exports.BASE_USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
@@ -9,6 +9,7 @@ exports.BASE_USDC_ADDRESS_SANDBOX = "0x65c088EfBDB0E03185Dbe8e258Ad0cf4Ab7946b0"
 exports.PROTOCOL_TREASURY = "0x598bF63F5449876efafa7b36b77Deb2070621C0E";
 exports.PROTOCOL_FEE_BPS = 100;
 exports.MIN_PAYMENT_AMOUNT = BigInt(1000);
+exports.SDK_VERSION = "2.2.2";
 exports.BASE_RPC_URLS = ["https://mainnet.base.org", "https://base.meowrpc.com", "https://1rpc.io/base"];
 exports.BASE_RPC_URLS_SANDBOX = ["https://sepolia.base.org", "https://base-sepolia-rpc.publicnode.com"];
 exports.ACCEPTED_TOKENS = {

package/dist/errors/index.d.ts

@@ -1,4 +1,4 @@
-/** Generated by scripts/sync-config.py */
+/** Generated by meta/scripts/sync-config.py */
 export declare enum ErrorCode {
     RpcError = "rpc_error",
     InsufficientFunds = "insufficient_funds",

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,oBAAY,SAAS;IACnB,QAAQ,cAAc;IACtB,iBAAiB,uBAAuB;IACxC,YAAY,mBAAmB;IAC/B,gBAAgB,uBAAuB;IACvC,iBAAiB,uBAAuB;IACxC,oBAAoB,0BAA0B;IAC9C,cAAc,oBAAoB;IAClC,aAAa,mBAAmB;IAChC,mBAAmB,0BAA0B;IAC7C,aAAa,mBAAmB;IAChC,aAAa,mBAAmB;IAChC,cAAc,oBAAoB;CACnC;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAajD,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,KAAK;IACtB,IAAI,EAAE,SAAS;IAA2B,OAAO,CAAC,EAAE,GAAG;gBAAvD,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,GAAG,YAAA;CAM3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,oBAAY,SAAS;IACnB,QAAQ,cAAc;IACtB,iBAAiB,uBAAuB;IACxC,YAAY,mBAAmB;IAC/B,gBAAgB,uBAAuB;IACvC,iBAAiB,uBAAuB;IACxC,oBAAoB,0BAA0B;IAC9C,cAAc,oBAAoB;IAClC,aAAa,mBAAmB;IAChC,mBAAmB,0BAA0B;IAC7C,aAAa,mBAAmB;IAChC,aAAa,mBAAmB;IAChC,cAAc,oBAAoB;CACnC;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAajD,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,KAAK;IACtB,IAAI,EAAE,SAAS;IAA2B,OAAO,CAAC,EAAE,GAAG;gBAAvD,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,GAAG,YAAA;CAM3E"}

package/dist/errors/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PayNodeException = exports.ERROR_MESSAGES = exports.ErrorCode = void 0;
-/** Generated by scripts/sync-config.py */
+/** Generated by meta/scripts/sync-config.py */
 var ErrorCode;
 (function (ErrorCode) {
     ErrorCode["RpcError"] = "rpc_error";

package/dist/index.d.ts

@@ -5,5 +5,7 @@ export * from './utils/webhook';
 export * from './client';
 export * from './errors';
 export * from './constants';
+export * from './utils/payload';
 export * from './types/x402';
+export { ethers } from 'ethers';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ethers = void 0;
 __exportStar(require("./middleware/x402"), exports);
 __exportStar(require("./utils/verifier"), exports);
 __exportStar(require("./utils/idempotency"), exports);
@@ -21,4 +22,7 @@ __exportStar(require("./utils/webhook"), exports);
 __exportStar(require("./client"), exports);
 __exportStar(require("./errors"), exports);
 __exportStar(require("./constants"), exports);
+__exportStar(require("./utils/payload"), exports);
 __exportStar(require("./types/x402"), exports);
+var ethers_1 = require("ethers");
+Object.defineProperty(exports, "ethers", { enumerable: true, get: function () { return ethers_1.ethers; } });

package/dist/middleware/x402.js

@@ -30,7 +30,7 @@ const x402Gate = (options) => {
         fractionPart = fractionPart.slice(0, decimals).padEnd(decimals, '0');
         rawAmount = BigInt(integerPart + fractionPart);
     }
-    const defaultOrderIdGen = (req) => `agent_js_${Date.now()}`;
+    const defaultOrderIdGen = (req) => `pn_sdk_${Date.now()}`;
     return async (req, res, next) => {
         // ... rest of the logic
         const getHeader = (name) => {
@@ -63,7 +63,7 @@ const x402Gate = (options) => {
                         inferredType = "onchain";
                     }
                     unifiedPayload = {
-                        version: "2.2.1",
+                        version: "2.2.2",
                         type: parsed._paynode?.type || inferredType,
                         orderId: internalOrderId,
                         router: parsed.accepted?.router,

package/dist/types/x402.d.ts

@@ -67,7 +67,7 @@ export interface VerifyResponse {
     payer?: string;
 }
 export interface UnifiedPaymentPayload {
-    version: "2.2.1";
+    version: "2.2.2";
     type: "onchain" | "eip3009";
     orderId: string;
     router?: string;

package/dist/utils/payload.d.ts

@@ -0,0 +1,17 @@
+import { UnifiedPaymentPayload } from '../types/x402';
+export declare class X402PayloadHelper {
+    /**
+     * Normalizes a raw payment payload (usually from PAYMENT-SIGNATURE or X-402-Payload headers)
+     * into the UnifiedPaymentPayload format used internally by PayNode.
+     *
+     * Supports:
+     * - standard X402 V2 format
+     * - legacy PayNode internal format (base64 encoded JSON)
+     *
+     * @param authHeader The base64 encoded payload header
+     * @param fallbackOrderId Optional orderId to use if missing from payload
+     * @returns UnifiedPaymentPayload
+     */
+    static normalize(authHeader: string, fallbackOrderId?: string): UnifiedPaymentPayload;
+}
+//# sourceMappingURL=payload.d.ts.map

package/dist/utils/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/utils/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,qBAAa,iBAAiB;IAC5B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,qBAAqB;CAuCtF"}

package/dist/utils/payload.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402PayloadHelper = void 0;
+class X402PayloadHelper {
+    /**
+     * Normalizes a raw payment payload (usually from PAYMENT-SIGNATURE or X-402-Payload headers)
+     * into the UnifiedPaymentPayload format used internally by PayNode.
+     *
+     * Supports:
+     * - standard X402 V2 format
+     * - legacy PayNode internal format (base64 encoded JSON)
+     *
+     * @param authHeader The base64 encoded payload header
+     * @param fallbackOrderId Optional orderId to use if missing from payload
+     * @returns UnifiedPaymentPayload
+     */
+    static normalize(authHeader, fallbackOrderId) {
+        try {
+            const decoded = Buffer.from(authHeader, 'base64').toString('utf-8');
+            const parsed = JSON.parse(decoded);
+            // 1. Handle Official X402 V2 Standard Format
+            if (parsed.x402Version === 2 && parsed.accepted) {
+                let inferredType = "onchain";
+                // Inference logic: signature/authorization presence implies EIP-3009 (USDC Permit/TransferWithAuth)
+                if (parsed.payload?.signature || parsed.payload?.authorization) {
+                    inferredType = "eip3009";
+                }
+                else if (parsed.payload?.txHash) {
+                    inferredType = "onchain";
+                }
+                return {
+                    version: "2.2.2",
+                    type: parsed._paynode?.type || inferredType,
+                    orderId: parsed._paynode?.orderId || fallbackOrderId || "",
+                    router: parsed.accepted?.router || parsed.router,
+                    payload: parsed.payload
+                };
+            }
+            // 2. Handle Legacy or already Unified Format
+            if (typeof parsed.version === 'string' && (parsed.version.startsWith("2.2") || parsed.version.startsWith("2.3"))) {
+                return {
+                    ...parsed,
+                    orderId: parsed.orderId || parsed.order_id || fallbackOrderId || ""
+                };
+            }
+            // 3. Fallback for raw internal format
+            return parsed;
+        }
+        catch (e) {
+            throw new Error(`Failed to normalize PayNode payload: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+}
+exports.X402PayloadHelper = X402PayloadHelper;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paynodelabs/sdk-js",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "The official JavaScript/TypeScript SDK for PayNode x402 protocol on Base L2.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -25,7 +25,7 @@
   "author": "PayNodeLabs",
   "license": "MIT",
   "dependencies": {
-    "ethers": "^6.13.0",
+    "ethers": "^6.16.0",
     "ioredis": "^5.10.1"
   },
   "peerDependencies": {