Panel System

Panels are the interactive inline keyboard menus that power the Telegram bot's UI. Instead of typing commands repeatedly, you tap buttons to navigate between features and make selections.

How Panels Work

When you send a slash command like /start or /app, the bot responds with a message containing inline keyboard buttons. Tapping a button navigates you to another panel or performs an action (like switching Apps). The message updates in place, so the conversation stays clean.

Panel Types

Start Panel

The main navigation hub. Displayed when you send /start.

Buttons:

• Wallet Status -- View wallet connection, open wallet panel
• App -- Switch Aomi App
• Model -- Change LLM provider
• Transactions -- View pending and completed transactions
• Sessions -- Browse conversation history
• Network -- Switch blockchain network
• Settings -- User preferences

App Panel

Select which Aomi App to use. Each App provides different tools and capabilities.

Displays all authorized Apps as buttons. The currently active App is highlighted. Tapping an App switches the AI context immediately.

Model Panel

Choose the LLM model. Displays available models (Claude, GPT-4, etc.) as buttons. The currently selected model is marked. Switching takes effect on the next message.

Wallet Panel

Shows current wallet status:

• If connected: displays the wallet address and a disconnect button
• If disconnected: shows a button that opens the Telegram mini-app for WalletConnect

Sessions Panel

Browse your conversation threads. Shows recent sessions with titles and timestamps. Tap a session to switch to it, or use the management buttons to rename or delete threads.

Settings Panel

User preferences and configuration options. Includes toggles for features like streaming mode.

Network Panel

Switch between supported blockchain networks (Ethereum, Polygon, Arbitrum, Base, etc.). The currently active network is highlighted.

Transaction Panel

View and manage wallet transaction requests. When the AI requests a transaction, this panel shows the details (recipient, amount, data) and provides approve/reject buttons that link to the mini-app for signing.

API Key Panel

Enter and manage your API key. The bot prompts for text input via a reply message. Once set, the key is used for authenticated requests to the backend.

Navigation

Panels link to each other through transitions. When you tap a button, the bot either:

1. Navigates to another panel (updates the message with the new panel's content)
2. Performs an action (e.g., selects a model) and shows a confirmation
3. Opens the mini-app (e.g., for wallet connection or transaction signing)

Most panels include a way to navigate back to the start panel or to related panels.

Transaction Approval Flow

When the AI needs a transaction signed:

1. The AI generates a transaction request during conversation
2. The bot displays a transaction panel with details (to address, value, data)
3. You tap "Sign" to open the mini-app
4. Review and approve the transaction in the mini-app
5. The signed transaction is sent back to the bot
6. The bot forwards the result to the AI, which continues the conversation