@t402/ton 2.0.0

package/dist/cjs/exact/facilitator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/facilitator/index.ts","../../../../src/exact/facilitator/scheme.ts","../../../../src/constants.ts","../../../../src/utils.ts"],"sourcesContent":["export { ExactTonScheme } from \"./scheme.js\";\nexport type { ExactTonSchemeConfig } from \"./scheme.js\";\n","/**\n * TON Facilitator Scheme Implementation\n *\n * Verifies and settles TON Jetton payments using the exact scheme.\n * Validates signed messages and broadcasts transactions to the network.\n */\n\nimport { Cell } from \"@ton/core\";\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@t402/core/types\";\nimport type { FacilitatorTonSigner } from \"../../signer.js\";\nimport type { ExactTonPayloadV2 } from \"../../types.js\";\nimport { SCHEME_EXACT } from \"../../constants.js\";\nimport { addressesEqual, normalizeNetwork } from \"../../utils.js\";\n\n/**\n * Configuration options for ExactTonScheme facilitator\n */\nexport interface ExactTonSchemeConfig {\n  /** Whether this facilitator can sponsor gas for transactions */\n  canSponsorGas?: boolean;\n}\n\n/**\n * TON facilitator implementation for the Exact payment scheme.\n *\n * Verifies signed Jetton transfer messages and broadcasts them\n * to the TON network to complete payments.\n */\nexport class ExactTonScheme implements SchemeNetworkFacilitator {\n  readonly scheme = SCHEME_EXACT;\n  readonly caipFamily = \"ton:*\";\n  private config: ExactTonSchemeConfig;\n\n  /**\n   * Creates a new ExactTonScheme facilitator instance.\n   *\n   * @param signer - The TON signer for facilitator operations\n   * @param config - Optional configuration\n   */\n  constructor(\n    private readonly signer: FacilitatorTonSigner,\n    config: ExactTonSchemeConfig = {},\n  ) {\n    this.config = config;\n  }\n\n  /**\n   * Get mechanism-specific extra data for the supported kinds endpoint.\n   * For TON, optionally returns gas sponsor address if configured.\n   *\n   * @param network - The network identifier\n   * @returns Extra data object or undefined\n   */\n  getExtra(network: string): Record<string, unknown> | undefined {\n    void network;\n\n    if (this.config.canSponsorGas) {\n      const addresses = this.signer.getAddresses();\n      if (addresses.length > 0) {\n        return {\n          gasSponsor: addresses[0],\n        };\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Get signer addresses used by this facilitator.\n   * Returns all addresses this facilitator can use for operations.\n   *\n   * @param network - The network identifier\n   * @returns Array of facilitator addresses\n   */\n  getSigners(network: string): string[] {\n    void network;\n    return [...this.signer.getAddresses()];\n  }\n\n  /**\n   * Verifies a payment payload.\n   *\n   * Performs comprehensive validation:\n   * 1. Scheme and network matching\n   * 2. BOC format validation\n   * 3. Message structure verification\n   * 4. Authorization expiry check\n   * 5. Balance verification\n   * 6. Amount and recipient validation\n   *\n   * @param payload - The payment payload to verify\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to verification response\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const tonPayload = payload.payload as ExactTonPayloadV2;\n    const authorization = tonPayload.authorization;\n\n    // Step 1: Verify scheme matches\n    if (payload.accepted.scheme !== SCHEME_EXACT || requirements.scheme !== SCHEME_EXACT) {\n      return {\n        isValid: false,\n        invalidReason: \"unsupported_scheme\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 2: Verify network matches\n    try {\n      const payloadNetwork = normalizeNetwork(payload.accepted.network);\n      const requirementsNetwork = normalizeNetwork(requirements.network);\n\n      if (payloadNetwork !== requirementsNetwork) {\n        return {\n          isValid: false,\n          invalidReason: \"network_mismatch\",\n          payer: authorization.from,\n        };\n      }\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_network\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 3: Parse and validate the signed BOC\n    try {\n      Cell.fromBase64(tonPayload.signedBoc);\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_boc_format\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 4: Verify the message structure and parameters\n    const verifyResult = await this.signer.verifyMessage({\n      signedBoc: tonPayload.signedBoc,\n      expectedFrom: authorization.from,\n      expectedTransfer: {\n        jettonAmount: BigInt(authorization.jettonAmount),\n        destination: requirements.payTo,\n        jettonMaster: requirements.asset,\n      },\n    });\n\n    if (!verifyResult.valid) {\n      return {\n        isValid: false,\n        invalidReason: verifyResult.reason || \"message_verification_failed\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 5: Check validUntil is in the future (with 30 second buffer)\n    const now = Math.floor(Date.now() / 1000);\n    if (authorization.validUntil < now + 30) {\n      return {\n        isValid: false,\n        invalidReason: \"authorization_expired\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 6: Verify Jetton balance\n    try {\n      const balance = await this.signer.getJettonBalance({\n        ownerAddress: authorization.from,\n        jettonMasterAddress: requirements.asset,\n      });\n\n      if (balance < BigInt(requirements.amount)) {\n        return {\n          isValid: false,\n          invalidReason: \"insufficient_jetton_balance\",\n          payer: authorization.from,\n        };\n      }\n    } catch (error) {\n      // If we can't check balance, log warning but continue\n      console.warn(\"Could not verify Jetton balance:\", error);\n    }\n\n    // Step 7: Verify amount is sufficient\n    if (BigInt(authorization.jettonAmount) < BigInt(requirements.amount)) {\n      return {\n        isValid: false,\n        invalidReason: \"insufficient_amount\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 8: Verify recipient matches\n    if (!addressesEqual(authorization.to, requirements.payTo)) {\n      return {\n        isValid: false,\n        invalidReason: \"recipient_mismatch\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 9: Verify Jetton master matches\n    if (!addressesEqual(authorization.jettonMaster, requirements.asset)) {\n      return {\n        isValid: false,\n        invalidReason: \"asset_mismatch\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 10: Check seqno hasn't been used (replay protection)\n    try {\n      const currentSeqno = await this.signer.getSeqno(authorization.from);\n      if (authorization.seqno < currentSeqno) {\n        return {\n          isValid: false,\n          invalidReason: \"seqno_already_used\",\n          payer: authorization.from,\n        };\n      }\n      if (authorization.seqno > currentSeqno) {\n        return {\n          isValid: false,\n          invalidReason: \"seqno_too_high\",\n          payer: authorization.from,\n        };\n      }\n    } catch (error) {\n      console.warn(\"Could not verify seqno:\", error);\n    }\n\n    // Step 11: Verify wallet is deployed\n    try {\n      const isDeployed = await this.signer.isDeployed(authorization.from);\n      if (!isDeployed) {\n        return {\n          isValid: false,\n          invalidReason: \"wallet_not_deployed\",\n          payer: authorization.from,\n        };\n      }\n    } catch (error) {\n      console.warn(\"Could not verify wallet deployment:\", error);\n    }\n\n    return {\n      isValid: true,\n      invalidReason: undefined,\n      payer: authorization.from,\n    };\n  }\n\n  /**\n   * Settles a payment by broadcasting the signed message.\n   *\n   * @param payload - The payment payload to settle\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to settlement response\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    const tonPayload = payload.payload as ExactTonPayloadV2;\n\n    // Re-verify before settling\n    const verifyResult = await this.verify(payload, requirements);\n    if (!verifyResult.isValid) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: \"\",\n        errorReason: verifyResult.invalidReason ?? \"verification_failed\",\n        payer: tonPayload.authorization.from,\n      };\n    }\n\n    try {\n      // Send the pre-signed external message\n      const txHash = await this.signer.sendExternalMessage(tonPayload.signedBoc);\n\n      // Wait for confirmation\n      const confirmation = await this.signer.waitForTransaction({\n        address: tonPayload.authorization.from,\n        seqno: tonPayload.authorization.seqno + 1, // Wait for next seqno\n        timeout: 60000, // 60 second timeout\n      });\n\n      if (!confirmation.success) {\n        return {\n          success: false,\n          errorReason: confirmation.error || \"transaction_not_confirmed\",\n          transaction: txHash,\n          network: payload.accepted.network,\n          payer: tonPayload.authorization.from,\n        };\n      }\n\n      return {\n        success: true,\n        transaction: confirmation.hash || txHash,\n        network: payload.accepted.network,\n        payer: tonPayload.authorization.from,\n      };\n    } catch (error) {\n      console.error(\"Failed to settle TON transaction:\", error);\n      return {\n        success: false,\n        errorReason: \"transaction_failed\",\n        transaction: \"\",\n        network: payload.accepted.network,\n        payer: tonPayload.authorization.from,\n      };\n    }\n  }\n}\n","/**\n * TON Network Constants\n *\n * This module provides constants for TON blockchain integration including:\n * - CAIP-2 network identifiers\n * - RPC endpoints\n * - Jetton transfer operation codes\n * - Default gas amounts\n */\n\n/**\n * CAIP-2 Network Identifiers for TON\n * Using simple identifiers for mainnet/testnet\n */\nexport const TON_MAINNET_CAIP2 = \"ton:mainnet\";\nexport const TON_TESTNET_CAIP2 = \"ton:testnet\";\n\n/**\n * Supported TON networks\n */\nexport const TON_NETWORKS = [TON_MAINNET_CAIP2, TON_TESTNET_CAIP2] as const;\n\nexport type TonNetwork = (typeof TON_NETWORKS)[number];\n\n/**\n * Default RPC endpoints (TonCenter API v2)\n */\nexport const TON_MAINNET_ENDPOINT = \"https://toncenter.com/api/v2/jsonRPC\";\nexport const TON_TESTNET_ENDPOINT = \"https://testnet.toncenter.com/api/v2/jsonRPC\";\n\n/**\n * TON API v4 endpoints (for @ton/ton TonClient4)\n */\nexport const TON_MAINNET_V4_ENDPOINT = \"https://mainnet-v4.tonhubapi.com\";\nexport const TON_TESTNET_V4_ENDPOINT = \"https://testnet-v4.tonhubapi.com\";\n\n/**\n * Network endpoint mapping\n */\nexport const NETWORK_ENDPOINTS: Record<string, string> = {\n  [TON_MAINNET_CAIP2]: TON_MAINNET_ENDPOINT,\n  [TON_TESTNET_CAIP2]: TON_TESTNET_ENDPOINT,\n};\n\nexport const NETWORK_V4_ENDPOINTS: Record<string, string> = {\n  [TON_MAINNET_CAIP2]: TON_MAINNET_V4_ENDPOINT,\n  [TON_TESTNET_CAIP2]: TON_TESTNET_V4_ENDPOINT,\n};\n\n/**\n * Jetton Transfer Operation Codes (TEP-74)\n * @see https://github.com/ton-blockchain/TEPs/blob/master/text/0074-jettons-standard.md\n */\nexport const JETTON_TRANSFER_OP = 0x0f8a7ea5; // transfer\nexport const JETTON_INTERNAL_TRANSFER_OP = 0x178d4519; // internal_transfer\nexport const JETTON_TRANSFER_NOTIFICATION_OP = 0x7362d09c; // transfer_notification\nexport const JETTON_BURN_OP = 0x595f07bc; // burn\n\n/**\n * Default gas amounts for Jetton transfers\n * TON requires attaching TON for gas to internal messages\n */\nexport const DEFAULT_JETTON_TRANSFER_TON = 100_000_000n; // 0.1 TON for gas\nexport const DEFAULT_FORWARD_TON = 1n; // Minimal forward amount (notification)\nexport const MIN_JETTON_TRANSFER_TON = 50_000_000n; // 0.05 TON minimum\n\n/**\n * Maximum gas amounts to prevent excessive fees\n */\nexport const MAX_JETTON_TRANSFER_TON = 500_000_000n; // 0.5 TON maximum\n\n/**\n * Scheme identifier for exact payments\n */\nexport const SCHEME_EXACT = \"exact\";\n\n/**\n * Default timeout for payment validity (in seconds)\n */\nexport const DEFAULT_VALIDITY_DURATION = 3600; // 1 hour\n\n/**\n * Address format constants\n */\nexport const TON_ADDRESS_LENGTH = 48; // Friendly format length (base64url)\nexport const TON_RAW_ADDRESS_LENGTH = 66; // Raw format: workchain:hash (0:64hex)\n","/**\n * TON Utility Functions\n *\n * Helper functions for TON address handling, message building,\n * and network operations.\n */\n\nimport { Address, beginCell, Cell } from \"@ton/core\";\nimport type { Network } from \"@t402/core/types\";\nimport {\n  TON_MAINNET_CAIP2,\n  TON_TESTNET_CAIP2,\n  TON_NETWORKS,\n  NETWORK_ENDPOINTS,\n  JETTON_TRANSFER_OP,\n} from \"./constants.js\";\n\n/**\n * Normalize network identifier to CAIP-2 format\n *\n * @param network - Network identifier (may be legacy format)\n * @returns Normalized CAIP-2 network identifier\n * @throws Error if network is not supported\n */\nexport function normalizeNetwork(network: Network): Network {\n  // Already in CAIP-2 format\n  if (network.startsWith(\"ton:\")) {\n    if (!TON_NETWORKS.includes(network as (typeof TON_NETWORKS)[number])) {\n      throw new Error(`Unsupported TON network: ${network}`);\n    }\n    return network as Network;\n  }\n\n  // Handle legacy format conversions\n  const mapping: Record<string, Network> = {\n    ton: TON_MAINNET_CAIP2 as Network,\n    \"ton-mainnet\": TON_MAINNET_CAIP2 as Network,\n    mainnet: TON_MAINNET_CAIP2 as Network,\n    \"ton-testnet\": TON_TESTNET_CAIP2 as Network,\n    testnet: TON_TESTNET_CAIP2 as Network,\n  };\n\n  const caip2 = mapping[network.toLowerCase()];\n  if (!caip2) {\n    throw new Error(`Unsupported TON network: ${network}`);\n  }\n  return caip2;\n}\n\n/**\n * Get RPC endpoint for a network\n *\n * @param network - Network identifier\n * @returns RPC endpoint URL\n */\nexport function getEndpoint(network: Network): string {\n  const caip2 = normalizeNetwork(network);\n  const endpoint = NETWORK_ENDPOINTS[caip2];\n  if (!endpoint) {\n    throw new Error(`No endpoint configured for network: ${network}`);\n  }\n  return endpoint;\n}\n\n/**\n * Check if a network identifier is a supported TON network\n *\n * @param network - Network identifier to check\n * @returns true if supported\n */\nexport function isTonNetwork(network: string): boolean {\n  try {\n    normalizeNetwork(network as Network);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validate TON address format\n *\n * @param address - Address to validate\n * @returns true if valid TON address\n */\nexport function validateTonAddress(address: string): boolean {\n  try {\n    Address.parse(address);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Parse TON address from string\n *\n * @param address - Address string (friendly or raw format)\n * @returns Parsed Address object\n * @throws Error if invalid format\n */\nexport function parseTonAddress(address: string): Address {\n  return Address.parse(address);\n}\n\n/**\n * Compare two TON addresses for equality\n * Handles different address formats (friendly, raw, bounceable/non-bounceable)\n *\n * @param addr1 - First address\n * @param addr2 - Second address\n * @returns true if addresses are equal\n */\nexport function addressesEqual(addr1: string, addr2: string): boolean {\n  try {\n    const a1 = Address.parse(addr1);\n    const a2 = Address.parse(addr2);\n    return a1.equals(a2);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Format address to friendly format\n *\n * @param address - Address to format\n * @param options - Formatting options\n * @returns Friendly format address string\n */\nexport function formatAddress(\n  address: string | Address,\n  options?: { bounceable?: boolean; testOnly?: boolean },\n): string {\n  const addr = typeof address === \"string\" ? Address.parse(address) : address;\n  return addr.toString({\n    bounceable: options?.bounceable ?? true,\n    testOnly: options?.testOnly ?? false,\n  });\n}\n\n/**\n * Convert decimal amount to smallest units (e.g., nano-Jettons)\n *\n * @param decimalAmount - Amount in decimal format (e.g., \"1.50\")\n * @param decimals - Number of decimal places\n * @returns Amount in smallest units as string\n */\nexport function convertToJettonAmount(decimalAmount: string, decimals: number): string {\n  const amount = parseFloat(decimalAmount);\n  if (isNaN(amount)) {\n    throw new Error(`Invalid amount: ${decimalAmount}`);\n  }\n  const jettonAmount = Math.floor(amount * Math.pow(10, decimals));\n  return jettonAmount.toString();\n}\n\n/**\n * Convert smallest units to decimal amount\n *\n * @param jettonAmount - Amount in smallest units\n * @param decimals - Number of decimal places\n * @returns Amount in decimal format as string\n */\nexport function convertFromJettonAmount(jettonAmount: string | bigint, decimals: number): string {\n  const amount = typeof jettonAmount === \"string\" ? BigInt(jettonAmount) : jettonAmount;\n  const divisor = BigInt(Math.pow(10, decimals));\n  const wholePart = amount / divisor;\n  const fractionalPart = amount % divisor;\n\n  if (fractionalPart === 0n) {\n    return wholePart.toString();\n  }\n\n  const fractionalStr = fractionalPart.toString().padStart(decimals, \"0\");\n  return `${wholePart}.${fractionalStr}`.replace(/\\.?0+$/, \"\");\n}\n\n/**\n * Generate a unique query ID for Jetton transfer\n * Uses timestamp + random component for uniqueness\n *\n * @returns BigInt query ID\n */\nexport function generateQueryId(): bigint {\n  const timestamp = BigInt(Date.now());\n  const random = BigInt(Math.floor(Math.random() * 1000000));\n  return timestamp * 1000000n + random;\n}\n\n/**\n * Build Jetton transfer message body (TEP-74)\n *\n * @param params - Transfer parameters\n * @returns Cell containing the transfer message\n */\nexport function buildJettonTransferBody(params: {\n  queryId: bigint;\n  amount: bigint;\n  destination: Address;\n  responseDestination: Address;\n  forwardAmount?: bigint;\n  forwardPayload?: Cell;\n}): Cell {\n  const builder = beginCell()\n    .storeUint(JETTON_TRANSFER_OP, 32) // op: transfer\n    .storeUint(params.queryId, 64) // query_id\n    .storeCoins(params.amount) // amount\n    .storeAddress(params.destination) // destination\n    .storeAddress(params.responseDestination) // response_destination\n    .storeBit(false); // no custom payload\n\n  // Forward amount (for notification)\n  builder.storeCoins(params.forwardAmount ?? 1n);\n\n  // Forward payload (optional)\n  if (params.forwardPayload) {\n    builder.storeBit(true).storeRef(params.forwardPayload);\n  } else {\n    builder.storeBit(false);\n  }\n\n  return builder.endCell();\n}\n\n/**\n * Parse Jetton transfer message from Cell\n *\n * @param body - Cell containing the message\n * @returns Parsed transfer parameters\n * @throws Error if not a valid Jetton transfer message\n */\nexport function parseJettonTransferBody(body: Cell): {\n  op: number;\n  queryId: bigint;\n  amount: bigint;\n  destination: Address;\n  responseDestination: Address;\n  forwardAmount: bigint;\n  forwardPayload?: Cell;\n} {\n  const slice = body.beginParse();\n\n  const op = slice.loadUint(32);\n  if (op !== JETTON_TRANSFER_OP) {\n    throw new Error(`Not a Jetton transfer message. Expected op ${JETTON_TRANSFER_OP}, got ${op}`);\n  }\n\n  const queryId = slice.loadUintBig(64);\n  const amount = slice.loadCoins();\n  const destination = slice.loadAddress();\n  const responseDestination = slice.loadAddress();\n\n  // Skip custom_payload bit\n  const hasCustomPayload = slice.loadBit();\n  if (hasCustomPayload) {\n    slice.loadRef(); // Skip custom payload\n  }\n\n  const forwardAmount = slice.loadCoins();\n\n  // Forward payload\n  const hasForwardPayload = slice.loadBit();\n  const forwardPayload = hasForwardPayload ? slice.loadRef() : undefined;\n\n  return {\n    op,\n    queryId,\n    amount,\n    destination,\n    responseDestination,\n    forwardAmount,\n    forwardPayload,\n  };\n}\n\n/**\n * Calculate estimated gas for Jetton transfer\n * Based on typical TON network fees\n *\n * @param params - Optional parameters for estimation\n * @returns Estimated gas in nanoTON\n */\nexport function estimateJettonTransferGas(_params?: {\n  hasForwardPayload?: boolean;\n}): bigint {\n  // Base cost for Jetton transfer (typical)\n  // Includes: external message, wallet internal message, Jetton wallet message\n  return 100_000_000n; // 0.1 TON (conservative estimate)\n}\n"],"mappings":"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","names":["import_core"]}

