@t402/ton 2.1.0 → 2.3.0

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

@@ -1,5 +1,5 @@
 import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@t402/core/types';
-import { C as ClientTonSigner } from '../../signer-CFiw2DST.js';
+import { C as ClientTonSigner } from '../../signer-Bqn2K0b4.js';
 import { t402Client, PaymentPolicy } from '@t402/core/client';
 import '@ton/core';
 
@@ -48,7 +48,7 @@ declare class ExactTonScheme implements SchemeNetworkClient {
      * @param paymentRequirements - The payment requirements
      * @returns Promise resolving to a payment payload
      */
-    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, 't402Version' | 'payload'>>;
 }
 
 /**

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

@@ -3,6 +3,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -16,6 +17,7 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/exact/client/index.ts
 var client_exports = {};
@@ -103,7 +105,7 @@ var ExactTonScheme = class {
     this.signer = signer;
     this.getJettonWalletAddress = getJettonWalletAddress;
     this.config = config;
-    this.scheme = SCHEME_EXACT;
+    __publicField(this, "scheme", SCHEME_EXACT);
   }
   /**
    * Creates a payment payload for the Exact scheme.

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/exact/client/index.ts","../../../../src/exact/client/scheme.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/exact/client/register.ts"],"sourcesContent":["export { ExactTonScheme } from \"./scheme.js\";\nexport type { ExactTonSchemeConfig } from \"./scheme.js\";\nexport { registerExactTonScheme } from \"./register.js\";\nexport type { TonClientConfig } from \"./register.js\";\n","/**\n * TON Client Scheme Implementation\n *\n * Creates payment payloads for TON Jetton transfers using the exact scheme.\n * Builds and signs external messages for Jetton wallet interactions.\n */\n\nimport { Address, SendMode } from \"@ton/core\";\nimport type { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from \"@t402/core/types\";\nimport type { ClientTonSigner } from \"../../signer.js\";\nimport type { ExactTonPayloadV2 } from \"../../types.js\";\nimport { SCHEME_EXACT, DEFAULT_JETTON_TRANSFER_TON, DEFAULT_FORWARD_TON } from \"../../constants.js\";\nimport {\n  generateQueryId,\n  buildJettonTransferBody,\n  normalizeNetwork,\n  parseTonAddress,\n} from \"../../utils.js\";\n\n/**\n * Configuration for ExactTonScheme client\n */\nexport interface ExactTonSchemeConfig {\n  /** Override the TON amount attached for gas (in nanoTON) */\n  gasAmount?: bigint;\n  /** Override the forward TON amount (in nanoTON) */\n  forwardAmount?: bigint;\n}\n\n/**\n * TON client implementation for the Exact payment scheme.\n *\n * Creates signed Jetton transfer messages that can be broadcast\n * by a facilitator to complete the payment.\n */\nexport class ExactTonScheme implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT;\n\n  /**\n   * Creates a new ExactTonScheme instance.\n   *\n   * @param signer - The TON signer for client operations\n   * @param getJettonWalletAddress - Function to derive Jetton wallet address\n   * @param config - Optional configuration overrides\n   */\n  constructor(\n    private readonly signer: ClientTonSigner,\n    private readonly getJettonWalletAddress: (\n      ownerAddress: string,\n      jettonMasterAddress: string,\n    ) => Promise<string>,\n    private readonly config: ExactTonSchemeConfig = {},\n  ) {}\n\n  /**\n   * Creates a payment payload for the Exact scheme.\n   *\n   * The payload contains a pre-signed external message that performs\n   * a Jetton transfer from the client to the recipient.\n   *\n   * @param t402Version - The t402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<Pick<PaymentPayload, \"t402Version\" | \"payload\">> {\n    // Normalize and validate network\n    const network = normalizeNetwork(paymentRequirements.network);\n\n    // Validate required fields\n    if (!paymentRequirements.asset) {\n      throw new Error(\"Asset (Jetton master address) is required\");\n    }\n    if (!paymentRequirements.payTo) {\n      throw new Error(\"PayTo address is required\");\n    }\n    if (!paymentRequirements.amount) {\n      throw new Error(\"Amount is required\");\n    }\n\n    // Parse addresses\n    const jettonMasterAddress = paymentRequirements.asset;\n    const destinationAddress = parseTonAddress(paymentRequirements.payTo);\n\n    // Get client's Jetton wallet address\n    const senderJettonWalletAddress = await this.getJettonWalletAddress(\n      this.signer.address.toString(),\n      jettonMasterAddress,\n    );\n    const senderJettonWallet = Address.parse(senderJettonWalletAddress);\n\n    // Get current seqno for replay protection\n    const seqno = await this.signer.getSeqno();\n\n    // Calculate validity period\n    const now = Math.floor(Date.now() / 1000);\n    const validUntil = now + paymentRequirements.maxTimeoutSeconds;\n\n    // Generate unique query ID\n    const queryId = generateQueryId();\n\n    // Parse amount\n    const jettonAmount = BigInt(paymentRequirements.amount);\n\n    // Build Jetton transfer body\n    const jettonTransferBody = buildJettonTransferBody({\n      queryId,\n      amount: jettonAmount,\n      destination: destinationAddress,\n      responseDestination: this.signer.address,\n      forwardAmount: this.config.forwardAmount ?? DEFAULT_FORWARD_TON,\n    });\n\n    // Gas amount for the transfer\n    const tonAmount = this.config.gasAmount ?? DEFAULT_JETTON_TRANSFER_TON;\n\n    // Sign the message\n    const signedMessage = await this.signer.signMessage({\n      to: senderJettonWallet,\n      value: tonAmount,\n      body: jettonTransferBody,\n      sendMode: SendMode.PAY_GAS_SEPARATELY,\n      timeout: paymentRequirements.maxTimeoutSeconds,\n    });\n\n    // Encode to base64\n    const signedBoc = signedMessage.toBoc().toString(\"base64\");\n\n    // Build authorization metadata\n    const authorization: ExactTonPayloadV2[\"authorization\"] = {\n      from: this.signer.address.toString({ bounceable: true }),\n      to: paymentRequirements.payTo,\n      jettonMaster: jettonMasterAddress,\n      jettonAmount: jettonAmount.toString(),\n      tonAmount: tonAmount.toString(),\n      validUntil,\n      seqno,\n      queryId: queryId.toString(),\n    };\n\n    // Create payload\n    const payload: ExactTonPayloadV2 = {\n      signedBoc,\n      authorization,\n    };\n\n    // Mark network as used\n    void network;\n\n    return {\n      t402Version,\n      payload,\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","import { t402Client, PaymentPolicy } from \"@t402/core/client\";\nimport { Network } from \"@t402/core/types\";\nimport { ClientTonSigner } from \"../../signer.js\";\nimport { ExactTonScheme, ExactTonSchemeConfig } from \"./scheme.js\";\nimport { TON_NETWORKS } from \"../../constants.js\";\n\n/**\n * Configuration options for registering TON schemes to an t402Client\n */\nexport interface TonClientConfig {\n  /**\n   * The TON signer to use for creating payment payloads\n   */\n  signer: ClientTonSigner;\n\n  /**\n   * Function to get Jetton wallet address for a given owner and Jetton master\n   * This is required for building Jetton transfer messages\n   */\n  getJettonWalletAddress: (ownerAddress: string, jettonMasterAddress: string) => Promise<string>;\n\n  /**\n   * Optional policies to apply to the client\n   */\n  policies?: PaymentPolicy[];\n\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (ton:*)\n   */\n  networks?: Network[];\n\n  /**\n   * Optional scheme configuration (gas amounts, etc.)\n   */\n  schemeConfig?: ExactTonSchemeConfig;\n}\n\n/**\n * Registers TON exact payment schemes to an t402Client instance.\n *\n * This function registers:\n * - V2: ton:* wildcard scheme with ExactTonScheme (or specific networks if provided)\n *\n * @param client - The t402Client instance to register schemes to\n * @param config - Configuration for TON client registration\n * @returns The client instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactTonScheme } from \"@t402/ton/exact/client/register\";\n * import { t402Client } from \"@t402/core/client\";\n * import { TonClient } from \"@ton/ton\";\n *\n * const tonClient = new TonClient({ endpoint: \"...\" });\n * const wallet = WalletContractV4.create({ ... });\n *\n * const client = new t402Client();\n * registerExactTonScheme(client, {\n *   signer: toClientTonSigner(wallet, tonClient),\n *   getJettonWalletAddress: async (owner, master) => {\n *     // Derive Jetton wallet address\n *     return jettonWalletAddress;\n *   }\n * });\n * ```\n */\nexport function registerExactTonScheme(client: t402Client, config: TonClientConfig): t402Client {\n  const scheme = new ExactTonScheme(\n    config.signer,\n    config.getJettonWalletAddress,\n    config.schemeConfig,\n  );\n\n  // Register V2 scheme\n  if (config.networks && config.networks.length > 0) {\n    // Register specific networks\n    config.networks.forEach(network => {\n      client.register(network, scheme);\n    });\n  } else {\n    // Register wildcard for all TON networks\n    client.register(\"ton:*\", scheme);\n  }\n\n  // Apply policies if provided\n  if (config.policies) {\n    config.policies.forEach(policy => {\n      client.registerPolicy(policy);\n    });\n  }\n\n  return client;\n}\n"],"mappings":"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","names":["import_core"]}
+{"version":3,"sources":["../../../../src/exact/client/index.ts","../../../../src/exact/client/scheme.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/exact/client/register.ts"],"sourcesContent":["export { ExactTonScheme } from './scheme.js'\nexport type { ExactTonSchemeConfig } from './scheme.js'\nexport { registerExactTonScheme } from './register.js'\nexport type { TonClientConfig } from './register.js'\n","/**\n * TON Client Scheme Implementation\n *\n * Creates payment payloads for TON Jetton transfers using the exact scheme.\n * Builds and signs external messages for Jetton wallet interactions.\n */\n\nimport { Address, SendMode } from '@ton/core'\nimport type { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from '@t402/core/types'\nimport type { ClientTonSigner } from '../../signer.js'\nimport type { ExactTonPayloadV2 } from '../../types.js'\nimport { SCHEME_EXACT, DEFAULT_JETTON_TRANSFER_TON, DEFAULT_FORWARD_TON } from '../../constants.js'\nimport {\n  generateQueryId,\n  buildJettonTransferBody,\n  normalizeNetwork,\n  parseTonAddress,\n} from '../../utils.js'\n\n/**\n * Configuration for ExactTonScheme client\n */\nexport interface ExactTonSchemeConfig {\n  /** Override the TON amount attached for gas (in nanoTON) */\n  gasAmount?: bigint\n  /** Override the forward TON amount (in nanoTON) */\n  forwardAmount?: bigint\n}\n\n/**\n * TON client implementation for the Exact payment scheme.\n *\n * Creates signed Jetton transfer messages that can be broadcast\n * by a facilitator to complete the payment.\n */\nexport class ExactTonScheme implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT\n\n  /**\n   * Creates a new ExactTonScheme instance.\n   *\n   * @param signer - The TON signer for client operations\n   * @param getJettonWalletAddress - Function to derive Jetton wallet address\n   * @param config - Optional configuration overrides\n   */\n  constructor(\n    private readonly signer: ClientTonSigner,\n    private readonly getJettonWalletAddress: (\n      ownerAddress: string,\n      jettonMasterAddress: string,\n    ) => Promise<string>,\n    private readonly config: ExactTonSchemeConfig = {},\n  ) {}\n\n  /**\n   * Creates a payment payload for the Exact scheme.\n   *\n   * The payload contains a pre-signed external message that performs\n   * a Jetton transfer from the client to the recipient.\n   *\n   * @param t402Version - The t402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<Pick<PaymentPayload, 't402Version' | 'payload'>> {\n    // Normalize and validate network\n    const network = normalizeNetwork(paymentRequirements.network)\n\n    // Validate required fields\n    if (!paymentRequirements.asset) {\n      throw new Error('Asset (Jetton master address) is required')\n    }\n    if (!paymentRequirements.payTo) {\n      throw new Error('PayTo address is required')\n    }\n    if (!paymentRequirements.amount) {\n      throw new Error('Amount is required')\n    }\n\n    // Parse addresses\n    const jettonMasterAddress = paymentRequirements.asset\n    const destinationAddress = parseTonAddress(paymentRequirements.payTo)\n\n    // Get client's Jetton wallet address\n    const senderJettonWalletAddress = await this.getJettonWalletAddress(\n      this.signer.address.toString(),\n      jettonMasterAddress,\n    )\n    const senderJettonWallet = Address.parse(senderJettonWalletAddress)\n\n    // Get current seqno for replay protection\n    const seqno = await this.signer.getSeqno()\n\n    // Calculate validity period\n    const now = Math.floor(Date.now() / 1000)\n    const validUntil = now + paymentRequirements.maxTimeoutSeconds\n\n    // Generate unique query ID\n    const queryId = generateQueryId()\n\n    // Parse amount\n    const jettonAmount = BigInt(paymentRequirements.amount)\n\n    // Build Jetton transfer body\n    const jettonTransferBody = buildJettonTransferBody({\n      queryId,\n      amount: jettonAmount,\n      destination: destinationAddress,\n      responseDestination: this.signer.address,\n      forwardAmount: this.config.forwardAmount ?? DEFAULT_FORWARD_TON,\n    })\n\n    // Gas amount for the transfer\n    const tonAmount = this.config.gasAmount ?? DEFAULT_JETTON_TRANSFER_TON\n\n    // Sign the message\n    const signedMessage = await this.signer.signMessage({\n      to: senderJettonWallet,\n      value: tonAmount,\n      body: jettonTransferBody,\n      sendMode: SendMode.PAY_GAS_SEPARATELY,\n      timeout: paymentRequirements.maxTimeoutSeconds,\n    })\n\n    // Encode to base64\n    const signedBoc = signedMessage.toBoc().toString('base64')\n\n    // Build authorization metadata\n    const authorization: ExactTonPayloadV2['authorization'] = {\n      from: this.signer.address.toString({ bounceable: true }),\n      to: paymentRequirements.payTo,\n      jettonMaster: jettonMasterAddress,\n      jettonAmount: jettonAmount.toString(),\n      tonAmount: tonAmount.toString(),\n      validUntil,\n      seqno,\n      queryId: queryId.toString(),\n    }\n\n    // Create payload\n    const payload: ExactTonPayloadV2 = {\n      signedBoc,\n      authorization,\n    }\n\n    // Mark network as used\n    void network\n\n    return {\n      t402Version,\n      payload,\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?: { hasForwardPayload?: boolean }): 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","import { t402Client, PaymentPolicy } from '@t402/core/client'\nimport { Network } from '@t402/core/types'\nimport { ClientTonSigner } from '../../signer.js'\nimport { ExactTonScheme, ExactTonSchemeConfig } from './scheme.js'\n\n/**\n * Configuration options for registering TON schemes to an t402Client\n */\nexport interface TonClientConfig {\n  /**\n   * The TON signer to use for creating payment payloads\n   */\n  signer: ClientTonSigner\n\n  /**\n   * Function to get Jetton wallet address for a given owner and Jetton master\n   * This is required for building Jetton transfer messages\n   */\n  getJettonWalletAddress: (ownerAddress: string, jettonMasterAddress: string) => Promise<string>\n\n  /**\n   * Optional policies to apply to the client\n   */\n  policies?: PaymentPolicy[]\n\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (ton:*)\n   */\n  networks?: Network[]\n\n  /**\n   * Optional scheme configuration (gas amounts, etc.)\n   */\n  schemeConfig?: ExactTonSchemeConfig\n}\n\n/**\n * Registers TON exact payment schemes to an t402Client instance.\n *\n * This function registers:\n * - V2: ton:* wildcard scheme with ExactTonScheme (or specific networks if provided)\n *\n * @param client - The t402Client instance to register schemes to\n * @param config - Configuration for TON client registration\n * @returns The client instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactTonScheme } from \"@t402/ton/exact/client/register\";\n * import { t402Client } from \"@t402/core/client\";\n * import { TonClient } from \"@ton/ton\";\n *\n * const tonClient = new TonClient({ endpoint: \"...\" });\n * const wallet = WalletContractV4.create({ ... });\n *\n * const client = new t402Client();\n * registerExactTonScheme(client, {\n *   signer: toClientTonSigner(wallet, tonClient),\n *   getJettonWalletAddress: async (owner, master) => {\n *     // Derive Jetton wallet address\n *     return jettonWalletAddress;\n *   }\n * });\n * ```\n */\nexport function registerExactTonScheme(client: t402Client, config: TonClientConfig): t402Client {\n  const scheme = new ExactTonScheme(\n    config.signer,\n    config.getJettonWalletAddress,\n    config.schemeConfig,\n  )\n\n  // Register V2 scheme\n  if (config.networks && config.networks.length > 0) {\n    // Register specific networks\n    config.networks.forEach((network) => {\n      client.register(network, scheme)\n    })\n  } else {\n    // Register wildcard for all TON networks\n    client.register('ton:*', scheme)\n  }\n\n  // Apply policies if provided\n  if (config.policies) {\n    config.policies.forEach((policy) => {\n      client.registerPolicy(policy)\n    })\n  }\n\n  return client\n}\n"],"mappings":"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","names":["import_core"]}

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

