uvd-x402-sdk 2.5.0 → 2.10.0

package/dist/utils/index.d.mts

@@ -1,4 +1,4 @@
-import { X as X402Version, k as X402Header, o as X402PayloadData, l as X402HeaderV1, n as X402PaymentOption, m as X402HeaderV2, C as ChainConfig } from '../index-DR2vXt-c.mjs';
+import { l as X402Version, m as X402Header, q as X402PayloadData, n as X402HeaderV1, p as X402PaymentOption, o as X402HeaderV2, C as ChainConfig, g as PaymentHeaders, X as X402HeaderName } from '../index-D-dO_FoP.mjs';
 
 /**
  * uvd-x402-sdk - x402 Protocol Utilities
@@ -101,11 +101,12 @@ declare function isCAIP2Format(network: string): boolean;
 declare function convertX402Header(header: X402Header, targetVersion: X402Version): X402Header;
 
 /**
- * uvd-x402-sdk - Validation Utilities
+ * uvd-x402-sdk - Validation and Payment Header Utilities
  *
- * Functions for validating payment parameters to prevent
- * invalid or empty values from being processed.
+ * Functions for validating payment parameters and creating
+ * payment headers for HTTP requests.
  */
+
 /**
  * Validate that a recipient address is present and valid
  *
@@ -128,5 +129,56 @@ declare function validateRecipient(recipient: string | undefined | null, network
  * @throws X402Error with code 'INVALID_AMOUNT' if validation fails
  */
 declare function validateAmount(amount: string | undefined | null): asserts amount is string;
+/**
+ * Create payment headers object from a base64-encoded payload
+ *
+ * Returns an object with both X-PAYMENT and PAYMENT-SIGNATURE headers,
+ * making it easy to use either header format.
+ *
+ * @param paymentHeader - Base64-encoded payment payload
+ * @returns PaymentHeaders object with both header formats
+ *
+ * @example
+ * ```ts
+ * const headers = createPaymentHeaders(paymentHeader);
+ *
+ * // Use v1 header (most compatible)
+ * fetch(url, { headers: { 'X-PAYMENT': headers['X-PAYMENT'] } });
+ *
+ * // Use v2 header
+ * fetch(url, { headers: { 'PAYMENT-SIGNATURE': headers['PAYMENT-SIGNATURE'] } });
+ * ```
+ */
+declare function createPaymentHeaders(paymentHeader: string): PaymentHeaders;
+/**
+ * Get a single payment header by name
+ *
+ * @param paymentHeader - Base64-encoded payment payload
+ * @param headerName - Header name to use ('X-PAYMENT' or 'PAYMENT-SIGNATURE')
+ * @returns Object with a single header entry
+ *
+ * @example
+ * ```ts
+ * // Use with fetch spread operator
+ * fetch(url, {
+ *   headers: {
+ *     'Content-Type': 'application/json',
+ *     ...getPaymentHeader(result.paymentHeader, 'X-PAYMENT'),
+ *   },
+ * });
+ * ```
+ */
+declare function getPaymentHeader(paymentHeader: string, headerName?: X402HeaderName): Record<X402HeaderName, string>;
+/**
+ * Default x402 payment header name
+ *
+ * Use 'X-PAYMENT' for maximum compatibility with all facilitators.
+ * Use 'PAYMENT-SIGNATURE' for x402 v2 compliance.
+ */
+declare const DEFAULT_PAYMENT_HEADER: X402HeaderName;
+/**
+ * All supported x402 payment header names
+ */
+declare const PAYMENT_HEADER_NAMES: readonly X402HeaderName[];
 