package/dist/cjs/exact/server/index.d.ts

@@ -0,0 +1,135 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@t402/core/types';
+
+/**
+ * TON Server Scheme Implementation
+ *
+ * Handles price parsing and payment requirement enhancement for
+ * TON Jetton payments using the exact scheme.
+ */
+
+/**
+ * Configuration options for ExactTonScheme server
+ */
+interface ExactTonSchemeConfig {
+    /** Preferred Jetton symbol (e.g., "USDT"). Defaults to network's highest priority token. */
+    preferredJetton?: string;
+}
+/**
+ * TON server implementation for the Exact payment scheme.
+ * Handles price parsing and converts user-friendly amounts to Jetton amounts.
+ */
+declare class ExactTonScheme implements SchemeNetworkServer {
+    readonly scheme = "exact";
+    private moneyParsers;
+    private config;
+    constructor(config?: ExactTonSchemeConfig);
+    /**
+     * Register a custom money parser in the parser chain.
+     * Multiple parsers can be registered - they will be tried in registration order.
+     * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
+     * If a parser returns null, the next parser in the chain will be tried.
+     * The default parser is always the final fallback.
+     *
+     * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+     * @returns The server instance for chaining
+     *
+     * @example
+     * tonServer.registerMoneyParser(async (amount, network) => {
+     *   // Use custom Jetton for large amounts
+     *   if (amount > 1000) {
+     *     return {
+     *       amount: (amount * 1e9).toString(),
+     *       asset: "EQCustomJettonAddress...",
+     *       extra: { tier: "premium" }
+     *     };
+     *   }
+     *   return null; // Use next parser
+     * });
+     */
+    registerMoneyParser(parser: MoneyParser): ExactTonScheme;
+    /**
+     * Parses a price into an asset amount.
+     * If price is already an AssetAmount, returns it directly.
+     * If price is Money (string | number), parses to decimal and tries custom parsers.
+     * Falls back to default conversion if all custom parsers return null.
+     *
+     * @param price - The price to parse
+     * @param network - The network to use
+     * @returns Promise that resolves to the parsed asset amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Build payment requirements for this scheme/network combination.
+     * Adds TON-specific fields like gas sponsor if provided by facilitator.
+     *
+     * @param paymentRequirements - Base payment requirements with amount/asset already set
+     * @param supportedKind - The supported kind from facilitator's /supported endpoint
+     * @param extensionKeys - Extensions supported by the facilitator (unused)
+     * @returns Enhanced payment requirements ready to be sent to clients
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        t402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse Money (string | number) to a decimal number.
+     * Handles formats like "$1.50", "1.50", 1.50, etc.
+     *
+     * @param money - The money value to parse
+     * @returns Decimal number
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money conversion implementation.
+     * Converts decimal amount to the preferred Jetton on the specified network.
+     *
+     * @param amount - The decimal amount (e.g., 1.50)
+     * @param network - The network to use
+     * @returns The parsed asset amount
+     */
+    private defaultMoneyConversion;
+    /**
+     * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal tokens)
+     *
+     * @param decimalAmount - The decimal amount to convert
+     * @param decimals - Number of decimals for the token
+     * @returns The token amount as a string
+     */
+    private convertToTokenAmount;
+    /**
+     * Get the default asset info for a network.
+     * Priority: configured preferredJetton > USDT > first available
+     *
+     * @param network - The network to get asset info for
+     * @returns The Jetton configuration
+     */
+    private getDefaultAsset;
+    /**
+     * Get Jetton info for a given symbol on a network
+     *
+     * @param symbol - The Jetton symbol (e.g., "USDT")
+     * @param network - The network to use
+     * @returns The Jetton configuration
+     */
+    private getAssetInfo;
+    /**
+     * Get the number of decimals for a Jetton on a network
+     *
+     * @param network - The network to use
+     * @param jettonAddress - Optional Jetton address to look up
+     * @returns The number of decimals for the Jetton
+     */
+    private getAssetDecimals;
+    /**
+     * Get all supported networks
+     */
+    static getSupportedNetworks(): string[];
+    /**
+     * Check if a network is supported
+     */
+    static isNetworkSupported(network: string): boolean;
+}
+
+export { ExactTonScheme, type ExactTonSchemeConfig };