@@ -1,5 +1,5 @@
 import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@t402/core/types';
-import { F as FacilitatorTonSigner } from '../../signer-CFiw2DST.js';
+import { F as FacilitatorTonSigner } from '../../signer-Bqn2K0b4.js';
 import { t402Facilitator } from '@t402/core/facilitator';
 import '@ton/core';
 

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

@@ -3,6 +3,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -16,6 +17,7 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/exact/facilitator/index.ts
 var facilitator_exports = {};
@@ -88,8 +90,9 @@ var ExactTonScheme = class {
    */
   constructor(signer, config = {}) {
     this.signer = signer;
-    this.scheme = SCHEME_EXACT;
-    this.caipFamily = "ton:*";
+    __publicField(this, "scheme", SCHEME_EXACT);
+    __publicField(this, "caipFamily", "ton:*");
+    __publicField(this, "config");
     this.config = config;
   }
   /**
@@ -139,6 +142,13 @@ var ExactTonScheme = class {
    */
   async verify(payload, requirements) {
     const tonPayload = payload.payload;
+    if (!tonPayload?.authorization?.from || !tonPayload?.signedBoc) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_payload_structure",
+        payer: ""
+      };
+    }
     const authorization = tonPayload.authorization;
     if (payload.accepted.scheme !== SCHEME_EXACT || requirements.scheme !== SCHEME_EXACT) {
       return {
@@ -279,6 +289,15 @@ var ExactTonScheme = class {
    */
   async settle(payload, requirements) {
     const tonPayload = payload.payload;
+    if (!tonPayload?.authorization?.from || !tonPayload?.signedBoc) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: "invalid_payload_structure",
+        payer: ""
+      };
+    }
     const verifyResult = await this.verify(payload, requirements);
     if (!verifyResult.isValid) {
       return {

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/exact/facilitator/index.ts","../../../../src/exact/facilitator/scheme.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/exact/facilitator/register.ts"],"sourcesContent":["export { ExactTonScheme } from \"./scheme.js\";\nexport type { ExactTonSchemeConfig } from \"./scheme.js\";\nexport { registerExactTonScheme } from \"./register.js\";\nexport type { TonFacilitatorConfig } from \"./register.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","import { t402Facilitator } from \"@t402/core/facilitator\";\nimport { Network } from \"@t402/core/types\";\nimport { FacilitatorTonSigner } from \"../../signer.js\";\nimport { ExactTonScheme, ExactTonSchemeConfig } from \"./scheme.js\";\n\n/**\n * Configuration options for registering TON schemes to an t402Facilitator\n */\nexport interface TonFacilitatorConfig {\n  /**\n   * The TON signer for facilitator operations (verify and settle)\n   */\n  signer: FacilitatorTonSigner;\n\n  /**\n   * Networks to register (single network or array of networks)\n   * Examples: \"ton:mainnet\", [\"ton:mainnet\", \"ton:testnet\"]\n   */\n  networks: Network | Network[];\n\n  /**\n   * Optional scheme configuration (gas sponsorship, etc.)\n   */\n  schemeConfig?: ExactTonSchemeConfig;\n}\n\n/**\n * Registers TON exact payment schemes to an t402Facilitator instance.\n *\n * This function registers:\n * - V2: Specified networks with ExactTonScheme\n *\n * @param facilitator - The t402Facilitator instance to register schemes to\n * @param config - Configuration for TON facilitator registration\n * @returns The facilitator instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactTonScheme } from \"@t402/ton/exact/facilitator/register\";\n * import { t402Facilitator } from \"@t402/core/facilitator\";\n * import { TonClient } from \"@ton/ton\";\n *\n * const tonClient = new TonClient({ endpoint: \"...\" });\n * const facilitator = new t402Facilitator();\n *\n * // Single network\n * registerExactTonScheme(facilitator, {\n *   signer: toFacilitatorTonSigner(tonClient),\n *   networks: \"ton:mainnet\"\n * });\n *\n * // Multiple networks\n * registerExactTonScheme(facilitator, {\n *   signer: toFacilitatorTonSigner(tonClient),\n *   networks: [\"ton:mainnet\", \"ton:testnet\"]\n * });\n *\n * // With gas sponsorship\n * registerExactTonScheme(facilitator, {\n *   signer: toFacilitatorTonSigner(tonClient),\n *   networks: \"ton:mainnet\",\n *   schemeConfig: { canSponsorGas: true }\n * });\n * ```\n */\nexport function registerExactTonScheme(\n  facilitator: t402Facilitator,\n  config: TonFacilitatorConfig,\n): t402Facilitator {\n  // Register V2 scheme with specified networks\n  facilitator.register(config.networks, new ExactTonScheme(config.signer, config.schemeConfig));\n\n  return facilitator;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOA,IAAAA,eAAqB;;;ACOd,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;;;ACnE5B,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;AAkEO,SAAS,eAAe,OAAe,OAAwB;AACpE,MAAI;AACF,UAAM,KAAK,oBAAQ,MAAM,KAAK;AAC9B,UAAM,KAAK,oBAAQ,MAAM,KAAK;AAC9B,WAAO,GAAG,OAAO,EAAE;AAAA,EACrB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;AFvFO,IAAM,iBAAN,MAAyD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAW9D,YACmB,QACjB,SAA+B,CAAC,GAChC;AAFiB;AAXnB,SAAS,SAAS;AAClB,SAAS,aAAa;AAapB,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,SAAS,SAAsD;AAC7D,SAAK;AAEL,QAAI,KAAK,OAAO,eAAe;AAC7B,YAAM,YAAY,KAAK,OAAO,aAAa;AAC3C,UAAI,UAAU,SAAS,GAAG;AACxB,eAAO;AAAA,UACL,YAAY,UAAU,CAAC;AAAA,QACzB;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,SAA2B;AACpC,SAAK;AACL,WAAO,CAAC,GAAG,KAAK,OAAO,aAAa,CAAC;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,aAAa,QAAQ;AAC3B,UAAM,gBAAgB,WAAW;AAGjC,QAAI,QAAQ,SAAS,WAAW,gBAAgB,aAAa,WAAW,cAAc;AACpF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,cAAc;AAAA,MACvB;AAAA,IACF;AAGA,QAAI;AACF,YAAM,iBAAiB,iBAAiB,QAAQ,SAAS,OAAO;AAChE,YAAM,sBAAsB,iBAAiB,aAAa,OAAO;AAEjE,UAAI,mBAAmB,qBAAqB;AAC1C,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf,OAAO,cAAc;AAAA,QACvB;AAAA,MACF;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,cAAc;AAAA,MACvB;AAAA,IACF;AAGA,QAAI;AACF,wBAAK,WAAW,WAAW,SAAS;AAAA,IACtC,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,cAAc;AAAA,MACvB;AAAA,IACF;AAGA,UAAM,eAAe,MAAM,KAAK,OAAO,cAAc;AAAA,MACnD,WAAW,WAAW;AAAA,MACtB,cAAc,cAAc;AAAA,MAC5B,kBAAkB;AAAA,QAChB,cAAc,OAAO,cAAc,YAAY;AAAA,QAC/C,aAAa,aAAa;AAAA,QAC1B,cAAc,aAAa;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,QAAI,CAAC,aAAa,OAAO;AACvB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe,aAAa,UAAU;AAAA,QACtC,OAAO,cAAc;AAAA,MACvB;AAAA,IACF;AAGA,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AACxC,QAAI,cAAc,aAAa,MAAM,IAAI;AACvC,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,cAAc;AAAA,MACvB;AAAA,IACF;AAGA,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,OAAO,iBAAiB;AAAA,QACjD,cAAc,cAAc;AAAA,QAC5B,qBAAqB,aAAa;AAAA,MACpC,CAAC;AAED,UAAI,UAAU,OAAO,aAAa,MAAM,GAAG;AACzC,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf,OAAO,cAAc;AAAA,QACvB;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AAEd,cAAQ,KAAK,oCAAoC,KAAK;AAAA,IACxD;AAGA,QAAI,OAAO,cAAc,YAAY,IAAI,OAAO,aAAa,MAAM,GAAG;AACpE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,cAAc;AAAA,MACvB;AAAA,IACF;AAGA,QAAI,CAAC,eAAe,cAAc,IAAI,aAAa,KAAK,GAAG;AACzD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,cAAc;AAAA,MACvB;AAAA,IACF;AAGA,QAAI,CAAC,eAAe,cAAc,cAAc,aAAa,KAAK,GAAG;AACnE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,cAAc;AAAA,MACvB;AAAA,IACF;AAGA,QAAI;AACF,YAAM,eAAe,MAAM,KAAK,OAAO,SAAS,cAAc,IAAI;AAClE,UAAI,cAAc,QAAQ,cAAc;AACtC,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf,OAAO,cAAc;AAAA,QACvB;AAAA,MACF;AACA,UAAI,cAAc,QAAQ,cAAc;AACtC,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf,OAAO,cAAc;AAAA,QACvB;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,KAAK,2BAA2B,KAAK;AAAA,IAC/C;AAGA,QAAI;AACF,YAAM,aAAa,MAAM,KAAK,OAAO,WAAW,cAAc,IAAI;AAClE,UAAI,CAAC,YAAY;AACf,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf,OAAO,cAAc;AAAA,QACvB;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,KAAK,uCAAuC,KAAK;AAAA,IAC3D;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,eAAe;AAAA,MACf,OAAO,cAAc;AAAA,IACvB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,aAAa,QAAQ;AAG3B,UAAM,eAAe,MAAM,KAAK,OAAO,SAAS,YAAY;AAC5D,QAAI,CAAC,aAAa,SAAS;AACzB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa,aAAa,iBAAiB;AAAA,QAC3C,OAAO,WAAW,cAAc;AAAA,MAClC;AAAA,IACF;AAEA,QAAI;AAEF,YAAM,SAAS,MAAM,KAAK,OAAO,oBAAoB,WAAW,SAAS;AAGzE,YAAM,eAAe,MAAM,KAAK,OAAO,mBAAmB;AAAA,QACxD,SAAS,WAAW,cAAc;AAAA,QAClC,OAAO,WAAW,cAAc,QAAQ;AAAA;AAAA,QACxC,SAAS;AAAA;AAAA,MACX,CAAC;AAED,UAAI,CAAC,aAAa,SAAS;AACzB,eAAO;AAAA,UACL,SAAS;AAAA,UACT,aAAa,aAAa,SAAS;AAAA,UACnC,aAAa;AAAA,UACb,SAAS,QAAQ,SAAS;AAAA,UAC1B,OAAO,WAAW,cAAc;AAAA,QAClC;AAAA,MACF;AAEA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa,aAAa,QAAQ;AAAA,QAClC,SAAS,QAAQ,SAAS;AAAA,QAC1B,OAAO,WAAW,cAAc;AAAA,MAClC;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,qCAAqC,KAAK;AACxD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,aAAa;AAAA,QACb,SAAS,QAAQ,SAAS;AAAA,QAC1B,OAAO,WAAW,cAAc;AAAA,MAClC;AAAA,IACF;AAAA,EACF;AACF;;;AGvQO,SAAS,uBACd,aACA,QACiB;AAEjB,cAAY,SAAS,OAAO,UAAU,IAAI,eAAe,OAAO,QAAQ,OAAO,YAAY,CAAC;AAE5F,SAAO;AACT;","names":["import_core"]}
+{"version":3,"sources":["../../../../src/exact/facilitator/index.ts","../../../../src/exact/facilitator/scheme.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/exact/facilitator/register.ts"],"sourcesContent":["export { ExactTonScheme } from './scheme.js'\nexport type { ExactTonSchemeConfig } from './scheme.js'\nexport { registerExactTonScheme } from './register.js'\nexport type { TonFacilitatorConfig } from './register.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 | undefined\n\n    // Validate payload structure\n    if (!tonPayload?.authorization?.from || !tonPayload?.signedBoc) {\n      return {\n        isValid: false,\n        invalidReason: 'invalid_payload_structure',\n        payer: '',\n      }\n    }\n\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 | undefined\n\n    // Validate payload structure\n    if (!tonPayload?.authorization?.from || !tonPayload?.signedBoc) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: '',\n        errorReason: 'invalid_payload_structure',\n        payer: '',\n      }\n    }\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?: { hasForwardPayload?: boolean }): 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","import { t402Facilitator } from '@t402/core/facilitator'\nimport { Network } from '@t402/core/types'\nimport { FacilitatorTonSigner } from '../../signer.js'\nimport { ExactTonScheme, ExactTonSchemeConfig } from './scheme.js'\n\n/**\n * Configuration options for registering TON schemes to an t402Facilitator\n */\nexport interface TonFacilitatorConfig {\n  /**\n   * The TON signer for facilitator operations (verify and settle)\n   */\n  signer: FacilitatorTonSigner\n\n  /**\n   * Networks to register (single network or array of networks)\n   * Examples: \"ton:mainnet\", [\"ton:mainnet\", \"ton:testnet\"]\n   */\n  networks: Network | Network[]\n\n  /**\n   * Optional scheme configuration (gas sponsorship, etc.)\n   */\n  schemeConfig?: ExactTonSchemeConfig\n}\n\n/**\n * Registers TON exact payment schemes to an t402Facilitator instance.\n *\n * This function registers:\n * - V2: Specified networks with ExactTonScheme\n *\n * @param facilitator - The t402Facilitator instance to register schemes to\n * @param config - Configuration for TON facilitator registration\n * @returns The facilitator instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactTonScheme } from \"@t402/ton/exact/facilitator/register\";\n * import { t402Facilitator } from \"@t402/core/facilitator\";\n * import { TonClient } from \"@ton/ton\";\n *\n * const tonClient = new TonClient({ endpoint: \"...\" });\n * const facilitator = new t402Facilitator();\n *\n * // Single network\n * registerExactTonScheme(facilitator, {\n *   signer: toFacilitatorTonSigner(tonClient),\n *   networks: \"ton:mainnet\"\n * });\n *\n * // Multiple networks\n * registerExactTonScheme(facilitator, {\n *   signer: toFacilitatorTonSigner(tonClient),\n *   networks: [\"ton:mainnet\", \"ton:testnet\"]\n * });\n *\n * // With gas sponsorship\n * registerExactTonScheme(facilitator, {\n *   signer: toFacilitatorTonSigner(tonClient),\n *   networks: \"ton:mainnet\",\n *   schemeConfig: { canSponsorGas: true }\n * });\n * ```\n */\nexport function registerExactTonScheme(\n  facilitator: t402Facilitator,\n  config: TonFacilitatorConfig,\n): t402Facilitator {\n  // Register V2 scheme with specified networks\n  facilitator.register(config.networks, new ExactTonScheme(config.signer, config.schemeConfig))\n\n  return facilitator\n}\n"],"mappings":"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","names":["import_core"]}

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

@@ -107,22 +107,6 @@ declare class ExactTonScheme implements SchemeNetworkServer {
      * @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
      */

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

@@ -3,6 +3,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -16,6 +17,7 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/exact/server/index.ts
 var server_exports = {};
@@ -84,13 +86,6 @@ 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");
@@ -118,8 +113,9 @@ function normalizeNetwork(network) {
 // src/exact/server/scheme.ts
 var ExactTonScheme = class {
   constructor(config = {}) {
-    this.scheme = SCHEME_EXACT;
-    this.moneyParsers = [];
+    __publicField(this, "scheme", SCHEME_EXACT);
+    __publicField(this, "moneyParsers", []);
+    __publicField(this, "config");
     this.config = config;
   }
   /**
@@ -270,35 +266,6 @@ var ExactTonScheme = class {
     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
    */