@t402/evm 2.1.0 → 2.3.0

package/dist/esm/index.mjs

@@ -1,28 +1,34 @@
+import {
+  UptoEvmFacilitatorScheme,
+  UptoEvmServerScheme,
+  createUptoEvmFacilitatorScheme,
+  createUptoEvmServerScheme
+} from "./chunk-SJ52GTJJ.mjs";
 import {
   ExactEvmScheme
-} from "./chunk-LGSG73NJ.mjs";
+} from "./chunk-LM5RZBVP.mjs";
 import {
-  TOKEN_PRIORITY,
   TOKEN_REGISTRY,
-  USDC_ADDRESSES,
-  USDT0_ADDRESSES,
   USDT_LEGACY_ADDRESSES,
-  getDefaultToken,
-  getEIP712Domain,
-  getNetworkTokens,
-  getNetworksForToken,
-  getTokenByAddress,
-  getTokenConfig,
-  getUsdt0Networks,
-  supportsEIP3009
-} from "./chunk-OEXW2OK2.mjs";
+  getTokenConfig
+} from "./chunk-IWSDEZKI.mjs";
 import {
-  authorizationTypes,
-  createNonce,
-  eip3009ABI,
   erc20LegacyABI,
   legacyAuthorizationTypes
-} from "./chunk-XYKAO6KJ.mjs";
+} from "./chunk-Y4U7Q543.mjs";
+import {
+  UptoEvmScheme,
+  createUptoEvmScheme
+} from "./chunk-SURTCHSX.mjs";
+import {
+  createNonce
+} from "./chunk-SYVPLXYV.mjs";
+import {
+  __publicField
+} from "./chunk-NSSMTXJJ.mjs";
+
+// src/index.ts
+export * from "@t402/evm-core";
 
 // src/exact-legacy/client/scheme.ts
 import { getAddress } from "viem";
