Telegram Wallet

The Aomi Telegram bot supports wallet connectivity through a Telegram WebApp (mini-app). This allows you to connect your wallet, approve transactions, and sign messages directly from within Telegram.

Connecting Your Wallet

1. Send /wallet to the bot (or tap "Wallet" from the start panel)
2. Tap the "Connect Wallet" button in the inline keyboard
3. A Telegram mini-app opens with the WalletConnect interface
4. Scan the QR code or choose your wallet from the list
5. Approve the connection in your wallet app
6. The bot confirms the connection and displays your address

Once connected, your wallet address is linked to your Telegram user ID. This means the same wallet is available across all your conversations with the bot, including in different group chats.

What You Can Do

View Wallet Status

Send /wallet at any time to see:

• Whether a wallet is connected
• The connected address
• The active network

Approve Transactions

When the AI assistant determines a transaction is needed:

1. The AI describes what it wants to do (e.g., "I'll swap 0.5 ETH for USDC on Uniswap")
2. A transaction panel appears with the details (to, value, data)
3. Tap "Sign" to open the mini-app
4. Review the transaction details in the mini-app
5. Approve or reject in your wallet
6. The result is sent back to the AI, which continues the conversation

Sign Typed Data (EIP-712)

For operations that require typed data signatures (permit approvals, gasless transactions, etc.), the flow is similar:

1. The AI requests an EIP-712 signature
2. A signing panel appears with the typed data details
3. Tap to open the mini-app and review
4. Sign or reject in your wallet
5. The signature is returned to the AI

Transaction Flow Diagram

User: "Swap 1 ETH for USDC"
    │
    ▼
AI processes request, builds transaction
    │
    ▼
Bot: Shows transaction panel
    [To: 0xRouter...]
    [Value: 1 ETH]
    [Sign] [Reject]
    │
    ▼ (user taps Sign)
Mini-App opens with WalletConnect
    │
    ▼
User reviews and approves in wallet
    │
    ▼
Transaction hash sent back to bot
    │
    ▼
AI: "Swap executed! Tx: 0xabc..."

Network Switching

Use the /network command to switch the active blockchain network:

1. Send /network
2. Tap the desired network from the inline keyboard (Ethereum, Polygon, Arbitrum, etc.)
3. The bot confirms the switch

The network selection affects which chain is used for subsequent transactions. Your wallet must support the selected network.

Disconnecting

To disconnect your wallet:

1. Send /wallet
2. Tap "Disconnect" from the wallet panel
3. Your wallet address is unlinked from your Telegram session

Mini-App Details

The wallet mini-app is a lightweight web application embedded within Telegram. It provides:

• WalletConnect integration for connecting any compatible wallet
• Transaction review and approval interface
• EIP-712 typed data signing interface
• Network information display

The mini-app URL is configured by the bot administrator and must use HTTPS. It communicates with the bot through Telegram's WebApp API.