uvd-x402-sdk 2.11.1 → 2.13.0

package/dist/{index-C60c_e5z.d.mts → index-C6Vxnneo.d.mts}

@@ -1,4 +1,4 @@
-import { w as X402ClientConfig, P as PaymentInfo, f as PaymentResult, W as WalletState, C as ChainConfig, y as X402Event, B as X402EventHandler, a as NetworkType, T as TokenType, b as TokenConfig } from './index-D-dO_FoP.mjs';
+import { w as X402ClientConfig, P as PaymentInfo, f as PaymentResult, W as WalletState, C as ChainConfig, y as X402Event, B as X402EventHandler, a as NetworkType, T as TokenType, b as TokenConfig } from './index-fIhvHqCQ.mjs';
 
 /**
  * uvd-x402-sdk - Main Client

package/dist/{index-VIOUicmO.d.ts → index-DmJGKD9r.d.ts}

@@ -1,4 +1,4 @@
-import { w as X402ClientConfig, P as PaymentInfo, f as PaymentResult, W as WalletState, C as ChainConfig, y as X402Event, B as X402EventHandler, a as NetworkType, T as TokenType, b as TokenConfig } from './index-D-dO_FoP.js';
+import { w as X402ClientConfig, P as PaymentInfo, f as PaymentResult, W as WalletState, C as ChainConfig, y as X402Event, B as X402EventHandler, a as NetworkType, T as TokenType, b as TokenConfig } from './index-fIhvHqCQ.js';
 
 /**
  * uvd-x402-sdk - Main Client

package/dist/{index-D-dO_FoP.d.mts → index-fIhvHqCQ.d.mts}

@@ -304,23 +304,21 @@ interface NEARPaymentPayload {
 /**
  * Algorand payment payload (atomic transaction group)
  *
- * Algorand uses a unique payment model where the facilitator creates and signs
- * an atomic transaction group. The user signs their portion (the ASA transfer)
- * and the facilitator submits the complete group.
+ * Follows the GoPlausible x402-avm spec for atomic groups:
+ * - Transaction 0: Fee payment (UNSIGNED) - facilitator -> facilitator, covers all fees
+ * - Transaction 1: ASA transfer (SIGNED) - client -> merchant
+ *
+ * The facilitator signs transaction 0 and submits the complete atomic group.
  */
 interface AlgorandPaymentPayload {
-    /** Sender's Algorand address (58-character base32) */
-    from: string;
-    /** Recipient's Algorand address */
-    to: string;
-    /** Amount in base units (microAlgos for ALGO, or base units for ASA) */
-    amount: string;
-    /** USDC ASA ID (31566704 for mainnet, 10458941 for testnet) */
-    assetId: number;
-    /** Base64-encoded signed transaction bytes */
-    signedTxn: string;
-    /** Optional note field */
-    note?: string;
+    /** Index of the payment transaction in the group (always 1) */
+    paymentIndex: number;
+    /**
+     * Array of base64-encoded msgpack transactions forming the atomic group:
+     * - [0]: Unsigned fee transaction (facilitator signs)
+     * - [1]: Signed ASA transfer (client signed)
+     */
+    paymentGroup: string[];
 }
 /**
  * Union type for all payment payloads
@@ -410,15 +408,13 @@ interface X402NEARPayload {
     signedDelegateAction: string;
 }
 /**
- * Algorand-specific payload in x402 header
+ * Algorand-specific payload in x402 header (atomic group format)
  */
 interface X402AlgorandPayload {
-    from: string;
-    to: string;
-    amount: string;
-    assetId: number;
-    signedTxn: string;
-    note?: string;
+    /** Index of the payment transaction in the group (always 1) */
+    paymentIndex: number;
+    /** Array of base64-encoded msgpack transactions */
+    paymentGroup: string[];
 }
 /**
  * Union of all x402 payload types

package/dist/{index-D-dO_FoP.d.ts → index-fIhvHqCQ.d.ts}

@@ -304,23 +304,21 @@ interface NEARPaymentPayload {
 /**
  * Algorand payment payload (atomic transaction group)
  *
- * Algorand uses a unique payment model where the facilitator creates and signs
- * an atomic transaction group. The user signs their portion (the ASA transfer)
- * and the facilitator submits the complete group.
+ * Follows the GoPlausible x402-avm spec for atomic groups:
+ * - Transaction 0: Fee payment (UNSIGNED) - facilitator -> facilitator, covers all fees
+ * - Transaction 1: ASA transfer (SIGNED) - client -> merchant
+ *
+ * The facilitator signs transaction 0 and submits the complete atomic group.
  */
 interface AlgorandPaymentPayload {
-    /** Sender's Algorand address (58-character base32) */
-    from: string;
-    /** Recipient's Algorand address */
-    to: string;
-    /** Amount in base units (microAlgos for ALGO, or base units for ASA) */
-    amount: string;
-    /** USDC ASA ID (31566704 for mainnet, 10458941 for testnet) */
-    assetId: number;
-    /** Base64-encoded signed transaction bytes */
-    signedTxn: string;
-    /** Optional note field */
-    note?: string;
+    /** Index of the payment transaction in the group (always 1) */
+    paymentIndex: number;
+    /**
+     * Array of base64-encoded msgpack transactions forming the atomic group:
+     * - [0]: Unsigned fee transaction (facilitator signs)
+     * - [1]: Signed ASA transfer (client signed)
+     */
+    paymentGroup: string[];
 }
 /**
  * Union type for all payment payloads
@@ -410,15 +408,13 @@ interface X402NEARPayload {
     signedDelegateAction: string;
 }
 /**
- * Algorand-specific payload in x402 header
+ * Algorand-specific payload in x402 header (atomic group format)
  */
 interface X402AlgorandPayload {
-    from: string;
-    to: string;
-    amount: string;
-    assetId: number;
-    signedTxn: string;
-    note?: string;
+    /** Index of the payment transaction in the group (always 1) */
+    paymentIndex: number;
+    /** Array of base64-encoded msgpack transactions */
+    paymentGroup: string[];
 }
 /**
  * Union of all x402 payload types

package/dist/index.d.mts

@@ -1,3 +1,57 @@
-export { D as DEFAULT_CHAIN, a as DEFAULT_FACILITATOR_URL, S as SUPPORTED_CHAINS, X as X402Client, q as getAlgorandChains, g as getChainById, b as getChainByName, d as getChainsByNetworkType, p as getChainsByToken, e as getEVMChainIds, c as getEnabledChains, l as getExplorerAddressUrl, k as getExplorerTxUrl, j as getNetworkType, f as getSVMChains, n as getSupportedTokens, m as getTokenConfig, r as isAlgorandChain, i as isChainSupported, h as isSVMChain, o as isTokenSupported } from './index-C60c_e5z.mjs';
+export { D as DEFAULT_CHAIN, a as DEFAULT_FACILITATOR_URL, S as SUPPORTED_CHAINS, X as X402Client, q as getAlgorandChains, g as getChainById, b as getChainByName, d as getChainsByNetworkType, p as getChainsByToken, e as getEVMChainIds, c as getEnabledChains, l as getExplorerAddressUrl, k as getExplorerTxUrl, j as getNetworkType, f as getSVMChains, n as getSupportedTokens, m as getTokenConfig, r as isAlgorandChain, i as isChainSupported, h as isSVMChain, o as isTokenSupported } from './index-C6Vxnneo.mjs';
 export { DEFAULT_PAYMENT_HEADER, PAYMENT_HEADER_NAMES, caip2ToChain, chainToCAIP2, convertX402Header, createPaymentHeaders, createX402Header, createX402V1Header, createX402V2Header, decodeX402Header, detectX402Version, encodeX402Header, generatePaymentOptions, getPaymentHeader, isCAIP2Format, parseNetworkIdentifier, validateAmount, validateRecipient } from './utils/index.mjs';
-export { A as AlgorandPaymentPayload, H as CAIP2_IDENTIFIERS, I as CAIP2_TO_CHAIN, C as ChainConfig, G as DEFAULT_CONFIG, E as EIP712Domain, d as EIP712Types, i as EVMPaymentPayload, M as MultiPaymentConfig, k as NEARPaymentPayload, N as NativeCurrency, x as NetworkBalance, a as NetworkType, g as PaymentHeaders, P as PaymentInfo, h as PaymentPayload, e as PaymentRequest, f as PaymentResult, S as SolanaPaymentPayload, j as StellarPaymentPayload, b as TokenConfig, T as TokenType, U as USDCConfig, c as WalletAdapter, W as WalletState, v as X402AlgorandPayload, w as X402ClientConfig, r as X402EVMPayload, F as X402Error, D as X402ErrorCode, y as X402Event, z as X402EventData, B as X402EventHandler, m as X402Header, X as X402HeaderName, n as X402HeaderV1, o as X402HeaderV2, u as X402NEARPayload, q as X402PayloadData, p as X402PaymentOption, s as X402SolanaPayload, t as X402StellarPayload, l as X402Version } from './index-D-dO_FoP.mjs';
+export { A as AlgorandPaymentPayload, H as CAIP2_IDENTIFIERS, I as CAIP2_TO_CHAIN, C as ChainConfig, G as DEFAULT_CONFIG, E as EIP712Domain, d as EIP712Types, i as EVMPaymentPayload, M as MultiPaymentConfig, k as NEARPaymentPayload, N as NativeCurrency, x as NetworkBalance, a as NetworkType, g as PaymentHeaders, P as PaymentInfo, h as PaymentPayload, e as PaymentRequest, f as PaymentResult, S as SolanaPaymentPayload, j as StellarPaymentPayload, b as TokenConfig, T as TokenType, U as USDCConfig, c as WalletAdapter, W as WalletState, v as X402AlgorandPayload, w as X402ClientConfig, r as X402EVMPayload, F as X402Error, D as X402ErrorCode, y as X402Event, z as X402EventData, B as X402EventHandler, m as X402Header, X as X402HeaderName, n as X402HeaderV1, o as X402HeaderV2, u as X402NEARPayload, q as X402PayloadData, p as X402PaymentOption, s as X402SolanaPayload, t as X402StellarPayload, l as X402Version } from './index-fIhvHqCQ.mjs';
+
+/**
+ * Facilitator wallet addresses by chain type
+ *
+ * These are the public addresses of the facilitator's wallets.
+ * The facilitator uses these to pay fees and sign transactions.
+ */
+declare const FACILITATOR_ADDRESSES: {
+    /**
+     * Solana facilitator address (fee payer)
+     * Used for: Paying transaction fees on Solana
+     */
+    readonly solana: "F742C4VfFLQ9zRQyithoj5229ZgtX2WqKCSFKgH2EThq";
+    /**
+     * Algorand facilitator address (fee payer)
+     * Used for: Signing Transaction 0 (fee tx) in atomic groups
+     * Note: This is derived from the facilitator's Algorand mnemonic
+     */
+    readonly algorand: "SXHRBXS22SKKXHXK44DTQMWN2SXK3SFJWBDAQZGF4DRPW7PNFAUM2GYFAQ";
+    /**
+     * Algorand testnet facilitator address
+     */
+    readonly 'algorand-testnet': "SXHRBXS22SKKXHXK44DTQMWN2SXK3SFJWBDAQZGF4DRPW7PNFAUM2GYFAQ";
+    /**
+     * EVM facilitator address
+     * Used for: Submitting EIP-3009 transferWithAuthorization transactions
+     * Note: Same address across all EVM chains
+     */
+    readonly evm: "0x7c5F3AdB0C7775968Bc7e7cF61b27fECf2e2b500";
+    /**
+     * Stellar facilitator address
+     * Used for: Signing soroban authorization entries
+     */
+    readonly stellar: "GDUTDNV53WQPOB2JUZPO6SXH4LVT7CJSLCMLFQ7W4CNAXGIX7XYMCNP2";
+    /**
+     * NEAR facilitator address
+     * Used for: Relaying meta-transactions
+     */
+    readonly near: "uvd-facilitator.near";
+};
+/**
+ * Get the facilitator address for a specific chain
+ *
+ * @param chainName - The chain name (e.g., 'algorand', 'solana', 'base')
+ * @param networkType - The network type (e.g., 'evm', 'svm', 'algorand')
+ * @returns The facilitator address for that chain, or undefined if not supported
+ */
+declare function getFacilitatorAddress(chainName: string, networkType?: string): string | undefined;
+/**
+ * Type for facilitator addresses
+ */
+type FacilitatorAddresses = typeof FACILITATOR_ADDRESSES;
+
+export { FACILITATOR_ADDRESSES, type FacilitatorAddresses, getFacilitatorAddress };

