@truecarry/mcp 0.1.0

package/dist/core/LimitsManager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * LimitsManager - Enforces transaction, daily, and wallet count limits
+ */
+import type { LimitsConfig } from '../types/config.js';
+import type { UserScopedStorage } from './UserScopedStorage.js';
+/**
+ * Result of a limit check
+ */
+export interface LimitCheckResult {
+    allowed: boolean;
+    reason?: string;
+}
+/**
+ * LimitsManager enforces safety limits on transactions and wallet counts.
+ */
+export declare class LimitsManager {
+    private readonly limits;
+    constructor(limits?: LimitsConfig);
+    /**
+     * Check if a transaction amount is within limits
+     */
+    checkTransactionLimit(storage: UserScopedStorage, amountTon: number): Promise<LimitCheckResult>;
+    /**
+     * Record a transaction for daily limit tracking
+     */
+    recordTransaction(storage: UserScopedStorage, amountTon: number): Promise<void>;
+    /**
+     * Check if user can create another wallet
+     */
+    checkWalletCountLimit(currentWalletCount: number): Promise<LimitCheckResult>;
+    /**
+     * Get the configured limits
+     */
+    getLimits(): Required<LimitsConfig>;
+    /**
+     * Get today's date as ISO string (YYYY-MM-DD)
+     */
+    private getTodayDate;
+    /**
+     * Get daily usage for a specific date
+     */
+    private getDailyUsage;
+    /**
+     * Convert TON to nanoTON string
+     */
+    private tonToNano;
+    /**
+     * Convert nanoTON string to TON
+     */
+    private nanoToTon;
+}
+//# sourceMappingURL=LimitsManager.d.ts.map

package/dist/core/LimitsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitsManager.d.ts","sourceRoot":"","sources":["../../src/core/LimitsManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAehE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAEpC,MAAM,CAAC,EAAE,YAAY;IASjC;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0BrG;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrF;;OAEG;IACG,qBAAqB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUlF;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,YAAY,CAAC;IAInC;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;YACW,aAAa;IAK3B;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,SAAS;CAGpB"}

package/dist/core/PendingTransactionManager.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * PendingTransactionManager - Manages two-step transaction confirmation flow
+ *
+ * When requireConfirmation is enabled:
+ * 1. send_ton/send_jetton/execute_swap creates a pending transaction
+ * 2. User must call confirm_transaction to execute
+ * 3. Or cancel_transaction to abort
+ */
+import type { UserScopedStorage } from './UserScopedStorage.js';
+/**
+ * Pending transaction types
+ */
+export type PendingTransactionType = 'send_ton' | 'send_jetton' | 'swap';
+/**
+ * Pending transaction data stored in storage
+ */
+export interface PendingTransaction {
+    /** Unique transaction ID */
+    id: string;
+    /** Transaction type */
+    type: PendingTransactionType;
+    /** Wallet name to send from */
+    walletName: string;
+    /** ISO timestamp when created */
+    createdAt: string;
+    /** ISO timestamp when expires */
+    expiresAt: string;
+    /** Human-readable description for confirmation */
+    description: string;
+    /** Transaction-specific data */
+    data: PendingTonTransfer | PendingJettonTransfer | PendingSwap;
+}
+/**
+ * Pending TON transfer data
+ */
+export interface PendingTonTransfer {
+    type: 'send_ton';
+    toAddress: string;
+    /** Amount in nanoTON */
+    amountNano: string;
+    /** Human-readable amount */
+    amountTon: string;
+    comment?: string;
+}
+/**
+ * Pending Jetton transfer data
+ */
+export interface PendingJettonTransfer {
+    type: 'send_jetton';
+    toAddress: string;
+    jettonAddress: string;
+    /** Raw amount */
+    amountRaw: string;
+    /** Human-readable amount */
+    amountHuman: string;
+    symbol?: string;
+    decimals: number;
+    comment?: string;
+}
+/**
+ * Pending swap data
+ */
+export interface PendingSwap {
+    type: 'swap';
+    fromToken: string;
+    toToken: string;
+    fromAmount: string;
+    toAmount: string;
+    minReceived: string;
+    provider: string;
+    /** Serialized quote for execution */
+    quoteJson: string;
+}
+/**
+ * PendingTransactionManager handles the confirmation flow for transactions.
+ */
+export declare class PendingTransactionManager {
+    private readonly ttlSeconds;
+    constructor(ttlSeconds?: number);
+    /**
+     * Generate a unique transaction ID
+     */
+    generateId(): string;
+    /**
+     * Create a pending transaction
+     */
+    createPending(storage: UserScopedStorage, params: {
+        type: PendingTransactionType;
+        walletName: string;
+        description: string;
+        data: PendingTonTransfer | PendingJettonTransfer | PendingSwap;
+    }): Promise<PendingTransaction>;
+    /**
+     * Get a pending transaction by ID
+     */
+    getPending(storage: UserScopedStorage, transactionId: string): Promise<PendingTransaction | null>;
+    /**
+     * List all pending transactions for the user
+     */
+    listPending(storage: UserScopedStorage): Promise<PendingTransaction[]>;
+    /**
+     * Delete a pending transaction
+     */
+    deletePending(storage: UserScopedStorage, transactionId: string): Promise<boolean>;
+    /**
+     * Mark a pending transaction as confirmed (delete it)
+     * The actual execution is handled by the caller
+     */
+    confirmPending(storage: UserScopedStorage, transactionId: string): Promise<PendingTransaction | null>;
+    /**
+     * Cancel a pending transaction
+     */
+    cancelPending(storage: UserScopedStorage, transactionId: string): Promise<boolean>;
+}
+//# sourceMappingURL=PendingTransactionManager.d.ts.map

