@truecarry/mcp 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/tools/transfer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,iBAAS,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW7D;AAED;;;;;;GAMG;AACH,iBAAS,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,+DAA+D;AAC/D,QAAA,MAAM,YAAY,IAAI,CAAC;AAEvB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAW3B,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,aAAa;;;;;;;;;;;;;;;;;;;wBAM9B,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkD7B,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;;;;;;;;;;;;;EAgGjE;AAED,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC"}

package/dist/tools/wallet.d.ts

@@ -0,0 +1,138 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * Wallet management MCP tools
+ */
+import { z } from 'zod';
+import type { WalletService } from '../services/WalletService.js';
+export declare const createWalletSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodEnum<["v5r1", "v4r2"]>>;
+    network: z.ZodOptional<z.ZodEnum<["mainnet", "testnet"]>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version?: "v5r1" | "v4r2" | undefined;
+    network?: "mainnet" | "testnet" | undefined;
+}, {
+    name: string;
+    version?: "v5r1" | "v4r2" | undefined;
+    network?: "mainnet" | "testnet" | undefined;
+}>;
+export declare const importWalletSchema: z.ZodObject<{
+    name: z.ZodString;
+    mnemonic: z.ZodString;
+    version: z.ZodOptional<z.ZodEnum<["v5r1", "v4r2"]>>;
+    network: z.ZodOptional<z.ZodEnum<["mainnet", "testnet"]>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    mnemonic: string;
+    version?: "v5r1" | "v4r2" | undefined;
+    network?: "mainnet" | "testnet" | undefined;
+}, {
+    name: string;
+    mnemonic: string;
+    version?: "v5r1" | "v4r2" | undefined;
+    network?: "mainnet" | "testnet" | undefined;
+}>;
+export declare const removeWalletSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export declare function createWalletTools(walletService: WalletService): {
+    create_wallet: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodEnum<["v5r1", "v4r2"]>>;
+            network: z.ZodOptional<z.ZodEnum<["mainnet", "testnet"]>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            version?: "v5r1" | "v4r2" | undefined;
+            network?: "mainnet" | "testnet" | undefined;
+        }, {
+            name: string;
+            version?: "v5r1" | "v4r2" | undefined;
+            network?: "mainnet" | "testnet" | undefined;
+        }>;
+        handler: (args: z.infer<typeof createWalletSchema>) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    import_wallet: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            name: z.ZodString;
+            mnemonic: z.ZodString;
+            version: z.ZodOptional<z.ZodEnum<["v5r1", "v4r2"]>>;
+            network: z.ZodOptional<z.ZodEnum<["mainnet", "testnet"]>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            mnemonic: string;
+            version?: "v5r1" | "v4r2" | undefined;
+            network?: "mainnet" | "testnet" | undefined;
+        }, {
+            name: string;
+            mnemonic: string;
+            version?: "v5r1" | "v4r2" | undefined;
+            network?: "mainnet" | "testnet" | undefined;
+        }>;
+        handler: (args: z.infer<typeof importWalletSchema>) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError: boolean;
+        } | {
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError?: undefined;
+        }>;
+    };
+    list_wallets: {
+        description: string;
+        inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        handler: () => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    remove_wallet: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+        }, {
+            name: string;
+        }>;
+        handler: (args: z.infer<typeof removeWalletSchema>) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError: boolean;
+        } | {
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError?: undefined;
+        }>;
+    };
+};
+//# sourceMappingURL=wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/tools/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAU7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAW7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,aAAa;;;;;;;;;;;;;;;;wBAM5B,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;wBA8BlC,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA0ElC,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC;;;;;;;;;;;;;;EA8BnE"}

