Architecture Overview

Core Components

• TMAWalletClient: This is the main class that developers interact with to manage wallets and perform wallet-related operations. It is responsible for initializing the wallet, creating bundles, and interacting with Ethereum.

• Controllers: The SDK includes two key controllers:

  • ClientBundleController: Manages client-side bundles, including creating, retrieving, and clearing bundles. It helps manage cryptographic keys and other user-specific data securely.

  • WalletBundleController: Handles wallet addresses, storing, retrieving, and clearing wallet addresses linked to client bundles.

• Storage: Storage plays a crucial role in handling sensitive data:

  • TelegramCloudStorage: Implements storage functionality using Telegram's cloud infrastructure. This class ensures user data is stored securely and is accessible across devices via Telegram.

How It Works

The TMAWallet SDK works by leveraging Multi-Party Computation (MPC) to securely generate and manage wallet keys, which are split across multiple parties to eliminate the risk of a single point of failure. The wallet keys are not stored in one location, ensuring maximum security.

Workflow Overview:

1. Initialization: The TMAWalletClient is initialized with a project token, establishing the connection to the Telegram environment and setting up the initial configuration.

2. Key and Wallet Management: Using the ClientBundleController, the SDK manages key bundles for each user, securely creating and storing keys using MPC.

3. Storage: User data, including key information, is stored in TelegramCloudStorage, ensuring seamless access across devices while maintaining security.

4. Interaction with Ethereum: The SDK allows users to sign transactions and interact with Ethereum-based smart contracts through the ethers.js library, using the generated wallet keys.

The combination of MPC and Telegram's cloud storage ensures a balance between security and user convenience, allowing users to access their wallets effortlessly while ensuring that private keys are always kept safe.