Разработка Telegram Mini App слотов

Разработка Telegram Mini App слотов

Telegram Mini Apps (TMA) — это WebApp внутри мессенджера с аудиторией 900M+ пользователей. TON blockchain нативно интегрирован с Telegram через @wallet бот и TON Connect протокол. Слоты в TMA — один из наиболее распространённых GameFi use cases для этой экосистемы. Разберём полный стек: от TMA API до смарт-контракта на TON.

Telegram Mini App: технические основы

TMA — это обычное веб-приложение (React/Vue), открывающееся во встроенном браузере Telegram. Взаимодействие с Telegram через window.Telegram.WebApp объект:

import WebApp from "@twa-dev/sdk";

// Инициализация
WebApp.ready(); // сообщаем Telegram, что приложение загружено
WebApp.expand(); // разворачиваем на весь экран

// Данные пользователя (без дополнительного входа)
const user = WebApp.initDataUnsafe.user;
// { id: 123456789, first_name: "Alex", username: "alex123", ... }

// Верификация данных на сервере (HMAC-SHA256)
// initData содержит подпись от Telegram — никогда не доверяйте клиенту
const isValid = await verifyTelegramData(WebApp.initData, BOT_TOKEN);

// Haptic feedback
WebApp.HapticFeedback.impactOccurred("medium"); // при выигрыше
WebApp.HapticFeedback.notificationOccurred("success");

// Main Button (нативная кнопка Telegram)
WebApp.MainButton.setText("КРУТИТЬ");
WebApp.MainButton.show();
WebApp.MainButton.onClick(() => spinReels());

Верификация initData на бэкенде

import crypto from "crypto";

function verifyTelegramWebAppData(initData: string, botToken: string): boolean {
  const urlParams = new URLSearchParams(initData);
  const hash = urlParams.get("hash");
  urlParams.delete("hash");

  // Сортировка параметров по алфавиту
  const dataCheckString = Array.from(urlParams.entries())
    .sort(([a], [b]) => a.localeCompare(b))
    .map(([key, value]) => `${key}=${value}`)
    .join("\n");

  const secretKey = crypto
    .createHmac("sha256", "WebAppData")
    .update(botToken)
    .digest();

  const computedHash = crypto
    .createHmac("sha256", secretKey)
    .update(dataCheckString)
    .digest("hex");

  return computedHash === hash;
}

TON смарт-контракт для слотов

TON использует FunC или Tact (более современный, TypeScript-подобный синтаксис) для смарт-контрактов. Слоты на TON — это контракт, принимающий TON монеты и выплачивающий призы.

// Tact синтаксис
import "@stdlib/deploy";

struct SpinResult {
    reel1: Int as uint8;
    reel2: Int as uint8;
    reel3: Int as uint8;
    payout: Int as coins;
}

contract SlotMachine with Deployable {
    owner: Address;
    houseBalance: Int as coins = 0;

    // Минимальная и максимальная ставка
    const MIN_BET: Int = ton("0.1");
    const MAX_BET: Int = ton("10");

    // Паблик ключ сервера для верификации случайности
    serverPublicKey: Int as uint256;

    init(owner: Address, serverPublicKey: Int) {
        self.owner = owner;
        self.serverPublicKey = serverPublicKey;
    }

    // Принимаем ставку
    receive("spin") {
        let ctx: Context = context();
        require(ctx.value >= self.MIN_BET, "Bet too small");
        require(ctx.value <= self.MAX_BET, "Bet too large");

        // Emit событие — сервер подхватит и вернёт подписанный результат
        emit(SpinRequested{
            player: ctx.sender,
            betAmount: ctx.value,
            nonce: now()
        }.toCell());

        self.houseBalance += ctx.value;
    }

    // Сервер отправляет подписанный результат
    receive(msg: ClaimWin) {
        // Верифицируем подпись сервера
        let hash: Int = beginCell()
            .storeAddress(msg.player)
            .storeCoins(msg.betAmount)
            .storeUint(msg.nonce, 64)
            .storeUint(msg.reel1, 8)
            .storeUint(msg.reel2, 8)
            .storeUint(msg.reel3, 8)
            .endCell()
            .hash();

        require(checkSignature(hash, msg.signature, self.serverPublicKey), "Invalid signature");

        let payout: Int = self.calculatePayout(msg.reel1, msg.reel2, msg.reel3, msg.betAmount);

        if (payout > 0) {
            require(self.houseBalance >= payout, "Insufficient house balance");
            self.houseBalance -= payout;
            send(SendParameters{
                to: msg.player,
                value: payout,
                mode: SendIgnoreErrors
            });
        }
    }

    fun calculatePayout(r1: Int, r2: Int, r3: Int, bet: Int): Int {
        // Три семёрки — джекпот
        if (r1 == 7 && r2 == 7 && r3 == 7) { return bet * 100; }
        // Три одинаковых
        if (r1 == r2 && r2 == r3) { return bet * 10; }
        // Два одинаковых
        if (r1 == r2 || r2 == r3 || r1 == r3) { return bet * 2; }
        // BAR комбинация
        if (r1 == 6 && r2 == 6) { return bet * 3; }
        return 0;
    }

    // Пополнение призового пула
    receive("deposit") {
        self.houseBalance += context().value;
    }

    get fun balance(): Int { return self.houseBalance; }
}