-export { caip2ToChain, chainToCAIP2, convertX402Header, createX402Header, createX402V1Header, createX402V2Header, decodeX402Header, detectX402Version, encodeX402Header, generatePaymentOptions, isCAIP2Format, parseNetworkIdentifier, validateAmount, validateRecipient };
+export { DEFAULT_PAYMENT_HEADER, PAYMENT_HEADER_NAMES, caip2ToChain, chainToCAIP2, convertX402Header, createPaymentHeaders, createX402Header, createX402V1Header, createX402V2Header, decodeX402Header, detectX402Version, encodeX402Header, generatePaymentOptions, getPaymentHeader, isCAIP2Format, parseNetworkIdentifier, validateAmount, validateRecipient };

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-import { X as X402Version, k as X402Header, o as X402PayloadData, l as X402HeaderV1, n as X402PaymentOption, m as X402HeaderV2, C as ChainConfig } from '../index-DR2vXt-c.js';
+import { l as X402Version, m as X402Header, q as X402PayloadData, n as X402HeaderV1, p as X402PaymentOption, o as X402HeaderV2, C as ChainConfig, g as PaymentHeaders, X as X402HeaderName } from '../index-D-dO_FoP.js';
 
 /**
  * uvd-x402-sdk - x402 Protocol Utilities
@@ -101,11 +101,12 @@ declare function isCAIP2Format(network: string): boolean;
 declare function convertX402Header(header: X402Header, targetVersion: X402Version): X402Header;
 
 /**
- * uvd-x402-sdk - Validation Utilities
+ * uvd-x402-sdk - Validation and Payment Header Utilities
  *
- * Functions for validating payment parameters to prevent
- * invalid or empty values from being processed.
+ * Functions for validating payment parameters and creating
+ * payment headers for HTTP requests.
  */
+
 /**
  * Validate that a recipient address is present and valid
  *
@@ -128,5 +129,56 @@ declare function validateRecipient(recipient: string | undefined | null, network
  * @throws X402Error with code 'INVALID_AMOUNT' if validation fails
  */
 declare function validateAmount(amount: string | undefined | null): asserts amount is string;
+/**
+ * Create payment headers object from a base64-encoded payload
+ *
+ * Returns an object with both X-PAYMENT and PAYMENT-SIGNATURE headers,
+ * making it easy to use either header format.
+ *
+ * @param paymentHeader - Base64-encoded payment payload
+ * @returns PaymentHeaders object with both header formats
+ *
+ * @example
+ * ```ts
+ * const headers = createPaymentHeaders(paymentHeader);
+ *
+ * // Use v1 header (most compatible)
+ * fetch(url, { headers: { 'X-PAYMENT': headers['X-PAYMENT'] } });
+ *
+ * // Use v2 header
+ * fetch(url, { headers: { 'PAYMENT-SIGNATURE': headers['PAYMENT-SIGNATURE'] } });
+ * ```
+ */
+declare function createPaymentHeaders(paymentHeader: string): PaymentHeaders;
+/**
+ * Get a single payment header by name
+ *
+ * @param paymentHeader - Base64-encoded payment payload
+ * @param headerName - Header name to use ('X-PAYMENT' or 'PAYMENT-SIGNATURE')
+ * @returns Object with a single header entry
+ *
+ * @example
+ * ```ts
+ * // Use with fetch spread operator
+ * fetch(url, {
+ *   headers: {
+ *     'Content-Type': 'application/json',
+ *     ...getPaymentHeader(result.paymentHeader, 'X-PAYMENT'),
+ *   },
+ * });
+ * ```
+ */
+declare function getPaymentHeader(paymentHeader: string, headerName?: X402HeaderName): Record<X402HeaderName, string>;
+/**
+ * Default x402 payment header name
+ *
+ * Use 'X-PAYMENT' for maximum compatibility with all facilitators.
+ * Use 'PAYMENT-SIGNATURE' for x402 v2 compliance.
+ */
+declare const DEFAULT_PAYMENT_HEADER: X402HeaderName;
+/**
+ * All supported x402 payment header names
+ */
+declare const PAYMENT_HEADER_NAMES: readonly X402HeaderName[];
 
-export { caip2ToChain, chainToCAIP2, convertX402Header, createX402Header, createX402V1Header, createX402V2Header, decodeX402Header, detectX402Version, encodeX402Header, generatePaymentOptions, isCAIP2Format, parseNetworkIdentifier, validateAmount, validateRecipient };
+export { DEFAULT_PAYMENT_HEADER, PAYMENT_HEADER_NAMES, caip2ToChain, chainToCAIP2, convertX402Header, createPaymentHeaders, createX402Header, createX402V1Header, createX402V2Header, decodeX402Header, detectX402Version, encodeX402Header, generatePaymentOptions, getPaymentHeader, isCAIP2Format, parseNetworkIdentifier, validateAmount, validateRecipient };

package/dist/utils/index.js

