Доки — harvest

◆

Коротко о проекте

Факт	Значение
Сети из коробки	4 — Robinhood 46630 · Flop · Arc 5042002 · vibe/vibe
Тесты	pytest · контрактные сценарии · CI
Генерация	BIP-39 · ~60 кошельков/сек · AES-256-GCM
RPC-слой	мульти-RPC · EMA · circuit breaker · TTL-кэши
Управление	CLI auto.py · Rich-меню main.py · портал + Telegram-бот
Дистрибуция	exe через PyInstaller · Docker + compose

Как устроено

main.py — меню для человека, auto.py — тот же пайплайн для скрипта. Оба делят одно ядро core/. Один NetworkManager на сессию — латентность, кэши и монитор общие. Запись в БД идёт через BatchWriter батчами, с паузой после серии сбоев.

main.py ── interactive menu (Rich live, p/q keys) auto.py ── CLI pipeline: gen → faucet → farm → export │ core/config.py ── load + env-override + validate core/license.py ── hub gate, PBKDF2, offline grace core/performance.py ── workers/rpc/gen/chunk │ core/pool.py FarmerPool ── state.json recovery └── core/workpool.py ── health-scaled workers └── core/farmer.py ── one-wallet cycle └── core/actions.py ── weights × adaptive scores └── core/behavior.py ── sha256(address) profiles │ core/network.py ── multi-RPC, EMA, breaker, TTL core/faucet.py ── chainstack/direct, batch+semaphore core/database.py ── SQLite WAL / PostgreSQL DSN core/crypto.py ── AES-256-GCM seeds core/exporter.py ── CSV/JSON (+AES-CBC v2 files)

Модуль	Отвечает за
network	Пинг 30с, проба 2500мс, ретраи ×3, failover, receipt-бюджет 30с
workpool	Очередь приоритетов, retire без cancel, respawn с backoff
batchwriter	flush 2с/500 строк, dropped_count, cooldown 30с
vibevibe	ABI, EIP-712 TradeIntent, gas default 300000
database	wallets/actions_log/nonces/cycle_history, VACUUM, бэкапы
doctor	Конфиг → ключ → БД → RPC → кран → лицензия, exit code
web_gui	Локальная веб-панель: кнопки, WebSocket-лог, топ и история (main.py → G, 127.0.0.1:8080)

Детали каждого слоя — devdocs/ в репозитории (ядро, портал, конфиги, Tier-2 про реальные RPC/контракты).

Портал и Telegram

python -m portal поднимает aiohttp (веб + API) и, если есть токен, Telegram-бота. Секреты — только через env. Если портал выставляют не на loopback и способа входа нет, он отказывается стартовать.

env	Назначение
PORTAL_SECRET	Подпись сессий, мин. 16 символов
TELEGRAM_BOT_TOKEN	Токен от BotFather
TELEGRAM_ALLOW_IDS	Default-deny список user_id
TELEGRAM_OWNER_ID	user_id владельца, панель /admin
FARMER_MASTER_KEY	Мастер-ключ БД / PIN веб-входа
GOOGLE_CLIENT_ID/SECRET	Google OAuth 2.0 + PKCE
PORTAL_DB / PORTAL_FARM_CONFIG	Путь к БД / конфиг фермера

@harvest_testnet_bot

Старт/стоп/пауза, поле и статистика, ссылки, экспорт CSV/JSON, кнопки под сообщениями, команды: /start, /menu, /status, /monitor, /doctor, /diag, /history, /pnl, /balance, /wallets, /profiles, /export, /network, /pause, /resume, /stop, /faucet, /rpc, /scheduler, /alerts, /admin (только владелец), /cmd, /cfg, /check, /ref, /cancel, /help — плюс конструкторы /cmd (готовая команда), /cfg (готовый YAML файлом), /check (проверка YAML валидатором) и /ref (справочник). Стиль сообщений — как этот сайт: секции harvest // X, маркеры [RUN]/[STOP]/[ok], эмодзи только в статусе home. Значения экранируются, колбэки — с generic-ответами об ошибках.

deploy/

VPS / Docker

Готовый кит: Dockerfile + compose, long-polling без публичного URL, Caddy для HTTPS позже, .env-шаблон, healthcheck, volume для данных.

Безопасность — по умолчанию закрыто

Шифрование

Сиды — AES-256-GCM (nonce 12B, AAD wallet-seed). Файлы экспорта — AES-256-CBC v2: PBKDF2-SHA256 100k, раздельные ключи шифрования и MAC, HMAC-проверка до записи.

Redaction

RPC-URL чистятся везде: credentials до @ и query-токены стираются. https://user:pass@host/?api_key=X → https://host/. Логи, история циклов, CLI-вывод.

Fail-closed

Нет мастер-ключа при шифрованных сидах — отказ. Портал default-deny, single-instance лок на БД, ограничение прав файлов, лимиты логина 5/10мин per-IP.

Нашли уязвимость — не открывайте публичный issue. Напишите через private vulnerability reporting на GitHub или напрямую мейнтейнеру. Поддерживается последний релиз; стараюсь ответить в течение 48 часов.

Проверки и вопросы

python -m pytest tests -q

wait_for_receipt: EMA-бюджет поллинга, failover при серии ошибок, деградация частоты, None по бюджету без отката nonce, кросс-чек на вторичной ноде.
Линт: ruff · flake8 · black (120) · mypy · bandit. CI гоняет то же, что можно запустить локально; покрытие core/portal — это гейт в CI, а не цифра для хвастовства на сайте.
Нагрузочный тест — opt-in: $env:HARVEST_LOAD=1; python -m pytest tests/test_load_opt.py -q.

Q1 Это для мейннета?

Нет. Только тестнеты и учебная активность. Не используйте реальные средства и не храните реальные ключи в демо-зоне сайта.

Q2 Где мои ключи из демо-генератора?

Только в памяти вкладки. Сайт статический, на сервер ничего не уходит — закройте вкладку или нажмите «Очистить», и ключи исчезнут. Для постоянного хранения используйте экспорт и шифрование из Python-версии.

Q3 Что делать с 0x0-контрактами в конфиге?

Это заглушки по дизайну: валидатор пропускает их с замечанием, runtime откатывается на transfer. Впишите реальные адреса из Tier-2 документации, когда будете готовы.

Q4 Почему поле пустое?

Поле оживает после первой публикации: запустите python publish_dash.py на машине фермы (по умолчанию раз в 30 минут, допустимо 15–60; история main не растёт — снапшот уходит в ветку gh-pages). Если данных нет — это не ошибка сайта, ферма просто ещё ничего не отправила.

Q5 Вы обещаете дроп?

Нет. harvest не гарантирует дроп, поинты или прибыль. Тестнеты меняются, активность могут не засчитать. Инструмент помогает делать практику аккуратно, но результат не в его власти.

Лицензия MIT

Свободно используйте, копируйте, изменяйте, публикуйте и продавайте — с сохранением уведомления об авторстве. Без гарантий.

MIT License Copyright (c) 2026 ssrjkk (https://t.me/ssrjkk_bot) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.