package/dist/index.d.ts

@@ -1,3 +1,57 @@
-export { D as DEFAULT_CHAIN, a as DEFAULT_FACILITATOR_URL, S as SUPPORTED_CHAINS, X as X402Client, q as getAlgorandChains, g as getChainById, b as getChainByName, d as getChainsByNetworkType, p as getChainsByToken, e as getEVMChainIds, c as getEnabledChains, l as getExplorerAddressUrl, k as getExplorerTxUrl, j as getNetworkType, f as getSVMChains, n as getSupportedTokens, m as getTokenConfig, r as isAlgorandChain, i as isChainSupported, h as isSVMChain, o as isTokenSupported } from './index-VIOUicmO.js';
+export { D as DEFAULT_CHAIN, a as DEFAULT_FACILITATOR_URL, S as SUPPORTED_CHAINS, X as X402Client, q as getAlgorandChains, g as getChainById, b as getChainByName, d as getChainsByNetworkType, p as getChainsByToken, e as getEVMChainIds, c as getEnabledChains, l as getExplorerAddressUrl, k as getExplorerTxUrl, j as getNetworkType, f as getSVMChains, n as getSupportedTokens, m as getTokenConfig, r as isAlgorandChain, i as isChainSupported, h as isSVMChain, o as isTokenSupported } from './index-DmJGKD9r.js';
 export { DEFAULT_PAYMENT_HEADER, PAYMENT_HEADER_NAMES, caip2ToChain, chainToCAIP2, convertX402Header, createPaymentHeaders, createX402Header, createX402V1Header, createX402V2Header, decodeX402Header, detectX402Version, encodeX402Header, generatePaymentOptions, getPaymentHeader, isCAIP2Format, parseNetworkIdentifier, validateAmount, validateRecipient } from './utils/index.js';
