@t402/ton 2.0.0

package/dist/cjs/index.d.ts

@@ -0,0 +1,293 @@
+export { ExactTonScheme } from './exact/client/index.js';
+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.js';
+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 };