fastton

Project Overview

fastton is a platform designed to combine trading automation, token launchpad ("rag-pad"), price change alerts, and engaging game/social mechanics—all powered by the TON blockchain.

Key Features

• Trading Bot: Monitors tokens, finds top price movers, and posts updates to Telegram chats.
• Rag-Pad: Launch tokens with special parameters—rag-time and rag-cap—enabling unique tokenomics and social games.
• Price Alerts: Get smart price alerts (Gainers-and-Losers) in Telegram chats, with future plans for AI-driven suggestions.
• Game Mechanics: Interact with the "rag-man" character, feed him energy drinks to earn in-app tokens, and spend them on activities.
• TON Connect Integration: (Planned) Users will be able to connect their TON wallets, authorize, edit profiles, mint, buy, and sell tokens directly in the app.

---

How TON is Integrated

1. TON in the Frontend (TMA App)

• The frontend (tma/) is a React app.
• It includes dependencies for TON Connect:
  • @tonconnect/sdk
  • @tonconnect/ui-react
• The UI has a placeholder for TON Connect, indicating planned integration for wallet connection and blockchain actions.
• Users will eventually be able to:
  • Authorize with their TON wallet
  • Edit their profile
  • Mint, buy, and sell tokens

Current Status:
TON Connect is not yet active in the demo, but the groundwork is laid in the code and dependencies.

2. TON in the Backend (Bot & Data)

• The backend (bot/) is a Telegram bot that:
  • Fetches token data from DYOR.io (a TON analytics API)
  • Monitors price changes for all tokens (jettons) on TON
  • Posts top gainers/losers and recent trades to Telegram chats
  • Uses user-friendly TON addresses and links to DYOR/TONViewer for token info
• The bot uses SQLite for persistence and can be run via Docker.
• All token data, price changes, and charts are based on the TON blockchain via DYOR API.

TON-specific logic includes:

• Address conversion between raw and user-friendly TON formats
• Fetching and displaying token (jetton) info, price, and trades from the TON blockchain
• Linking to TON explorers (DYOR, TONViewer) for transparency

---

How to Use the MVP

1. Telegram Bot

Setup

1. Clone the repo:

   git clone <repo-url>
   cd fastton/bot

2. Create a .env file:

   DYOR=your_dyor_api_key
   BOT=your_telegram_bot_token
   

3. Build and run with Docker:

   docker build -t fastton-bot .
   docker run --env-file .env fastton-bot

Usage

• Add the bot to your Telegram chat as an admin.
• The bot will automatically post updates about top gainers and losers on TON, with charts and recent trades.
• You can reset sent messages for testing by running:

  UPDATE sent_messages SET sent=0;

2. Frontend (TMA App)

Setup

1. Install dependencies:

   cd fastton/tma
   npm install

2. Run the app:

   npm run dev

Usage

• The app features the "rag-man" character.
• Click "Give Energy Drink!" to feed him and earn tokens (demo logic).
• TON Connect button is present (disabled for now)—future updates will enable wallet connection and blockchain actions.

---

The "Rag-Pad" Concept

• Rag-Time: A time window during which a token can be "ragged."
• Rag-Cap: A cap value; if reached before rag-time ends, the token is considered a "rag."
• Both parameters are planned to be encrypted and stored on the TON blockchain.
• This creates a social game around token launches, with transparency and verifiability.

---

Go-to-Market Strategy

• Leverage social activities and in-app tokens to drive engagement.
• Promote the bot's Gainers-and-Losers functionality for smart price alerts in Telegram chats.
• Future plans include AI-driven suggestions and deeper analytics.

---

Roadmap / Next Steps

• Enable TON Connect in the frontend for wallet-based actions.
• Implement rag-pad token launch logic on-chain.
• Expand game mechanics and in-app token utility.
• Integrate AI for smarter alerts and analytics.

---

File Structure

• bot/ — Telegram bot, DYOR API integration, SQLite DB
• tma/ — React frontend, game UI, TON Connect (planned)
• README.md — This documentation

---

References

• TON Connect
• DYOR.io API
• TONViewer