-export { A as AlgorandPaymentPayload, H as CAIP2_IDENTIFIERS, I as CAIP2_TO_CHAIN, C as ChainConfig, G as DEFAULT_CONFIG, E as EIP712Domain, d as EIP712Types, i as EVMPaymentPayload, M as MultiPaymentConfig, k as NEARPaymentPayload, N as NativeCurrency, x as NetworkBalance, a as NetworkType, g as PaymentHeaders, P as PaymentInfo, h as PaymentPayload, e as PaymentRequest, f as PaymentResult, S as SolanaPaymentPayload, j as StellarPaymentPayload, b as TokenConfig, T as TokenType, U as USDCConfig, c as WalletAdapter, W as WalletState, v as X402AlgorandPayload, w as X402ClientConfig, r as X402EVMPayload, F as X402Error, D as X402ErrorCode, y as X402Event, z as X402EventData, B as X402EventHandler, m as X402Header, X as X402HeaderName, n as X402HeaderV1, o as X402HeaderV2, u as X402NEARPayload, q as X402PayloadData, p as X402PaymentOption, s as X402SolanaPayload, t as X402StellarPayload, l as X402Version } from './index-D-dO_FoP.js';
+export { A as AlgorandPaymentPayload, H as CAIP2_IDENTIFIERS, I as CAIP2_TO_CHAIN, C as ChainConfig, G as DEFAULT_CONFIG, E as EIP712Domain, d as EIP712Types, i as EVMPaymentPayload, M as MultiPaymentConfig, k as NEARPaymentPayload, N as NativeCurrency, x as NetworkBalance, a as NetworkType, g as PaymentHeaders, P as PaymentInfo, h as PaymentPayload, e as PaymentRequest, f as PaymentResult, S as SolanaPaymentPayload, j as StellarPaymentPayload, b as TokenConfig, T as TokenType, U as USDCConfig, c as WalletAdapter, W as WalletState, v as X402AlgorandPayload, w as X402ClientConfig, r as X402EVMPayload, F as X402Error, D as X402ErrorCode, y as X402Event, z as X402EventData, B as X402EventHandler, m as X402Header, X as X402HeaderName, n as X402HeaderV1, o as X402HeaderV2, u as X402NEARPayload, q as X402PayloadData, p as X402PaymentOption, s as X402SolanaPayload, t as X402StellarPayload, l as X402Version } from './index-fIhvHqCQ.js';
+
+/**
+ * Facilitator wallet addresses by chain type
+ *
+ * These are the public addresses of the facilitator's wallets.
+ * The facilitator uses these to pay fees and sign transactions.
+ */
+declare const FACILITATOR_ADDRESSES: {
+    /**
+     * Solana facilitator address (fee payer)
+     * Used for: Paying transaction fees on Solana
+     */
+    readonly solana: "F742C4VfFLQ9zRQyithoj5229ZgtX2WqKCSFKgH2EThq";
+    /**
+     * Algorand facilitator address (fee payer)
+     * Used for: Signing Transaction 0 (fee tx) in atomic groups
+     * Note: This is derived from the facilitator's Algorand mnemonic
+     */
+    readonly algorand: "SXHRBXS22SKKXHXK44DTQMWN2SXK3SFJWBDAQZGF4DRPW7PNFAUM2GYFAQ";
+    /**
+     * Algorand testnet facilitator address
+     */
+    readonly 'algorand-testnet': "SXHRBXS22SKKXHXK44DTQMWN2SXK3SFJWBDAQZGF4DRPW7PNFAUM2GYFAQ";
+    /**
+     * EVM facilitator address
+     * Used for: Submitting EIP-3009 transferWithAuthorization transactions
+     * Note: Same address across all EVM chains
+     */
+    readonly evm: "0x7c5F3AdB0C7775968Bc7e7cF61b27fECf2e2b500";
+    /**
+     * Stellar facilitator address
+     * Used for: Signing soroban authorization entries
+     */
+    readonly stellar: "GDUTDNV53WQPOB2JUZPO6SXH4LVT7CJSLCMLFQ7W4CNAXGIX7XYMCNP2";
+    /**
+     * NEAR facilitator address
+     * Used for: Relaying meta-transactions
+     */
+    readonly near: "uvd-facilitator.near";
+};
+/**
+ * Get the facilitator address for a specific chain
+ *
+ * @param chainName - The chain name (e.g., 'algorand', 'solana', 'base')
+ * @param networkType - The network type (e.g., 'evm', 'svm', 'algorand')
+ * @returns The facilitator address for that chain, or undefined if not supported
+ */
+declare function getFacilitatorAddress(chainName: string, networkType?: string): string | undefined;
+/**
+ * Type for facilitator addresses
+ */
+type FacilitatorAddresses = typeof FACILITATOR_ADDRESSES;
+
+export { FACILITATOR_ADDRESSES, type FacilitatorAddresses, getFacilitatorAddress };