@@ -19,7 +19,10 @@ var CAIP2_IDENTIFIERS = {
   // Stellar
   stellar: "stellar:pubnet",
   // NEAR
-  near: "near:mainnet"
+  near: "near:mainnet",
+  // Algorand
+  algorand: "algorand:mainnet",
+  "algorand-testnet": "algorand:testnet"
 };
 var CAIP2_TO_CHAIN = Object.fromEntries(
   Object.entries(CAIP2_IDENTIFIERS).map(([k, v]) => [v, k])
@@ -561,6 +564,80 @@ var SUPPORTED_CHAINS = {
       enabled: true
       // NEP-366 meta-transactions supported
     }
+  },
+  // ============================================================================
+  // ALGORAND (2 networks) - Uses ASA transfers with atomic transaction groups
+  // ============================================================================
+  algorand: {
+    chainId: 0,
+    // Non-EVM (Algorand uses genesis hash for network identification)
+    chainIdHex: "0x0",
+    name: "algorand",
+    displayName: "Algorand",
+    networkType: "algorand",
+    rpcUrl: "https://mainnet-api.algonode.cloud",
+    explorerUrl: "https://allo.info",
+    nativeCurrency: {
+      name: "Algo",
+      symbol: "ALGO",
+      decimals: 6
+      // Algorand uses 6 decimals (microAlgos)
+    },
+    usdc: {
+      address: "31566704",
+      // USDC ASA ID on Algorand mainnet
+      decimals: 6,
+      name: "USDC",
+      version: "1"
+    },
+    tokens: {
+      usdc: {
+        address: "31566704",
+        // USDC ASA ID on Algorand mainnet
+        decimals: 6,
+        name: "USDC",
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  "algorand-testnet": {
+    chainId: 0,
+    // Non-EVM
+    chainIdHex: "0x0",
+    name: "algorand-testnet",
+    displayName: "Algorand Testnet",
+    networkType: "algorand",
+    rpcUrl: "https://testnet-api.algonode.cloud",
+    explorerUrl: "https://testnet.allo.info",
+    nativeCurrency: {
+      name: "Algo",
+      symbol: "ALGO",
+      decimals: 6
+    },
+    usdc: {
+      address: "10458941",
+      // USDC ASA ID on Algorand testnet
+      decimals: 6,
+      name: "USDC",
+      version: "1"
+    },
+    tokens: {
+      usdc: {
+        address: "10458941",
+        // USDC ASA ID on Algorand testnet
+        decimals: 6,
+        name: "USDC",
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
   }
 };
 function getChainByName(name) {
@@ -786,10 +863,27 @@ function validateAmount(amount) {
     );
   }
 }
+function createPaymentHeaders(paymentHeader) {
+  return {
+    "X-PAYMENT": paymentHeader,
+    "PAYMENT-SIGNATURE": paymentHeader
+  };
+}
+function getPaymentHeader(paymentHeader, headerName = "X-PAYMENT") {
+  return { [headerName]: paymentHeader };
+}
+var DEFAULT_PAYMENT_HEADER = "X-PAYMENT";
+var PAYMENT_HEADER_NAMES = [
+  "X-PAYMENT",
+  "PAYMENT-SIGNATURE"
+];
 
+exports.DEFAULT_PAYMENT_HEADER = DEFAULT_PAYMENT_HEADER;
+exports.PAYMENT_HEADER_NAMES = PAYMENT_HEADER_NAMES;
 exports.caip2ToChain = caip2ToChain;
 exports.chainToCAIP2 = chainToCAIP2;
 exports.convertX402Header = convertX402Header;
+exports.createPaymentHeaders = createPaymentHeaders;
 exports.createX402Header = createX402Header;
 exports.createX402V1Header = createX402V1Header;
 exports.createX402V2Header = createX402V2Header;
@@ -797,6 +891,7 @@ exports.decodeX402Header = decodeX402Header;
 exports.detectX402Version = detectX402Version;
 exports.encodeX402Header = encodeX402Header;
 exports.generatePaymentOptions = generatePaymentOptions;
+exports.getPaymentHeader = getPaymentHeader;
 exports.isCAIP2Format = isCAIP2Format;
 exports.parseNetworkIdentifier = parseNetworkIdentifier;
 exports.validateAmount = validateAmount;