package/dist/core/PendingTransactionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingTransactionManager.d.ts","sourceRoot":"","sources":["../../src/core/PendingTransactionManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,IAAI,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,WAAW,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;CACrB;AAKD;;GAEG;AACH,qBAAa,yBAAyB;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,GAAE,MAAoC;IAI5D;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACG,aAAa,CACf,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE;QACJ,IAAI,EAAE,sBAAsB,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,WAAW,CAAC;KAClE,GACF,OAAO,CAAC,kBAAkB,CAAC;IAoB9B;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAgBvG;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAiB5E;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxF;;;OAGG;IACG,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAY3G;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS3F"}

package/dist/core/UserScopedSigner.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * UserScopedSigner - Wraps ISignerAdapter with user ownership verification
+ *
+ * All wallet IDs are prefixed with userId to ensure User A cannot
+ * access User B's wallets. Returns generic "not found" error for both
+ * missing and unauthorized wallets to prevent enumeration attacks.
+ */
+import type { ISignerAdapter, WalletInfo, CreateWalletParams, ImportWalletParams } from '../types/signer.js';
+/**
+ * User-scoped signer wrapper.
+ * Ensures all operations are scoped to the authenticated user.
+ */
+export declare class UserScopedSigner {
+    private readonly signer;
+    private readonly userId;
+    private readonly userPrefix;
+    constructor(signer: ISignerAdapter, userId: string);
+    /**
+     * Get the user ID this signer is scoped to
+     */
+    getUserId(): string;
+    /**
+     * Build user-scoped wallet ID from wallet name
+     */
+    private scopedId;
+    /**
+     * Extract wallet name from scoped ID
+     */
+    private extractName;
+    /**
+     * Check if a wallet ID belongs to this user
+     */
+    private isOwnedByUser;
+    /**
+     * Transform wallet info to expose wallet name instead of internal ID
+     */
+    private transformWalletInfo;
+    /**
+     * Create a new wallet (user-scoped)
+     */
+    createWallet(params: Omit<CreateWalletParams, 'walletId'> & {
+        name: string;
+    }): Promise<WalletInfo & {
+        name: string;
+    }>;
+    /**
+     * Import a wallet from mnemonic (user-scoped)
+     * Note: Mnemonic is passed to signer and stored securely, never returned
+     */
+    importWallet(params: Omit<ImportWalletParams, 'walletId'> & {
+        name: string;
+    }): Promise<WalletInfo & {
+        name: string;
+    }>;
+    /**
+     * Get wallet by name (user-scoped)
+     * Returns null for both "not found" and "not owned" to prevent enumeration
+     */
+    getWallet(walletName: string): Promise<(WalletInfo & {
+        name: string;
+    }) | null>;
+    /**
+     * List all wallets for this user
+     */
+    listWallets(): Promise<(WalletInfo & {
+        name: string;
+    })[]>;
+    /**
+     * Delete a wallet (user-scoped)
+     * Returns false for both "not found" and "not owned"
+     */
+    deleteWallet(walletName: string): Promise<boolean>;
+    /**
+     * Sign a transaction (user-scoped)
+     * Verifies ownership before signing
+     */
+    signTransaction(walletName: string, unsignedBoc: string): Promise<string>;
+    /**
+     * Sign a message (user-scoped)
+     * Verifies ownership before signing
+     */
+    signMessage(walletName: string, message: Buffer): Promise<Buffer>;
+    /**
+     * Get the underlying signer adapter.
+     * Use with caution - bypasses user isolation.
+     */
+    getUnderlyingSigner(): ISignerAdapter;
+}
+//# sourceMappingURL=UserScopedSigner.d.ts.map

