Skip to content

README-RU.md

Latest commit

 

History

History
180 lines (120 loc) · 7.45 KB

README-RU.md

File metadata and controls

180 lines (120 loc) · 7.45 KB
Fragment Logo

💎 Fragment API от @bohd4nx

Автоматизация пополнений TON, покупки Telegram Premium и Stars через Fragment.com

Сообщить об ошибке · Запросить функцию · Донат TON

✨ Возможности

  • 💰 Пополнение TON для рекламы - Отправка TON для рекламных кампаний и покупки подарков (1-1,000,000,000 TON)
  • 👑 Подарки Telegram Premium - Покупка Premium подписок(3, 6 или 12 месяцев)
  • ⭐ Покупка Telegram Stars - Покупка Stars для пользователей (50-1,000,000 Stars)

🚀 Быстрый старт

1. Установка

git clone https://github.com/bohd4nx/FragmentAPI.git
cd FragmentAPI
pip install -r requirements.txt

2. Настройка

Скопируйте пример конфигурации и отредактируйте:

cp .env.example .env

Отредактируйте файл .env:

COOKIES = your_fragment_cookies_here

SEED = word1 word2 word3 ... word24

HASH = your_fragment_hash_here

API_KEY = your_ton_api_key_here

3. Получение необходимых данных

🍪 Куки Fragment.com

Предварительные требования: Войдите в свой аккаунт Telegram и подключите TON кошелёк, который хотите использовать для платежей.

  1. Установите расширение Cookie Editor:

    • Скачайте из Chrome Web Store
    • Добавьте расширение в ваш браузер

  2. Извлечение куки:

    • Откройте Fragment.com и убедитесь, что вы вошли в систему
    • Полностью обновите страницу
    • Нажмите на иконку расширения Cookie Editor
    • Нажмите кнопку "Export"
    • Выберите формат "Header String"
    • Скопируйте результат → вставьте в COOKIES в вашем .env файле
    • Важно: Заключите значение в кавычки, чтобы точки с запятой не интерпретировались как комментарии

Ожидаемый формат:

COOKIES = "stel_token=<TOKEN>;stel_dt=<STEL_DT>;stel_ssid=<SSID>;stel_ton_token=<TON_TOKEN>"

🔐 Seed-фраза TON кошелька

Если у вас ещё нет TON кошелька:

  1. Скачайте Tonkeeper:

  2. Создайте новый кошелёк:

    • Откройте приложение Tonkeeper
    • Нажмите "Создать новый кошелёк"
    • ВАЖНО: Запишите вашу 24-словную seed-фразу на бумаге
    • Храните её в безопасном месте - никогда не делитесь ей ни с кем!
    • Завершите настройку кошелька

  3. Получите вашу seed-фразу:

    • Если у вас уже есть кошелёк, перейдите в Настройки → Резервное копирование
    • Введите ваш пароль
    • Скопируйте 24 слова → вставьте в SEED в вашем .env файле

Формат: слово1 слово2 слово3 ... слово24

🔗 Хеш Fragment

Предварительные требования: Сначала завершите настройку куки выше.

  1. Подключите кошелёк к Fragment:

    • Перейдите на Fragment.com
    • Убедитесь, что ваш TON кошелёк подключён
    • Войдите с вашим аккаунтом Telegram

  2. Извлечение хеша:

    • Откройте Инструменты разработчика (F12)
    • Нажмите на вкладку "Сеть"
    • Перейдите к покупке Stars
    • Выберите получателя как "Buy for myself"
    • Обновите страницу (Ctrl+R / Cmd+R)
    • Найдите сетевые запросы, содержащие ?hash=
    • Найдите значение хеша и скопируйте его → вставьте в HASH в вашем .env файле

Ожидаемый формат: ?hash=<ваш_хеш_здесь>

🔑 API ключ TON

  1. Получите API ключ:
    • Посетите TON Console
    • Создайте аккаунт и войдите
    • Сгенерируйте новый API ключ
    • Скопируйте ключ → вставьте в API_KEY в вашем .env файле

Альтернатива: Вы также можете использовать TON API для получения API ключа.

4. Использование

Запуск примеров

python main.py

Программное использование

from app.methods import FragmentTon, FragmentPremium, FragmentStars

# Пополнение TON для рекламы
ton_client = FragmentTon()
result = await ton_client.topup_ton("@username", 5)

# Покупка Premium
premium_client = FragmentPremium()
result = await premium_client.buy_premium("@username", 6)

# Покупка Stars
stars_client = FragmentStars()
result = await stars_client.buy_stars("@username", 50)

Поддерживаемые операции

Операция Метод Параметры Ограничения
Пополнение TON topup_ton(username, amount) Имя пользователя, количество TON 1-1,000,000,000 TON
Подарок Premium buy_premium(username, months) Имя пользователя, длительность 3, 6 или 12 месяцев
Покупка Stars buy_stars(username, amount) Имя пользователя, количество Stars 50-1,000,000 Stars

Форматы имён пользователей

Все методы принимают различные форматы имён пользователей:

  • @username (с @)
  • username (без @)

Made with ❤️ by @bohd4nx

Поставьте ⭐ этому репозиторию, если он оказался полезным!