package/dist/types/config.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * Configuration types for createTonWalletMCP factory
+ */
+import type { IStorageAdapter } from './storage.js';
+import type { ISignerAdapter } from './signer.js';
+import type { IUserContextProvider } from './user-context.js';
+import type { IContactResolver } from './contacts.js';
+/**
+ * Safety limits configuration
+ */
+export interface LimitsConfig {
+    /** Maximum TON amount per single transaction */
+    maxTransactionTon?: number;
+    /** Maximum TON amount per day per user */
+    dailyLimitTon?: number;
+    /** Maximum number of wallets per user */
+    maxWalletsPerUser?: number;
+}
+/**
+ * Configuration for createTonWalletMCP factory
+ */
+export interface TonMcpConfig {
+    /**
+     * Storage adapter for wallet metadata, contacts, pending transactions.
+     * Required.
+     */
+    storage: IStorageAdapter;
+    /**
+     * Signer adapter for secure key management and signing.
+     * Required.
+     */
+    signer: ISignerAdapter;
+    /**
+     * User context provider for extracting authenticated user ID.
+     * Required.
+     */
+    userContext: IUserContextProvider;
+    /**
+     * Optional contact resolver for name-to-address resolution.
+     */
+    contacts?: IContactResolver;
+    /**
+     * Default network for new wallets.
+     * @default 'mainnet'
+     */
+    network?: 'mainnet' | 'testnet';
+    /**
+     * Safety limits for transactions and wallets.
+     */
+    limits?: LimitsConfig;
+    /**
+     * If true, transactions require explicit confirmation via confirm_transaction tool.
+     * Recommended for Telegram bots and other user-facing applications.
+     * @default false
+     */
+    requireConfirmation?: boolean;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,OAAO,EAAE,eAAe,CAAC;IAEzB;;;OAGG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB;;;OAGG;IACH,WAAW,EAAE,oBAAoB,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAEhC;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACjC"}

package/dist/types/contacts.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * IContactResolver - Optional interface for resolving friend names to TON addresses
+ *
+ * Purpose: Allow users to send to "Alice" instead of raw addresses.
+ * Contacts are scoped to the user who created them.
+ */
+/**
+ * Contact information
+ */
+export interface Contact {
+    /** Human-readable name for the contact */
+    name: string;
+    /** TON address */
+    address: string;
+    /** Optional network specification (defaults to any) */
+    network?: 'mainnet' | 'testnet';
+}
+/**
+ * Interface for contact resolution.
+ * All operations are scoped to a specific user.
+ */
+export interface IContactResolver {
+    /**
+     * Resolve a contact name to an address.
+     *
+     * @param userId - The user's ID
+     * @param name - The contact name to resolve
+     * @returns The TON address or null if not found
+     */
+    resolve(userId: string, name: string): Promise<string | null>;
+    /**
+     * Add a new contact for a user.
+     *
+     * @param userId - The user's ID
+     * @param contact - The contact to add
+     */
+    addContact(userId: string, contact: Contact): Promise<void>;
+    /**
+     * List all contacts for a user.
+     *
+     * @param userId - The user's ID
+     * @returns Array of contacts
+     */
+    listContacts(userId: string): Promise<Contact[]>;
+    /**
+     * Remove a contact by name.
+     *
+     * @param userId - The user's ID
+     * @param name - The contact name to remove
+     * @returns true if removed, false if not found
+     */
+    removeContact(userId: string, name: string): Promise<boolean>;
+}
+//# sourceMappingURL=contacts.d.ts.map

package/dist/types/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/types/contacts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEjD;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE"}

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * Type exports for @ton/mcp package
+ */
+export type { IStorageAdapter } from './storage.js';
+export type { ISignerAdapter, WalletInfo, CreateWalletParams, ImportWalletParams } from './signer.js';
+export type { IUserContextProvider, RequestContext } from './user-context.js';
+export type { IContactResolver, Contact } from './contacts.js';
+export type { TonMcpConfig, LimitsConfig } from './config.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAGH,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtG,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAG9E,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG/D,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/signer.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * ISignerAdapter - Interface for secure key management and signing operations
+ *
+ * Critical: This adapter NEVER returns private keys or seed phrases.
+ * Seed phrases are accepted as input but stored securely by the adapter implementation.
+ */
+/**
+ * Wallet information returned by signer operations.
+ * Contains only public data - no private keys or seed phrases.
+ */
+export interface WalletInfo {
+    /** Internal wallet ID (may be user-prefixed internally by the adapter) */
+    walletId: string;
+    /** Hex-encoded public key */
+    publicKey: string;
+    /** TON address (user-friendly format) */
+    address: string;
+    /** Network the wallet is configured for */
+    network: 'mainnet' | 'testnet';
+    /** Wallet contract version */
+    version: 'v5r1' | 'v4r2';
+    /** ISO timestamp when wallet was created */
+    createdAt: string;
+}
+/**
+ * Parameters for creating a new wallet
+ */
+export interface CreateWalletParams {
+    /** Unique wallet ID (should be user-scoped externally) */
+    walletId: string;
+    /** Wallet contract version */
+    version: 'v5r1' | 'v4r2';
+    /** Network to create the wallet on */
+    network: 'mainnet' | 'testnet';
+}
+/**
+ * Parameters for importing a wallet from mnemonic
+ */
+export interface ImportWalletParams {
+    /** Unique wallet ID (should be user-scoped externally) */
+    walletId: string;
+    /** 24-word mnemonic phrase (stored securely, never returned) */
+    mnemonic: string[];
+    /** Wallet contract version */
+    version: 'v5r1' | 'v4r2';
+    /** Network to import the wallet on */
+    network: 'mainnet' | 'testnet';
+}
+/**
+ * Interface for secure key management and signing operations.
+ *
+ * Implementations should:
+ * - Store keys encrypted (e.g., AES-256-GCM with master key derived via PBKDF2/Argon2)
+ * - Never expose private keys or seed phrases through any method
+ * - Support user isolation if operating in multi-tenant mode
+ */
+export interface ISignerAdapter {
+    /**
+     * Create a new wallet with generated keys.
+     * The mnemonic is generated and stored securely - NEVER returned.
+     *
+     * @param params - Wallet creation parameters
+     * @returns Wallet info (address, public key) - NO private data
+     */
+    createWallet(params: CreateWalletParams): Promise<WalletInfo>;
+    /**
+     * Import a wallet from mnemonic.
+     * The mnemonic is stored securely by the adapter - NEVER returned.
+     *
+     * @param params - Import parameters including mnemonic
+     * @returns Wallet info (address, public key) - NO private data
+     */
+    importWallet(params: ImportWalletParams): Promise<WalletInfo>;
+    /**
+     * Get wallet info by ID.
+     *
+     * @param walletId - The wallet ID
+     * @returns Wallet info or null if not found
+     */
+    getWallet(walletId: string): Promise<WalletInfo | null>;
+    /**
+     * List all wallet IDs managed by this adapter.
+     * For user isolation, the wrapper should filter by user prefix.
+     *
+     * @returns Array of wallet IDs
+     */
+    listWalletIds(): Promise<string[]>;
+    /**
+     * Delete a wallet and its keys.
+     *
+     * @param walletId - The wallet ID to delete
+     * @returns true if deleted, false if not found
+     */
+    deleteWallet(walletId: string): Promise<boolean>;
+    /**
+     * Sign a transaction.
+     * The adapter loads the private key internally and signs.
+     *
+     * @param walletId - The wallet ID to sign with
+     * @param unsignedBoc - Base64-encoded unsigned transaction BOC
+     * @returns Base64-encoded signed transaction BOC
+     */
+    signTransaction(walletId: string, unsignedBoc: string): Promise<string>;
+    /**
+     * Sign an arbitrary message.
+     *
+     * @param walletId - The wallet ID to sign with
+     * @param message - The message bytes to sign
+     * @returns The signature bytes
+     */
+    signMessage(walletId: string, message: Buffer): Promise<Buffer>;
+}
+//# sourceMappingURL=signer.d.ts.map

package/dist/types/signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/types/signer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,sCAAsC;IACtC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,sCAAsC;IACtC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAExD;;;;;OAKG;IACH,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD;;;;;;;OAOG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnE"}

package/dist/types/storage.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * IStorageAdapter - Interface for persistent key-value storage
+ *
+ * Purpose: Store wallet metadata, contacts, transaction history, pending transactions.
+ * Does NOT store: private keys, seed phrases (that's ISignerAdapter's responsibility)
+ */
+export interface IStorageAdapter {
+    /**
+     * Get a value by key
+     * @param key - The storage key
+     * @returns The stored value or null if not found
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value with optional TTL
+     * @param key - The storage key
+     * @param value - The value to store
+     * @param ttlSeconds - Optional time-to-live in seconds (for pending transactions, etc.)
+     */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /**
+     * Delete a key
+     * @param key - The storage key
+     * @returns true if the key existed and was deleted, false otherwise
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * List all keys matching a prefix
+     * @param prefix - The key prefix to match
+     * @returns Array of matching keys
+     */
+    list(prefix: string): Promise<string[]>;
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/types/storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3C"}

package/dist/types/user-context.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * IUserContextProvider - Interface for extracting authenticated user identity
+ *
+ * Purpose: Identify the current user from MCP request context.
+ * Returns null if user cannot be authenticated (request should be rejected).
+ */
+/**
+ * Request context passed to the user context provider.
+ * Contains headers and metadata from the MCP request.
+ */
+export interface RequestContext {
+    /** HTTP headers (e.g., x-telegram-user-id, authorization) */
+    headers?: Record<string, string>;
+    /** Additional metadata from the transport */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Interface for extracting user identity from request context.
+ *
+ * Implementations should:
+ * - Extract user ID from appropriate header or metadata
+ * - Return null if user cannot be authenticated
+ * - Optionally provide user metadata for auditing
+ */
+export interface IUserContextProvider {
+    /**
+     * Extract user ID from request context.
+     *
+     * @param context - The request context with headers and metadata
+     * @returns User ID string or null if unauthenticated
+     */
+    getUserId(context: RequestContext): Promise<string | null>;
+    /**
+     * Optional: Get additional user metadata for logging/auditing.
+     *
+     * @param userId - The user ID
+     * @returns User metadata or null if not available
+     */
+    getUserMetadata?(userId: string): Promise<Record<string, unknown> | null>;
+}
+//# sourceMappingURL=user-context.d.ts.map

package/dist/types/user-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-context.d.ts","sourceRoot":"","sources":["../../src/types/user-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,eAAe,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;CAC7E"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@truecarry/mcp",
+  "version": "0.1.0",
+  "description": "TON MCP Server - Model Context Protocol server for TON blockchain wallet operations",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "ton-mcp": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "ton",
+    "mcp",
+    "wallet",
+    "model-context-protocol",
+    "blockchain"
+  ],
+  "author": "TON Tech",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ton-connect/kit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "zod": "^3.25.76",
+    "@ton/walletkit": "0.0.6"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.29",
+    "@vitest/coverage-v8": "^4.0.17",
+    "rimraf": "^6.1.0",
+    "rolldown": "1.0.0-rc.2",
+    "typescript": "~5.9.3",
+    "vitest": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "pnpm build:clean && rolldown -c && pnpm build:types && pnpm build:chmod",
+    "build:clean": "rimraf dist",
+    "build:types": "tsc -p tsconfig.json --emitDeclarationOnly",
+    "build:chmod": "chmod +x dist/cli.js",
+    "dev": "rolldown -c --watch",
+    "dev:cli": "node --import tsx/esm src/cli.ts",
+    "dev:cli:http": "node --import tsx/esm src/cli.ts --http",
+    "lint": "eslint src --max-warnings 0",
+    "lint:fix": "eslint src --max-warnings 0 --fix",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}