@t402/ton 2.0.0

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

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

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

@@ -0,0 +1,212 @@
+import {
+  JETTON_REGISTRY,
+  getDefaultJetton,
+  getJettonByAddress,
+  getJettonConfig
+} from "../../chunk-RST5PY7E.mjs";
+import {
+  SCHEME_EXACT,
+  normalizeNetwork
+} from "../../chunk-6LOUEHJT.mjs";
+
+// src/exact/server/scheme.ts
+var ExactTonScheme = class {
+  constructor(config = {}) {
+    this.scheme = SCHEME_EXACT;
+    this.moneyParsers = [];
+    this.config = config;
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   * Multiple parsers can be registered - they will be tried in registration order.
+   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
+   * If a parser returns null, the next parser in the chain will be tried.
+   * The default parser is always the final fallback.
+   *
+   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+   * @returns The server instance for chaining
+   *
+   * @example
+   * tonServer.registerMoneyParser(async (amount, network) => {
+   *   // Use custom Jetton for large amounts
+   *   if (amount > 1000) {
+   *     return {
+   *       amount: (amount * 1e9).toString(),
+   *       asset: "EQCustomJettonAddress...",
+   *       extra: { tier: "premium" }
+   *     };
+   *   }
+   *   return null; // Use next parser
+   * });
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parses a price into an asset amount.
+   * If price is already an AssetAmount, returns it directly.
+   * If price is Money (string | number), parses to decimal and tries custom parsers.
+   * Falls back to default conversion if all custom parsers return null.
+   *
+   * @param price - The price to parse
+   * @param network - The network to use
+   * @returns Promise that resolves to the parsed asset amount
+   */
+  async parsePrice(price, network) {
+    const normalizedNetwork = normalizeNetwork(network);
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);
+      }
+      return {
+        amount: price.amount,
+        asset: price.asset,
+        extra: price.extra || {}
+      };
+    }
+    const amount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(amount, normalizedNetwork);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, normalizedNetwork);
+  }
+  /**
+   * Build payment requirements for this scheme/network combination.
+   * Adds TON-specific fields like gas sponsor if provided by facilitator.
+   *
+   * @param paymentRequirements - Base payment requirements with amount/asset already set
+   * @param supportedKind - The supported kind from facilitator's /supported endpoint
+   * @param extensionKeys - Extensions supported by the facilitator (unused)
+   * @returns Enhanced payment requirements ready to be sent to clients
+   */
+  async enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
+    void extensionKeys;
+    const extra = { ...paymentRequirements.extra };
+    if (supportedKind.extra?.gasSponsor) {
+      extra.gasSponsor = supportedKind.extra.gasSponsor;
+    }
+    return {
+      ...paymentRequirements,
+      extra
+    };
+  }
+  /**
+   * Parse Money (string | number) to a decimal number.
+   * Handles formats like "$1.50", "1.50", 1.50, etc.
+   *
+   * @param money - The money value to parse
+   * @returns Decimal number
+   */
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      return money;
+    }
+    const cleanMoney = money.replace(/^\$/, "").trim();
+    const amount = parseFloat(cleanMoney);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid money format: ${money}`);
+    }
+    return amount;
+  }
+  /**
+   * Default money conversion implementation.
+   * Converts decimal amount to the preferred Jetton on the specified network.
+   *
+   * @param amount - The decimal amount (e.g., 1.50)
+   * @param network - The network to use
+   * @returns The parsed asset amount
+   */
+  defaultMoneyConversion(amount, network) {
+    const jetton = this.getDefaultAsset(network);
+    const tokenAmount = this.convertToTokenAmount(amount.toString(), jetton.decimals);
+    return {
+      amount: tokenAmount,
+      asset: jetton.masterAddress,
+      extra: {
+        symbol: jetton.symbol,
+        name: jetton.name,
+        decimals: jetton.decimals
+      }
+    };
+  }
+  /**
+   * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal tokens)
+   *
+   * @param decimalAmount - The decimal amount to convert
+   * @param decimals - Number of decimals for the token
+   * @returns The token amount as a string
+   */
+  convertToTokenAmount(decimalAmount, decimals) {
+    const amount = parseFloat(decimalAmount);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid amount: ${decimalAmount}`);
+    }
+    const tokenAmount = Math.floor(amount * Math.pow(10, decimals));
+    return tokenAmount.toString();
+  }
+  /**
+   * Get the default asset info for a network.
+   * Priority: configured preferredJetton > USDT > first available
+   *
+   * @param network - The network to get asset info for
+   * @returns The Jetton configuration
+   */
+  getDefaultAsset(network) {
+    if (this.config.preferredJetton) {
+      const preferred = getJettonConfig(network, this.config.preferredJetton);
+      if (preferred) return preferred;
+    }
+    const defaultJetton = getDefaultJetton(network);
+    if (defaultJetton) return defaultJetton;
+    throw new Error(`No Jettons configured for network ${network}`);
+  }
+  /**
+   * Get Jetton info for a given symbol on a network
+   *
+   * @param symbol - The Jetton symbol (e.g., "USDT")
+   * @param network - The network to use
+   * @returns The Jetton configuration
+   */
+  getAssetInfo(symbol, network) {
+    const jetton = getJettonConfig(network, symbol);
+    if (jetton) return jetton;
+    if (symbol.toUpperCase() === "USD") {
+      return this.getDefaultAsset(network);
+    }
+    throw new Error(`Unsupported Jetton: ${symbol} on network ${network}`);
+  }
+  /**
+   * Get the number of decimals for a Jetton on a network
+   *
+   * @param network - The network to use
+   * @param jettonAddress - Optional Jetton address to look up
+   * @returns The number of decimals for the Jetton
+   */
+  getAssetDecimals(network, jettonAddress) {
+    if (jettonAddress) {
+      const jetton = getJettonByAddress(network, jettonAddress);
+      if (jetton) return jetton.decimals;
+    }
+    return 6;
+  }
+  /**
+   * Get all supported networks
+   */
+  static getSupportedNetworks() {
+    return Object.keys(JETTON_REGISTRY);
+  }
+  /**
+   * Check if a network is supported
+   */
+  static isNetworkSupported(network) {
+    return network in JETTON_REGISTRY;
+  }
+};
+export {
+  ExactTonScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/server/scheme.ts"],"sourcesContent":["/**\n * TON Server Scheme Implementation\n *\n * Handles price parsing and payment requirement enhancement for\n * TON Jetton payments using the exact scheme.\n */\n\nimport type {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT } from \"../../constants.js\";\nimport {\n  getDefaultJetton,\n  getJettonConfig,\n  getJettonByAddress,\n  JETTON_REGISTRY,\n} from \"../../tokens.js\";\nimport { normalizeNetwork } from \"../../utils.js\";\n\n/**\n * Configuration options for ExactTonScheme server\n */\nexport interface ExactTonSchemeConfig {\n  /** Preferred Jetton symbol (e.g., \"USDT\"). Defaults to network's highest priority token. */\n  preferredJetton?: string;\n}\n\n/**\n * TON server implementation for the Exact payment scheme.\n * Handles price parsing and converts user-friendly amounts to Jetton amounts.\n */\nexport class ExactTonScheme implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT;\n  private moneyParsers: MoneyParser[] = [];\n  private config: ExactTonSchemeConfig;\n\n  constructor(config: ExactTonSchemeConfig = {}) {\n    this.config = config;\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   * Multiple parsers can be registered - they will be tried in registration order.\n   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).\n   * If a parser returns null, the next parser in the chain will be tried.\n   * The default parser is always the final fallback.\n   *\n   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n   * @returns The server instance for chaining\n   *\n   * @example\n   * tonServer.registerMoneyParser(async (amount, network) => {\n   *   // Use custom Jetton for large amounts\n   *   if (amount > 1000) {\n   *     return {\n   *       amount: (amount * 1e9).toString(),\n   *       asset: \"EQCustomJettonAddress...\",\n   *       extra: { tier: \"premium\" }\n   *     };\n   *   }\n   *   return null; // Use next parser\n   * });\n   */\n  registerMoneyParser(parser: MoneyParser): ExactTonScheme {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parses a price into an asset amount.\n   * If price is already an AssetAmount, returns it directly.\n   * If price is Money (string | number), parses to decimal and tries custom parsers.\n   * Falls back to default conversion if all custom parsers return null.\n   *\n   * @param price - The price to parse\n   * @param network - The network to use\n   * @returns Promise that resolves to the parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // Normalize network to CAIP-2 format\n    const normalizedNetwork = normalizeNetwork(network);\n\n    // If already an AssetAmount, return it directly\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      if (!price.asset) {\n        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      };\n    }\n\n    // Parse Money to decimal number\n    const amount = this.parseMoneyToDecimal(price);\n\n    // Try each custom money parser in order\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, normalizedNetwork);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, normalizedNetwork);\n  }\n\n  /**\n   * Build payment requirements for this scheme/network combination.\n   * Adds TON-specific fields like gas sponsor if provided by facilitator.\n   *\n   * @param paymentRequirements - Base payment requirements with amount/asset already set\n   * @param supportedKind - The supported kind from facilitator's /supported endpoint\n   * @param extensionKeys - Extensions supported by the facilitator (unused)\n   * @returns Enhanced payment requirements ready to be sent to clients\n   */\n  async enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      t402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    // Mark unused parameters to satisfy linter\n    void extensionKeys;\n\n    // Start with existing extra fields\n    const extra = { ...paymentRequirements.extra };\n\n    // Add gas sponsor from facilitator if provided\n    if (supportedKind.extra?.gasSponsor) {\n      extra.gasSponsor = supportedKind.extra.gasSponsor;\n    }\n\n    return {\n      ...paymentRequirements,\n      extra,\n    };\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   * Handles formats like \"$1.50\", \"1.50\", 1.50, etc.\n   *\n   * @param money - The money value to parse\n   * @returns Decimal number\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      return money;\n    }\n\n    // Remove $ sign and whitespace, then parse\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n\n    return amount;\n  }\n\n  /**\n   * Default money conversion implementation.\n   * Converts decimal amount to the preferred Jetton on the specified network.\n   *\n   * @param amount - The decimal amount (e.g., 1.50)\n   * @param network - The network to use\n   * @returns The parsed asset amount\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const jetton = this.getDefaultAsset(network);\n\n    // Convert decimal amount to token amount\n    const tokenAmount = this.convertToTokenAmount(amount.toString(), jetton.decimals);\n\n    return {\n      amount: tokenAmount,\n      asset: jetton.masterAddress,\n      extra: {\n        symbol: jetton.symbol,\n        name: jetton.name,\n        decimals: jetton.decimals,\n      },\n    };\n  }\n\n  /**\n   * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal tokens)\n   *\n   * @param decimalAmount - The decimal amount to convert\n   * @param decimals - Number of decimals for the token\n   * @returns The token amount as a string\n   */\n  private convertToTokenAmount(decimalAmount: string, decimals: number): string {\n    const amount = parseFloat(decimalAmount);\n    if (isNaN(amount)) {\n      throw new Error(`Invalid amount: ${decimalAmount}`);\n    }\n    // Convert to smallest unit (e.g., for USDT with 6 decimals: 0.10 * 10^6 = 100000)\n    const tokenAmount = Math.floor(amount * Math.pow(10, decimals));\n    return tokenAmount.toString();\n  }\n\n  /**\n   * Get the default asset info for a network.\n   * Priority: configured preferredJetton > USDT > first available\n   *\n   * @param network - The network to get asset info for\n   * @returns The Jetton configuration\n   */\n  private getDefaultAsset(\n    network: Network,\n  ): { masterAddress: string; symbol: string; name: string; decimals: number } {\n    // If a preferred Jetton is configured, try to use it\n    if (this.config.preferredJetton) {\n      const preferred = getJettonConfig(network, this.config.preferredJetton);\n      if (preferred) return preferred;\n    }\n\n    // Use the network's default token (sorted by priority)\n    const defaultJetton = getDefaultJetton(network);\n    if (defaultJetton) return defaultJetton;\n\n    throw new Error(`No Jettons configured for network ${network}`);\n  }\n\n  /**\n   * Get Jetton info for a given symbol on a network\n   *\n   * @param symbol - The Jetton symbol (e.g., \"USDT\")\n   * @param network - The network to use\n   * @returns The Jetton configuration\n   */\n  private getAssetInfo(\n    symbol: string,\n    network: Network,\n  ): { masterAddress: string; symbol: string; name: string; decimals: number } {\n    const jetton = getJettonConfig(network, symbol);\n    if (jetton) return jetton;\n\n    // Fallback: treat \"USD\" as request for default stablecoin\n    if (symbol.toUpperCase() === \"USD\") {\n      return this.getDefaultAsset(network);\n    }\n\n    throw new Error(`Unsupported Jetton: ${symbol} on network ${network}`);\n  }\n\n  /**\n   * Get the number of decimals for a Jetton on a network\n   *\n   * @param network - The network to use\n   * @param jettonAddress - Optional Jetton address to look up\n   * @returns The number of decimals for the Jetton\n   */\n  private getAssetDecimals(network: Network, jettonAddress?: string): number {\n    if (jettonAddress) {\n      const jetton = getJettonByAddress(network, jettonAddress);\n      if (jetton) return jetton.decimals;\n    }\n    // Default to 6 decimals (USDT standard)\n    return 6;\n  }\n\n  /**\n   * Get all supported networks\n   */\n  static getSupportedNetworks(): string[] {\n    return Object.keys(JETTON_REGISTRY);\n  }\n\n  /**\n   * Check if a network is supported\n   */\n  static isNetworkSupported(network: string): boolean {\n    return network in JETTON_REGISTRY;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/esm/index.d.mts

@@ -0,0 +1,293 @@
+export { ExactTonScheme } from './exact/client/index.mjs';
+export { C as ClientTonSigner, b as ExactTonPayload, E as ExactTonPayloadV2, F as FacilitatorTonSigner, S as SignMessageParams, T as TransactionConfirmation, V as VerifyMessageParams, c as VerifyMessageResult, W as WaitForTransactionParams, t as toClientTonSigner, a as toFacilitatorTonSigner } from './signer-CFiw2DST.mjs';
+import { Address, Cell } from '@ton/core';
+import { Network } from '@t402/core/types';
+
+/**
+ * TON Jetton Token Configuration
+ *
+ * This module provides comprehensive Jetton token definitions including:
+ * - USDT (Tether USD on TON)
+ * - Network-specific configurations
+ * - Helper functions for token lookups
+ */
+/**
+ * Jetton token configuration
+ */
+interface JettonConfig {
+    /** Jetton master contract address (friendly format) */
+    masterAddress: string;
+    /** Token symbol */
+    symbol: string;
+    /** Token name */
+    name: string;
+    /** Number of decimal places */
+    decimals: number;
+    /** Payment priority (lower = higher priority) */
+    priority: number;
+}
+/**
+ * Network token registry mapping network -> symbol -> config
+ */
+type NetworkJettonRegistry = Record<string, Record<string, JettonConfig>>;
+/**
+ * USDT Jetton Master Contract Addresses by Network
+ *
+ * USDT on TON follows the TEP-74 Jetton standard.
+ * @see https://docs.tether.to/tether-on-ton
+ */
+declare const USDT_ADDRESSES: Record<string, string>;
+/**
+ * Complete Jetton registry with all supported tokens per network
+ */
+declare const JETTON_REGISTRY: NetworkJettonRegistry;
+/**
+ * Get Jetton configuration for a specific token on a network
+ *
+ * @param network - Network identifier (CAIP-2 format)
+ * @param symbol - Token symbol (e.g., "USDT")
+ * @returns Jetton configuration or undefined
+ */
+declare function getJettonConfig(network: string, symbol: string): JettonConfig | undefined;
+/**
+ * Get all Jettons available on a network
+ *
+ * @param network - Network identifier
+ * @returns Array of Jetton configurations sorted by priority
+ */
+declare function getNetworkJettons(network: string): JettonConfig[];
+/**
+ * Get the default/preferred Jetton for a network
+ * Prefers USDT based on priority
+ *
+ * @param network - Network identifier
+ * @returns Default Jetton configuration or undefined
+ */
+declare function getDefaultJetton(network: string): JettonConfig | undefined;
+/**
+ * Get Jetton by master contract address on a network
+ *
+ * @param network - Network identifier
+ * @param address - Jetton master contract address
+ * @returns Jetton configuration or undefined
+ */
+declare function getJettonByAddress(network: string, address: string): JettonConfig | undefined;
+/**
+ * Get all networks that support a specific Jetton
+ *
+ * @param symbol - Token symbol
+ * @returns Array of network identifiers
+ */
+declare function getNetworksForJetton(symbol: string): string[];
+/**
+ * Get USDT networks on TON
+ *
+ * @returns Array of networks supporting USDT
+ */
+declare function getUsdtNetworks(): string[];
+/**
+ * Check if a network is supported
+ *
+ * @param network - Network identifier to check
+ * @returns true if network has configured Jettons
+ */
+declare function isNetworkSupported(network: string): boolean;
+/**
+ * Get all supported networks
+ *
+ * @returns Array of all supported network identifiers
+ */
+declare function getSupportedNetworks(): string[];
+
+/**
+ * TON Network Constants
+ *
+ * This module provides constants for TON blockchain integration including:
+ * - CAIP-2 network identifiers
+ * - RPC endpoints
+ * - Jetton transfer operation codes
+ * - Default gas amounts
+ */
+/**
+ * CAIP-2 Network Identifiers for TON
+ * Using simple identifiers for mainnet/testnet
+ */
+declare const TON_MAINNET_CAIP2 = "ton:mainnet";
+declare const TON_TESTNET_CAIP2 = "ton:testnet";
+/**
+ * Supported TON networks
+ */
+declare const TON_NETWORKS: readonly ["ton:mainnet", "ton:testnet"];
+type TonNetwork = (typeof TON_NETWORKS)[number];
+/**
+ * Default RPC endpoints (TonCenter API v2)
+ */
+declare const TON_MAINNET_ENDPOINT = "https://toncenter.com/api/v2/jsonRPC";
+declare const TON_TESTNET_ENDPOINT = "https://testnet.toncenter.com/api/v2/jsonRPC";
+/**
+ * TON API v4 endpoints (for @ton/ton TonClient4)
+ */
+declare const TON_MAINNET_V4_ENDPOINT = "https://mainnet-v4.tonhubapi.com";
+declare const TON_TESTNET_V4_ENDPOINT = "https://testnet-v4.tonhubapi.com";
+/**
+ * Network endpoint mapping
+ */
+declare const NETWORK_ENDPOINTS: Record<string, string>;
+declare const NETWORK_V4_ENDPOINTS: Record<string, string>;
+/**
+ * Jetton Transfer Operation Codes (TEP-74)
+ * @see https://github.com/ton-blockchain/TEPs/blob/master/text/0074-jettons-standard.md
+ */
+declare const JETTON_TRANSFER_OP = 260734629;
+declare const JETTON_INTERNAL_TRANSFER_OP = 395134233;
+declare const JETTON_TRANSFER_NOTIFICATION_OP = 1935855772;
+declare const JETTON_BURN_OP = 1499400124;
+/**
+ * Default gas amounts for Jetton transfers
+ * TON requires attaching TON for gas to internal messages
+ */
+declare const DEFAULT_JETTON_TRANSFER_TON = 100000000n;
+declare const DEFAULT_FORWARD_TON = 1n;
+declare const MIN_JETTON_TRANSFER_TON = 50000000n;
+/**
+ * Maximum gas amounts to prevent excessive fees
+ */
+declare const MAX_JETTON_TRANSFER_TON = 500000000n;
+/**
+ * Scheme identifier for exact payments
+ */
+declare const SCHEME_EXACT = "exact";
+/**
+ * Default timeout for payment validity (in seconds)
+ */
+declare const DEFAULT_VALIDITY_DURATION = 3600;
+
+/**
+ * TON Utility Functions
+ *
+ * Helper functions for TON address handling, message building,
+ * and network operations.
+ */
+
+/**
+ * Normalize network identifier to CAIP-2 format
+ *
+ * @param network - Network identifier (may be legacy format)
+ * @returns Normalized CAIP-2 network identifier
+ * @throws Error if network is not supported
+ */
+declare function normalizeNetwork(network: Network): Network;
+/**
+ * Get RPC endpoint for a network
+ *
+ * @param network - Network identifier
+ * @returns RPC endpoint URL
+ */
+declare function getEndpoint(network: Network): string;
+/**
+ * Check if a network identifier is a supported TON network
+ *
+ * @param network - Network identifier to check
+ * @returns true if supported
+ */
+declare function isTonNetwork(network: string): boolean;
+/**
+ * Validate TON address format
+ *
+ * @param address - Address to validate
+ * @returns true if valid TON address
+ */
+declare function validateTonAddress(address: string): boolean;
+/**
+ * Parse TON address from string
+ *
+ * @param address - Address string (friendly or raw format)
+ * @returns Parsed Address object
+ * @throws Error if invalid format
+ */
+declare function parseTonAddress(address: string): Address;
+/**
+ * Compare two TON addresses for equality
+ * Handles different address formats (friendly, raw, bounceable/non-bounceable)
+ *
+ * @param addr1 - First address
+ * @param addr2 - Second address
+ * @returns true if addresses are equal
+ */
+declare function addressesEqual(addr1: string, addr2: string): boolean;
+/**
+ * Format address to friendly format
+ *
+ * @param address - Address to format
+ * @param options - Formatting options
+ * @returns Friendly format address string
+ */
+declare function formatAddress(address: string | Address, options?: {
+    bounceable?: boolean;
+    testOnly?: boolean;
+}): string;
+/**
+ * Convert decimal amount to smallest units (e.g., nano-Jettons)
+ *
+ * @param decimalAmount - Amount in decimal format (e.g., "1.50")
+ * @param decimals - Number of decimal places
+ * @returns Amount in smallest units as string
+ */
+declare function convertToJettonAmount(decimalAmount: string, decimals: number): string;
+/**
+ * Convert smallest units to decimal amount
+ *
+ * @param jettonAmount - Amount in smallest units
+ * @param decimals - Number of decimal places
+ * @returns Amount in decimal format as string
+ */
+declare function convertFromJettonAmount(jettonAmount: string | bigint, decimals: number): string;
+/**
+ * Generate a unique query ID for Jetton transfer
+ * Uses timestamp + random component for uniqueness
+ *
+ * @returns BigInt query ID
+ */
+declare function generateQueryId(): bigint;
+/**
+ * Build Jetton transfer message body (TEP-74)
+ *
+ * @param params - Transfer parameters
+ * @returns Cell containing the transfer message
+ */
+declare function buildJettonTransferBody(params: {
+    queryId: bigint;
+    amount: bigint;
+    destination: Address;
+    responseDestination: Address;
+    forwardAmount?: bigint;
+    forwardPayload?: Cell;
+}): Cell;
+/**
+ * Parse Jetton transfer message from Cell
+ *
+ * @param body - Cell containing the message
+ * @returns Parsed transfer parameters
+ * @throws Error if not a valid Jetton transfer message
+ */
+declare function parseJettonTransferBody(body: Cell): {
+    op: number;
+    queryId: bigint;
+    amount: bigint;
+    destination: Address;
+    responseDestination: Address;
+    forwardAmount: bigint;
+    forwardPayload?: Cell;
+};
+/**
+ * Calculate estimated gas for Jetton transfer
+ * Based on typical TON network fees
+ *
+ * @param params - Optional parameters for estimation
+ * @returns Estimated gas in nanoTON
+ */
+declare function estimateJettonTransferGas(_params?: {
+    hasForwardPayload?: boolean;
+}): bigint;
+
+export { DEFAULT_FORWARD_TON, DEFAULT_JETTON_TRANSFER_TON, DEFAULT_VALIDITY_DURATION, JETTON_BURN_OP, JETTON_INTERNAL_TRANSFER_OP, JETTON_REGISTRY, JETTON_TRANSFER_NOTIFICATION_OP, JETTON_TRANSFER_OP, type JettonConfig, MAX_JETTON_TRANSFER_TON, MIN_JETTON_TRANSFER_TON, NETWORK_ENDPOINTS, NETWORK_V4_ENDPOINTS, type NetworkJettonRegistry, SCHEME_EXACT, TON_MAINNET_CAIP2, TON_MAINNET_ENDPOINT, TON_MAINNET_V4_ENDPOINT, TON_NETWORKS, TON_TESTNET_CAIP2, TON_TESTNET_ENDPOINT, TON_TESTNET_V4_ENDPOINT, type TonNetwork, USDT_ADDRESSES, addressesEqual, buildJettonTransferBody, convertFromJettonAmount, convertToJettonAmount, estimateJettonTransferGas, formatAddress, generateQueryId, getDefaultJetton, getEndpoint, getJettonByAddress, getJettonConfig, getNetworkJettons, getNetworksForJetton, getSupportedNetworks, getUsdtNetworks, isNetworkSupported, isTonNetwork, normalizeNetwork, parseJettonTransferBody, parseTonAddress, validateTonAddress };