@@ -34,7 +40,7 @@ var ExactLegacyEvmScheme = class {
    */
   constructor(signer) {
     this.signer = signer;
-    this.scheme = "exact-legacy";
+    __publicField(this, "scheme", "exact-legacy");
   }
   /**
    * Creates a payment payload for the exact-legacy scheme.
@@ -109,13 +115,39 @@ var ExactLegacyEvmScheme = class {
 
 // src/exact-legacy/server/scheme.ts
 var ExactLegacyEvmScheme2 = class {
+  /**
+   * Creates a new ExactLegacyEvmScheme instance.
+   *
+   * @param config - Optional configuration options for the scheme
+   */
   constructor(config = {}) {
-    this.scheme = "exact-legacy";
-    this.moneyParsers = [];
+    __publicField(this, "scheme", "exact-legacy");
+    __publicField(this, "moneyParsers", []);
+    __publicField(this, "config");
     this.config = config;
   }
+  /**
+   * Get all supported networks that have legacy tokens
+   *
+   * @returns Array of network identifiers with legacy token support
+   */
+  static getSupportedNetworks() {
+    return Object.keys(USDT_LEGACY_ADDRESSES);
+  }
+  /**
+   * Check if a network has legacy token support
+   *
+   * @param network - The network identifier to check
+   * @returns True if the network has legacy token support
+   */
+  static isNetworkSupported(network) {
+    return network in USDT_LEGACY_ADDRESSES;
+  }
   /**
    * Register a custom money parser in the parser chain.
+   *
+   * @param parser - Custom function to convert amount to AssetAmount
+   * @returns The scheme instance for method chaining
    */
   registerMoneyParser(parser) {
     this.moneyParsers.push(parser);
@@ -123,6 +155,10 @@ var ExactLegacyEvmScheme2 = class {
   }
   /**
    * Parses a price into an asset amount for legacy tokens.
+   *
+   * @param price - The price to parse (Money or AssetAmount)
+   * @param network - The network identifier in CAIP-2 format
+   * @returns Promise resolving to the parsed asset amount
    */
   async parsePrice(price, network) {
     if (typeof price === "object" && price !== null && "amount" in price) {
@@ -150,6 +186,15 @@ var ExactLegacyEvmScheme2 = class {
   /**
    * Build payment requirements for this scheme/network combination.
    * Adds the spender (facilitator) address to the extra field.
+   *
+   * @param paymentRequirements - The base payment requirements to enhance
+   * @param supportedKind - The supported kind from facilitator
+   * @param supportedKind.t402Version - The t402 protocol version
+   * @param supportedKind.scheme - The logical payment scheme identifier
+   * @param supportedKind.network - The network identifier in CAIP-2 format
+   * @param supportedKind.extra - Optional extra metadata with spender address
+   * @param extensionKeys - Extension keys supported by the facilitator (unused)
+   * @returns Promise resolving to enhanced payment requirements
    */
   enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
     void extensionKeys;
@@ -165,6 +210,9 @@ var ExactLegacyEvmScheme2 = class {
   }
   /**
    * Parse Money (string | number) to a decimal number.
+   *
+   * @param money - The money value to parse (e.g., "$1.50" or 1.50)
+   * @returns The decimal number representation
    */
   parseMoneyToDecimal(money) {
     if (typeof money === "number") {
@@ -179,6 +227,10 @@ var ExactLegacyEvmScheme2 = class {
   }
   /**
    * Default money conversion implementation for legacy tokens.
+   *
+   * @param amount - The decimal amount to convert (e.g., 1.50)
+   * @param network - The network identifier in CAIP-2 format
+   * @returns The asset amount in token units
    */
   defaultMoneyConversion(amount, network) {
     const token = this.getDefaultAsset(network);
@@ -196,6 +248,10 @@ var ExactLegacyEvmScheme2 = class {
   }
   /**
    * Convert decimal amount to token units
+   *
+   * @param decimalAmount - The decimal amount as a string (e.g., "1.50")
+   * @param decimals - The number of decimal places for the token
+   * @returns The token amount as a string in smallest units
    */
   convertToTokenAmount(decimalAmount, decimals) {
     const amount = parseFloat(decimalAmount);
@@ -207,6 +263,9 @@ var ExactLegacyEvmScheme2 = class {
   }
   /**
    * Get the default legacy token for a network.
+   *
+   * @param network - The network identifier in CAIP-2 format
+   * @returns The token configuration for the default legacy token
    */
   getDefaultAsset(network) {
     if (this.config.preferredToken) {
@@ -226,18 +285,6 @@ var ExactLegacyEvmScheme2 = class {
     }
     throw new Error(`No legacy tokens configured for network ${network}`);
   }
-  /**
-   * Get all supported networks that have legacy tokens
-   */
-  static getSupportedNetworks() {
-    return Object.keys(USDT_LEGACY_ADDRESSES);
-  }
-  /**
-   * Check if a network has legacy token support
-   */
-  static isNetworkSupported(network) {
-    return network in USDT_LEGACY_ADDRESSES;
-  }
 };
 
 // src/exact-legacy/facilitator/scheme.ts
@@ -251,8 +298,9 @@ var ExactLegacyEvmScheme3 = class {
    */
   constructor(signer, config) {
     this.signer = signer;
-    this.scheme = "exact-legacy";
-    this.caipFamily = "eip155:*";
+    __publicField(this, "scheme", "exact-legacy");
+    __publicField(this, "caipFamily", "eip155:*");
+    __publicField(this, "config");
     this.config = {
       minAllowanceRatio: config?.minAllowanceRatio ?? 1
     };
@@ -277,6 +325,9 @@ var ExactLegacyEvmScheme3 = class {
   }
   /**
    * Get signer addresses used by this facilitator.
+   *
+   * @param network - The network identifier (unused, returns same addresses for all networks)
+   * @returns Array of signer addresses
    */
   getSigners(network) {
     void network;
@@ -284,6 +335,10 @@ var ExactLegacyEvmScheme3 = class {
   }
   /**
    * Verifies a payment payload.
+   *
+   * @param payload - The payment payload to verify
+   * @param requirements - The payment requirements to verify against
+   * @returns Promise resolving to verification response with validity status
    */
   async verify(payload, requirements) {
     const legacyPayload = payload.payload;
@@ -430,6 +485,10 @@ var ExactLegacyEvmScheme3 = class {
   }
   /**
    * Settles a payment by executing transferFrom.
+   *
+   * @param payload - The payment payload containing transfer authorization
+   * @param requirements - The payment requirements specifying amount and recipient
+   * @returns Promise resolving to settlement response with transaction hash
    */
   async settle(payload, requirements) {
     const legacyPayload = payload.payload;
@@ -483,16 +542,8 @@ var ExactLegacyEvmScheme3 = class {
   }
 };
 
-// src/signer.ts
-function toClientEvmSigner(signer) {
-  return signer;
-}
-function toFacilitatorEvmSigner(client) {
-  return {
-    ...client,
-    getAddresses: () => [client.address]
-  };
-}
+// src/bridge/client.ts
+import { keccak256, toBytes } from "viem";
 
 // src/bridge/constants.ts
 var LAYERZERO_ENDPOINT_IDS = {
@@ -666,9 +717,7 @@ function supportsBridging(chain) {
   return chain in USDT0_OFT_ADDRESSES && chain in LAYERZERO_ENDPOINT_IDS;
 }
 function getBridgeableChains() {
-  return Object.keys(USDT0_OFT_ADDRESSES).filter(
-    (chain) => chain in LAYERZERO_ENDPOINT_IDS
-  );
+  return Object.keys(USDT0_OFT_ADDRESSES).filter((chain) => chain in LAYERZERO_ENDPOINT_IDS);
 }
 function addressToBytes32(address) {
   const cleanAddress = address.slice(2).toLowerCase();
@@ -679,6 +728,7 @@ function bytes32ToAddress(bytes32) {
 }
 
 // src/bridge/client.ts
+var OFT_SENT_EVENT_TOPIC = keccak256(toBytes("OFTSent(bytes32,uint32,address,uint256,uint256)"));
 var DEFAULT_SLIPPAGE = 0.5;
 var ESTIMATED_BRIDGE_TIME = 300;
 var Usdt0Bridge = class {
@@ -689,6 +739,8 @@ var Usdt0Bridge = class {
    * @param chain - Source chain name (e.g., "arbitrum", "ethereum")
    */
   constructor(signer, chain) {
+    __publicField(this, "signer");
+    __publicField(this, "chain");
     if (!supportsBridging(chain)) {
       throw new Error(
         `Chain "${chain}" does not support USDT0 bridging. Supported chains: ${getBridgeableChains().join(", ")}`
@@ -751,10 +803,10 @@ var Usdt0Bridge = class {
     if (receipt.status !== "success") {
       throw new Error(`Bridge transaction failed: ${txHash}`);
     }
+    const messageGuid = this.extractMessageGuid(receipt);
     return {
       txHash,
-      messageGuid: "0x" + "0".repeat(64),
-      // Would be extracted from event logs
+      messageGuid,
       amountSent: params.amount,
       amountToReceive: sendParam.minAmountLD,
       fromChain: params.fromChain,
@@ -762,8 +814,44 @@ var Usdt0Bridge = class {
       estimatedTime: ESTIMATED_BRIDGE_TIME
     };
   }
+  /**
+   * Get all supported destination chains from current chain
+   *
+   * @returns Array of supported destination chain names
+   */
+  getSupportedDestinations() {
+    return getBridgeableChains().filter((chain) => chain !== this.chain);
+  }
+  /**
+   * Check if a destination chain is supported
+   *
+   * @param toChain - The destination chain to check
+   * @returns True if the destination chain is supported
+   */
+  supportsDestination(toChain) {
+    return toChain !== this.chain && supportsBridging(toChain);
+  }
+  /**
+   * Extract LayerZero message GUID from OFTSent event logs
+   *
+   * @param receipt - Transaction receipt with logs
+   * @returns Message GUID as hex string
+   */
+  extractMessageGuid(receipt) {
+    for (const log of receipt.logs) {
+      if (log.topics[0] === OFT_SENT_EVENT_TOPIC && log.topics[1]) {
+        return log.topics[1];
+      }
+    }
+    throw new Error(
+      "Failed to extract message GUID from transaction logs. The OFTSent event was not found in the transaction receipt."
+    );
+  }
   /**
    * Ensure sufficient token allowance for the OFT contract
+   *
+   * @param oftAddress - The OFT contract address
+   * @param amount - The amount to approve
    */
   async ensureAllowance(oftAddress, amount) {
     const allowance = await this.signer.readContract({
@@ -784,6 +872,9 @@ var Usdt0Bridge = class {
   }
   /**
    * Build SendParam struct for LayerZero
+   *
+   * @param params - Bridge parameters
+   * @returns SendParam struct for the OFT contract
    */
   buildSendParam(params) {
     const dstEid = getEndpointId(params.toChain);
@@ -804,6 +895,8 @@ var Usdt0Bridge = class {
   }
   /**
    * Validate bridge parameters
+   *
+   * @param params - Bridge parameters to validate
    */
   validateBridgeParams(params) {
     if (params.fromChain !== this.chain) {
@@ -824,21 +917,301 @@ var Usdt0Bridge = class {
       throw new Error("Amount must be greater than 0");
     }
   }
+};
+function createUsdt0Bridge(signer, chain) {
+  return new Usdt0Bridge(signer, chain);
+}
+
+// src/bridge/scan.ts
+var LAYERZERO_SCAN_BASE_URL = "https://scan.layerzero-api.com/v1";
+var DEFAULT_TIMEOUT = 6e5;
+var DEFAULT_POLL_INTERVAL = 1e4;
+var LayerZeroScanClient = class {
   /**
-   * Get all supported destination chains from current chain
+   * Create a new LayerZero Scan client
+   *
+   * @param baseUrl - API base URL (default: production endpoint)
+   */
+  constructor(baseUrl = LAYERZERO_SCAN_BASE_URL) {
+    __publicField(this, "baseUrl");
+    this.baseUrl = baseUrl;
+  }
+  /**
+   * Get message by GUID
+   *
+   * @param guid - LayerZero message GUID
+   * @returns Message details including status
+   * @throws Error if message not found or API error
+   */
+  async getMessage(guid) {
+    const url = `${this.baseUrl}/messages/guid/${guid}`;
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        Accept: "application/json"
+      }
+    });
+    if (!response.ok) {
+      if (response.status === 404) {
+        throw new Error(`Message not found: ${guid}`);
+      }
+      throw new Error(`LayerZero Scan API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return this.mapApiResponse(data);
+  }
+  /**
+   * Get messages by wallet address
+   *
+   * @param address - Wallet address that initiated messages
+   * @param limit - Maximum number of messages to return (default: 20)
+   * @returns Array of messages
+   */
+  async getMessagesByWallet(address, limit = 20) {
+    const url = `${this.baseUrl}/messages/wallet/${address}?limit=${limit}`;
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        Accept: "application/json"
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`LayerZero Scan API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    const messages = data.messages ?? data.data ?? [];
+    return messages.map((msg) => this.mapApiResponse(msg));
+  }
+  /**
+   * Poll message status until delivered or failed
+   *
+   * @param guid - LayerZero message GUID
+   * @param options - Wait configuration options
+   * @returns Final message state (DELIVERED)
+   * @throws Error if message fails, is blocked, or times out
+   */
+  async waitForDelivery(guid, options = {}) {
+    const {
+      timeout = DEFAULT_TIMEOUT,
+      pollInterval = DEFAULT_POLL_INTERVAL,
+      onStatusChange
+    } = options;
+    const startTime = Date.now();
+    let lastStatus = null;
+    while (Date.now() - startTime < timeout) {
+      try {
+        const message = await this.getMessage(guid);
+        if (lastStatus !== message.status) {
+          lastStatus = message.status;
+          onStatusChange?.(message.status);
+        }
+        if (message.status === "DELIVERED") {
+          return message;
+        }
+        if (message.status === "FAILED") {
+          throw new Error(`Bridge message failed: ${guid}`);
+        }
+        if (message.status === "BLOCKED") {
+          throw new Error(`Bridge message blocked by DVN: ${guid}`);
+        }
+        await this.sleep(pollInterval);
+      } catch (error) {
+        if (error.message.includes("not found")) {
+          await this.sleep(pollInterval);
+          continue;
+        }
+        throw error;
+      }
+    }
+    throw new Error(`Timeout waiting for message delivery: ${guid}`);
+  }
+  /**
+   * Check if a message has been delivered
+   *
+   * @param guid - LayerZero message GUID
+   * @returns True if delivered, false otherwise
+   */
+  async isDelivered(guid) {
+    try {
+      const message = await this.getMessage(guid);
+      return message.status === "DELIVERED";
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Map API response to our interface
+   *
+   * @param data - The raw API response data
+   * @returns The mapped LayerZeroMessage object
+   */
+  mapApiResponse(data) {
+    const msg = data;
+    return {
+      guid: msg.guid ?? msg.messageGuid ?? "",
+      srcEid: msg.srcEid ?? msg.srcChainId ?? 0,
+      dstEid: msg.dstEid ?? msg.dstChainId ?? 0,
+      srcUaAddress: msg.srcUaAddress ?? msg.srcAddress ?? "",
+      dstUaAddress: msg.dstUaAddress ?? msg.dstAddress ?? "",
+      srcTxHash: msg.srcTxHash ?? "",
+      dstTxHash: msg.dstTxHash ?? void 0,
+      status: msg.status ?? "INFLIGHT",
+      srcBlockNumber: msg.srcBlockNumber ?? 0,
+      dstBlockNumber: msg.dstBlockNumber ?? void 0,
+      created: msg.created ?? msg.createdAt ?? "",
+      updated: msg.updated ?? msg.updatedAt ?? ""
+    };
+  }
+  /**
+   * Sleep helper
+   *
+   * @param ms - The number of milliseconds to sleep
+   * @returns A promise that resolves after the specified delay
+   */
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+function createLayerZeroScanClient(baseUrl) {
+  return new LayerZeroScanClient(baseUrl);
+}
+
+// src/bridge/router.ts
+var CrossChainPaymentRouter = class {
+  /**
+   * Create a cross-chain payment router
+   *
+   * @param signer - Wallet signer for bridge operations
+   * @param sourceChain - Chain where user's funds are located
+   */
+  constructor(signer, sourceChain) {
+    __publicField(this, "bridge");
+    __publicField(this, "scanClient");
+    __publicField(this, "sourceChain");
+    this.bridge = new Usdt0Bridge(signer, sourceChain);
+    this.scanClient = new LayerZeroScanClient();
+    this.sourceChain = sourceChain;
+  }
+  /**
+   * Get all bridgeable chains
+   *
+   * @returns Array of all chain names that support USDT0 bridging
+   */
+  static getBridgeableChains() {
+    return getBridgeableChains();
+  }
+  /**
+   * Route payment across chains
+   *
+   * This method:
+   * 1. Bridges USDT0 from source chain to destination chain
+   * 2. Sends funds to the payer's address on destination chain
+   * 3. Returns tracking info for monitoring delivery
+   *
+   * After delivery, the payer can use the bridged funds to pay on the destination chain.
+   *
+   * @param params - Payment routing parameters
+   * @returns Result with transaction hash and tracking info
+   */
+  async routePayment(params) {
+    this.validateParams(params);
+    const result = await this.bridge.send({
+      fromChain: params.sourceChain,
+      toChain: params.destinationChain,
+      amount: params.amount,
+      recipient: params.payer,
+      slippageTolerance: params.slippageTolerance
+    });
+    return {
+      bridgeTxHash: result.txHash,
+      messageGuid: result.messageGuid,
+      amountBridged: result.amountSent,
+      estimatedReceiveAmount: result.amountToReceive,
+      sourceChain: params.sourceChain,
+      destinationChain: params.destinationChain,
+      estimatedDeliveryTime: result.estimatedTime
+    };
+  }
+  /**
+   * Get estimated fees for routing a payment
+   *
+   * @param params - Payment parameters
+   * @returns Quote with native fee and estimated receive amount
+   */
+  async estimateFees(params) {
+    const quote = await this.bridge.quote({
+      fromChain: params.sourceChain,
+      toChain: params.destinationChain,
+      amount: params.amount,
+      recipient: params.payer
+    });
+    return {
+      nativeFee: quote.nativeFee,
+      estimatedReceiveAmount: quote.minAmountToReceive,
+      estimatedTime: quote.estimatedTime
+    };
+  }
+  /**
+   * Track message delivery status
+   *
+   * @param messageGuid - LayerZero message GUID from routePayment result
+   * @returns Current message status
+   */
+  async trackMessage(messageGuid) {
+    return this.scanClient.getMessage(messageGuid);
+  }
+  /**
+   * Wait for payment to be delivered on destination chain
+   *
+   * @param messageGuid - LayerZero message GUID from routePayment result
+   * @param options - Wait options (timeout, poll interval, callbacks)
+   * @returns Final message state when delivered
+   */
+  async waitForDelivery(messageGuid, options) {
+    return this.scanClient.waitForDelivery(messageGuid, options);
+  }
+  /**
+   * Check if routing between two chains is supported
+   *
+   * @param sourceChain - Source chain name
+   * @param destinationChain - Destination chain name
+   * @returns True if routing is supported
+   */
+  canRoute(sourceChain, destinationChain) {
+    return sourceChain !== destinationChain && supportsBridging(sourceChain) && supportsBridging(destinationChain);
+  }
+  /**
+   * Get all supported destination chains from source chain
+   *
+   * @returns Array of chain names that can receive bridged funds
    */
   getSupportedDestinations() {
-    return getBridgeableChains().filter((chain) => chain !== this.chain);
+    return this.bridge.getSupportedDestinations();
   }
   /**
-   * Check if a destination chain is supported
+   * Validate routing parameters
+   *
+   * @param params - The cross-chain payment parameters to validate
+   * @throws Error if parameters are invalid or routing is not supported
    */
-  supportsDestination(toChain) {
-    return toChain !== this.chain && supportsBridging(toChain);
+  validateParams(params) {
+    if (params.sourceChain !== this.sourceChain) {
+      throw new Error(
+        `Source chain mismatch: router initialized for "${this.sourceChain}" but got "${params.sourceChain}"`
+      );
+    }
+    if (!this.canRoute(params.sourceChain, params.destinationChain)) {
+      throw new Error(
+        `Cannot route payment from "${params.sourceChain}" to "${params.destinationChain}". Supported chains: ${getBridgeableChains().join(", ")}`
+      );
+    }
+    if (params.amount <= 0n) {
+      throw new Error("Amount must be greater than 0");
+    }
   }
 };
-function createUsdt0Bridge(signer, chain) {
-  return new Usdt0Bridge(signer, chain);
+function createCrossChainPaymentRouter(signer, sourceChain) {
+  return new CrossChainPaymentRouter(signer, sourceChain);
 }
 
 // src/erc4337/constants.ts
@@ -1018,23 +1391,33 @@ function unpackGasFees(packed) {
 // src/erc4337/builder.ts
 import { concat, pad, toHex } from "viem";
 var UserOpBuilder = class {
+  /**
+   * Create a new UserOpBuilder instance
+   *
+   * @param options - Optional configuration for the builder
+   */
   constructor(options = {}) {
+    __publicField(this, "entryPoint");
+    __publicField(this, "gasMultiplier");
     this.entryPoint = options.entryPoint ?? ENTRYPOINT_V07_ADDRESS;
     this.gasMultiplier = options.gasMultiplier ?? 1.2;
   }
   /**
    * Build a UserOperation from a transaction intent
+   *
+   * @param signer - The smart account signer
+   * @param intent - The transaction intent to execute
+   * @param client - The public client for chain interaction
+   * @param gasEstimate - Optional gas estimates (uses defaults if not provided)
+   * @param paymaster - Optional paymaster data for sponsored transactions
+   * @returns A UserOperation ready for signing
    */
   async buildUserOp(signer, intent, client, gasEstimate, paymaster) {
     const sender = await signer.getAddress();
     const nonce = await this.getNonce(client, sender);
     const isDeployed = await signer.isDeployed();
     const initCode = isDeployed ? "0x" : await signer.getInitCode();
-    const callData = signer.encodeExecute(
-      intent.to,
-      intent.value ?? 0n,
-      intent.data ?? "0x"
-    );
+    const callData = signer.encodeExecute(intent.to, intent.value ?? 0n, intent.data ?? "0x");
     const { maxFeePerGas, maxPriorityFeePerGas } = await this.getGasPrices(client);
     const gas = gasEstimate ?? DEFAULT_GAS_LIMITS;
     const verificationGasLimit = this.applyMultiplier(gas.verificationGasLimit);
@@ -1058,6 +1441,13 @@ var UserOpBuilder = class {
   }
   /**
    * Build a batch UserOperation from multiple transaction intents
+   *
+   * @param signer - The smart account signer
+   * @param intents - Array of transaction intents to execute
+   * @param client - The public client for chain interaction
+   * @param gasEstimate - Optional gas estimates (uses defaults if not provided)
+   * @param paymaster - Optional paymaster data for sponsored transactions
+   * @returns A UserOperation ready for signing
    */
   async buildBatchUserOp(signer, intents, client, gasEstimate, paymaster) {
     const sender = await signer.getAddress();
@@ -1094,6 +1484,9 @@ var UserOpBuilder = class {
   }
   /**
    * Pack a UserOperation for on-chain submission (v0.7 format)
+   *
+   * @param userOp - The UserOperation to pack
+   * @returns The packed UserOperation for on-chain submission
    */
   packUserOp(userOp) {
     return {
@@ -1101,10 +1494,7 @@ var UserOpBuilder = class {
       nonce: userOp.nonce,
       initCode: userOp.initCode,
       callData: userOp.callData,
-      accountGasLimits: packAccountGasLimits(
-        userOp.verificationGasLimit,
-        userOp.callGasLimit
-      ),
+      accountGasLimits: packAccountGasLimits(userOp.verificationGasLimit, userOp.callGasLimit),
       preVerificationGas: userOp.preVerificationGas,
       gasFees: packGasFees(userOp.maxPriorityFeePerGas, userOp.maxFeePerGas),
       paymasterAndData: userOp.paymasterAndData,
@@ -1113,8 +1503,13 @@ var UserOpBuilder = class {
   }
   /**
    * Compute the UserOperation hash for signing
+   *
+   * @param userOp - The UserOperation to hash
+   * @param client - The public client for chain interaction
+   * @param _ - The chain ID (reserved for future use)
+   * @returns The UserOperation hash
    */
-  async getUserOpHash(userOp, client, chainId) {
+  async getUserOpHash(userOp, client, _) {
     const packed = this.packUserOp(userOp);
     const userOpTuple = {
       sender: packed.sender,
@@ -1137,6 +1532,12 @@ var UserOpBuilder = class {
   }
   /**
    * Sign a UserOperation
+   *
+   * @param userOp - The UserOperation to sign
+   * @param signer - The smart account signer
+   * @param client - The public client for chain interaction
+   * @param chainId - The chain ID for the signature
+   * @returns The UserOperation with signature attached
    */
   async signUserOp(userOp, signer, client, chainId) {
     const userOpHash = await this.getUserOpHash(userOp, client, chainId);
@@ -1148,6 +1549,10 @@ var UserOpBuilder = class {
   }
   /**
    * Get the nonce for an account from EntryPoint
+   *
+   * @param client - The public client for chain interaction
+   * @param sender - The smart account address
+   * @returns The current nonce for the account
    */
   async getNonce(client, sender) {
     try {
@@ -1165,6 +1570,9 @@ var UserOpBuilder = class {
   }
   /**
    * Get current gas prices from the chain
+   *
+   * @param client - The public client for chain interaction
+   * @returns The current gas prices for EIP-1559 transactions
    */
   async getGasPrices(client) {
     const block = await client.getBlock({ blockTag: "latest" });
@@ -1175,12 +1583,18 @@ var UserOpBuilder = class {
   }
   /**
    * Apply gas multiplier for safety margin
+   *
+   * @param gas - The gas amount to multiply
+   * @returns The gas amount with safety margin applied
    */
   applyMultiplier(gas) {
     return BigInt(Math.ceil(Number(gas) * this.gasMultiplier));
   }
   /**
    * Encode paymaster data for the UserOperation
+   *
+   * @param paymaster - The paymaster configuration
+   * @returns The encoded paymaster data
    */
   encodePaymasterData(paymaster) {
     const paymasterAddress = paymaster.paymaster;
@@ -1188,12 +1602,7 @@ var UserOpBuilder = class {
       size: 16
     });
     const postOpGas = pad(toHex(paymaster.paymasterPostOpGasLimit), { size: 16 });
-    return concat([
-      paymasterAddress,
-      verificationGas,
-      postOpGas,
-      paymaster.paymasterData
-    ]);
+    return concat([paymasterAddress, verificationGas, postOpGas, paymaster.paymasterData]);
   }
 };
 function createUserOpBuilder(options) {
@@ -1202,6 +1611,13 @@ function createUserOpBuilder(options) {
 
 // src/erc4337/bundler.ts
 var BundlerError = class extends Error {
+  /**
+   * Create a new BundlerError
+   *
+   * @param message - The error message
+   * @param code - Optional JSON-RPC error code
+   * @param data - Optional additional error data
+   */
   constructor(message, code, data) {
     super(message);
     this.code = code;
@@ -1210,21 +1626,31 @@ var BundlerError = class extends Error {
   }
 };
 var BundlerClient = class {
+  /**
+   * Create a new BundlerClient instance
+   *
+   * @param config - Configuration for the bundler client
+   */
   constructor(config) {
-    this.requestId = 0;
+    __publicField(this, "bundlerUrl");
+    __publicField(this, "entryPoint");
+    __publicField(this, "requestId", 0);
     this.bundlerUrl = config.bundlerUrl;
     this.entryPoint = config.entryPoint ?? ENTRYPOINT_V07_ADDRESS;
-    this.chainId = config.chainId;
+    void config.chainId;
   }
   /**
    * Send a UserOperation to the bundler
+   *
+   * @param userOp - The UserOperation to send
+   * @returns The result containing the userOpHash and a wait function
    */
   async sendUserOperation(userOp) {
     const packed = this.packForRpc(userOp);
-    const userOpHash = await this.rpcCall(
-      BUNDLER_METHODS.sendUserOperation,
-      [packed, this.entryPoint]
-    );
+    const userOpHash = await this.rpcCall(BUNDLER_METHODS.sendUserOperation, [
+      packed,
+      this.entryPoint
+    ]);
     return {
       userOpHash,
       wait: () => this.waitForReceipt(userOpHash)
@@ -1232,6 +1658,9 @@ var BundlerClient = class {
   }
   /**
    * Estimate gas for a UserOperation
+   *
+   * @param userOp - Partial UserOperation with required sender and callData
+   * @returns Gas estimates for the UserOperation
    */
   async estimateUserOperationGas(userOp) {
     const estimationOp = {
@@ -1260,6 +1689,9 @@ var BundlerClient = class {
   }
   /**
    * Get UserOperation by hash
+   *
+   * @param userOpHash - The hash of the UserOperation to retrieve
+   * @returns The UserOperation and EntryPoint, or null if not found
    */
   async getUserOperationByHash(userOpHash) {
     const result = await this.rpcCall(BUNDLER_METHODS.getUserOperationByHash, [userOpHash]);
@@ -1267,6 +1699,9 @@ var BundlerClient = class {
   }
   /**
    * Get UserOperation receipt
+   *
+   * @param userOpHash - The hash of the UserOperation
+   * @returns The receipt, or null if not yet included
    */
   async getUserOperationReceipt(userOpHash) {
     const result = await this.rpcCall(BUNDLER_METHODS.getUserOperationReceipt, [userOpHash]);
@@ -1289,12 +1724,16 @@ var BundlerClient = class {
   }
   /**
    * Get supported EntryPoints
+   *
+   * @returns Array of supported EntryPoint addresses
    */
   async getSupportedEntryPoints() {
     return this.rpcCall(BUNDLER_METHODS.supportedEntryPoints, []);
   }
   /**
    * Get chain ID from bundler
+   *
+   * @returns The chain ID
    */
   async getChainId() {
     const result = await this.rpcCall(BUNDLER_METHODS.chainId, []);
@@ -1302,6 +1741,12 @@ var BundlerClient = class {
   }
   /**
    * Wait for UserOperation receipt with polling
+   *
+   * @param userOpHash - The hash of the UserOperation to wait for
+   * @param options - Polling options
+   * @param options.timeout - Maximum time to wait in milliseconds (default: 60000)
+   * @param options.pollingInterval - Interval between polls in milliseconds (default: 2000)
+   * @returns The UserOperation receipt
    */
   async waitForReceipt(userOpHash, options = {}) {
     const timeout = options.timeout ?? 6e4;
@@ -1314,12 +1759,13 @@ var BundlerClient = class {
       }
       await new Promise((resolve) => setTimeout(resolve, pollingInterval));
     }
-    throw new BundlerError(
-      `Timeout waiting for UserOperation receipt: ${userOpHash}`
-    );
+    throw new BundlerError(`Timeout waiting for UserOperation receipt: ${userOpHash}`);
   }
   /**
    * Pack UserOperation for RPC (convert bigints to hex strings)
+   *
+   * @param userOp - The UserOperation to pack
+   * @returns The packed UserOperation for RPC transmission
    */
   packForRpc(userOp) {
     return {
@@ -1327,10 +1773,7 @@ var BundlerClient = class {
       nonce: this.toHex(userOp.nonce),
       initCode: userOp.initCode,
       callData: userOp.callData,
-      accountGasLimits: packAccountGasLimits(
-        userOp.verificationGasLimit,
-        userOp.callGasLimit
-      ),
+      accountGasLimits: packAccountGasLimits(userOp.verificationGasLimit, userOp.callGasLimit),
       preVerificationGas: this.toHex(userOp.preVerificationGas),
       gasFees: packGasFees(userOp.maxPriorityFeePerGas, userOp.maxFeePerGas),
       paymasterAndData: userOp.paymasterAndData,
@@ -1339,12 +1782,19 @@ var BundlerClient = class {
   }
   /**
    * Convert bigint to hex string
+   *
+   * @param value - The bigint value to convert
+   * @returns The hex string representation
    */
   toHex(value) {
     return `0x${value.toString(16)}`;
   }
   /**
    * Make a JSON-RPC call to the bundler
+   *
+   * @param method - The JSON-RPC method name
+   * @param params - The method parameters
+   * @returns The result from the bundler
    */
   async rpcCall(method, params) {
     const request = {
@@ -1361,9 +1811,7 @@ var BundlerClient = class {
       body: JSON.stringify(request)
     });
     if (!response.ok) {
-      throw new BundlerError(
-        `HTTP error: ${response.status} ${response.statusText}`
-      );
+      throw new BundlerError(`HTTP error: ${response.status} ${response.statusText}`);
     }
     const json = await response.json();
     if (json.error) {
@@ -1379,23 +1827,30 @@ function createBundlerClient(config) {
 // src/erc4337/paymaster.ts
 import { concat as concat2, pad as pad2, toHex as toHex2 } from "viem";
 var PaymasterClient = class {
+  /**
+   * Creates a new PaymasterClient instance
+   *
+   * @param config - Paymaster configuration including type, address, and optional URL
+   */
   constructor(config) {
+    __publicField(this, "config");
     this.config = config;
   }
   /**
    * Get paymaster data for a UserOperation
+   *
+   * @param userOp - Partial UserOperation to get paymaster data for
+   * @param chainId - The chain ID for the operation
+   * @param entryPoint - The EntryPoint contract address
+   * @param context - Optional context data for the paymaster
+   * @returns Paymaster data including address and gas limits
    */
   async getPaymasterData(userOp, chainId, entryPoint, context) {
     switch (this.config.type) {
       case "verifying":
         return this.getVerifyingPaymasterData(userOp, chainId, entryPoint);
       case "sponsoring":
-        return this.getSponsoringPaymasterData(
-          userOp,
-          chainId,
-          entryPoint,
-          context
-        );
+        return this.getSponsoringPaymasterData(userOp, chainId, entryPoint, context);
       case "token":
         return this.getTokenPaymasterData(userOp, chainId, entryPoint);
       default:
@@ -1404,8 +1859,12 @@ var PaymasterClient = class {
   }
   /**
    * Get gas estimates including paymaster gas
+   *
+   * @param _userOp - Partial UserOperation to estimate gas for (reserved for future use)
+   * @param _chainId - The chain ID for the operation (reserved for future use)
+   * @returns Gas estimates including paymaster verification and postOp gas
    */
-  async estimatePaymasterGas(userOp, _chainId) {
+  async estimatePaymasterGas(_userOp, _chainId) {
     return {
       verificationGasLimit: DEFAULT_GAS_LIMITS.verificationGasLimit,
       callGasLimit: DEFAULT_GAS_LIMITS.callGasLimit,
@@ -1416,6 +1875,12 @@ var PaymasterClient = class {
   }
   /**
    * Check if the paymaster will sponsor this operation
+   *
+   * @param userOp - Partial UserOperation to check sponsorship for
+   * @param chainId - The chain ID for the operation
+   * @param entryPoint - The EntryPoint contract address
+   * @param context - Optional context data for policy validation
+   * @returns True if the paymaster will sponsor the operation
    */
   async willSponsor(userOp, chainId, entryPoint, context) {
     if (!this.config.url) {
@@ -1441,6 +1906,11 @@ var PaymasterClient = class {
   }
   /**
    * Get verifying paymaster data (off-chain signature)
+   *
+   * @param userOp - Partial UserOperation to get paymaster data for
+   * @param chainId - The chain ID for the operation
+   * @param entryPoint - The EntryPoint contract address
+   * @returns Paymaster data with verification signature
    */
   async getVerifyingPaymasterData(userOp, chainId, entryPoint) {
     if (this.config.url) {
@@ -1455,6 +1925,12 @@ var PaymasterClient = class {
   }
   /**
    * Get sponsoring paymaster data (third-party pays)
+   *
+   * @param userOp - Partial UserOperation to get sponsorship for
+   * @param chainId - The chain ID for the operation
+   * @param entryPoint - The EntryPoint contract address
+   * @param context - Optional context data for sponsorship validation
+   * @returns Paymaster data for sponsored operation
    */
   async getSponsoringPaymasterData(userOp, chainId, entryPoint, context) {
     if (!this.config.url) {
@@ -1484,6 +1960,11 @@ var PaymasterClient = class {
   }
   /**
    * Get token paymaster data (pay gas with ERC20)
+   *
+   * @param userOp - Partial UserOperation to get token paymaster data for
+   * @param chainId - The chain ID for the operation
+   * @param entryPoint - The EntryPoint contract address
+   * @returns Paymaster data for ERC20 token payment
    */
   async getTokenPaymasterData(userOp, chainId, entryPoint) {
     const tokenAddress = this.config.options?.tokenAddress;
@@ -1505,6 +1986,12 @@ var PaymasterClient = class {
   }
   /**
    * Call paymaster service API
+   *
+   * @param userOp - Partial UserOperation to send to the service
+   * @param chainId - The chain ID for the operation
+   * @param entryPoint - The EntryPoint contract address
+   * @param context - Optional context data for the service
+   * @returns Paymaster data from the service response
    */
   async callPaymasterService(userOp, chainId, entryPoint, context) {
     if (!this.config.url) {
@@ -1534,12 +2021,14 @@ var PaymasterClient = class {
   }
   /**
    * Serialize UserOperation for API calls
+   *
+   * @param userOp - Partial UserOperation to serialize
+   * @returns Serialized UserOperation with hex-encoded values
    */
   serializeUserOp(userOp) {
     const result = {};
     if (userOp.sender) result.sender = userOp.sender;
-    if (userOp.nonce !== void 0)
-      result.nonce = `0x${userOp.nonce.toString(16)}`;
+    if (userOp.nonce !== void 0) result.nonce = `0x${userOp.nonce.toString(16)}`;
     if (userOp.initCode) result.initCode = userOp.initCode;
     if (userOp.callData) result.callData = userOp.callData;
     if (userOp.verificationGasLimit !== void 0)
@@ -1573,9 +2062,7 @@ function decodePaymasterAndData(paymasterAndData) {
     return null;
   }
   const paymaster = `0x${paymasterAndData.slice(2, 42)}`;
-  const paymasterVerificationGasLimit = BigInt(
-    `0x${paymasterAndData.slice(42, 74)}`
-  );
+  const paymasterVerificationGasLimit = BigInt(`0x${paymasterAndData.slice(42, 74)}`);
   const paymasterPostOpGasLimit = BigInt(`0x${paymasterAndData.slice(74, 106)}`);
   const paymasterData = `0x${paymasterAndData.slice(106)}`;
   return {
@@ -1591,8 +2078,8 @@ import { concat as concat3, pad as pad3, toHex as toHex3 } from "viem";
 
 // src/erc4337/accounts/safe.ts
 import {
-  encodeFunctionData as encodeFunctionData2,
-  encodeAbiParameters as encodeAbiParameters2,
+  encodeFunctionData,
+  encodeAbiParameters,
   concat as concat4,
   keccak256 as keccak2562,
   getContractAddress,
@@ -1600,7 +2087,7 @@ import {
 } from "viem";
 
 // src/erc4337/t402.ts
-import { encodeFunctionData as encodeFunctionData3 } from "viem";
+import { encodeFunctionData as encodeFunctionData2 } from "viem";
 var ERC20_TRANSFER_ABI = [
   {
     inputs: [
@@ -1633,7 +2120,18 @@ var EIP3009_TRANSFER_ABI = [
   }
 ];
 var GaslessT402Client = class {
+  /**
+   * Creates a new GaslessT402Client instance
+   *
+   * @param config - Configuration including signer, bundler, paymaster, and chain settings
+   */
   constructor(config) {
+    __publicField(this, "signer");
+    __publicField(this, "builder");
+    __publicField(this, "bundler");
+    __publicField(this, "paymaster");
+    __publicField(this, "chainId");
+    __publicField(this, "publicClient");
     this.signer = config.signer;
     this.builder = new UserOpBuilder();
     this.bundler = new BundlerClient(config.bundler);
@@ -1647,6 +2145,9 @@ var GaslessT402Client = class {
    * This submits the payment as a UserOperation which can be:
    * - Sponsored by a paymaster (truly gasless)
    * - Paid from the smart account's balance
+   *
+   * @param params - Payment parameters including token, recipient, and amount
+   * @returns Result containing the user operation hash and wait function
    */
   async executePayment(params) {
     const callData = params.authorization ? this.buildAuthorizedTransferCallData(params) : this.buildTransferCallData(params);
@@ -1674,6 +2175,9 @@ var GaslessT402Client = class {
   }
   /**
    * Execute multiple T402 payments in a single UserOperation
+   *
+   * @param payments - Array of payment parameters to batch together
+   * @returns Result containing the user operation hash and wait function
    */
   async executeBatchPayments(payments) {
     const intents = payments.map((params) => ({
@@ -1700,6 +2204,9 @@ var GaslessT402Client = class {
   }
   /**
    * Check if a payment can be sponsored (gasless)
+   *
+   * @param params - Payment parameters to check for sponsorship eligibility
+   * @returns True if the payment can be sponsored by the paymaster
    */
   async canSponsor(params) {
     if (!this.paymaster) return false;
@@ -1717,21 +2224,28 @@ var GaslessT402Client = class {
   }
   /**
    * Get the smart account address
+   *
+   * @returns The address of the smart account
    */
   async getAccountAddress() {
     return this.signer.getAddress();
   }
   /**
    * Check if the smart account is deployed
+   *
+   * @returns True if the smart account contract is deployed on-chain
    */
   async isAccountDeployed() {
     return this.signer.isDeployed();
   }
   /**
    * Build call data for a simple ERC20 transfer
+   *
+   * @param params - Payment parameters including recipient and amount
+   * @returns Encoded call data for ERC20 transfer function
    */
   buildTransferCallData(params) {
-    return encodeFunctionData3({
+    return encodeFunctionData2({
       abi: ERC20_TRANSFER_ABI,
       functionName: "transfer",
       args: [params.to, params.amount]
@@ -1739,6 +2253,9 @@ var GaslessT402Client = class {
   }
   /**
    * Build call data for an authorized transfer (EIP-3009)
+   *
+   * @param params - Payment parameters including authorization signature
+   * @returns Encoded call data for transferWithAuthorization function
    */
   buildAuthorizedTransferCallData(params) {
     if (!params.authorization) {
@@ -1748,7 +2265,7 @@ var GaslessT402Client = class {
     const r = `0x${sig.slice(2, 66)}`;
     const s = `0x${sig.slice(66, 130)}`;
     const v = parseInt(sig.slice(130, 132), 16);
-    return encodeFunctionData3({
+    return encodeFunctionData2({
       abi: EIP3009_TRANSFER_ABI,
       functionName: "transferWithAuthorization",
       args: [
@@ -1767,14 +2284,13 @@ var GaslessT402Client = class {
   }
   /**
    * Estimate gas for a single transaction
+   *
+   * @param intent - Transaction intent with target, value, and data
+   * @returns Gas estimates for the UserOperation
    */
   async estimateGas(intent) {
     const sender = await this.signer.getAddress();
-    const callData = this.signer.encodeExecute(
-      intent.to,
-      intent.value ?? 0n,
-      intent.data ?? "0x"
-    );
+    const callData = this.signer.encodeExecute(intent.to, intent.value ?? 0n, intent.data ?? "0x");
     try {
       return await this.bundler.estimateUserOperationGas({
         sender,
@@ -1790,6 +2306,9 @@ var GaslessT402Client = class {
   }
   /**
    * Estimate gas for a batch transaction
+   *
+   * @param intents - Array of transaction intents to batch
+   * @returns Gas estimates for the batched UserOperation
    */
   async estimateBatchGas(intents) {
     const sender = await this.signer.getAddress();
@@ -1813,15 +2332,14 @@ var GaslessT402Client = class {
   }
   /**
    * Get paymaster data if configured
+   *
+   * @param _ - Gas estimates (unused but kept for potential future use)
+   * @returns Paymaster data or undefined if no paymaster configured
    */
-  async getPaymasterData(_gasEstimate) {
+  async getPaymasterData(_) {
     if (!this.paymaster) return void 0;
     const sender = await this.signer.getAddress();
-    return this.paymaster.getPaymasterData(
-      { sender },
-      this.chainId,
-      ENTRYPOINT_V07_ADDRESS
-    );
+    return this.paymaster.getPaymasterData({ sender }, this.chainId, ENTRYPOINT_V07_ADDRESS);
   }
 };
 function createGaslessT402Client(config) {
@@ -1832,6 +2350,7 @@ export {
   BUNDLER_METHODS,
   BundlerClient,
   BundlerError,
+  CrossChainPaymentRouter,
   DEFAULT_GAS_LIMITS,
   ENTRYPOINT_V06_ADDRESS,
   ENTRYPOINT_V07_ABI,
@@ -1843,45 +2362,36 @@ export {
   GaslessT402Client,
   LAYERZERO_ENDPOINT_IDS,
   LAYERZERO_ENDPOINT_V2,
+  LAYERZERO_SCAN_BASE_URL,
+  LayerZeroScanClient,
   PaymasterClient,
   PaymasterType,
-  TOKEN_PRIORITY,
-  TOKEN_REGISTRY,
-  USDC_ADDRESSES,
-  USDT0_ADDRESSES,
   USDT0_OFT_ADDRESSES,
-  USDT_LEGACY_ADDRESSES,
+  UptoEvmFacilitatorScheme,
+  UptoEvmScheme,
+  UptoEvmServerScheme,
   Usdt0Bridge,
   UserOpBuilder,
   addressToBytes32,
-  authorizationTypes,
   bytes32ToAddress,
   createBundlerClient,
+  createCrossChainPaymentRouter,
   createGaslessT402Client,
+  createLayerZeroScanClient,
   createPaymasterClient,
+  createUptoEvmFacilitatorScheme,
+  createUptoEvmScheme,
+  createUptoEvmServerScheme,
   createUsdt0Bridge,
   createUserOpBuilder,
   decodePaymasterAndData,
-  eip3009ABI,
   encodePaymasterAndData,
-  erc20LegacyABI,
   getBridgeableChains,
-  getDefaultToken,
-  getEIP712Domain,
   getEndpointId,
-  getNetworkTokens,
-  getNetworksForToken,
-  getTokenByAddress,
-  getTokenConfig,
-  getUsdt0Networks,
   getUsdt0OftAddress,
-  legacyAuthorizationTypes,
   packAccountGasLimits,
   packGasFees,
   supportsBridging,
-  supportsEIP3009,
-  toClientEvmSigner,
-  toFacilitatorEvmSigner,
   unpackAccountGasLimits,
   unpackGasFees
 };