@truecarry/mcp 0.1.0

package/dist/services/McpWalletService.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type { SwapQuote } from '@ton/walletkit';
+import type { LimitsConfig } from '../types/config.js';
+import type { IStorageAdapter } from '../types/storage.js';
+import type { ISignerAdapter } from '../types/signer.js';
+import type { IContactResolver } from '../types/contacts.js';
+import { UserScopedStorage } from '../core/UserScopedStorage.js';
+import { UserScopedSigner } from '../core/UserScopedSigner.js';
+import { LimitsManager } from '../core/LimitsManager.js';
+import { PendingTransactionManager } from '../core/PendingTransactionManager.js';
+import type { PendingTransaction } from '../core/PendingTransactionManager.js';
+/**
+ * Wallet info returned to tools (no sensitive data)
+ */
+export interface McpWalletInfo {
+    name: string;
+    address: string;
+    network: 'mainnet' | 'testnet';
+    version: 'v5r1' | 'v4r2';
+    createdAt: string;
+}
+/**
+ * Result of creating a wallet (no mnemonic!)
+ */
+export interface CreateWalletResult {
+    name: string;
+    address: string;
+    network: 'mainnet' | 'testnet';
+}
+/**
+ * Result of importing a wallet
+ */
+export interface ImportWalletResult {
+    name: string;
+    address: string;
+    network: 'mainnet' | 'testnet';
+}
+/**
+ * Jetton information
+ */
+export interface JettonInfoResult {
+    address: string;
+    balance: string;
+    name?: string;
+    symbol?: string;
+    decimals?: number;
+}
+/**
+ * Transaction info (from events API)
+ */
+export interface TransactionInfo {
+    eventId: string;
+    timestamp: number;
+    type: 'TonTransfer' | 'JettonTransfer' | 'JettonSwap' | 'NftItemTransfer' | 'ContractDeploy' | 'SmartContractExec' | 'Unknown';
+    status: 'success' | 'failure';
+    from?: string;
+    to?: string;
+    amount?: string;
+    comment?: string;
+    jettonAddress?: string;
+    jettonSymbol?: string;
+    jettonAmount?: string;
+    dex?: string;
+    amountIn?: string;
+    amountOut?: string;
+    description?: string;
+    isScam: boolean;
+}
+/**
+ * Transfer result
+ */
+export interface TransferResult {
+    success: boolean;
+    message: string;
+    pendingTransactionId?: string;
+}
+/**
+ * Swap quote result
+ */
+export interface SwapQuoteResult {
+    quote: SwapQuote;
+    fromToken: string;
+    toToken: string;
+    fromAmount: string;
+    toAmount: string;
+    minReceived: string;
+    provider: string;
+    expiresAt?: number;
+}
+/**
+ * Swap result
+ */
+export interface SwapResult {
+    success: boolean;
+    message: string;
+    pendingTransactionId?: string;
+}
+/**
+ * Network configuration with optional API key
+ */
+export interface NetworkConfig {
+    /** TonCenter API key for this network */
+    apiKey?: string;
+}
+/**
+ * Configuration for McpWalletService
+ */
+export interface McpWalletServiceConfig {
+    storage: IStorageAdapter;
+    signer: ISignerAdapter;
+    contacts?: IContactResolver;
+    defaultNetwork?: 'mainnet' | 'testnet';
+    limits?: LimitsConfig;
+    requireConfirmation?: boolean;
+    /** Network-specific configuration */
+    networks?: {
+        mainnet?: NetworkConfig;
+        testnet?: NetworkConfig;
+    };
+}
+/**
+ * McpWalletService manages wallet operations for multi-user MCP deployments.
+ */
+export declare class McpWalletService {
+    private readonly config;
+    private readonly limitsManager;
+    private readonly pendingManager;
+    private kit;
+    private loadedWallets;
+    constructor(config: McpWalletServiceConfig);
+    /**
+     * Get Network instance from network name
+     */
+    private getNetwork;
+    /**
+     * Initialize TonWalletKit
+     */
+    private getKit;
+    /**
+     * Create user-scoped storage wrapper
+     */
+    createUserStorage(userId: string): UserScopedStorage;
+    /**
+     * Create user-scoped signer wrapper
+     */
+    createUserSigner(userId: string): UserScopedSigner;
+    /**
+     * Get limits manager
+     */
+    getLimitsManager(): LimitsManager;
+    /**
+     * Get pending transaction manager
+     */
+    getPendingManager(): PendingTransactionManager;
+    /**
+     * Check if confirmation is required
+     */
+    requiresConfirmation(): boolean;
+    /**
+     * Create a new wallet for a user
+     */
+    createWallet(userSigner: UserScopedSigner, userStorage: UserScopedStorage, name: string, version?: 'v5r1' | 'v4r2', networkName?: 'mainnet' | 'testnet'): Promise<CreateWalletResult>;
+    /**
+     * Import a wallet for a user
+     */
+    importWallet(userSigner: UserScopedSigner, userStorage: UserScopedStorage, name: string, mnemonic: string[], version?: 'v5r1' | 'v4r2', networkName?: 'mainnet' | 'testnet'): Promise<ImportWalletResult>;
+    /**
+     * List all wallets for a user
+     */
+    listWallets(userSigner: UserScopedSigner): Promise<McpWalletInfo[]>;
+    /**
+     * Remove a wallet for a user
+     */
+    removeWallet(userSigner: UserScopedSigner, userStorage: UserScopedStorage, name: string): Promise<boolean>;
+    /**
+     * Get or load a wallet for balance/transfer operations
+     */
+    private getWalletForOperations;
+    /**
+     * Get TON balance
+     */
+    getBalance(userSigner: UserScopedSigner, walletName: string): Promise<string>;
+    /**
+     * Get Jetton balance
+     */
+    getJettonBalance(userSigner: UserScopedSigner, walletName: string, jettonAddress: string): Promise<string>;
+    /**
+     * Get all Jettons
+     */
+    getJettons(userSigner: UserScopedSigner, walletName: string): Promise<JettonInfoResult[]>;
+    /**
+     * Get transaction history for a wallet
+     */
+    /**
+     * Get transaction history using events API (like demo wallet)
+     */
+    getTransactions(userSigner: UserScopedSigner, walletName: string, limit?: number): Promise<TransactionInfo[]>;
+    /**
+     * Send TON (with optional confirmation flow)
+     */
+    sendTon(userSigner: UserScopedSigner, userStorage: UserScopedStorage, walletName: string, toAddress: string, amountNano: string, amountTon: string, comment?: string): Promise<TransferResult>;
+    /**
+     * Execute TON transfer (internal)
+     */
+    executeTonTransfer(userSigner: UserScopedSigner, userStorage: UserScopedStorage, walletName: string, toAddress: string, amountNano: string, comment?: string): Promise<TransferResult>;
+    /**
+     * Send Jetton (with optional confirmation flow)
+     */
+    sendJetton(userSigner: UserScopedSigner, userStorage: UserScopedStorage, walletName: string, toAddress: string, jettonAddress: string, amountRaw: string, amountHuman: string, symbol: string | undefined, decimals: number, comment?: string): Promise<TransferResult>;
+    /**
+     * Execute Jetton transfer (internal)
+     */
+    executeJettonTransfer(userSigner: UserScopedSigner, walletName: string, toAddress: string, jettonAddress: string, amountRaw: string, comment?: string): Promise<TransferResult>;
+    /**
+     * Get swap quote
+     */
+    getSwapQuote(userSigner: UserScopedSigner, walletName: string, fromToken: string, toToken: string, amount: string, slippageBps?: number): Promise<SwapQuoteResult>;
+    /**
+     * Execute swap (with optional confirmation flow)
+     */
+    executeSwap(userSigner: UserScopedSigner, userStorage: UserScopedStorage, walletName: string, quote: SwapQuote): Promise<SwapResult>;
+    /**
+     * Execute swap (internal)
+     */
+    executeSwapInternal(userSigner: UserScopedSigner, walletName: string, quote: SwapQuote): Promise<SwapResult>;
+    /**
+     * Confirm a pending transaction
+     */
+    confirmTransaction(userSigner: UserScopedSigner, userStorage: UserScopedStorage, transactionId: string): Promise<TransferResult | SwapResult>;
+    /**
+     * Cancel a pending transaction
+     */
+    cancelTransaction(userStorage: UserScopedStorage, transactionId: string): Promise<boolean>;
+    /**
+     * List pending transactions
+     */
+    listPendingTransactions(userStorage: UserScopedStorage): Promise<PendingTransaction[]>;
+    /**
+     * Resolve contact name to address
+     */
+    resolveContact(userId: string, name: string): Promise<string | null>;
+    /**
+     * Close and cleanup
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=McpWalletService.d.ts.map

package/dist/services/McpWalletService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpWalletService.d.ts","sourceRoot":"","sources":["../../src/services/McpWalletService.ts"],"names":[],"mappings":"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"}

package/dist/services/WalletService.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type { SwapQuote } from '@ton/walletkit';
+export interface CreateWalletResult {
+    name: string;
+    address: string;
+    mnemonic: string[];
+    network: 'mainnet' | 'testnet';
+}
+export interface ImportWalletResult {
+    name: string;
+    address: string;
+    network: 'mainnet' | 'testnet';
+}
+export interface WalletInfo {
+    name: string;
+    address: string;
+    network: 'mainnet' | 'testnet';
+    version: 'v5r1' | 'v4r2';
+    createdAt: string;
+}
+export interface JettonInfoResult {
+    address: string;
+    balance: string;
+    name?: string;
+    symbol?: string;
+    decimals?: number;
+}
+export interface TransactionInfo {
+    eventId: string;
+    timestamp: number;
+    type: 'TonTransfer' | 'JettonTransfer' | 'JettonSwap' | 'NftItemTransfer' | 'ContractDeploy' | 'SmartContractExec' | 'Unknown';
+    status: 'success' | 'failure';
+    from?: string;
+    to?: string;
+    amount?: string;
+    comment?: string;
+    jettonAddress?: string;
+    jettonSymbol?: string;
+    jettonAmount?: string;
+    dex?: string;
+    amountIn?: string;
+    amountOut?: string;
+    description?: string;
+    isScam: boolean;
+}
+export interface TransferResult {
+    success: boolean;
+    message: string;
+}
+export interface SwapQuoteResult {
+    quote: SwapQuote;
+    fromToken: string;
+    toToken: string;
+    fromAmount: string;
+    toAmount: string;
+    minReceived: string;
+    provider: string;
+    expiresAt?: number;
+}
+export interface SwapResult {
+    success: boolean;
+    message: string;
+}
+/**
+ * WalletService manages TON wallets using TonWalletKit
+ * Supports both mainnet and testnet simultaneously
+ */
+export declare class WalletService {
+    private storage;
+    private kit;
+    private loadedWallets;
+    constructor();
+    /**
+     * Get Network instance from network name
+     */
+    private getNetwork;
+    /**
+     * Initialize the TonWalletKit instance (supports both networks)
+     */
+    private getKit;
+    /**
+     * Create a new wallet with generated mnemonic
+     */
+    createWallet(name: string, version?: 'v5r1' | 'v4r2', networkName?: 'mainnet' | 'testnet'): Promise<CreateWalletResult>;
+    /**
+     * Import a wallet from mnemonic
+     */
+    importWallet(name: string, mnemonic: string[], version?: 'v5r1' | 'v4r2', networkName?: 'mainnet' | 'testnet'): Promise<ImportWalletResult>;
+    /**
+     * List all stored wallets
+     */
+    listWallets(): Promise<WalletInfo[]>;
+    /**
+     * Remove a wallet by name
+     */
+    removeWallet(name: string): Promise<boolean>;
+    /**
+     * Get or load a wallet by name
+     */
+    private getWalletByName;
+    /**
+     * Get TON balance for a wallet
+     */
+    getBalance(walletName: string): Promise<string>;
+    /**
+     * Get Jetton balance for a wallet
+     */
+    getJettonBalance(walletName: string, jettonAddress: string): Promise<string>;
+    /**
+     * Get all Jettons for a wallet
+     */
+    getJettons(walletName: string): Promise<JettonInfoResult[]>;
+    /**
+     * Get transaction history for a wallet using events API (like demo wallet)
+     */
+    getTransactions(walletName: string, limit?: number): Promise<TransactionInfo[]>;
+    /**
+     * Send TON to an address
+     */
+    sendTon(walletName: string, toAddress: string, amount: string, comment?: string): Promise<TransferResult>;
+    /**
+     * Send Jetton to an address
+     */
+    sendJetton(walletName: string, toAddress: string, jettonAddress: string, amount: string, comment?: string): Promise<TransferResult>;
+    /**
+     * Get a swap quote
+     */
+    getSwapQuote(walletName: string, fromToken: string, toToken: string, amount: string, slippageBps?: number): Promise<SwapQuoteResult>;
+    /**
+     * Execute a swap using a quote
+     */
+    executeSwap(walletName: string, quote: SwapQuote): Promise<SwapResult>;
+    /**
+     * Close the service and cleanup
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=WalletService.d.ts.map

package/dist/services/WalletService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletService.d.ts","sourceRoot":"","sources":["../../src/services/WalletService.ts"],"names":[],"mappings":"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"}

package/dist/storage/SecureStorage.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export interface WalletData {
+    name: string;
+    address: string;
+    mnemonic: string[];
+    network: 'mainnet' | 'testnet';
+    version: 'v5r1' | 'v4r2';
+    createdAt: string;
+}
+export interface StorageFile {
+    version: number;
+    wallets: WalletData[];
+}
+/**
+ * Storage provider interface - allows swapping plaintext for encrypted storage
+ */
+export interface StorageProvider {
+    save(data: StorageFile): Promise<void>;
+    load(): Promise<StorageFile>;
+}
+/**
+ * Plaintext storage provider - stores data as JSON
+ * TODO: Replace with EncryptedStorageProvider for production use
+ */
+export declare class PlaintextStorageProvider implements StorageProvider {
+    private filePath;
+    constructor(filePath: string);
+    save(data: StorageFile): Promise<void>;
+    load(): Promise<StorageFile>;
+}
+/**
+ * SecureStorage class - manages wallet data with pluggable storage providers
+ */
+export declare class SecureStorage {
+    private provider;
+    private cache;
+    constructor(provider?: StorageProvider);
+    /**
+     * Get all stored wallets
+     */
+    getWallets(): Promise<WalletData[]>;
+    /**
+     * Get a wallet by name
+     */
+    getWallet(name: string): Promise<WalletData | undefined>;
+    /**
+     * Get a wallet by address
+     */
+    getWalletByAddress(address: string): Promise<WalletData | undefined>;
+    /**
+     * Get wallet ID (network:address format, matching @ton/walletkit pattern)
+     */
+    getWalletId(wallet: WalletData): string;
+    /**
+     * Add a new wallet
+     */
+    addWallet(wallet: WalletData): Promise<void>;
+    /**
+     * Remove a wallet by name
+     */
+    removeWallet(name: string): Promise<boolean>;
+    /**
+     * Update a wallet
+     */
+    updateWallet(name: string, updates: Partial<Omit<WalletData, 'name'>>): Promise<boolean>;
+    /**
+     * Clear all wallets
+     */
+    clearAll(): Promise<void>;
+    private loadData;
+    private saveData;
+}
+//# sourceMappingURL=SecureStorage.d.ts.map

package/dist/storage/SecureStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecureStorage.d.ts","sourceRoot":"","sources":["../../src/storage/SecureStorage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAItB,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;CAOrC;AAED;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,KAAK,CAA4B;gBAE7B,QAAQ,CAAC,EAAE,eAAe;IAKtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKzC;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAK9D;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAK1E;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAIvC;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlD;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAalD;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAa9F;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,QAAQ;YAOR,QAAQ;CAIzB"}

package/dist/tools/balance.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * Balance query MCP tools
+ *
+ * All balance responses include both raw and human-readable amounts:
+ * - rawBalance: The balance in smallest units (nanoTON for TON, raw units for jettons)
+ * - balance: Human-readable amount with proper decimal formatting
+ */
+import { z } from 'zod';
+import type { WalletService } from '../services/WalletService.js';
+/**
+ * Converts raw units to human-readable amount.
+ *
+ * @param rawAmount - Raw amount as string (e.g., "1500000000")
+ * @param decimals - Number of decimal places for the token
+ * @returns Human-readable amount as string (e.g., "1.5")
+ *
+ * @example
+ * fromRawAmount("1500000000", 9)  // "1.5" (1.5 TON)
+ * fromRawAmount("1000", 6)        // "0.001" (0.001 USDT)
+ * fromRawAmount("100000000000", 9) // "100" (100 TON)
+ */
+declare function fromRawAmount(rawAmount: string, decimals: number): string;
+/** TON has 9 decimal places (1 TON = 1,000,000,000 nanoTON) */
+declare const TON_DECIMALS = 9;
+export declare const getBalanceSchema: z.ZodObject<{
+    wallet: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    wallet: string;
+}, {
+    wallet: string;
+}>;
+export declare const getJettonBalanceSchema: z.ZodObject<{
+    wallet: z.ZodString;
+    jettonAddress: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    wallet: string;
+    jettonAddress: string;
+}, {
+    wallet: string;
+    jettonAddress: string;
+}>;
+export declare const getJettonsSchema: z.ZodObject<{
+    wallet: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    wallet: string;
+}, {
+    wallet: string;
+}>;
+export declare const getTransactionsSchema: z.ZodObject<{
+    wallet: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    wallet: string;
+    limit?: number | undefined;
+}, {
+    wallet: string;
+    limit?: number | undefined;
+}>;
+export declare function createBalanceTools(walletService: WalletService): {
+    get_balance: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            wallet: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            wallet: string;
+        }, {
+            wallet: string;
+        }>;
+        handler: (args: z.infer<typeof getBalanceSchema>) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError?: undefined;
+        } | {
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError: boolean;
+        }>;
+    };
+    get_jetton_balance: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            wallet: z.ZodString;
+            jettonAddress: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            wallet: string;
+            jettonAddress: string;
+        }, {
+            wallet: string;
+            jettonAddress: string;
+        }>;
+        handler: (args: z.infer<typeof getJettonBalanceSchema>) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError: boolean;
+        } | {
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError?: undefined;
+        }>;
+    };
+    get_jettons: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            wallet: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            wallet: string;
+        }, {
+            wallet: string;
+        }>;
+        handler: (args: z.infer<typeof getJettonsSchema>) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError?: undefined;
+        } | {
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError: boolean;
+        }>;
+    };
+    get_transactions: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            wallet: z.ZodString;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            wallet: string;
+            limit?: number | undefined;
+        }, {
+            wallet: string;
+            limit?: number | undefined;
+        }>;
+        handler: (args: z.infer<typeof getTransactionsSchema>) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError?: undefined;
+        } | {
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError: boolean;
+        }>;
+    };
+};
+export { fromRawAmount, TON_DECIMALS };
+//# sourceMappingURL=balance.d.ts.map

package/dist/tools/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../src/tools/balance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED,+DAA+D;AAC/D,QAAA,MAAM,YAAY,IAAI,CAAC;AAEvB,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;EAQhC,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa;;;;;;;;;;wBAM7B,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6ChC,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC;;;;;;;;;;;;;;;;;;;;;;;wBA8FtC,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuDhC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;;;;;;;;;;EA0EtE;AAED,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * Tool registration and exports
+ */
+export { createWalletTools } from './wallet.js';
+export { createBalanceTools } from './balance.js';
+export { createTransferTools } from './transfer.js';
+export { createSwapTools } from './swap.js';
+//# sourceMappingURL=index.d.ts.map