Telegram Agent

Build a Solana Agent Kit Telegram Agent

Create a Telegram bot powered by Solana Agent Kit to interact with Solana blockchain through natural language conversations. This implementation provides a seamless way to execute blockchain operations via Telegram.

Quick Start

​1. Agent Setup

# Clone the repository
npm install -g degit
degit sendaifun/solana-agent-kit/tree/main/examples/tg-bot-starter tg-agent
cd tg-agent

# Install dependencies
pnpm install

​2. Environment Configuration

Create a .env.local file:

OPENAI_API_KEY=your_openai_key
RPC_URL=your_solana_rpc_url
SOLANA_PRIVATE_KEY=your_wallet_private_key_base58
TELEGRAM_BOT_TOKEN=your_telegram_bot_token

​3. Create Telegram Bot

1. Message @BotFather on Telegram
2. Use /newbot command

3. Follow instructions to create bot

4. Save the bot token

​Project Structure

├── app/
│   ├── api/
│   │   └── bot/
│   │       └── route.ts    # Telegram webhook handler
│   ├── lib/
│   │   ├── agent.ts       # Solana Agent setup
│   │   └── telegram.ts    # Telegram utilities
│   └── config.ts          # Configuration
├── public/
└── package.json

​Implementation Steps

​1. Set Up Webhook

# Using curl
curl https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/setWebhook?url=https://<your-domain>/api/bot

# Or visit in browser
https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/setWebhook?url=https://<your-domain>/api/bot

​2. Local Development

# Start development server
pnpm dev

# Start ngrok tunnel
ngrok http 3000

​Core Components

​Webhook Handler

// app/api/bot/route.ts
export async function POST(req: Request) {
  const body = await req.json();
  
  // Initialize agent
  const agent = new SolanaAgentKit(
    process.env.SOLANA_PRIVATE_KEY!,
    process.env.RPC_URL!,
    process.env.OPENAI_API_KEY
  );

  // Process message
  const response = await processMessage(body, agent);
  
  return new Response(JSON.stringify(response));
}

​Message Processing

async function processMessage(message: any, agent: SolanaAgentKit) {
  const { text, chat } = message;
  
  // Generate response using agent
  const response = await agent.chat(text);
  
  // Send response to Telegram
  await sendTelegramMessage(chat.id, response);
}

​Features

1. Chat Interaction

   • Natural language processing

   • Command handling

   • Error responses

   • Message formatting

2. Blockchain Operations

   • Transaction execution

   • Balance checking

   • Token transfers

   • Price queries

3. Bot Management

   • User session handling

   • Rate limiting

   • Error handling

   • Logging

​Deployment

​Deploy to Vercel

1. Push code to GitHub

2. Import project in Vercel

3. Configure environment variables

4. Deploy

​Set Up Webhook

After deployment:

1. Get your deployment URL

2. Set webhook using the URL

3. Verify webhook status

4. Test bot functionality

​Security Considerations

1. Token Security

   • Secure storage of bot token

   • Environment variable protection

   • Access control

   • Rate limiting

2. Request Validation

   • Validate Telegram updates

   • Check message format

   • Verify user permissions

   • Monitor activity

3. Error Handling

   • Graceful error messages

   • Transaction failures

   • Network issues

   • API limits

​Example Bot Commands

/balance - Check wallet balance
/price SOL - Get SOL price
/transfer 1 SOL address - Transfer SOL
/help - Show available commands

​Development Tips

1. Local Testing

   • Use ngrok for local development

   • Test all commands thoroughly

   • Monitor error logs

   • Check response times

2. Message Handling

   • Parse commands correctly

   • Format responses properly

   • Handle long messages

   • Implement retry logic

3. User Experience

   • Clear error messages

   • Progress indicators

   • Command suggestions

   • Help documentation

​Common Issues

1. Webhook Setup

   • Invalid URL format

   • SSL certificate issues

   • Port configuration

   • Domain verification

2. Bot Responses

   • Slow response times

   • Message formatting

   • Command parsing

   • Error handling

3. Deployment

   • Environment variables

   • Webhook configuration

   • API access

   • Rate limits

​Testing

​Local Testing

# Start local server
pnpm dev

# Start ngrok
ngrok http 3000

# Set webhook to ngrok URL
curl https://api.telegram.org/bot<token>/setWebhook?url=<ngrok-url>/api/bot

​Production Testing

1. Send test messages

2. Check transaction execution

3. Verify responses

4. Monitor errors

​Resources

• Telegram Bot API
• Solana Agent Kit Docs
• Vercel Deployment
• ngrok Documentation

​Support

For support and questions:

• Create GitHub issue

• Join Telegram support group

• Check documentation

• Contact maintainers