sendai-cf-tgbot-sample

This project demonstrates how to build a Telegram bot using Solana Agent Kit and Cloudflare Workers.

📦 Features

• Serverless deployment using Cloudflare Workers
• Blockchain integration with Solana Agent Kit
• Interactive user experience through Telegram bot interface

📌 Requirements

• Node.js (v18 or higher)
• pnpm package manager
• Cloudflare account
• Telegram account and bot token
• OpenAI API key

🍞 Quick Start

🔑 Getting a Telegram Bot Token

1. Connect to @BotFather on Telegram
2. Send the /newbot command to create a new bot
3. Follow the instructions to set a name and username
4. Save the generated token (e.g., 123456789:ABCDefGhIJKlmNoPQRsTUVwxyZ)

For more details, check here.

🍞 Project Setup

1. Clone the repository

   git clone https://github.com/yourusername/sendai-cf-tgbot-sample.git

   cd sendai-cf-tgbot-sample

2. Install dependencies

   pnpm install

3. Set up environment variables

   • Copy .dev.vars.example to .dev.vars
   • Configure required variables (TELEGRAM_BOT_TOKEN, OPENAI_API_KEY, SOLANA_PRIVATE_KEY, etc.)

4. Start the local development server

   pnpm run dev

5. In a separate terminal, expose your local server using ngrok

   npx ngrok http 8787

6. Set up the webhook using the URL provided by ngrok

   curl https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/setWebhook?url=https://<NGROK_URL>/

7. If successful, you'll see this response

   { "ok": true, "result": true, "description": "Webhook was set" }

🚀 Deploying to Cloudflare

1. Log in to Cloudflare and access Workers & Pages

2. Set environment variables as Cloudflare secrets

   npx wrangler secret put TELEGRAM_BOT_TOKEN
   npx wrangler secret put OPENAI_API_KEY
   # Set other required environment variables similarly

3. Deploy your project

   pnpm run deploy

4. Set up the webhook using your deployed URL

   curl https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/setWebhook?url=https://<YOUR_WORKER_URL>/

🔧 Development

• src/index.ts: Main application code
• wrangler.jsonc: Cloudflare Workers configuration

🔍 Code Quality with Biome

This project uses Biome for linting and formatting. Biome is a fast formatter and linter for JavaScript and TypeScript.

Available scripts:

• pnpm lint: Run Biome linter on source files
• pnpm format: Format source files with Biome
• pnpm check: Check and automatically fix issues in source files

VS Code users can install the Biome extension for in-editor linting and formatting.

🤖 Troubleshooting

• Webhook setup fails: Verify that your URL is correct and your Telegram bot token is valid
• Bot doesn't respond: Check logs and ensure environment variables are properly configured
• When you run image generation tasks using an agent developed by Solana Agent Kit, sometimes it becomes a zombie process just keeping timeout and sending image generation tasks to API endlessly, so please be careful.

📝 License

MIT License

---

🎉 Congratulations! You now have a Telegram bot running with Solana Agent Kit on Cloudflare Workers.