HodlerGifts

Как запустить

От оплаты до первого лота на FunPay около 30 минут. Программа работает на вашем сервере круглосуточно, компьютер можно выключать. Ниже всё по шагам, команды можно копировать как есть.

Как это работает

  • Программа берёт NFT-подарки с Portals и выставляет их на FunPay с вашей наценкой.
  • Когда покупатель оплачивает заказ на FunPay, программа сама покупает подарок на Portals, выводит его в ваш Telegram и передаёт покупателю.
  • Вы только пополняете баланс Portals и следите за панелью. Чат с покупателем, возвраты и защита от убытков работают автоматически.

Подписка

Первый месяц стоит 30 долларов, каждый следующий 10 долларов. Плагин раз в несколько часов сверяется с нашим сайтом, оплачена ли подписка. Если она закончилась, у вас 7 дней на продление, потом плагин перестаёт создавать лоты и покупать подарки. Продлить можно на странице вашего заказа, ключ менять не нужно. Нужен доступ в интернет с сервера, где работает плагин.

Что понадобится

  • Сервер (VPS) с Ubuntu 22.04 или 24.04, от 1 ГБ памяти, примерно $4–6 в месяц. Подойдёт любой хостинг. Нужен постоянный IP: на нём будет работать ваш аккаунт FunPay.
  • Аккаунт FunPay и его ключ golden_key (шаг 2).
  • Аккаунт Telegram, в котором открыт Portals и лежит баланс. Подарки выводятся именно в него. Лучше отдельный аккаунт для работы.
  • api_id и api_hash с my.telegram.org (шаг 2).
  • TON на балансе Portals: на покупку подарков и комиссии. Начните с суммы, которой хватит на 2–3 дешёвых подарка.

Шаг 1. Подключитесь к серверу

После покупки VPS хостинг даст вам IP-адрес и пароль. На Windows откройте PowerShell (на Mac и Linux откройте «Терминал») и выполните, подставив свой IP:

ssh root@ВАШ_IP

Согласитесь на вопрос о ключе (yes) и введите пароль. Когда набираете пароль, символы на экране не отображаются, это нормально.

Шаг 2. Соберите три ключа

  • golden_key. Войдите на funpay.com в браузере. Нажмите F12, откройте вкладку «Приложение» (Application), слева «Файлы cookie» (Cookies), выберите funpay.com. Найдите строку golden_key и скопируйте её значение (около 32 символов). После этого закройте FunPay в этом браузере и не заходите туда, пока работает программа: один и тот же ключ, использованный с двух адресов, приводит к блокировке.
  • api_id и api_hash. Откройте my.telegram.org, войдите по номеру телефона, выберите «API development tools», создайте приложение (название любое) и скопируйте оба значения.

Шаг 3. Загрузите архив и запустите установщик

Скачайте архив со страницы заказа. На своём компьютере откройте второе окно PowerShell в папке с архивом и отправьте его на сервер:

scp giftdesk.zip root@ВАШ_IP:~

Затем в окне с подключением к серверу:

apt-get install -y unzip
unzip giftdesk.zip
cd giftdesk
bash install.sh

Установщик сам поставит Docker, спросит golden_key, api_id и api_hash, затем попросит войти в Telegram: введите номер телефона, код из Telegram и пароль двухфакторной защиты, если он включён. В конце программа запустится.

Шаг 4. Откройте панель управления

Панель закрыта от интернета, это сделано для безопасности. Откройте на своём компьютере PowerShell и выполните:

ssh -L 8787:127.0.0.1:8787 root@ВАШ_IP

Не закрывайте это окно, пока работаете с панелью. Затем откройте в браузере http://127.0.0.1:8787.

Шаг 5. Первый запуск

  1. Панель стартует в безопасном режиме: показывает, что сделала бы, но ничего не меняет на FunPay. Нажмите «Синхронизировать сейчас» и посмотрите блок «Что создал бы сухой прогон»: названия, цены, количество лотов.
  2. Откройте блок «Настройки» и проверьте наценку и список коллекций. Начните с двух-трёх дешёвых коллекций.
  3. Пополните баланс Portals в TON (в Telegram, в боте Portals).
  4. Включите «Боевой режим». Программа создаст лоты на FunPay. Проверьте на сайте, что они выглядят правильно.
  5. Включите «Исполнение заказов». С этого момента оплаченные заказы выполняются автоматически. Для первого раза сделайте заказ на самый дешёвый подарок и проследите за блоком «События».

Что настраивается в config.yaml

Файл лежит на сервере по пути giftdesk/data/config.yaml. Открыть для правки: nano data/config.yaml, сохранить: Ctrl+O, Enter, Ctrl+X. После правок примените: docker compose restart. Самое важное:

  • portals.collections: какие коллекции выставлять (названия как на Portals).
  • portals.per_collection: сколько лотов с конкретными подарками выставлять на каждую коллекцию.
  • pricing.markup и min_profit_usd: ваша наценка и минимальная прибыль с подарка.
  • fulfil.max_buy_ton: потолок цены, дороже которого программа не купит.
  • lot.type_map: какой коллекции какой «тип» на FunPay соответствует. Незнакомые идут в default_type.

Каждый день

  • Следите за балансом TON на Portals: если его не хватит, заказ получит возврат.
  • Раз в день заглядывайте в «События» в панели: ошибки подсвечены.
  • Если панель пишет «требует внимания» у заказа, откройте чат с покупателем на FunPay и ответьте вручную.

Режим «каталог» (по желанию)

В нём на FunPay висит один лот на коллекцию, а покупатель выбирает конкретный подарок на вашем сайте-витрине. Нужен свой домен с HTTPS: укажите его в storefront.public_url и catalog.public_url, поставьте portals.collection_lots: true и направьте домен на порт 8788 сервера через Caddy или nginx. Если не уверены, пропустите этот режим: сначала запустите обычный.

Если что-то не работает

  • Логи: cd giftdesk && docker compose logs --tail 100. Текст ошибки (без ключей) присылайте в поддержку.
  • Portals не отвечает или просит вход: повторите вход в Telegram: docker compose run --rm gifts python -m gifts login.
  • FunPay пишет, что ключ недействителен: возьмите новый golden_key (шаг 2), впишите в data/.env и выполните docker compose restart.
  • Панель пишет, что подписка закончилась: продлите её на странице заказа. Проверка обновится в течение нескольких часов, чтобы ускорить, перезапустите плагин: docker compose restart.
  • Панель не открывается: проверьте, что окно с туннелем открыто и контейнер работает: docker compose ps.
  • Обновление версии: скачайте новый архив со страницы заказа, распакуйте поверх старой папки (папку data не удаляйте) и выполните docker compose up -d --build.

Правила, которые защищают аккаунт

  • Один ключ FunPay используйте только на одном сервере. Тот же ключ с другого адреса приводит к блокировке.
  • Не заходите на FunPay в браузере под этим же ключом параллельно с ботом.
  • Не публикуйте ключи и данные входа в видео и скриншотах.
  • Описания лотов не должны содержать слов, запрещённых на FunPay. Бот проверяет свои тексты сам, но свои правки проверяйте вы.
  • Лицензия рассчитана на один аккаунт FunPay.

Нужна помощь

Напишите в поддержку: @hodler_gifts. Укажите номер заказа и текст ошибки (без ключей).