@t402/ton 2.3.1 → 2.5.0

package/dist/cjs/{signer-Bqn2K0b4.d.ts → signer-BCr73V5A.d.ts}

@@ -274,4 +274,4 @@ declare function toFacilitatorTonSigner(client: Omit<FacilitatorTonSigner, 'getA
     address: string;
 }): FacilitatorTonSigner;
 
-export { type ClientTonSigner as C, type ExactTonPayloadV2 as E, type FacilitatorTonSigner as F, type SignMessageParams as S, type TransactionConfirmation as T, type VerifyMessageParams as V, type WaitForTransactionParams as W, toFacilitatorTonSigner as a, type ExactTonPayload as b, type VerifyMessageResult as c, toClientTonSigner as t };
+export { type ClientTonSigner as C, type ExactTonPayload as E, type FacilitatorTonSigner as F, type SignMessageParams as S, type TransactionConfirmation as T, type VerifyMessageParams as V, type WaitForTransactionParams as W, type ExactTonPayloadV2 as a, type VerifyMessageResult as b, toFacilitatorTonSigner as c, toClientTonSigner as t };

package/dist/cjs/upto/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * TON Up-To Payment Scheme Types
+ *
+ * Defines the payload structure for TON Jetton upto payments in the t402 protocol.
+ * Uses an escrow pattern: client transfers maxAmount to the facilitator address,
+ * facilitator forwards settleAmount to payTo and refunds the rest.
+ *
+ * Uses BOC (Bag of Cells) format for message serialization.
+ */
+/**
+ * TON upto authorization metadata
+ *
+ * Contains all parameters for verifying the signed transfer message.
+ */
+type UptoTonAuthorization = {
+    /**
+     * Sender wallet address (friendly format, bounceable)
+     * This is the TON wallet address that will send the Jetton transfer
+     */
+    from: string;
+    /**
+     * Facilitator holding address that receives the initial transfer
+     * The facilitator will forward settleAmount to payTo and refund the rest
+     */
+    facilitator: string;
+    /**
+     * Jetton master contract address
+     * Identifies which Jetton token is being transferred (e.g., USDT)
+     */
+    jettonMaster: string;
+    /**
+     * Maximum authorized amount in smallest units (as string)
+     * The actual settlement amount may be less than this
+     */
+    maxAmount: string;
+    /**
+     * TON amount attached for gas (in nanoTON, as string)
+     * Required to pay for the internal message execution
+     */
+    tonAmount: string;
+    /**
+     * Unix timestamp (seconds) until which the message is valid
+     * Message will be rejected by the network after this time
+     */
+    validUntil: number;
+    /**
+     * Wallet sequence number at time of signing
+     * Prevents replay attacks - each seqno can only be used once
+     */
+    seqno: number;
+    /**
+     * Query ID for the Jetton transfer (as string for large numbers)
+     * Used for message correlation and deduplication
+     */
+    queryId: string;
+};
+/**
+ * TON upto payment payload (V2)
+ *
+ * Contains a pre-signed transfer message to the facilitator's holding address.
+ * The facilitator will broadcast the transfer, then forward settleAmount to payTo
+ * and refund (maxAmount - settleAmount) back to the client.
+ */
+type UptoTonPayload = {
+    /**
+     * Base64 encoded signed external message (BOC format)
+     * Contains the complete Jetton transfer message ready for broadcast
+     * The message transfers maxAmount to the facilitator's holding address
+     */
+    signedBoc: string;
+    /**
+     * Transfer authorization metadata for verification
+     * Provides human-readable and verifiable parameters
+     */
+    authorization: UptoTonAuthorization;
+    /**
+     * Unique nonce for replay protection (hex string)
+     * Separate from the wallet seqno - used by the t402 protocol
+     */
+    paymentNonce: string;
+};
+/**
+ * TON upto-specific extra fields for payment requirements
+ *
+ * Included in PaymentRequirements.extra to provide upto-specific parameters.
+ */
+type UptoTonExtra = {
+    /**
+     * Facilitator address that will receive the initial transfer
+     * Client should send maxAmount to this address
+     */
+    facilitator?: string;
+    /**
+     * Maximum payment amount authorized
+     * The upper bound for the escrow transfer
+     */
+    maxAmount?: string;
+    /**
+     * Minimum acceptable settlement amount
+     * Server may reject if usage is below this threshold
+     */
+    minAmount?: string;
+    /**
+     * Billing unit (e.g., "token", "request", "second")
+     * Describes what is being measured for usage-based billing
+     */
+    unit?: string;
+    /**
+     * Price per unit in smallest denomination
+     * Used with unit to calculate the final settlement amount
+     */
+    unitPrice?: string;
+};
+/**
+ * Type guard for UptoTonPayload
+ *
+ * Checks if the given data has the correct structure for a TON upto payload.
+ * Validates the presence and types of required fields including signedBoc,
+ * authorization (with from, facilitator, jettonMaster, maxAmount), and paymentNonce.
+ *
+ * @param data - The data to check
+ * @returns True if the data is a valid UptoTonPayload
+ */
+declare function isUptoTonPayload(data: unknown): data is UptoTonPayload;
+
+export { type UptoTonAuthorization, type UptoTonExtra, type UptoTonPayload, isUptoTonPayload };

package/dist/cjs/upto/index.js