package/dist/core/UserScopedSigner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserScopedSigner.d.ts","sourceRoot":"","sources":["../../src/core/UserScopedSigner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7G;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM;IAMlD;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACG,YAAY,CACd,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChE,OAAO,CAAC,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IASzC;;;OAGG;IACG,YAAY,CACd,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChE,OAAO,CAAC,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAUzC;;;OAGG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAgBpF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,CAAC,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAc/D;;;OAGG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYxD;;;OAGG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY/E;;;OAGG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYvE;;;OAGG;IACH,mBAAmB,IAAI,cAAc;CAGxC"}

package/dist/core/UserScopedStorage.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * UserScopedStorage - Wraps IStorageAdapter with user namespace isolation
+ *
+ * All storage keys are prefixed with user:{userId}: to ensure
+ * User A cannot access User B's data.
+ */
+import type { IStorageAdapter } from '../types/storage.js';
+/**
+ * User-scoped storage wrapper.
+ * Automatically prefixes all keys with user namespace.
+ */
+export declare class UserScopedStorage {
+    private readonly storage;
+    private readonly userId;
+    private readonly prefix;
+    constructor(storage: IStorageAdapter, userId: string);
+    /**
+     * Get the user ID this storage is scoped to
+     */
+    getUserId(): string;
+    /**
+     * Build full key with user prefix
+     */
+    private buildKey;
+    /**
+     * Strip user prefix from a key
+     */
+    private stripPrefix;
+    /**
+     * Get a value by key (user-scoped)
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value (user-scoped)
+     */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /**
+     * Delete a key (user-scoped)
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * List keys matching prefix (user-scoped)
+     * Returns keys with user prefix stripped.
+     */
+    list(subPrefix: string): Promise<string[]>;
+    /**
+     * Get the underlying storage adapter.
+     * Use with caution - bypasses user isolation.
+     */
+    getUnderlyingStorage(): IStorageAdapter;
+}
+//# sourceMappingURL=UserScopedStorage.d.ts.map

package/dist/core/UserScopedStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserScopedStorage.d.ts","sourceRoot":"","sources":["../../src/core/UserScopedStorage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;GAGG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM;IAMpD;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAI5C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3C;;;OAGG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMhD;;;OAGG;IACH,oBAAoB,IAAI,eAAe;CAG1C"}

package/dist/core/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.
+ *
+ */
+/**
+ * Core module exports
+ */
+export { UserScopedStorage } from './UserScopedStorage.js';
+export { UserScopedSigner } from './UserScopedSigner.js';
+export { LimitsManager } from './LimitsManager.js';
+export { PendingTransactionManager } from './PendingTransactionManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/factory.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * Factory function for creating configured MCP server instances
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TonMcpConfig } from './types/config.js';
+import type { RequestContext } from './types/user-context.js';
+import { McpWalletService } from './services/McpWalletService.js';
+/**
+ * Tool handler context with authenticated user
+ */
+export interface ToolContext {
+    userId: string;
+    requestContext: RequestContext;
+}
+/**
+ * Create a configured TON Wallet MCP server
+ *
+ * @param config - Configuration with adapters and limits
+ * @returns Configured McpServer instance
+ *
+ * @example
+ * ```typescript
+ * import { createTonWalletMCP, InMemoryStorageAdapter, LocalSignerAdapter } from '@ton/mcp';
+ *
+ * const server = createTonWalletMCP({
+ *   storage: new InMemoryStorageAdapter(),
+ *   signer: new LocalSignerAdapter(),
+ *   userContext: {
+ *     getUserId: async (ctx) => ctx.headers?.['x-user-id'] ?? null,
+ *   },
+ *   limits: {
+ *     maxTransactionTon: 100,
+ *     dailyLimitTon: 1000,
+ *     maxWalletsPerUser: 10,
+ *   },
+ *   requireConfirmation: true,
+ * });
+ * ```
+ */
+export declare function createTonWalletMCP(config: TonMcpConfig): McpServer;
+/**
+ * Get the wallet service shutdown handler
+ * Call this to properly cleanup when shutting down
+ */
+export declare function createShutdownHandler(walletService: McpWalletService): () => Promise<void>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAYlE;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAqFlE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAE1F"}