package/dist/cjs/exact/server/index.js

@@ -0,0 +1,318 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/exact/server/index.ts
+var server_exports = {};
+__export(server_exports, {
+  ExactTonScheme: () => ExactTonScheme
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/constants.ts
+var TON_MAINNET_CAIP2 = "ton:mainnet";
+var TON_TESTNET_CAIP2 = "ton:testnet";
+var TON_NETWORKS = [TON_MAINNET_CAIP2, TON_TESTNET_CAIP2];
+var TON_MAINNET_ENDPOINT = "https://toncenter.com/api/v2/jsonRPC";
+var TON_TESTNET_ENDPOINT = "https://testnet.toncenter.com/api/v2/jsonRPC";
+var TON_MAINNET_V4_ENDPOINT = "https://mainnet-v4.tonhubapi.com";
+var TON_TESTNET_V4_ENDPOINT = "https://testnet-v4.tonhubapi.com";
+var NETWORK_ENDPOINTS = {
+  [TON_MAINNET_CAIP2]: TON_MAINNET_ENDPOINT,
+  [TON_TESTNET_CAIP2]: TON_TESTNET_ENDPOINT
+};
+var NETWORK_V4_ENDPOINTS = {
+  [TON_MAINNET_CAIP2]: TON_MAINNET_V4_ENDPOINT,
+  [TON_TESTNET_CAIP2]: TON_TESTNET_V4_ENDPOINT
+};
+var SCHEME_EXACT = "exact";
+
+// src/tokens.ts
+var USDT_ADDRESSES = {
+  // TON Mainnet - Official Tether USDT
+  [TON_MAINNET_CAIP2]: "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs",
+  // TON Testnet - Test USDT (may vary)
+  [TON_TESTNET_CAIP2]: "kQBqSpvo4S87mX9tTc4FX3Sfqf4uSp3Tx-Fz4RBUfTRWBx"
+};
+var JETTON_REGISTRY = {
+  // TON Mainnet
+  [TON_MAINNET_CAIP2]: {
+    USDT: {
+      masterAddress: USDT_ADDRESSES[TON_MAINNET_CAIP2],
+      symbol: "USDT",
+      name: "Tether USD",
+      decimals: 6,
+      priority: 1
+    }
+  },
+  // TON Testnet
+  [TON_TESTNET_CAIP2]: {
+    USDT: {
+      masterAddress: USDT_ADDRESSES[TON_TESTNET_CAIP2],
+      symbol: "USDT",
+      name: "Tether USD (Testnet)",
+      decimals: 6,
+      priority: 1
+    }
+  }
+};
+function getJettonConfig(network, symbol) {
+  return JETTON_REGISTRY[network]?.[symbol.toUpperCase()];
+}
+function getNetworkJettons(network) {
+  const jettons = JETTON_REGISTRY[network];
+  if (!jettons) return [];
+  return Object.values(jettons).sort((a, b) => a.priority - b.priority);
+}
+function getDefaultJetton(network) {
+  const jettons = getNetworkJettons(network);
+  return jettons[0];
+}
+function getJettonByAddress(network, address) {
+  const jettons = JETTON_REGISTRY[network];
+  if (!jettons) return void 0;
+  return Object.values(jettons).find(
+    (j) => j.masterAddress.toLowerCase() === address.toLowerCase()
+  );
+}
+
+// src/utils.ts
+var import_core = require("@ton/core");
+function normalizeNetwork(network) {
+  if (network.startsWith("ton:")) {
+    if (!TON_NETWORKS.includes(network)) {
+      throw new Error(`Unsupported TON network: ${network}`);
+    }
+    return network;
+  }
+  const mapping = {
+    ton: TON_MAINNET_CAIP2,
+    "ton-mainnet": TON_MAINNET_CAIP2,
+    mainnet: TON_MAINNET_CAIP2,
+    "ton-testnet": TON_TESTNET_CAIP2,
+    testnet: TON_TESTNET_CAIP2
+  };
+  const caip2 = mapping[network.toLowerCase()];
+  if (!caip2) {
+    throw new Error(`Unsupported TON network: ${network}`);
+  }
+  return caip2;
+}
+
+// src/exact/server/scheme.ts
+var ExactTonScheme = class {
+  constructor(config = {}) {
+    this.scheme = SCHEME_EXACT;
+    this.moneyParsers = [];
+    this.config = config;
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   * Multiple parsers can be registered - they will be tried in registration order.
+   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
+   * If a parser returns null, the next parser in the chain will be tried.
+   * The default parser is always the final fallback.
+   *
+   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+   * @returns The server instance for chaining
+   *
+   * @example
+   * tonServer.registerMoneyParser(async (amount, network) => {
+   *   // Use custom Jetton for large amounts
+   *   if (amount > 1000) {
+   *     return {
+   *       amount: (amount * 1e9).toString(),
+   *       asset: "EQCustomJettonAddress...",
+   *       extra: { tier: "premium" }
+   *     };
+   *   }
+   *   return null; // Use next parser
+   * });
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parses a price into an asset amount.
+   * If price is already an AssetAmount, returns it directly.
+   * If price is Money (string | number), parses to decimal and tries custom parsers.
+   * Falls back to default conversion if all custom parsers return null.
+   *
+   * @param price - The price to parse
+   * @param network - The network to use
+   * @returns Promise that resolves to the parsed asset amount
+   */
+  async parsePrice(price, network) {
+    const normalizedNetwork = normalizeNetwork(network);
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);
+      }
+      return {
+        amount: price.amount,
+        asset: price.asset,
+        extra: price.extra || {}
+      };
+    }
+    const amount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(amount, normalizedNetwork);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, normalizedNetwork);
+  }
+  /**
+   * Build payment requirements for this scheme/network combination.
+   * Adds TON-specific fields like gas sponsor if provided by facilitator.
+   *
+   * @param paymentRequirements - Base payment requirements with amount/asset already set
+   * @param supportedKind - The supported kind from facilitator's /supported endpoint
+   * @param extensionKeys - Extensions supported by the facilitator (unused)
+   * @returns Enhanced payment requirements ready to be sent to clients
+   */
+  async enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
+    void extensionKeys;
+    const extra = { ...paymentRequirements.extra };
+    if (supportedKind.extra?.gasSponsor) {
+      extra.gasSponsor = supportedKind.extra.gasSponsor;
+    }
+    return {
+      ...paymentRequirements,
+      extra
+    };
+  }
+  /**
+   * Parse Money (string | number) to a decimal number.
+   * Handles formats like "$1.50", "1.50", 1.50, etc.
+   *
+   * @param money - The money value to parse
+   * @returns Decimal number
+   */
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      return money;
+    }
+    const cleanMoney = money.replace(/^\$/, "").trim();
+    const amount = parseFloat(cleanMoney);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid money format: ${money}`);
+    }
+    return amount;
+  }
+  /**
+   * Default money conversion implementation.
+   * Converts decimal amount to the preferred Jetton on the specified network.
+   *
+   * @param amount - The decimal amount (e.g., 1.50)
+   * @param network - The network to use
+   * @returns The parsed asset amount
+   */
+  defaultMoneyConversion(amount, network) {
+    const jetton = this.getDefaultAsset(network);
+    const tokenAmount = this.convertToTokenAmount(amount.toString(), jetton.decimals);
+    return {
+      amount: tokenAmount,
+      asset: jetton.masterAddress,
+      extra: {
+        symbol: jetton.symbol,
+        name: jetton.name,
+        decimals: jetton.decimals
+      }
+    };
+  }
+  /**
+   * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal tokens)
+   *
+   * @param decimalAmount - The decimal amount to convert
+   * @param decimals - Number of decimals for the token
+   * @returns The token amount as a string
+   */
+  convertToTokenAmount(decimalAmount, decimals) {
+    const amount = parseFloat(decimalAmount);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid amount: ${decimalAmount}`);
+    }
+    const tokenAmount = Math.floor(amount * Math.pow(10, decimals));
+    return tokenAmount.toString();
+  }
+  /**
+   * Get the default asset info for a network.
+   * Priority: configured preferredJetton > USDT > first available
+   *
+   * @param network - The network to get asset info for
+   * @returns The Jetton configuration
+   */
+  getDefaultAsset(network) {
+    if (this.config.preferredJetton) {
+      const preferred = getJettonConfig(network, this.config.preferredJetton);
+      if (preferred) return preferred;
+    }
+    const defaultJetton = getDefaultJetton(network);
+    if (defaultJetton) return defaultJetton;
+    throw new Error(`No Jettons configured for network ${network}`);
+  }
+  /**
+   * Get Jetton info for a given symbol on a network
+   *
+   * @param symbol - The Jetton symbol (e.g., "USDT")
+   * @param network - The network to use
+   * @returns The Jetton configuration
+   */
+  getAssetInfo(symbol, network) {
+    const jetton = getJettonConfig(network, symbol);
+    if (jetton) return jetton;
+    if (symbol.toUpperCase() === "USD") {
+      return this.getDefaultAsset(network);
+    }
+    throw new Error(`Unsupported Jetton: ${symbol} on network ${network}`);
+  }
+  /**
+   * Get the number of decimals for a Jetton on a network
+   *
+   * @param network - The network to use
+   * @param jettonAddress - Optional Jetton address to look up
+   * @returns The number of decimals for the Jetton
+   */
+  getAssetDecimals(network, jettonAddress) {
+    if (jettonAddress) {
+      const jetton = getJettonByAddress(network, jettonAddress);
+      if (jetton) return jetton.decimals;
+    }
+    return 6;
+  }
+  /**
+   * Get all supported networks
+   */
+  static getSupportedNetworks() {
+    return Object.keys(JETTON_REGISTRY);
+  }
+  /**
+   * Check if a network is supported
+   */
+  static isNetworkSupported(network) {
+    return network in JETTON_REGISTRY;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactTonScheme
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/exact/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/server/index.ts","../../../../src/constants.ts","../../../../src/tokens.ts","../../../../src/utils.ts","../../../../src/exact/server/scheme.ts"],"sourcesContent":["export { ExactTonScheme } from \"./scheme.js\";\nexport type { ExactTonSchemeConfig } from \"./scheme.js\";\n","/**\n * TON Network Constants\n *\n * This module provides constants for TON blockchain integration including:\n * - CAIP-2 network identifiers\n * - RPC endpoints\n * - Jetton transfer operation codes\n * - Default gas amounts\n */\n\n/**\n * CAIP-2 Network Identifiers for TON\n * Using simple identifiers for mainnet/testnet\n */\nexport const TON_MAINNET_CAIP2 = \"ton:mainnet\";\nexport const TON_TESTNET_CAIP2 = \"ton:testnet\";\n\n/**\n * Supported TON networks\n */\nexport const TON_NETWORKS = [TON_MAINNET_CAIP2, TON_TESTNET_CAIP2] as const;\n\nexport type TonNetwork = (typeof TON_NETWORKS)[number];\n\n/**\n * Default RPC endpoints (TonCenter API v2)\n */\nexport const TON_MAINNET_ENDPOINT = \"https://toncenter.com/api/v2/jsonRPC\";\nexport const TON_TESTNET_ENDPOINT = \"https://testnet.toncenter.com/api/v2/jsonRPC\";\n\n/**\n * TON API v4 endpoints (for @ton/ton TonClient4)\n */\nexport const TON_MAINNET_V4_ENDPOINT = \"https://mainnet-v4.tonhubapi.com\";\nexport const TON_TESTNET_V4_ENDPOINT = \"https://testnet-v4.tonhubapi.com\";\n\n/**\n * Network endpoint mapping\n */\nexport const NETWORK_ENDPOINTS: Record<string, string> = {\n  [TON_MAINNET_CAIP2]: TON_MAINNET_ENDPOINT,\n  [TON_TESTNET_CAIP2]: TON_TESTNET_ENDPOINT,\n};\n\nexport const NETWORK_V4_ENDPOINTS: Record<string, string> = {\n  [TON_MAINNET_CAIP2]: TON_MAINNET_V4_ENDPOINT,\n  [TON_TESTNET_CAIP2]: TON_TESTNET_V4_ENDPOINT,\n};\n\n/**\n * Jetton Transfer Operation Codes (TEP-74)\n * @see https://github.com/ton-blockchain/TEPs/blob/master/text/0074-jettons-standard.md\n */\nexport const JETTON_TRANSFER_OP = 0x0f8a7ea5; // transfer\nexport const JETTON_INTERNAL_TRANSFER_OP = 0x178d4519; // internal_transfer\nexport const JETTON_TRANSFER_NOTIFICATION_OP = 0x7362d09c; // transfer_notification\nexport const JETTON_BURN_OP = 0x595f07bc; // burn\n\n/**\n * Default gas amounts for Jetton transfers\n * TON requires attaching TON for gas to internal messages\n */\nexport const DEFAULT_JETTON_TRANSFER_TON = 100_000_000n; // 0.1 TON for gas\nexport const DEFAULT_FORWARD_TON = 1n; // Minimal forward amount (notification)\nexport const MIN_JETTON_TRANSFER_TON = 50_000_000n; // 0.05 TON minimum\n\n/**\n * Maximum gas amounts to prevent excessive fees\n */\nexport const MAX_JETTON_TRANSFER_TON = 500_000_000n; // 0.5 TON maximum\n\n/**\n * Scheme identifier for exact payments\n */\nexport const SCHEME_EXACT = \"exact\";\n\n/**\n * Default timeout for payment validity (in seconds)\n */\nexport const DEFAULT_VALIDITY_DURATION = 3600; // 1 hour\n\n/**\n * Address format constants\n */\nexport const TON_ADDRESS_LENGTH = 48; // Friendly format length (base64url)\nexport const TON_RAW_ADDRESS_LENGTH = 66; // Raw format: workchain:hash (0:64hex)\n","/**\n * TON Jetton Token Configuration\n *\n * This module provides comprehensive Jetton token definitions including:\n * - USDT (Tether USD on TON)\n * - Network-specific configurations\n * - Helper functions for token lookups\n */\n\nimport { TON_MAINNET_CAIP2, TON_TESTNET_CAIP2 } from \"./constants.js\";\n\n/**\n * Jetton token configuration\n */\nexport interface JettonConfig {\n  /** Jetton master contract address (friendly format) */\n  masterAddress: string;\n  /** Token symbol */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Number of decimal places */\n  decimals: number;\n  /** Payment priority (lower = higher priority) */\n  priority: number;\n}\n\n/**\n * Network token registry mapping network -> symbol -> config\n */\nexport type NetworkJettonRegistry = Record<string, Record<string, JettonConfig>>;\n\n/**\n * USDT Jetton Master Contract Addresses by Network\n *\n * USDT on TON follows the TEP-74 Jetton standard.\n * @see https://docs.tether.to/tether-on-ton\n */\nexport const USDT_ADDRESSES: Record<string, string> = {\n  // TON Mainnet - Official Tether USDT\n  [TON_MAINNET_CAIP2]: \"EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs\",\n  // TON Testnet - Test USDT (may vary)\n  [TON_TESTNET_CAIP2]: \"kQBqSpvo4S87mX9tTc4FX3Sfqf4uSp3Tx-Fz4RBUfTRWBx\",\n};\n\n/**\n * Complete Jetton registry with all supported tokens per network\n */\nexport const JETTON_REGISTRY: NetworkJettonRegistry = {\n  // TON Mainnet\n  [TON_MAINNET_CAIP2]: {\n    USDT: {\n      masterAddress: USDT_ADDRESSES[TON_MAINNET_CAIP2],\n      symbol: \"USDT\",\n      name: \"Tether USD\",\n      decimals: 6,\n      priority: 1,\n    },\n  },\n\n  // TON Testnet\n  [TON_TESTNET_CAIP2]: {\n    USDT: {\n      masterAddress: USDT_ADDRESSES[TON_TESTNET_CAIP2],\n      symbol: \"USDT\",\n      name: \"Tether USD (Testnet)\",\n      decimals: 6,\n      priority: 1,\n    },\n  },\n};\n\n/**\n * Get Jetton configuration for a specific token on a network\n *\n * @param network - Network identifier (CAIP-2 format)\n * @param symbol - Token symbol (e.g., \"USDT\")\n * @returns Jetton configuration or undefined\n */\nexport function getJettonConfig(network: string, symbol: string): JettonConfig | undefined {\n  return JETTON_REGISTRY[network]?.[symbol.toUpperCase()];\n}\n\n/**\n * Get all Jettons available on a network\n *\n * @param network - Network identifier\n * @returns Array of Jetton configurations sorted by priority\n */\nexport function getNetworkJettons(network: string): JettonConfig[] {\n  const jettons = JETTON_REGISTRY[network];\n  if (!jettons) return [];\n  return Object.values(jettons).sort((a, b) => a.priority - b.priority);\n}\n\n/**\n * Get the default/preferred Jetton for a network\n * Prefers USDT based on priority\n *\n * @param network - Network identifier\n * @returns Default Jetton configuration or undefined\n */\nexport function getDefaultJetton(network: string): JettonConfig | undefined {\n  const jettons = getNetworkJettons(network);\n  return jettons[0]; // Already sorted by priority\n}\n\n/**\n * Get Jetton by master contract address on a network\n *\n * @param network - Network identifier\n * @param address - Jetton master contract address\n * @returns Jetton configuration or undefined\n */\nexport function getJettonByAddress(network: string, address: string): JettonConfig | undefined {\n  const jettons = JETTON_REGISTRY[network];\n  if (!jettons) return undefined;\n\n  // Normalize address comparison (case-insensitive for base64)\n  return Object.values(jettons).find(\n    (j) => j.masterAddress.toLowerCase() === address.toLowerCase(),\n  );\n}\n\n/**\n * Get all networks that support a specific Jetton\n *\n * @param symbol - Token symbol\n * @returns Array of network identifiers\n */\nexport function getNetworksForJetton(symbol: string): string[] {\n  const networks: string[] = [];\n  for (const [network, jettons] of Object.entries(JETTON_REGISTRY)) {\n    if (jettons[symbol.toUpperCase()]) {\n      networks.push(network);\n    }\n  }\n  return networks;\n}\n\n/**\n * Get USDT networks on TON\n *\n * @returns Array of networks supporting USDT\n */\nexport function getUsdtNetworks(): string[] {\n  return getNetworksForJetton(\"USDT\");\n}\n\n/**\n * Check if a network is supported\n *\n * @param network - Network identifier to check\n * @returns true if network has configured Jettons\n */\nexport function isNetworkSupported(network: string): boolean {\n  return network in JETTON_REGISTRY;\n}\n\n/**\n * Get all supported networks\n *\n * @returns Array of all supported network identifiers\n */\nexport function getSupportedNetworks(): string[] {\n  return Object.keys(JETTON_REGISTRY);\n}\n","/**\n * TON Utility Functions\n *\n * Helper functions for TON address handling, message building,\n * and network operations.\n */\n\nimport { Address, beginCell, Cell } from \"@ton/core\";\nimport type { Network } from \"@t402/core/types\";\nimport {\n  TON_MAINNET_CAIP2,\n  TON_TESTNET_CAIP2,\n  TON_NETWORKS,\n  NETWORK_ENDPOINTS,\n  JETTON_TRANSFER_OP,\n} from \"./constants.js\";\n\n/**\n * Normalize network identifier to CAIP-2 format\n *\n * @param network - Network identifier (may be legacy format)\n * @returns Normalized CAIP-2 network identifier\n * @throws Error if network is not supported\n */\nexport function normalizeNetwork(network: Network): Network {\n  // Already in CAIP-2 format\n  if (network.startsWith(\"ton:\")) {\n    if (!TON_NETWORKS.includes(network as (typeof TON_NETWORKS)[number])) {\n      throw new Error(`Unsupported TON network: ${network}`);\n    }\n    return network as Network;\n  }\n\n  // Handle legacy format conversions\n  const mapping: Record<string, Network> = {\n    ton: TON_MAINNET_CAIP2 as Network,\n    \"ton-mainnet\": TON_MAINNET_CAIP2 as Network,\n    mainnet: TON_MAINNET_CAIP2 as Network,\n    \"ton-testnet\": TON_TESTNET_CAIP2 as Network,\n    testnet: TON_TESTNET_CAIP2 as Network,\n  };\n\n  const caip2 = mapping[network.toLowerCase()];\n  if (!caip2) {\n    throw new Error(`Unsupported TON network: ${network}`);\n  }\n  return caip2;\n}\n\n/**\n * Get RPC endpoint for a network\n *\n * @param network - Network identifier\n * @returns RPC endpoint URL\n */\nexport function getEndpoint(network: Network): string {\n  const caip2 = normalizeNetwork(network);\n  const endpoint = NETWORK_ENDPOINTS[caip2];\n  if (!endpoint) {\n    throw new Error(`No endpoint configured for network: ${network}`);\n  }\n  return endpoint;\n}\n\n/**\n * Check if a network identifier is a supported TON network\n *\n * @param network - Network identifier to check\n * @returns true if supported\n */\nexport function isTonNetwork(network: string): boolean {\n  try {\n    normalizeNetwork(network as Network);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validate TON address format\n *\n * @param address - Address to validate\n * @returns true if valid TON address\n */\nexport function validateTonAddress(address: string): boolean {\n  try {\n    Address.parse(address);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Parse TON address from string\n *\n * @param address - Address string (friendly or raw format)\n * @returns Parsed Address object\n * @throws Error if invalid format\n */\nexport function parseTonAddress(address: string): Address {\n  return Address.parse(address);\n}\n\n/**\n * Compare two TON addresses for equality\n * Handles different address formats (friendly, raw, bounceable/non-bounceable)\n *\n * @param addr1 - First address\n * @param addr2 - Second address\n * @returns true if addresses are equal\n */\nexport function addressesEqual(addr1: string, addr2: string): boolean {\n  try {\n    const a1 = Address.parse(addr1);\n    const a2 = Address.parse(addr2);\n    return a1.equals(a2);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Format address to friendly format\n *\n * @param address - Address to format\n * @param options - Formatting options\n * @returns Friendly format address string\n */\nexport function formatAddress(\n  address: string | Address,\n  options?: { bounceable?: boolean; testOnly?: boolean },\n): string {\n  const addr = typeof address === \"string\" ? Address.parse(address) : address;\n  return addr.toString({\n    bounceable: options?.bounceable ?? true,\n    testOnly: options?.testOnly ?? false,\n  });\n}\n\n/**\n * Convert decimal amount to smallest units (e.g., nano-Jettons)\n *\n * @param decimalAmount - Amount in decimal format (e.g., \"1.50\")\n * @param decimals - Number of decimal places\n * @returns Amount in smallest units as string\n */\nexport function convertToJettonAmount(decimalAmount: string, decimals: number): string {\n  const amount = parseFloat(decimalAmount);\n  if (isNaN(amount)) {\n    throw new Error(`Invalid amount: ${decimalAmount}`);\n  }\n  const jettonAmount = Math.floor(amount * Math.pow(10, decimals));\n  return jettonAmount.toString();\n}\n\n/**\n * Convert smallest units to decimal amount\n *\n * @param jettonAmount - Amount in smallest units\n * @param decimals - Number of decimal places\n * @returns Amount in decimal format as string\n */\nexport function convertFromJettonAmount(jettonAmount: string | bigint, decimals: number): string {\n  const amount = typeof jettonAmount === \"string\" ? BigInt(jettonAmount) : jettonAmount;\n  const divisor = BigInt(Math.pow(10, decimals));\n  const wholePart = amount / divisor;\n  const fractionalPart = amount % divisor;\n\n  if (fractionalPart === 0n) {\n    return wholePart.toString();\n  }\n\n  const fractionalStr = fractionalPart.toString().padStart(decimals, \"0\");\n  return `${wholePart}.${fractionalStr}`.replace(/\\.?0+$/, \"\");\n}\n\n/**\n * Generate a unique query ID for Jetton transfer\n * Uses timestamp + random component for uniqueness\n *\n * @returns BigInt query ID\n */\nexport function generateQueryId(): bigint {\n  const timestamp = BigInt(Date.now());\n  const random = BigInt(Math.floor(Math.random() * 1000000));\n  return timestamp * 1000000n + random;\n}\n\n/**\n * Build Jetton transfer message body (TEP-74)\n *\n * @param params - Transfer parameters\n * @returns Cell containing the transfer message\n */\nexport function buildJettonTransferBody(params: {\n  queryId: bigint;\n  amount: bigint;\n  destination: Address;\n  responseDestination: Address;\n  forwardAmount?: bigint;\n  forwardPayload?: Cell;\n}): Cell {\n  const builder = beginCell()\n    .storeUint(JETTON_TRANSFER_OP, 32) // op: transfer\n    .storeUint(params.queryId, 64) // query_id\n    .storeCoins(params.amount) // amount\n    .storeAddress(params.destination) // destination\n    .storeAddress(params.responseDestination) // response_destination\n    .storeBit(false); // no custom payload\n\n  // Forward amount (for notification)\n  builder.storeCoins(params.forwardAmount ?? 1n);\n\n  // Forward payload (optional)\n  if (params.forwardPayload) {\n    builder.storeBit(true).storeRef(params.forwardPayload);\n  } else {\n    builder.storeBit(false);\n  }\n\n  return builder.endCell();\n}\n\n/**\n * Parse Jetton transfer message from Cell\n *\n * @param body - Cell containing the message\n * @returns Parsed transfer parameters\n * @throws Error if not a valid Jetton transfer message\n */\nexport function parseJettonTransferBody(body: Cell): {\n  op: number;\n  queryId: bigint;\n  amount: bigint;\n  destination: Address;\n  responseDestination: Address;\n  forwardAmount: bigint;\n  forwardPayload?: Cell;\n} {\n  const slice = body.beginParse();\n\n  const op = slice.loadUint(32);\n  if (op !== JETTON_TRANSFER_OP) {\n    throw new Error(`Not a Jetton transfer message. Expected op ${JETTON_TRANSFER_OP}, got ${op}`);\n  }\n\n  const queryId = slice.loadUintBig(64);\n  const amount = slice.loadCoins();\n  const destination = slice.loadAddress();\n  const responseDestination = slice.loadAddress();\n\n  // Skip custom_payload bit\n  const hasCustomPayload = slice.loadBit();\n  if (hasCustomPayload) {\n    slice.loadRef(); // Skip custom payload\n  }\n\n  const forwardAmount = slice.loadCoins();\n\n  // Forward payload\n  const hasForwardPayload = slice.loadBit();\n  const forwardPayload = hasForwardPayload ? slice.loadRef() : undefined;\n\n  return {\n    op,\n    queryId,\n    amount,\n    destination,\n    responseDestination,\n    forwardAmount,\n    forwardPayload,\n  };\n}\n\n/**\n * Calculate estimated gas for Jetton transfer\n * Based on typical TON network fees\n *\n * @param params - Optional parameters for estimation\n * @returns Estimated gas in nanoTON\n */\nexport function estimateJettonTransferGas(_params?: {\n  hasForwardPayload?: boolean;\n}): bigint {\n  // Base cost for Jetton transfer (typical)\n  // Includes: external message, wallet internal message, Jetton wallet message\n  return 100_000_000n; // 0.1 TON (conservative estimate)\n}\n","/**\n * TON Server Scheme Implementation\n *\n * Handles price parsing and payment requirement enhancement for\n * TON Jetton payments using the exact scheme.\n */\n\nimport type {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT } from \"../../constants.js\";\nimport {\n  getDefaultJetton,\n  getJettonConfig,\n  getJettonByAddress,\n  JETTON_REGISTRY,\n} from \"../../tokens.js\";\nimport { normalizeNetwork } from \"../../utils.js\";\n\n/**\n * Configuration options for ExactTonScheme server\n */\nexport interface ExactTonSchemeConfig {\n  /** Preferred Jetton symbol (e.g., \"USDT\"). Defaults to network's highest priority token. */\n  preferredJetton?: string;\n}\n\n/**\n * TON server implementation for the Exact payment scheme.\n * Handles price parsing and converts user-friendly amounts to Jetton amounts.\n */\nexport class ExactTonScheme implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT;\n  private moneyParsers: MoneyParser[] = [];\n  private config: ExactTonSchemeConfig;\n\n  constructor(config: ExactTonSchemeConfig = {}) {\n    this.config = config;\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   * Multiple parsers can be registered - they will be tried in registration order.\n   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).\n   * If a parser returns null, the next parser in the chain will be tried.\n   * The default parser is always the final fallback.\n   *\n   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n   * @returns The server instance for chaining\n   *\n   * @example\n   * tonServer.registerMoneyParser(async (amount, network) => {\n   *   // Use custom Jetton for large amounts\n   *   if (amount > 1000) {\n   *     return {\n   *       amount: (amount * 1e9).toString(),\n   *       asset: \"EQCustomJettonAddress...\",\n   *       extra: { tier: \"premium\" }\n   *     };\n   *   }\n   *   return null; // Use next parser\n   * });\n   */\n  registerMoneyParser(parser: MoneyParser): ExactTonScheme {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parses a price into an asset amount.\n   * If price is already an AssetAmount, returns it directly.\n   * If price is Money (string | number), parses to decimal and tries custom parsers.\n   * Falls back to default conversion if all custom parsers return null.\n   *\n   * @param price - The price to parse\n   * @param network - The network to use\n   * @returns Promise that resolves to the parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // Normalize network to CAIP-2 format\n    const normalizedNetwork = normalizeNetwork(network);\n\n    // If already an AssetAmount, return it directly\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      if (!price.asset) {\n        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      };\n    }\n\n    // Parse Money to decimal number\n    const amount = this.parseMoneyToDecimal(price);\n\n    // Try each custom money parser in order\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, normalizedNetwork);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, normalizedNetwork);\n  }\n\n  /**\n   * Build payment requirements for this scheme/network combination.\n   * Adds TON-specific fields like gas sponsor if provided by facilitator.\n   *\n   * @param paymentRequirements - Base payment requirements with amount/asset already set\n   * @param supportedKind - The supported kind from facilitator's /supported endpoint\n   * @param extensionKeys - Extensions supported by the facilitator (unused)\n   * @returns Enhanced payment requirements ready to be sent to clients\n   */\n  async enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      t402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    // Mark unused parameters to satisfy linter\n    void extensionKeys;\n\n    // Start with existing extra fields\n    const extra = { ...paymentRequirements.extra };\n\n    // Add gas sponsor from facilitator if provided\n    if (supportedKind.extra?.gasSponsor) {\n      extra.gasSponsor = supportedKind.extra.gasSponsor;\n    }\n\n    return {\n      ...paymentRequirements,\n      extra,\n    };\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   * Handles formats like \"$1.50\", \"1.50\", 1.50, etc.\n   *\n   * @param money - The money value to parse\n   * @returns Decimal number\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      return money;\n    }\n\n    // Remove $ sign and whitespace, then parse\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n\n    return amount;\n  }\n\n  /**\n   * Default money conversion implementation.\n   * Converts decimal amount to the preferred Jetton on the specified network.\n   *\n   * @param amount - The decimal amount (e.g., 1.50)\n   * @param network - The network to use\n   * @returns The parsed asset amount\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const jetton = this.getDefaultAsset(network);\n\n    // Convert decimal amount to token amount\n    const tokenAmount = this.convertToTokenAmount(amount.toString(), jetton.decimals);\n\n    return {\n      amount: tokenAmount,\n      asset: jetton.masterAddress,\n      extra: {\n        symbol: jetton.symbol,\n        name: jetton.name,\n        decimals: jetton.decimals,\n      },\n    };\n  }\n\n  /**\n   * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal tokens)\n   *\n   * @param decimalAmount - The decimal amount to convert\n   * @param decimals - Number of decimals for the token\n   * @returns The token amount as a string\n   */\n  private convertToTokenAmount(decimalAmount: string, decimals: number): string {\n    const amount = parseFloat(decimalAmount);\n    if (isNaN(amount)) {\n      throw new Error(`Invalid amount: ${decimalAmount}`);\n    }\n    // Convert to smallest unit (e.g., for USDT with 6 decimals: 0.10 * 10^6 = 100000)\n    const tokenAmount = Math.floor(amount * Math.pow(10, decimals));\n    return tokenAmount.toString();\n  }\n\n  /**\n   * Get the default asset info for a network.\n   * Priority: configured preferredJetton > USDT > first available\n   *\n   * @param network - The network to get asset info for\n   * @returns The Jetton configuration\n   */\n  private getDefaultAsset(\n    network: Network,\n  ): { masterAddress: string; symbol: string; name: string; decimals: number } {\n    // If a preferred Jetton is configured, try to use it\n    if (this.config.preferredJetton) {\n      const preferred = getJettonConfig(network, this.config.preferredJetton);\n      if (preferred) return preferred;\n    }\n\n    // Use the network's default token (sorted by priority)\n    const defaultJetton = getDefaultJetton(network);\n    if (defaultJetton) return defaultJetton;\n\n    throw new Error(`No Jettons configured for network ${network}`);\n  }\n\n  /**\n   * Get Jetton info for a given symbol on a network\n   *\n   * @param symbol - The Jetton symbol (e.g., \"USDT\")\n   * @param network - The network to use\n   * @returns The Jetton configuration\n   */\n  private getAssetInfo(\n    symbol: string,\n    network: Network,\n  ): { masterAddress: string; symbol: string; name: string; decimals: number } {\n    const jetton = getJettonConfig(network, symbol);\n    if (jetton) return jetton;\n\n    // Fallback: treat \"USD\" as request for default stablecoin\n    if (symbol.toUpperCase() === \"USD\") {\n      return this.getDefaultAsset(network);\n    }\n\n    throw new Error(`Unsupported Jetton: ${symbol} on network ${network}`);\n  }\n\n  /**\n   * Get the number of decimals for a Jetton on a network\n   *\n   * @param network - The network to use\n   * @param jettonAddress - Optional Jetton address to look up\n   * @returns The number of decimals for the Jetton\n   */\n  private getAssetDecimals(network: Network, jettonAddress?: string): number {\n    if (jettonAddress) {\n      const jetton = getJettonByAddress(network, jettonAddress);\n      if (jetton) return jetton.decimals;\n    }\n    // Default to 6 decimals (USDT standard)\n    return 6;\n  }\n\n  /**\n   * Get all supported networks\n   */\n  static getSupportedNetworks(): string[] {\n    return Object.keys(JETTON_REGISTRY);\n  }\n\n  /**\n   * Check if a network is supported\n   */\n  static isNetworkSupported(network: string): boolean {\n    return network in JETTON_REGISTRY;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcO,IAAM,oBAAoB;AAC1B,IAAM,oBAAoB;AAK1B,IAAM,eAAe,CAAC,mBAAmB,iBAAiB;AAO1D,IAAM,uBAAuB;AAC7B,IAAM,uBAAuB;AAK7B,IAAM,0BAA0B;AAChC,IAAM,0BAA0B;AAKhC,IAAM,oBAA4C;AAAA,EACvD,CAAC,iBAAiB,GAAG;AAAA,EACrB,CAAC,iBAAiB,GAAG;AACvB;AAEO,IAAM,uBAA+C;AAAA,EAC1D,CAAC,iBAAiB,GAAG;AAAA,EACrB,CAAC,iBAAiB,GAAG;AACvB;AA2BO,IAAM,eAAe;;;ACpCrB,IAAM,iBAAyC;AAAA;AAAA,EAEpD,CAAC,iBAAiB,GAAG;AAAA;AAAA,EAErB,CAAC,iBAAiB,GAAG;AACvB;AAKO,IAAM,kBAAyC;AAAA;AAAA,EAEpD,CAAC,iBAAiB,GAAG;AAAA,IACnB,MAAM;AAAA,MACJ,eAAe,eAAe,iBAAiB;AAAA,MAC/C,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AAAA;AAAA,EAGA,CAAC,iBAAiB,GAAG;AAAA,IACnB,MAAM;AAAA,MACJ,eAAe,eAAe,iBAAiB;AAAA,MAC/C,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AACF;AASO,SAAS,gBAAgB,SAAiB,QAA0C;AACzF,SAAO,gBAAgB,OAAO,IAAI,OAAO,YAAY,CAAC;AACxD;AAQO,SAAS,kBAAkB,SAAiC;AACjE,QAAM,UAAU,gBAAgB,OAAO;AACvC,MAAI,CAAC,QAAS,QAAO,CAAC;AACtB,SAAO,OAAO,OAAO,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AACtE;AASO,SAAS,iBAAiB,SAA2C;AAC1E,QAAM,UAAU,kBAAkB,OAAO;AACzC,SAAO,QAAQ,CAAC;AAClB;AASO,SAAS,mBAAmB,SAAiB,SAA2C;AAC7F,QAAM,UAAU,gBAAgB,OAAO;AACvC,MAAI,CAAC,QAAS,QAAO;AAGrB,SAAO,OAAO,OAAO,OAAO,EAAE;AAAA,IAC5B,CAAC,MAAM,EAAE,cAAc,YAAY,MAAM,QAAQ,YAAY;AAAA,EAC/D;AACF;;;ACnHA,kBAAyC;AAiBlC,SAAS,iBAAiB,SAA2B;AAE1D,MAAI,QAAQ,WAAW,MAAM,GAAG;AAC9B,QAAI,CAAC,aAAa,SAAS,OAAwC,GAAG;AACpE,YAAM,IAAI,MAAM,4BAA4B,OAAO,EAAE;AAAA,IACvD;AACA,WAAO;AAAA,EACT;AAGA,QAAM,UAAmC;AAAA,IACvC,KAAK;AAAA,IACL,eAAe;AAAA,IACf,SAAS;AAAA,IACT,eAAe;AAAA,IACf,SAAS;AAAA,EACX;AAEA,QAAM,QAAQ,QAAQ,QAAQ,YAAY,CAAC;AAC3C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,4BAA4B,OAAO,EAAE;AAAA,EACvD;AACA,SAAO;AACT;;;ACXO,IAAM,iBAAN,MAAoD;AAAA,EAKzD,YAAY,SAA+B,CAAC,GAAG;AAJ/C,SAAS,SAAS;AAClB,SAAQ,eAA8B,CAAC;AAIrC,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,oBAAoB,QAAqC;AACvD,SAAK,aAAa,KAAK,MAAM;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,WAAW,OAAc,SAAwC;AAErE,UAAM,oBAAoB,iBAAiB,OAAO;AAGlD,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,YAAY,OAAO;AACpE,UAAI,CAAC,MAAM,OAAO;AAChB,cAAM,IAAI,MAAM,8DAA8D,OAAO,EAAE;AAAA,MACzF;AACA,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,OAAO,MAAM,SAAS,CAAC;AAAA,MACzB;AAAA,IACF;AAGA,UAAM,SAAS,KAAK,oBAAoB,KAAK;AAG7C,eAAW,UAAU,KAAK,cAAc;AACtC,YAAM,SAAS,MAAM,OAAO,QAAQ,iBAAiB;AACrD,UAAI,WAAW,MAAM;AACnB,eAAO;AAAA,MACT;AAAA,IACF;AAGA,WAAO,KAAK,uBAAuB,QAAQ,iBAAiB;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,2BACJ,qBACA,eAMA,eAC8B;AAE9B,SAAK;AAGL,UAAM,QAAQ,EAAE,GAAG,oBAAoB,MAAM;AAG7C,QAAI,cAAc,OAAO,YAAY;AACnC,YAAM,aAAa,cAAc,MAAM;AAAA,IACzC;AAEA,WAAO;AAAA,MACL,GAAG;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,oBAAoB,OAAgC;AAC1D,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO;AAAA,IACT;AAGA,UAAM,aAAa,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAK;AACjD,UAAM,SAAS,WAAW,UAAU;AAEpC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,yBAAyB,KAAK,EAAE;AAAA,IAClD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,uBAAuB,QAAgB,SAA+B;AAC5E,UAAM,SAAS,KAAK,gBAAgB,OAAO;AAG3C,UAAM,cAAc,KAAK,qBAAqB,OAAO,SAAS,GAAG,OAAO,QAAQ;AAEhF,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO,OAAO;AAAA,MACd,OAAO;AAAA,QACL,QAAQ,OAAO;AAAA,QACf,MAAM,OAAO;AAAA,QACb,UAAU,OAAO;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,qBAAqB,eAAuB,UAA0B;AAC5E,UAAM,SAAS,WAAW,aAAa;AACvC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,mBAAmB,aAAa,EAAE;AAAA,IACpD;AAEA,UAAM,cAAc,KAAK,MAAM,SAAS,KAAK,IAAI,IAAI,QAAQ,CAAC;AAC9D,WAAO,YAAY,SAAS;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,gBACN,SAC2E;AAE3E,QAAI,KAAK,OAAO,iBAAiB;AAC/B,YAAM,YAAY,gBAAgB,SAAS,KAAK,OAAO,eAAe;AACtE,UAAI,UAAW,QAAO;AAAA,IACxB;AAGA,UAAM,gBAAgB,iBAAiB,OAAO;AAC9C,QAAI,cAAe,QAAO;AAE1B,UAAM,IAAI,MAAM,qCAAqC,OAAO,EAAE;AAAA,EAChE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,aACN,QACA,SAC2E;AAC3E,UAAM,SAAS,gBAAgB,SAAS,MAAM;AAC9C,QAAI,OAAQ,QAAO;AAGnB,QAAI,OAAO,YAAY,MAAM,OAAO;AAClC,aAAO,KAAK,gBAAgB,OAAO;AAAA,IACrC;AAEA,UAAM,IAAI,MAAM,uBAAuB,MAAM,eAAe,OAAO,EAAE;AAAA,EACvE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,iBAAiB,SAAkB,eAAgC;AACzE,QAAI,eAAe;AACjB,YAAM,SAAS,mBAAmB,SAAS,aAAa;AACxD,UAAI,OAAQ,QAAO,OAAO;AAAA,IAC5B;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,uBAAiC;AACtC,WAAO,OAAO,KAAK,eAAe;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,mBAAmB,SAA0B;AAClD,WAAO,WAAW;AAAA,EACpB;AACF;","names":[]}