@@ -0,0 +1,41 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/upto/index.ts
+var upto_exports = {};
+__export(upto_exports, {
+  isUptoTonPayload: () => isUptoTonPayload
+});
+module.exports = __toCommonJS(upto_exports);
+
+// src/upto/types.ts
+function isUptoTonPayload(data) {
+  if (typeof data !== "object" || data === null) return false;
+  const p = data;
+  if (typeof p.signedBoc !== "string" || p.signedBoc === "") return false;
+  if (typeof p.paymentNonce !== "string" || p.paymentNonce === "") return false;
+  if (typeof p.authorization !== "object" || p.authorization === null) return false;
+  const auth = p.authorization;
+  return typeof auth.from === "string" && auth.from !== "" && typeof auth.facilitator === "string" && auth.facilitator !== "" && typeof auth.jettonMaster === "string" && typeof auth.maxAmount === "string" && typeof auth.tonAmount === "string" && typeof auth.validUntil === "number" && typeof auth.seqno === "number" && typeof auth.queryId === "string";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isUptoTonPayload
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/upto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/upto/index.ts","../../../src/upto/types.ts"],"sourcesContent":["/**\n * Up-To Scheme for TON\n *\n * The upto scheme enables usage-based billing on TON using an escrow pattern:\n * 1. Client signs a transfer of maxAmount to the facilitator's holding address\n * 2. Facilitator broadcasts the transfer, then sends settleAmount to payTo\n *    and refunds (maxAmount - settleAmount) back to the client\n *\n * @module\n */\n\n// Re-export types\nexport type { UptoTonAuthorization, UptoTonPayload, UptoTonExtra } from './types.js'\n\nexport { isUptoTonPayload } from './types.js'\n","/**\n * TON Up-To Payment Scheme Types\n *\n * Defines the payload structure for TON Jetton upto payments in the t402 protocol.\n * Uses an escrow pattern: client transfers maxAmount to the facilitator address,\n * facilitator forwards settleAmount to payTo and refunds the rest.\n *\n * Uses BOC (Bag of Cells) format for message serialization.\n */\n\n/**\n * TON upto authorization metadata\n *\n * Contains all parameters for verifying the signed transfer message.\n */\nexport type UptoTonAuthorization = {\n  /**\n   * Sender wallet address (friendly format, bounceable)\n   * This is the TON wallet address that will send the Jetton transfer\n   */\n  from: string\n\n  /**\n   * Facilitator holding address that receives the initial transfer\n   * The facilitator will forward settleAmount to payTo and refund the rest\n   */\n  facilitator: string\n\n  /**\n   * Jetton master contract address\n   * Identifies which Jetton token is being transferred (e.g., USDT)\n   */\n  jettonMaster: string\n\n  /**\n   * Maximum authorized amount in smallest units (as string)\n   * The actual settlement amount may be less than this\n   */\n  maxAmount: string\n\n  /**\n   * TON amount attached for gas (in nanoTON, as string)\n   * Required to pay for the internal message execution\n   */\n  tonAmount: string\n\n  /**\n   * Unix timestamp (seconds) until which the message is valid\n   * Message will be rejected by the network after this time\n   */\n  validUntil: number\n\n  /**\n   * Wallet sequence number at time of signing\n   * Prevents replay attacks - each seqno can only be used once\n   */\n  seqno: number\n\n  /**\n   * Query ID for the Jetton transfer (as string for large numbers)\n   * Used for message correlation and deduplication\n   */\n  queryId: string\n}\n\n/**\n * TON upto payment payload (V2)\n *\n * Contains a pre-signed transfer message to the facilitator's holding address.\n * The facilitator will broadcast the transfer, then forward settleAmount to payTo\n * and refund (maxAmount - settleAmount) back to the client.\n */\nexport type UptoTonPayload = {\n  /**\n   * Base64 encoded signed external message (BOC format)\n   * Contains the complete Jetton transfer message ready for broadcast\n   * The message transfers maxAmount to the facilitator's holding address\n   */\n  signedBoc: string\n\n  /**\n   * Transfer authorization metadata for verification\n   * Provides human-readable and verifiable parameters\n   */\n  authorization: UptoTonAuthorization\n\n  /**\n   * Unique nonce for replay protection (hex string)\n   * Separate from the wallet seqno - used by the t402 protocol\n   */\n  paymentNonce: string\n}\n\n/**\n * TON upto-specific extra fields for payment requirements\n *\n * Included in PaymentRequirements.extra to provide upto-specific parameters.\n */\nexport type UptoTonExtra = {\n  /**\n   * Facilitator address that will receive the initial transfer\n   * Client should send maxAmount to this address\n   */\n  facilitator?: string\n\n  /**\n   * Maximum payment amount authorized\n   * The upper bound for the escrow transfer\n   */\n  maxAmount?: string\n\n  /**\n   * Minimum acceptable settlement amount\n   * Server may reject if usage is below this threshold\n   */\n  minAmount?: string\n\n  /**\n   * Billing unit (e.g., \"token\", \"request\", \"second\")\n   * Describes what is being measured for usage-based billing\n   */\n  unit?: string\n\n  /**\n   * Price per unit in smallest denomination\n   * Used with unit to calculate the final settlement amount\n   */\n  unitPrice?: string\n}\n\n/**\n * Type guard for UptoTonPayload\n *\n * Checks if the given data has the correct structure for a TON upto payload.\n * Validates the presence and types of required fields including signedBoc,\n * authorization (with from, facilitator, jettonMaster, maxAmount), and paymentNonce.\n *\n * @param data - The data to check\n * @returns True if the data is a valid UptoTonPayload\n */\nexport function isUptoTonPayload(data: unknown): data is UptoTonPayload {\n  if (typeof data !== 'object' || data === null) return false\n  const p = data as Record<string, unknown>\n\n  if (typeof p.signedBoc !== 'string' || p.signedBoc === '') return false\n  if (typeof p.paymentNonce !== 'string' || p.paymentNonce === '') return false\n\n  if (typeof p.authorization !== 'object' || p.authorization === null) return false\n  const auth = p.authorization as Record<string, unknown>\n\n  return (\n    typeof auth.from === 'string' &&\n    auth.from !== '' &&\n    typeof auth.facilitator === 'string' &&\n    auth.facilitator !== '' &&\n    typeof auth.jettonMaster === 'string' &&\n    typeof auth.maxAmount === 'string' &&\n    typeof auth.tonAmount === 'string' &&\n    typeof auth.validUntil === 'number' &&\n    typeof auth.seqno === 'number' &&\n    typeof auth.queryId === 'string'\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4IO,SAAS,iBAAiB,MAAuC;AACtE,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,QAAM,IAAI;AAEV,MAAI,OAAO,EAAE,cAAc,YAAY,EAAE,cAAc,GAAI,QAAO;AAClE,MAAI,OAAO,EAAE,iBAAiB,YAAY,EAAE,iBAAiB,GAAI,QAAO;AAExE,MAAI,OAAO,EAAE,kBAAkB,YAAY,EAAE,kBAAkB,KAAM,QAAO;AAC5E,QAAM,OAAO,EAAE;AAEf,SACE,OAAO,KAAK,SAAS,YACrB,KAAK,SAAS,MACd,OAAO,KAAK,gBAAgB,YAC5B,KAAK,gBAAgB,MACrB,OAAO,KAAK,iBAAiB,YAC7B,OAAO,KAAK,cAAc,YAC1B,OAAO,KAAK,cAAc,YAC1B,OAAO,KAAK,eAAe,YAC3B,OAAO,KAAK,UAAU,YACtB,OAAO,KAAK,YAAY;AAE5B;","names":[]}

package/dist/esm/{chunk-3BN2G4M7.mjs → chunk-2EIGZGJU.mjs}

@@ -1,7 +1,3 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-
 // src/constants.ts
 var TON_MAINNET_CAIP2 = "ton:mainnet";
 var TON_TESTNET_CAIP2 = "ton:testnet";
@@ -31,6 +27,7 @@ var DEFAULT_VALIDITY_DURATION = 3600;
 
 // src/utils.ts
 import { Address, beginCell } from "@ton/core";
+import { cryptoRandomBigInt } from "@t402/core/utils";
 function normalizeNetwork(network) {
   if (network.startsWith("ton:")) {
     if (!TON_NETWORKS.includes(network)) {
@@ -115,8 +112,8 @@ function convertFromJettonAmount(jettonAmount, decimals) {
 }
 function generateQueryId() {
   const timestamp = BigInt(Date.now());
-  const random = BigInt(Math.floor(Math.random() * 1e6));
-  return timestamp * 1000000n + random;
+  const random = cryptoRandomBigInt(20);
+  return timestamp * 1048576n + random;
 }
 function buildJettonTransferBody(params) {
   const builder = beginCell().storeUint(JETTON_TRANSFER_OP, 32).storeUint(params.queryId, 64).storeCoins(params.amount).storeAddress(params.destination).storeAddress(params.responseDestination).storeBit(false);
@@ -160,7 +157,6 @@ function estimateJettonTransferGas(_params) {
 }
 
 export {
-  __publicField,
   TON_MAINNET_CAIP2,
   TON_TESTNET_CAIP2,
   TON_NETWORKS,
@@ -194,4 +190,4 @@ export {
   parseJettonTransferBody,
   estimateJettonTransferGas
 };
-//# sourceMappingURL=chunk-3BN2G4M7.mjs.map
+//# sourceMappingURL=chunk-2EIGZGJU.mjs.map

package/dist/esm/chunk-2EIGZGJU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/utils.ts"],"sourcesContent":["/**\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 { cryptoRandomBigInt } from '@t402/core/utils'\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 + cryptographically secure random component for uniqueness\n *\n * @returns BigInt query ID (64-bit)\n */\nexport function generateQueryId(): bigint {\n  const timestamp = BigInt(Date.now())\n  // Use 20 bits of cryptographic randomness (0-1048575)\n  const random = cryptoRandomBigInt(20)\n  return timestamp * 1048576n + 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"],"mappings":";AAcO,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;AAMO,IAAM,qBAAqB;AAC3B,IAAM,8BAA8B;AACpC,IAAM,kCAAkC;AACxC,IAAM,iBAAiB;AAMvB,IAAM,8BAA8B;AACpC,IAAM,sBAAsB;AAC5B,IAAM,0BAA0B;AAKhC,IAAM,0BAA0B;AAKhC,IAAM,eAAe;AAKrB,IAAM,4BAA4B;;;ACxEzC,SAAS,SAAS,iBAAuB;AAEzC,SAAS,0BAA0B;AAgB5B,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;AAQO,SAAS,YAAY,SAA0B;AACpD,QAAM,QAAQ,iBAAiB,OAAO;AACtC,QAAM,WAAW,kBAAkB,KAAK;AACxC,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,uCAAuC,OAAO,EAAE;AAAA,EAClE;AACA,SAAO;AACT;AAQO,SAAS,aAAa,SAA0B;AACrD,MAAI;AACF,qBAAiB,OAAkB;AACnC,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQO,SAAS,mBAAmB,SAA0B;AAC3D,MAAI;AACF,YAAQ,MAAM,OAAO;AACrB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AASO,SAAS,gBAAgB,SAA0B;AACxD,SAAO,QAAQ,MAAM,OAAO;AAC9B;AAUO,SAAS,eAAe,OAAe,OAAwB;AACpE,MAAI;AACF,UAAM,KAAK,QAAQ,MAAM,KAAK;AAC9B,UAAM,KAAK,QAAQ,MAAM,KAAK;AAC9B,WAAO,GAAG,OAAO,EAAE;AAAA,EACrB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AASO,SAAS,cACd,SACA,SACQ;AACR,QAAM,OAAO,OAAO,YAAY,WAAW,QAAQ,MAAM,OAAO,IAAI;AACpE,SAAO,KAAK,SAAS;AAAA,IACnB,YAAY,SAAS,cAAc;AAAA,IACnC,UAAU,SAAS,YAAY;AAAA,EACjC,CAAC;AACH;AASO,SAAS,sBAAsB,eAAuB,UAA0B;AACrF,QAAM,SAAS,WAAW,aAAa;AACvC,MAAI,MAAM,MAAM,GAAG;AACjB,UAAM,IAAI,MAAM,mBAAmB,aAAa,EAAE;AAAA,EACpD;AACA,QAAM,eAAe,KAAK,MAAM,SAAS,KAAK,IAAI,IAAI,QAAQ,CAAC;AAC/D,SAAO,aAAa,SAAS;AAC/B;AASO,SAAS,wBAAwB,cAA+B,UAA0B;AAC/F,QAAM,SAAS,OAAO,iBAAiB,WAAW,OAAO,YAAY,IAAI;AACzE,QAAM,UAAU,OAAO,KAAK,IAAI,IAAI,QAAQ,CAAC;AAC7C,QAAM,YAAY,SAAS;AAC3B,QAAM,iBAAiB,SAAS;AAEhC,MAAI,mBAAmB,IAAI;AACzB,WAAO,UAAU,SAAS;AAAA,EAC5B;AAEA,QAAM,gBAAgB,eAAe,SAAS,EAAE,SAAS,UAAU,GAAG;AACtE,SAAO,GAAG,SAAS,IAAI,aAAa,GAAG,QAAQ,UAAU,EAAE;AAC7D;AAQO,SAAS,kBAA0B;AACxC,QAAM,YAAY,OAAO,KAAK,IAAI,CAAC;AAEnC,QAAM,SAAS,mBAAmB,EAAE;AACpC,SAAO,YAAY,WAAW;AAChC;AAQO,SAAS,wBAAwB,QAO/B;AACP,QAAM,UAAU,UAAU,EACvB,UAAU,oBAAoB,EAAE,EAChC,UAAU,OAAO,SAAS,EAAE,EAC5B,WAAW,OAAO,MAAM,EACxB,aAAa,OAAO,WAAW,EAC/B,aAAa,OAAO,mBAAmB,EACvC,SAAS,KAAK;AAGjB,UAAQ,WAAW,OAAO,iBAAiB,EAAE;AAG7C,MAAI,OAAO,gBAAgB;AACzB,YAAQ,SAAS,IAAI,EAAE,SAAS,OAAO,cAAc;AAAA,EACvD,OAAO;AACL,YAAQ,SAAS,KAAK;AAAA,EACxB;AAEA,SAAO,QAAQ,QAAQ;AACzB;AASO,SAAS,wBAAwB,MAQtC;AACA,QAAM,QAAQ,KAAK,WAAW;AAE9B,QAAM,KAAK,MAAM,SAAS,EAAE;AAC5B,MAAI,OAAO,oBAAoB;AAC7B,UAAM,IAAI,MAAM,8CAA8C,kBAAkB,SAAS,EAAE,EAAE;AAAA,EAC/F;AAEA,QAAM,UAAU,MAAM,YAAY,EAAE;AACpC,QAAM,SAAS,MAAM,UAAU;AAC/B,QAAM,cAAc,MAAM,YAAY;AACtC,QAAM,sBAAsB,MAAM,YAAY;AAG9C,QAAM,mBAAmB,MAAM,QAAQ;AACvC,MAAI,kBAAkB;AACpB,UAAM,QAAQ;AAAA,EAChB;AAEA,QAAM,gBAAgB,MAAM,UAAU;AAGtC,QAAM,oBAAoB,MAAM,QAAQ;AACxC,QAAM,iBAAiB,oBAAoB,MAAM,QAAQ,IAAI;AAE7D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AASO,SAAS,0BAA0B,SAAmD;AAG3F,SAAO;AACT;","names":[]}

package/dist/esm/{chunk-NGYEU24R.mjs → chunk-HIUPRMQV.mjs}

@@ -2,16 +2,19 @@ import {
   SCHEME_EXACT,
   TON_MAINNET_CAIP2,
   TON_TESTNET_CAIP2,
-  __publicField,
   normalizeNetwork
-} from "./chunk-3BN2G4M7.mjs";
+} from "./chunk-2EIGZGJU.mjs";
+import {
+  __publicField
+} from "./chunk-NSSMTXJJ.mjs";
 
 // src/tokens.ts
 var USDT_ADDRESSES = {
   // TON Mainnet - Official Tether USDT
   [TON_MAINNET_CAIP2]: "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs",
-  // TON Testnet - Test USDT (may vary)
-  [TON_TESTNET_CAIP2]: "kQBqSpvo4S87mX9tTc4FX3Sfqf4uSp3Tx-Fz4RBUfTRWBx"
+  // TON Testnet - Test USDT from TON documentation
+  // @see https://docs.ton.org/v3/guidelines/dapps/cookbook
+  [TON_TESTNET_CAIP2]: "kQD0GKBM8ZbryVk2aESmzfU6b9b_8era_IkvBSELujFZPsyy"
 };
 var JETTON_REGISTRY = {
   // TON Mainnet
@@ -268,4 +271,4 @@ export {
   ExactTonScheme,
   registerExactTonScheme
 };
-//# sourceMappingURL=chunk-NGYEU24R.mjs.map
+//# sourceMappingURL=chunk-HIUPRMQV.mjs.map

package/dist/esm/chunk-HIUPRMQV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tokens.ts","../../src/exact/server/scheme.ts","../../src/exact/server/register.ts"],"sourcesContent":["/**\n * TON Jetton Token Configuration\n *\n * This module provides comprehensive Jetton token definitions including:\n * - USDT (Tether USD on TON)\n * - Network-specific configurations\n * - Helper functions for token lookups\n */\n\nimport { TON_MAINNET_CAIP2, TON_TESTNET_CAIP2 } from './constants.js'\n\n/**\n * Jetton token configuration\n */\nexport interface JettonConfig {\n  /** Jetton master contract address (friendly format) */\n  masterAddress: string\n  /** Token symbol */\n  symbol: string\n  /** Token name */\n  name: string\n  /** Number of decimal places */\n  decimals: number\n  /** Payment priority (lower = higher priority) */\n  priority: number\n}\n\n/**\n * Network token registry mapping network -> symbol -> config\n */\nexport type NetworkJettonRegistry = Record<string, Record<string, JettonConfig>>\n\n/**\n * USDT Jetton Master Contract Addresses by Network\n *\n * USDT on TON follows the TEP-74 Jetton standard.\n * @see https://docs.tether.to/tether-on-ton\n */\nexport const USDT_ADDRESSES: Record<string, string> = {\n  // TON Mainnet - Official Tether USDT\n  [TON_MAINNET_CAIP2]: 'EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs',\n  // TON Testnet - Test USDT from TON documentation\n  // @see https://docs.ton.org/v3/guidelines/dapps/cookbook\n  [TON_TESTNET_CAIP2]: 'kQD0GKBM8ZbryVk2aESmzfU6b9b_8era_IkvBSELujFZPsyy',\n}\n\n/**\n * Complete Jetton registry with all supported tokens per network\n */\nexport const JETTON_REGISTRY: NetworkJettonRegistry = {\n  // TON Mainnet\n  [TON_MAINNET_CAIP2]: {\n    USDT: {\n      masterAddress: USDT_ADDRESSES[TON_MAINNET_CAIP2],\n      symbol: 'USDT',\n      name: 'Tether USD',\n      decimals: 6,\n      priority: 1,\n    },\n  },\n\n  // TON Testnet\n  [TON_TESTNET_CAIP2]: {\n    USDT: {\n      masterAddress: USDT_ADDRESSES[TON_TESTNET_CAIP2],\n      symbol: 'USDT',\n      name: 'Tether USD (Testnet)',\n      decimals: 6,\n      priority: 1,\n    },\n  },\n}\n\n/**\n * Get Jetton configuration for a specific token on a network\n *\n * @param network - Network identifier (CAIP-2 format)\n * @param symbol - Token symbol (e.g., \"USDT\")\n * @returns Jetton configuration or undefined\n */\nexport function getJettonConfig(network: string, symbol: string): JettonConfig | undefined {\n  return JETTON_REGISTRY[network]?.[symbol.toUpperCase()]\n}\n\n/**\n * Get all Jettons available on a network\n *\n * @param network - Network identifier\n * @returns Array of Jetton configurations sorted by priority\n */\nexport function getNetworkJettons(network: string): JettonConfig[] {\n  const jettons = JETTON_REGISTRY[network]\n  if (!jettons) return []\n  return Object.values(jettons).sort((a, b) => a.priority - b.priority)\n}\n\n/**\n * Get the default/preferred Jetton for a network\n * Prefers USDT based on priority\n *\n * @param network - Network identifier\n * @returns Default Jetton configuration or undefined\n */\nexport function getDefaultJetton(network: string): JettonConfig | undefined {\n  const jettons = getNetworkJettons(network)\n  return jettons[0] // Already sorted by priority\n}\n\n/**\n * Get Jetton by master contract address on a network\n *\n * @param network - Network identifier\n * @param address - Jetton master contract address\n * @returns Jetton configuration or undefined\n */\nexport function getJettonByAddress(network: string, address: string): JettonConfig | undefined {\n  const jettons = JETTON_REGISTRY[network]\n  if (!jettons) return undefined\n\n  // Normalize address comparison (case-insensitive for base64)\n  return Object.values(jettons).find((j) => j.masterAddress.toLowerCase() === address.toLowerCase())\n}\n\n/**\n * Get all networks that support a specific Jetton\n *\n * @param symbol - Token symbol\n * @returns Array of network identifiers\n */\nexport function getNetworksForJetton(symbol: string): string[] {\n  const networks: string[] = []\n  for (const [network, jettons] of Object.entries(JETTON_REGISTRY)) {\n    if (jettons[symbol.toUpperCase()]) {\n      networks.push(network)\n    }\n  }\n  return networks\n}\n\n/**\n * Get USDT networks on TON\n *\n * @returns Array of networks supporting USDT\n */\nexport function getUsdtNetworks(): string[] {\n  return getNetworksForJetton('USDT')\n}\n\n/**\n * Check if a network is supported\n *\n * @param network - Network identifier to check\n * @returns true if network has configured Jettons\n */\nexport function isNetworkSupported(network: string): boolean {\n  return network in JETTON_REGISTRY\n}\n\n/**\n * Get all supported networks\n *\n * @returns Array of all supported network identifiers\n */\nexport function getSupportedNetworks(): string[] {\n  return Object.keys(JETTON_REGISTRY)\n}\n","/**\n * TON Server Scheme Implementation\n *\n * Handles price parsing and payment requirement enhancement for\n * TON Jetton payments using the exact scheme.\n */\n\nimport type {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from '@t402/core/types'\nimport { SCHEME_EXACT } from '../../constants.js'\nimport { getDefaultJetton, getJettonConfig, JETTON_REGISTRY } from '../../tokens.js'\nimport { normalizeNetwork } from '../../utils.js'\n\n/**\n * Configuration options for ExactTonScheme server\n */\nexport interface ExactTonSchemeConfig {\n  /** Preferred Jetton symbol (e.g., \"USDT\"). Defaults to network's highest priority token. */\n  preferredJetton?: string\n}\n\n/**\n * TON server implementation for the Exact payment scheme.\n * Handles price parsing and converts user-friendly amounts to Jetton amounts.\n */\nexport class ExactTonScheme implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT\n  private moneyParsers: MoneyParser[] = []\n  private config: ExactTonSchemeConfig\n\n  constructor(config: ExactTonSchemeConfig = {}) {\n    this.config = config\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   * Multiple parsers can be registered - they will be tried in registration order.\n   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).\n   * If a parser returns null, the next parser in the chain will be tried.\n   * The default parser is always the final fallback.\n   *\n   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n   * @returns The server instance for chaining\n   *\n   * @example\n   * tonServer.registerMoneyParser(async (amount, network) => {\n   *   // Use custom Jetton for large amounts\n   *   if (amount > 1000) {\n   *     return {\n   *       amount: (amount * 1e9).toString(),\n   *       asset: \"EQCustomJettonAddress...\",\n   *       extra: { tier: \"premium\" }\n   *     };\n   *   }\n   *   return null; // Use next parser\n   * });\n   */\n  registerMoneyParser(parser: MoneyParser): ExactTonScheme {\n    this.moneyParsers.push(parser)\n    return this\n  }\n\n  /**\n   * Parses a price into an asset amount.\n   * If price is already an AssetAmount, returns it directly.\n   * If price is Money (string | number), parses to decimal and tries custom parsers.\n   * Falls back to default conversion if all custom parsers return null.\n   *\n   * @param price - The price to parse\n   * @param network - The network to use\n   * @returns Promise that resolves to the parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // Normalize network to CAIP-2 format\n    const normalizedNetwork = normalizeNetwork(network)\n\n    // If already an AssetAmount, return it directly\n    if (typeof price === 'object' && price !== null && 'amount' in price) {\n      if (!price.asset) {\n        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`)\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      }\n    }\n\n    // Parse Money to decimal number\n    const amount = this.parseMoneyToDecimal(price)\n\n    // Try each custom money parser in order\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, normalizedNetwork)\n      if (result !== null) {\n        return result\n      }\n    }\n\n    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, normalizedNetwork)\n  }\n\n  /**\n   * Build payment requirements for this scheme/network combination.\n   * Adds TON-specific fields like gas sponsor if provided by facilitator.\n   *\n   * @param paymentRequirements - Base payment requirements with amount/asset already set\n   * @param supportedKind - The supported kind from facilitator's /supported endpoint\n   * @param extensionKeys - Extensions supported by the facilitator (unused)\n   * @returns Enhanced payment requirements ready to be sent to clients\n   */\n  async enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      t402Version: number\n      scheme: string\n      network: Network\n      extra?: Record<string, unknown>\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    // Mark unused parameters to satisfy linter\n    void extensionKeys\n\n    // Start with existing extra fields\n    const extra = { ...paymentRequirements.extra }\n\n    // Add gas sponsor from facilitator if provided\n    if (supportedKind.extra?.gasSponsor) {\n      extra.gasSponsor = supportedKind.extra.gasSponsor\n    }\n\n    return {\n      ...paymentRequirements,\n      extra,\n    }\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   * Handles formats like \"$1.50\", \"1.50\", 1.50, etc.\n   *\n   * @param money - The money value to parse\n   * @returns Decimal number\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === 'number') {\n      return money\n    }\n\n    // Remove $ sign and whitespace, then parse\n    const cleanMoney = money.replace(/^\\$/, '').trim()\n    const amount = parseFloat(cleanMoney)\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`)\n    }\n\n    return amount\n  }\n\n  /**\n   * Default money conversion implementation.\n   * Converts decimal amount to the preferred Jetton on the specified network.\n   *\n   * @param amount - The decimal amount (e.g., 1.50)\n   * @param network - The network to use\n   * @returns The parsed asset amount\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const jetton = this.getDefaultAsset(network)\n\n    // Convert decimal amount to token amount\n    const tokenAmount = this.convertToTokenAmount(amount.toString(), jetton.decimals)\n\n    return {\n      amount: tokenAmount,\n      asset: jetton.masterAddress,\n      extra: {\n        symbol: jetton.symbol,\n        name: jetton.name,\n        decimals: jetton.decimals,\n      },\n    }\n  }\n\n  /**\n   * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal tokens)\n   *\n   * @param decimalAmount - The decimal amount to convert\n   * @param decimals - Number of decimals for the token\n   * @returns The token amount as a string\n   */\n  private convertToTokenAmount(decimalAmount: string, decimals: number): string {\n    const amount = parseFloat(decimalAmount)\n    if (isNaN(amount)) {\n      throw new Error(`Invalid amount: ${decimalAmount}`)\n    }\n    // Convert to smallest unit (e.g., for USDT with 6 decimals: 0.10 * 10^6 = 100000)\n    const tokenAmount = Math.floor(amount * Math.pow(10, decimals))\n    return tokenAmount.toString()\n  }\n\n  /**\n   * Get the default asset info for a network.\n   * Priority: configured preferredJetton > USDT > first available\n   *\n   * @param network - The network to get asset info for\n   * @returns The Jetton configuration\n   */\n  private getDefaultAsset(network: Network): {\n    masterAddress: string\n    symbol: string\n    name: string\n    decimals: number\n  } {\n    // If a preferred Jetton is configured, try to use it\n    if (this.config.preferredJetton) {\n      const preferred = getJettonConfig(network, this.config.preferredJetton)\n      if (preferred) return preferred\n    }\n\n    // Use the network's default token (sorted by priority)\n    const defaultJetton = getDefaultJetton(network)\n    if (defaultJetton) return defaultJetton\n\n    throw new Error(`No Jettons configured for network ${network}`)\n  }\n\n  /**\n   * Get all supported networks\n   */\n  static getSupportedNetworks(): string[] {\n    return Object.keys(JETTON_REGISTRY)\n  }\n\n  /**\n   * Check if a network is supported\n   */\n  static isNetworkSupported(network: string): boolean {\n    return network in JETTON_REGISTRY\n  }\n}\n","import { t402ResourceServer } from '@t402/core/server'\nimport { Network } from '@t402/core/types'\nimport { ExactTonScheme, ExactTonSchemeConfig } from './scheme.js'\n\n/**\n * Configuration options for registering TON schemes to an t402ResourceServer\n */\nexport interface TonResourceServerConfig {\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 (preferred Jetton, etc.)\n   */\n  schemeConfig?: ExactTonSchemeConfig\n}\n\n/**\n * Registers TON exact payment schemes to an t402ResourceServer instance.\n *\n * This function registers:\n * - V2: ton:* wildcard scheme with ExactTonScheme (or specific networks if provided)\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for TON resource server registration\n * @returns The server instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactTonScheme } from \"@t402/ton/exact/server/register\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n *\n * const server = new t402ResourceServer(facilitatorClient);\n * registerExactTonScheme(server, {});\n *\n * // Or with specific Jetton preference\n * registerExactTonScheme(server, {\n *   schemeConfig: { preferredJetton: \"USDT\" }\n * });\n * ```\n */\nexport function registerExactTonScheme(\n  server: t402ResourceServer,\n  config: TonResourceServerConfig = {},\n): t402ResourceServer {\n  const scheme = new ExactTonScheme(config.schemeConfig)\n\n  // Register V2 scheme\n  if (config.networks && config.networks.length > 0) {\n    // Register specific networks\n    config.networks.forEach((network) => {\n      server.register(network, scheme)\n    })\n  } else {\n    // Register wildcard for all TON networks\n    server.register('ton:*', scheme)\n  }\n\n  return server\n}\n"],"mappings":";;;;;;;;;;;AAsCO,IAAM,iBAAyC;AAAA;AAAA,EAEpD,CAAC,iBAAiB,GAAG;AAAA;AAAA;AAAA,EAGrB,CAAC,iBAAiB,GAAG;AACvB;AAKO,IAAM,kBAAyC;AAAA;AAAA,EAEpD,CAAC,iBAAiB,GAAG;AAAA,IACnB,MAAM;AAAA,MACJ,eAAe,eAAe,iBAAiB;AAAA,MAC/C,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AAAA;AAAA,EAGA,CAAC,iBAAiB,GAAG;AAAA,IACnB,MAAM;AAAA,MACJ,eAAe,eAAe,iBAAiB;AAAA,MAC/C,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AACF;AASO,SAAS,gBAAgB,SAAiB,QAA0C;AACzF,SAAO,gBAAgB,OAAO,IAAI,OAAO,YAAY,CAAC;AACxD;AAQO,SAAS,kBAAkB,SAAiC;AACjE,QAAM,UAAU,gBAAgB,OAAO;AACvC,MAAI,CAAC,QAAS,QAAO,CAAC;AACtB,SAAO,OAAO,OAAO,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AACtE;AASO,SAAS,iBAAiB,SAA2C;AAC1E,QAAM,UAAU,kBAAkB,OAAO;AACzC,SAAO,QAAQ,CAAC;AAClB;AASO,SAAS,mBAAmB,SAAiB,SAA2C;AAC7F,QAAM,UAAU,gBAAgB,OAAO;AACvC,MAAI,CAAC,QAAS,QAAO;AAGrB,SAAO,OAAO,OAAO,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc,YAAY,MAAM,QAAQ,YAAY,CAAC;AACnG;AAQO,SAAS,qBAAqB,QAA0B;AAC7D,QAAM,WAAqB,CAAC;AAC5B,aAAW,CAAC,SAAS,OAAO,KAAK,OAAO,QAAQ,eAAe,GAAG;AAChE,QAAI,QAAQ,OAAO,YAAY,CAAC,GAAG;AACjC,eAAS,KAAK,OAAO;AAAA,IACvB;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,kBAA4B;AAC1C,SAAO,qBAAqB,MAAM;AACpC;AAQO,SAAS,mBAAmB,SAA0B;AAC3D,SAAO,WAAW;AACpB;AAOO,SAAS,uBAAiC;AAC/C,SAAO,OAAO,KAAK,eAAe;AACpC;;;ACtIO,IAAM,iBAAN,MAAoD;AAAA,EAKzD,YAAY,SAA+B,CAAC,GAAG;AAJ/C,wBAAS,UAAS;AAClB,wBAAQ,gBAA8B,CAAC;AACvC,wBAAQ;AAGN,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,oBAAoB,QAAqC;AACvD,SAAK,aAAa,KAAK,MAAM;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,WAAW,OAAc,SAAwC;AAErE,UAAM,oBAAoB,iBAAiB,OAAO;AAGlD,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,YAAY,OAAO;AACpE,UAAI,CAAC,MAAM,OAAO;AAChB,cAAM,IAAI,MAAM,8DAA8D,OAAO,EAAE;AAAA,MACzF;AACA,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,OAAO,MAAM,SAAS,CAAC;AAAA,MACzB;AAAA,IACF;AAGA,UAAM,SAAS,KAAK,oBAAoB,KAAK;AAG7C,eAAW,UAAU,KAAK,cAAc;AACtC,YAAM,SAAS,MAAM,OAAO,QAAQ,iBAAiB;AACrD,UAAI,WAAW,MAAM;AACnB,eAAO;AAAA,MACT;AAAA,IACF;AAGA,WAAO,KAAK,uBAAuB,QAAQ,iBAAiB;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,2BACJ,qBACA,eAMA,eAC8B;AAE9B,SAAK;AAGL,UAAM,QAAQ,EAAE,GAAG,oBAAoB,MAAM;AAG7C,QAAI,cAAc,OAAO,YAAY;AACnC,YAAM,aAAa,cAAc,MAAM;AAAA,IACzC;AAEA,WAAO;AAAA,MACL,GAAG;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,oBAAoB,OAAgC;AAC1D,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO;AAAA,IACT;AAGA,UAAM,aAAa,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAK;AACjD,UAAM,SAAS,WAAW,UAAU;AAEpC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,yBAAyB,KAAK,EAAE;AAAA,IAClD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,uBAAuB,QAAgB,SAA+B;AAC5E,UAAM,SAAS,KAAK,gBAAgB,OAAO;AAG3C,UAAM,cAAc,KAAK,qBAAqB,OAAO,SAAS,GAAG,OAAO,QAAQ;AAEhF,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO,OAAO;AAAA,MACd,OAAO;AAAA,QACL,QAAQ,OAAO;AAAA,QACf,MAAM,OAAO;AAAA,QACb,UAAU,OAAO;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,qBAAqB,eAAuB,UAA0B;AAC5E,UAAM,SAAS,WAAW,aAAa;AACvC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,mBAAmB,aAAa,EAAE;AAAA,IACpD;AAEA,UAAM,cAAc,KAAK,MAAM,SAAS,KAAK,IAAI,IAAI,QAAQ,CAAC;AAC9D,WAAO,YAAY,SAAS;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,gBAAgB,SAKtB;AAEA,QAAI,KAAK,OAAO,iBAAiB;AAC/B,YAAM,YAAY,gBAAgB,SAAS,KAAK,OAAO,eAAe;AACtE,UAAI,UAAW,QAAO;AAAA,IACxB;AAGA,UAAM,gBAAgB,iBAAiB,OAAO;AAC9C,QAAI,cAAe,QAAO;AAE1B,UAAM,IAAI,MAAM,qCAAqC,OAAO,EAAE;AAAA,EAChE;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,uBAAiC;AACtC,WAAO,OAAO,KAAK,eAAe;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,mBAAmB,SAA0B;AAClD,WAAO,WAAW;AAAA,EACpB;AACF;;;AC7MO,SAAS,uBACd,QACA,SAAkC,CAAC,GACf;AACpB,QAAM,SAAS,IAAI,eAAe,OAAO,YAAY;AAGrD,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AAEjD,WAAO,SAAS,QAAQ,CAAC,YAAY;AACnC,aAAO,SAAS,SAAS,MAAM;AAAA,IACjC,CAAC;AAAA,EACH,OAAO;AAEL,WAAO,SAAS,SAAS,MAAM;AAAA,EACjC;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/chunk-NSSMTXJJ.mjs

@@ -0,0 +1,8 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+export {
+  __publicField
+};
+//# sourceMappingURL=chunk-NSSMTXJJ.mjs.map

package/dist/esm/chunk-NSSMTXJJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/{chunk-ZJA7AWWH.mjs → chunk-OOC4E2LE.mjs}

@@ -1,9 +1,11 @@
 import {
   SCHEME_EXACT,
-  __publicField,
   addressesEqual,
   normalizeNetwork
-} from "./chunk-3BN2G4M7.mjs";
+} from "./chunk-2EIGZGJU.mjs";
+import {
+  __publicField
+} from "./chunk-NSSMTXJJ.mjs";
 
 // src/exact/facilitator/scheme.ts
 import { Cell } from "@ton/core";
@@ -281,4 +283,4 @@ export {
   ExactTonScheme,
   registerExactTonScheme
 };
-//# sourceMappingURL=chunk-ZJA7AWWH.mjs.map
+//# sourceMappingURL=chunk-OOC4E2LE.mjs.map

package/dist/esm/{chunk-ZJA7AWWH.mjs.map → chunk-OOC4E2LE.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../src/exact/facilitator/scheme.ts","../../src/exact/facilitator/register.ts"],"sourcesContent":["/**\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","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":[]}
+{"version":3,"sources":["../../src/exact/facilitator/scheme.ts","../../src/exact/facilitator/register.ts"],"sourcesContent":["/**\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","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":[]}

package/dist/esm/{chunk-7OE2PWYP.mjs → chunk-QTEA4ZJU.mjs}

@@ -2,12 +2,14 @@ import {
   DEFAULT_FORWARD_TON,
   DEFAULT_JETTON_TRANSFER_TON,
   SCHEME_EXACT,
-  __publicField,
   buildJettonTransferBody,
   generateQueryId,
   normalizeNetwork,
   parseTonAddress
-} from "./chunk-3BN2G4M7.mjs";
+} from "./chunk-2EIGZGJU.mjs";
+import {
+  __publicField
+} from "./chunk-NSSMTXJJ.mjs";
 
 // src/exact/client/scheme.ts
 import { Address, SendMode } from "@ton/core";
@@ -122,4 +124,4 @@ export {
   ExactTonScheme,
   registerExactTonScheme
 };
-//# sourceMappingURL=chunk-7OE2PWYP.mjs.map
+//# sourceMappingURL=chunk-QTEA4ZJU.mjs.map

package/dist/esm/{chunk-7OE2PWYP.mjs.map → chunk-QTEA4ZJU.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../src/exact/client/scheme.ts","../../src/exact/client/register.ts"],"sourcesContent":["/**\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","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":";;;;;;;;;;;;AAOA,SAAS,SAAS,gBAAgB;AA4B3B,IAAM,iBAAN,MAAoD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUzD,YACmB,QACA,wBAIA,SAA+B,CAAC,GACjD;AANiB;AACA;AAIA;AAfnB,wBAAS,UAAS;AAAA,EAgBf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYH,MAAM,qBACJ,aACA,qBAC0D;AAE1D,UAAM,UAAU,iBAAiB,oBAAoB,OAAO;AAG5D,QAAI,CAAC,oBAAoB,OAAO;AAC9B,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AACA,QAAI,CAAC,oBAAoB,OAAO;AAC9B,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AACA,QAAI,CAAC,oBAAoB,QAAQ;AAC/B,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACtC;AAGA,UAAM,sBAAsB,oBAAoB;AAChD,UAAM,qBAAqB,gBAAgB,oBAAoB,KAAK;AAGpE,UAAM,4BAA4B,MAAM,KAAK;AAAA,MAC3C,KAAK,OAAO,QAAQ,SAAS;AAAA,MAC7B;AAAA,IACF;AACA,UAAM,qBAAqB,QAAQ,MAAM,yBAAyB;AAGlE,UAAM,QAAQ,MAAM,KAAK,OAAO,SAAS;AAGzC,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AACxC,UAAM,aAAa,MAAM,oBAAoB;AAG7C,UAAM,UAAU,gBAAgB;AAGhC,UAAM,eAAe,OAAO,oBAAoB,MAAM;AAGtD,UAAM,qBAAqB,wBAAwB;AAAA,MACjD;AAAA,MACA,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,qBAAqB,KAAK,OAAO;AAAA,MACjC,eAAe,KAAK,OAAO,iBAAiB;AAAA,IAC9C,CAAC;AAGD,UAAM,YAAY,KAAK,OAAO,aAAa;AAG3C,UAAM,gBAAgB,MAAM,KAAK,OAAO,YAAY;AAAA,MAClD,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU,SAAS;AAAA,MACnB,SAAS,oBAAoB;AAAA,IAC/B,CAAC;AAGD,UAAM,YAAY,cAAc,MAAM,EAAE,SAAS,QAAQ;AAGzD,UAAM,gBAAoD;AAAA,MACxD,MAAM,KAAK,OAAO,QAAQ,SAAS,EAAE,YAAY,KAAK,CAAC;AAAA,MACvD,IAAI,oBAAoB;AAAA,MACxB,cAAc;AAAA,MACd,cAAc,aAAa,SAAS;AAAA,MACpC,WAAW,UAAU,SAAS;AAAA,MAC9B;AAAA,MACA;AAAA,MACA,SAAS,QAAQ,SAAS;AAAA,IAC5B;AAGA,UAAM,UAA6B;AAAA,MACjC;AAAA,MACA;AAAA,IACF;AAGA,SAAK;AAEL,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;;;AC1FO,SAAS,uBAAuB,QAAoB,QAAqC;AAC9F,QAAM,SAAS,IAAI;AAAA,IACjB,OAAO;AAAA,IACP,OAAO;AAAA,IACP,OAAO;AAAA,EACT;AAGA,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AAEjD,WAAO,SAAS,QAAQ,CAAC,YAAY;AACnC,aAAO,SAAS,SAAS,MAAM;AAAA,IACjC,CAAC;AAAA,EACH,OAAO;AAEL,WAAO,SAAS,SAAS,MAAM;AAAA,EACjC;AAGA,MAAI,OAAO,UAAU;AACnB,WAAO,SAAS,QAAQ,CAAC,WAAW;AAClC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/exact/client/scheme.ts","../../src/exact/client/register.ts"],"sourcesContent":["/**\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","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":";;;;;;;;;;;;;;AAOA,SAAS,SAAS,gBAAgB;AA4B3B,IAAM,iBAAN,MAAoD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUzD,YACmB,QACA,wBAIA,SAA+B,CAAC,GACjD;AANiB;AACA;AAIA;AAfnB,wBAAS,UAAS;AAAA,EAgBf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYH,MAAM,qBACJ,aACA,qBAC0D;AAE1D,UAAM,UAAU,iBAAiB,oBAAoB,OAAO;AAG5D,QAAI,CAAC,oBAAoB,OAAO;AAC9B,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AACA,QAAI,CAAC,oBAAoB,OAAO;AAC9B,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AACA,QAAI,CAAC,oBAAoB,QAAQ;AAC/B,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACtC;AAGA,UAAM,sBAAsB,oBAAoB;AAChD,UAAM,qBAAqB,gBAAgB,oBAAoB,KAAK;AAGpE,UAAM,4BAA4B,MAAM,KAAK;AAAA,MAC3C,KAAK,OAAO,QAAQ,SAAS;AAAA,MAC7B;AAAA,IACF;AACA,UAAM,qBAAqB,QAAQ,MAAM,yBAAyB;AAGlE,UAAM,QAAQ,MAAM,KAAK,OAAO,SAAS;AAGzC,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AACxC,UAAM,aAAa,MAAM,oBAAoB;AAG7C,UAAM,UAAU,gBAAgB;AAGhC,UAAM,eAAe,OAAO,oBAAoB,MAAM;AAGtD,UAAM,qBAAqB,wBAAwB;AAAA,MACjD;AAAA,MACA,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,qBAAqB,KAAK,OAAO;AAAA,MACjC,eAAe,KAAK,OAAO,iBAAiB;AAAA,IAC9C,CAAC;AAGD,UAAM,YAAY,KAAK,OAAO,aAAa;AAG3C,UAAM,gBAAgB,MAAM,KAAK,OAAO,YAAY;AAAA,MAClD,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU,SAAS;AAAA,MACnB,SAAS,oBAAoB;AAAA,IAC/B,CAAC;AAGD,UAAM,YAAY,cAAc,MAAM,EAAE,SAAS,QAAQ;AAGzD,UAAM,gBAAoD;AAAA,MACxD,MAAM,KAAK,OAAO,QAAQ,SAAS,EAAE,YAAY,KAAK,CAAC;AAAA,MACvD,IAAI,oBAAoB;AAAA,MACxB,cAAc;AAAA,MACd,cAAc,aAAa,SAAS;AAAA,MACpC,WAAW,UAAU,SAAS;AAAA,MAC9B;AAAA,MACA;AAAA,MACA,SAAS,QAAQ,SAAS;AAAA,IAC5B;AAGA,UAAM,UAA6B;AAAA,MACjC;AAAA,MACA;AAAA,IACF;AAGA,SAAK;AAEL,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;;;AC1FO,SAAS,uBAAuB,QAAoB,QAAqC;AAC9F,QAAM,SAAS,IAAI;AAAA,IACjB,OAAO;AAAA,IACP,OAAO;AAAA,IACP,OAAO;AAAA,EACT;AAGA,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AAEjD,WAAO,SAAS,QAAQ,CAAC,YAAY;AACnC,aAAO,SAAS,SAAS,MAAM;AAAA,IACjC,CAAC;AAAA,EACH,OAAO;AAEL,WAAO,SAAS,SAAS,MAAM;AAAA,EACjC;AAGA,MAAI,OAAO,UAAU;AACnB,WAAO,SAAS,QAAQ,CAAC,WAAW;AAClC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/chunk-TC3EU5ZU.mjs

@@ -0,0 +1,15 @@
+// src/upto/types.ts
+function isUptoTonPayload(data) {
+  if (typeof data !== "object" || data === null) return false;
+  const p = data;
+  if (typeof p.signedBoc !== "string" || p.signedBoc === "") return false;
+  if (typeof p.paymentNonce !== "string" || p.paymentNonce === "") return false;
+  if (typeof p.authorization !== "object" || p.authorization === null) return false;
+  const auth = p.authorization;
+  return typeof auth.from === "string" && auth.from !== "" && typeof auth.facilitator === "string" && auth.facilitator !== "" && typeof auth.jettonMaster === "string" && typeof auth.maxAmount === "string" && typeof auth.tonAmount === "string" && typeof auth.validUntil === "number" && typeof auth.seqno === "number" && typeof auth.queryId === "string";
+}
+
+export {
+  isUptoTonPayload
+};
+//# sourceMappingURL=chunk-TC3EU5ZU.mjs.map

package/dist/esm/chunk-TC3EU5ZU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upto/types.ts"],"sourcesContent":["/**\n * TON Up-To Payment Scheme Types\n *\n * Defines the payload structure for TON Jetton upto payments in the t402 protocol.\n * Uses an escrow pattern: client transfers maxAmount to the facilitator address,\n * facilitator forwards settleAmount to payTo and refunds the rest.\n *\n * Uses BOC (Bag of Cells) format for message serialization.\n */\n\n/**\n * TON upto authorization metadata\n *\n * Contains all parameters for verifying the signed transfer message.\n */\nexport type UptoTonAuthorization = {\n  /**\n   * Sender wallet address (friendly format, bounceable)\n   * This is the TON wallet address that will send the Jetton transfer\n   */\n  from: string\n\n  /**\n   * Facilitator holding address that receives the initial transfer\n   * The facilitator will forward settleAmount to payTo and refund the rest\n   */\n  facilitator: string\n\n  /**\n   * Jetton master contract address\n   * Identifies which Jetton token is being transferred (e.g., USDT)\n   */\n  jettonMaster: string\n\n  /**\n   * Maximum authorized amount in smallest units (as string)\n   * The actual settlement amount may be less than this\n   */\n  maxAmount: string\n\n  /**\n   * TON amount attached for gas (in nanoTON, as string)\n   * Required to pay for the internal message execution\n   */\n  tonAmount: string\n\n  /**\n   * Unix timestamp (seconds) until which the message is valid\n   * Message will be rejected by the network after this time\n   */\n  validUntil: number\n\n  /**\n   * Wallet sequence number at time of signing\n   * Prevents replay attacks - each seqno can only be used once\n   */\n  seqno: number\n\n  /**\n   * Query ID for the Jetton transfer (as string for large numbers)\n   * Used for message correlation and deduplication\n   */\n  queryId: string\n}\n\n/**\n * TON upto payment payload (V2)\n *\n * Contains a pre-signed transfer message to the facilitator's holding address.\n * The facilitator will broadcast the transfer, then forward settleAmount to payTo\n * and refund (maxAmount - settleAmount) back to the client.\n */\nexport type UptoTonPayload = {\n  /**\n   * Base64 encoded signed external message (BOC format)\n   * Contains the complete Jetton transfer message ready for broadcast\n   * The message transfers maxAmount to the facilitator's holding address\n   */\n  signedBoc: string\n\n  /**\n   * Transfer authorization metadata for verification\n   * Provides human-readable and verifiable parameters\n   */\n  authorization: UptoTonAuthorization\n\n  /**\n   * Unique nonce for replay protection (hex string)\n   * Separate from the wallet seqno - used by the t402 protocol\n   */\n  paymentNonce: string\n}\n\n/**\n * TON upto-specific extra fields for payment requirements\n *\n * Included in PaymentRequirements.extra to provide upto-specific parameters.\n */\nexport type UptoTonExtra = {\n  /**\n   * Facilitator address that will receive the initial transfer\n   * Client should send maxAmount to this address\n   */\n  facilitator?: string\n\n  /**\n   * Maximum payment amount authorized\n   * The upper bound for the escrow transfer\n   */\n  maxAmount?: string\n\n  /**\n   * Minimum acceptable settlement amount\n   * Server may reject if usage is below this threshold\n   */\n  minAmount?: string\n\n  /**\n   * Billing unit (e.g., \"token\", \"request\", \"second\")\n   * Describes what is being measured for usage-based billing\n   */\n  unit?: string\n\n  /**\n   * Price per unit in smallest denomination\n   * Used with unit to calculate the final settlement amount\n   */\n  unitPrice?: string\n}\n\n/**\n * Type guard for UptoTonPayload\n *\n * Checks if the given data has the correct structure for a TON upto payload.\n * Validates the presence and types of required fields including signedBoc,\n * authorization (with from, facilitator, jettonMaster, maxAmount), and paymentNonce.\n *\n * @param data - The data to check\n * @returns True if the data is a valid UptoTonPayload\n */\nexport function isUptoTonPayload(data: unknown): data is UptoTonPayload {\n  if (typeof data !== 'object' || data === null) return false\n  const p = data as Record<string, unknown>\n\n  if (typeof p.signedBoc !== 'string' || p.signedBoc === '') return false\n  if (typeof p.paymentNonce !== 'string' || p.paymentNonce === '') return false\n\n  if (typeof p.authorization !== 'object' || p.authorization === null) return false\n  const auth = p.authorization as Record<string, unknown>\n\n  return (\n    typeof auth.from === 'string' &&\n    auth.from !== '' &&\n    typeof auth.facilitator === 'string' &&\n    auth.facilitator !== '' &&\n    typeof auth.jettonMaster === 'string' &&\n    typeof auth.maxAmount === 'string' &&\n    typeof auth.tonAmount === 'string' &&\n    typeof auth.validUntil === 'number' &&\n    typeof auth.seqno === 'number' &&\n    typeof auth.queryId === 'string'\n  )\n}\n"],"mappings":";AA4IO,SAAS,iBAAiB,MAAuC;AACtE,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,QAAM,IAAI;AAEV,MAAI,OAAO,EAAE,cAAc,YAAY,EAAE,cAAc,GAAI,QAAO;AAClE,MAAI,OAAO,EAAE,iBAAiB,YAAY,EAAE,iBAAiB,GAAI,QAAO;AAExE,MAAI,OAAO,EAAE,kBAAkB,YAAY,EAAE,kBAAkB,KAAM,QAAO;AAC5E,QAAM,OAAO,EAAE;AAEf,SACE,OAAO,KAAK,SAAS,YACrB,KAAK,SAAS,MACd,OAAO,KAAK,gBAAgB,YAC5B,KAAK,gBAAgB,MACrB,OAAO,KAAK,iBAAiB,YAC7B,OAAO,KAAK,cAAc,YAC1B,OAAO,KAAK,cAAc,YAC1B,OAAO,KAAK,eAAe,YAC3B,OAAO,KAAK,UAAU,YACtB,OAAO,KAAK,YAAY;AAE5B;","names":[]}

package/dist/esm/exact/client/index.d.mts

@@ -1,6 +1,6 @@
 import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@t402/core/types';
-import { C as ClientTonSigner } from '../../signer-Bqn2K0b4.mjs';
-import { t402Client, PaymentPolicy } from '@t402/core/client';
+import { C as ClientTonSigner } from '../../signer-BCr73V5A.mjs';
+import { PaymentPolicy, t402Client } from '@t402/core/client';
 import '@ton/core';
 
 /**

package/dist/esm/exact/client/index.mjs

@@ -1,8 +1,9 @@
 import {
   ExactTonScheme,
   registerExactTonScheme
-} from "../../chunk-7OE2PWYP.mjs";
-import "../../chunk-3BN2G4M7.mjs";
+} from "../../chunk-QTEA4ZJU.mjs";
+import "../../chunk-2EIGZGJU.mjs";
+import "../../chunk-NSSMTXJJ.mjs";
 export {
   ExactTonScheme,
   registerExactTonScheme

package/dist/esm/exact/facilitator/index.d.mts

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

package/dist/esm/exact/facilitator/index.mjs

@@ -1,8 +1,9 @@
 import {
   ExactTonScheme,
   registerExactTonScheme
-} from "../../chunk-ZJA7AWWH.mjs";
-import "../../chunk-3BN2G4M7.mjs";
+} from "../../chunk-OOC4E2LE.mjs";
+import "../../chunk-2EIGZGJU.mjs";
+import "../../chunk-NSSMTXJJ.mjs";
 export {
   ExactTonScheme,
   registerExactTonScheme