package/dist/index.js

@@ -1530,12 +1530,70 @@ var X402Client = class {
   }
 };
 
+// src/facilitator.ts
+var FACILITATOR_ADDRESSES = {
+  /**
+   * Solana facilitator address (fee payer)
+   * Used for: Paying transaction fees on Solana
+   */
+  solana: "F742C4VfFLQ9zRQyithoj5229ZgtX2WqKCSFKgH2EThq",
+  /**
+   * Algorand facilitator address (fee payer)
+   * Used for: Signing Transaction 0 (fee tx) in atomic groups
+   * Note: This is derived from the facilitator's Algorand mnemonic
+   */
+  algorand: "SXHRBXS22SKKXHXK44DTQMWN2SXK3SFJWBDAQZGF4DRPW7PNFAUM2GYFAQ",
+  /**
+   * Algorand testnet facilitator address
+   */
+  "algorand-testnet": "SXHRBXS22SKKXHXK44DTQMWN2SXK3SFJWBDAQZGF4DRPW7PNFAUM2GYFAQ",
+  /**
+   * EVM facilitator address
+   * Used for: Submitting EIP-3009 transferWithAuthorization transactions
+   * Note: Same address across all EVM chains
+   */
+  evm: "0x7c5F3AdB0C7775968Bc7e7cF61b27fECf2e2b500",
+  /**
+   * Stellar facilitator address
+   * Used for: Signing soroban authorization entries
+   */
+  stellar: "GDUTDNV53WQPOB2JUZPO6SXH4LVT7CJSLCMLFQ7W4CNAXGIX7XYMCNP2",
+  /**
+   * NEAR facilitator address
+   * Used for: Relaying meta-transactions
+   */
+  near: "uvd-facilitator.near"
+};
+function getFacilitatorAddress(chainName, networkType) {
+  const exactMatch = FACILITATOR_ADDRESSES[chainName];
+  if (exactMatch) {
+    return exactMatch;
+  }
+  if (networkType === "evm") {
+    return FACILITATOR_ADDRESSES.evm;
+  }
+  if (networkType === "svm" || networkType === "solana") {
+    return FACILITATOR_ADDRESSES.solana;
+  }
+  if (networkType === "algorand") {
+    return FACILITATOR_ADDRESSES.algorand;
+  }
+  if (networkType === "stellar") {
+    return FACILITATOR_ADDRESSES.stellar;
+  }
+  if (networkType === "near") {
+    return FACILITATOR_ADDRESSES.near;
+  }
+  return void 0;
+}
+
 exports.CAIP2_IDENTIFIERS = CAIP2_IDENTIFIERS;
 exports.CAIP2_TO_CHAIN = CAIP2_TO_CHAIN;
 exports.DEFAULT_CHAIN = DEFAULT_CHAIN;
 exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
 exports.DEFAULT_FACILITATOR_URL = DEFAULT_FACILITATOR_URL;
 exports.DEFAULT_PAYMENT_HEADER = DEFAULT_PAYMENT_HEADER;
+exports.FACILITATOR_ADDRESSES = FACILITATOR_ADDRESSES;
 exports.PAYMENT_HEADER_NAMES = PAYMENT_HEADER_NAMES;
 exports.SUPPORTED_CHAINS = SUPPORTED_CHAINS;
 exports.X402Client = X402Client;
@@ -1560,6 +1618,7 @@ exports.getEVMChainIds = getEVMChainIds;
 exports.getEnabledChains = getEnabledChains;
 exports.getExplorerAddressUrl = getExplorerAddressUrl;
 exports.getExplorerTxUrl = getExplorerTxUrl;
+exports.getFacilitatorAddress = getFacilitatorAddress;
 exports.getNetworkType = getNetworkType;
 exports.getPaymentHeader = getPaymentHeader;
 exports.getSVMChains = getSVMChains;