TON Connect: подключение кошелька

import TonConnect from "@tonconnect/sdk";

const connector = new TonConnect({
  manifestUrl: "https://yourapp.com/tonconnect-manifest.json",
});

// tonconnect-manifest.json:
// { "url": "https://yourapp.com", "name": "Slots Game",
//   "iconUrl": "https://yourapp.com/icon.png" }

// Подключить кошелёк (открывает @wallet бот или внешний кошелёк)
const walletsList = await connector.getWallets();
connector.connect({ universalLink: walletsList[0].universalLink, bridgeUrl: ... });

connector.onStatusChange((wallet) => {
  if (wallet) {
    console.log("Connected:", wallet.account.address);
    initGame(wallet.account.address);
  }
});

// Отправить транзакцию (ставка в TON)
async function placeBet(amount: number) {
  await connector.sendTransaction({
    validUntil: Math.floor(Date.now() / 1000) + 300,
    messages: [{
      address: SLOT_CONTRACT_ADDRESS,
      amount: String(amount * 1e9), // в nanoTON
      payload: "spin", // текстовый комментарий
    }],
  });
}

Игровой процесс и анимация

Слоты — это анимация барабанов. Используем CSS/Canvas animation или Pixi.js:

1. Игрок нажимает "Крутить" → отправляется TON транзакция
2. Пока идёт транзакция → барабаны крутятся в "ожидающей" анимации
3. Game server замечает транзакцию → генерирует случайный результат → подписывает → вызывает ClaimWin на контракте
4. Фронтенд получает event через TON Center API или тонсдк → барабаны "тормозят" на финальных символах
5. Если выигрыш — haptic feedback + эффект монет

// Мониторинг событий контракта
async function watchSlotEvents(contractAddress: string) {
  const client = new TonClient({ endpoint: "https://toncenter.com/api/v2/jsonRPC" });

  setInterval(async () => {
    const transactions = await client.getTransactions(Address.parse(contractAddress), {
      limit: 10,
    });

    for (const tx of transactions) {
      if (tx.inMessage?.body) {
        // Парсим результат барабанов из body транзакции
        const result = parseSpinResult(tx.inMessage.body);
        if (result && result.player === currentPlayerAddress) {
          animateReels(result.reel1, result.reel2, result.reel3);
        }
      }
    }
  }, 2000);
}

Монетизация и TON экосистема

TON обеспечивает несколько преимуществ для TMA слотов:

• @wallet integration — пользователи Telegram часто уже имеют TON кошелёк через встроенный @wallet
• Комиссии — транзакции в TON стоят ~$0.003–0.01, что приемлемо для игровых микротранзакций
• TON Stars — внутренняя валюта Telegram (для non-crypto пользователей)
• Viral mechanics — нативный шаринг результатов в чаты через WebApp.openTelegramLink

RTP (Return to Player) для честных слотов: 95–97%. House edge 3–5% обеспечивает устойчивую экономику при достаточном объёме игр.