Гайд по использованию Starknet aio
Что умеет скрипт?
1). Асинхронная работа абсолютно всех функций, то есть одновременный запуск сразу нескольких кошельков
2). Скрипт умеет работать как с сидфразами так и с приватными ключами любых кошельков, и при работе не нужно указывать какой у вас кошелек, скрипт это сделает за вас
3). Возможность использовать круговые прогоны Okx -> Starknet -> Okx -> следующий кошёлек, с переведом с субакков на главный аккаунт
4). Свапы на Avnu, 10Kswap, Sithswap, Fibrous, Jediswap, MySwap, Wido, Rango, Protoss
5). Сборщик токенов в эфир
6). Добавление и вывод из ликвидности на 10Kswap, Jediswap, MySwap
7). Бридж эфира в обе стороны (через Starkgate) и Orbiter
8). Работа с нфт : минт Starknet Id, Starkverse, Zerius, выставление офферов и листингов на нфт-маркетах Unframed и Flexing
9). Отправка сообщений через Dmail
10). Работа с ZkLend: добавление и вывод ликвидности, включение и выключение коллатерала, возможность делать borrow и репей, а также отдельный модуль с набиванием объёма
11). Вывод и отправка на Okx
12). Работа с кошельками: cоздание кошельков, конвертация из сидки, деплой и обновление кошелька
13). Отслеживание гвея в эфире и в старкнете
14). Работа с прокси, как с обычными так и с мобильными
15). Возможность включения телеграм бота, в котором можно очень удобно отслеживать ваш прогресс при запуске скрипта
16). Фарм транзакций, настройка путей, рандомизация абсолютно всех параметров, настройка перерывов между действиями, полная настройка ваших действий
17). Встроенный чекер балансов и транз.
18). Очень удобная запись в таблицу по всем действиям, которые проделал скрипт, в том числе объемы и комиссии. При каждом запуске создается отдельный лист со всеми действиями (пример ниже)
Начнём установку:
Для начала скачиваем pycharm (бесплатную community версию) и python версию выше 3.9.
Скачиваем файлы бота, открываем их в пичарме и через терминал создаем venv:
python -m venv venv venv\Scripts\activate.bat
Вводим туда команды ниже и скачиваем нужные библиотеки:
pip install -r requirements.txt
Далее если вы пользователь Windows:
1) Скачиваем chocolately - https://chocolatey.org/install
2) Далее открываем windows powershell от имени администратора и вводим туда команду:
choco install mingw
3) После установки, заходим по поиску в изменение системных переменных среды,
далее тыкаем переменные среды,
далее нажимаем создать и вводим в поле:C:\ProgramData\chocolatey\lib\mingw\tools\install\mingw64\bin
После тыкаем Ок и перезагружаем компьютер.
Перейдем к заполнению файлов с кошельками и прокси:
Открываем папку wallets_data и заполняем:
- в evm_keys.txt приватники от евм ключей, которые будут 1 к 1 к старкнетовским ключам,
- в keys.txt приватники/сидки от старка или если мы будет использовать модуль с трансфером то приватники от старка вместе с адресом на который нужно будет отправить в формате - starknet_privatekey;starknet_address_to_send (обязательно через ";")
- в proxies.txt вставляем прокси в формате log:pass@ip:port (обязательно http). Для каждого ключа старка будет взята 1 прокси, т.е если у вас прокси меньше чем приватников от старка, то скрипт будет брать уже использующиеся прокси
В итоге при заполнении всех данных, каждый аккаунт при запуске скрипта будет представлять из себя пару из евм приватника, старкнет приватника, старкнет адреса для пополнения и прокси
Перейдем к настройке конфига и более подробному описанию того что в происходит в скрипте:
Настройка рпц: указываем свои (рекомендую именно рпц от http://infura.io/, регаемся и вставляем один раз для каждой сети), (также можно не указывать рпц для старкнета, в таком случае будет использоваться дефолтная мейн рпц старка: https://alpha-mainnet.starknet.io
Далее читаем и заполняем другие переменные, при возможности указываем телеграмм бота (рекомендую). При его использовании всегда можно будет получить актуальную информацию о статусе выполнения и получить логи, те же самые что идут в консоль, удобно когда нужно куда то уйти
Настройка перерывов:
start_delay - перерыв перед началом работы, нужен для того чтобы наши кошельки запустились максимально рандомно в разное время (рекомендуется брать числа имеющие максимально большое различие, 1 и 1000, или 1 и 500, для большего рандома)
Выбор модулей:
Краткое описание как работает каждый тип модуля (для каждого модуля далее будет своя настройка):
- Работа с кошельками:
- create_wallets - скрипт создает указанное количество кошельков браавоса или аргента и записывает в таблицу
- convert_from_seed, convert_from_keys - конвертирует из сидки в приватник и адрес, из приватника в адрес и записывает всё в таблицу
- update - обновляет кошёлек до кайро 1 (только для аргента в данный момент)
- deploy - деплоит не задеплоенный кошёлек, по дефолту включено, перед работой скрипт проверяет задеплоен ли адрес и если нет то деплоит его (нужно указать wallet_type!)
- Дексы:
- Агрегаторы - Avnu, Wido, Fibrous, Rango
- Обычные свапалки - 10Kswap, Sithswap, Jediswap, MySwap, Protoss
- Cкрипт свапает на этих дексах, больше всего идеален для набивания объёмов - Avnu
- Ликвидность:
- Jediswap, 10Kswap, MySwap - cкрипт покупает проверяет есть ли на балансе указанный вами токен для добавления в ликвидность, если он отсуствует, то будет покупать на этом же дексе
- Бридж эфира:
- Starkgate_to_stark - бридж эфира в старк из эфира
- Starkgate_to_eth - бридж эфира из старка в эфир
- Orbiter - бридж эфира через орбитер
- Во всех случаях, при указании модуля скрипт начнёт cначала бриджить эфир, и ждать его получения (если вы включили wait_balance). Приоритетнее бриджей только вывод с Окха, эти модули будут выполняться раньше всех остальных модулей
- Нфт:
- Нфт офферы:
- Unframed_offer, Flexing_offer - выставляет оффер на рандомное количество эфира на рандомную нфт из списка коллекций, которые вы укажите в конфиге. Также есть возможность указать отмену оффера, в этом случае скрипт будет делать доп транзакцию
- Unframed_listing, Flexing_listing - выставляет вашу рандомную нфт, на маркете за рандомную сумму, которую вы укажите в конфиге
- Dmail:
- Отправляет сообщения через дмейл (только транзы), есть возможность указать кол-во транзакций, они будут перемешаны вместе с другими модулями
- Zk_lend:
- Взаимодействует с лендингом Zklend. При указании модуля есть возможность включить выполнение займа usdc, после которого скрипт будет работать с занятыми usdc, и после завершения работы отдавать долг. Также если включен use_withdraw то скрипт будет выводить после работы эфир из лендинга, если же он выключен, то вам нужно будет дополнительно либо указывать в модулях модуль вывода эфира из лендинга
- Zklend volume - набивает объём путем добавления и вывода эфира из лендинга, происходит это параллельно с другими модулями, не подряд, что добавляет больше рандома вашим действиям
- Okx:
- Трансфер:
- отправляет эфир на указанный вами адрес, в количестве либо равно какому-то проценту баланса либо сумме равной баланс за вычетом остатка на кошельке. После этого ожидает его пополнения на балансе и выводит на главный аккаунт
Указываем нужные нам модули
В modules_ через запятую пишем все, что нам нужно.
Также по желанию изменяем модули в cheep_modules, в самых дешёвых модулях, которые можно использовать просто для поддержания активности
Указываем перемешивать ли модули в shuffle_modules_, рекомендую это делать для большего объёма
Также есть возможность добавить ещё больше рандома для ваших аккаунтов, путём включения random_choice_modules, и указанием от и до скольки модулей оставлять из большого списка ваших модулей (условно у вас есть 10 модулей, скрипт выбрал 4 модуля, тогда изначально от 10 модулей останется всего 4). Модули бриджей, вывода с Окх и трансфер не учитываются при обрезании модулей!
Указываем количество транзакций, которые необходимо нужно будет сделать, после того как скрипт выполнит их он закончит работу на данном кошельке. Также можно ничего не указывать и оставить скобки пустыми, тогда скрипт просто пройдётся по всем модулям
Настройка модулей
Создание кошельков
Указываем тип кошелька и количество кошей для создания
Также wallet_type кошелька который указан тут, будет использоваться для деплоя незадеплоенного кошелька (если на кошельке нет средств, обязательно указываем модуль вывода средств). Также обязательно нужно указать тут тип кошелька, который будет использоваться, если у вас используются сид фразы.
Настройка дексов
В dex mode - указываем режим для свапов:
exact - для КАЖДОГО декса будут использоваться только токены выбранные в ТОКЕНАХ для данного декса all - для всех дексов указанных в модулях для работы будет использоваться usdc amount mode
procent - будет выбран рандомный процент от баланса в диапазоне (нужно заполнить amount_swap в ПРОЦЕНТАХ)
manual - будет выбран рандомный сумма в диапазоне (нужно заполнить amount_swap в ЭФИРЕ)
double_swap - рекомендую использовать, свапает ваш токен обратно в эфир, на том же декс
swap remains (сборщик в эфир)
доп функция которую можно включить или выключить, чекает остатки токенов и свапает в эфир если они есть. указываем в swap_remains_dexs
дексы которые мы бы хотели использовать для свапа обратно в эфир. также указываем мин баланс для свапа.
Настройки ликвидности
liq_mode - указываем мод для работы в данном модуле:
add - добавить ликвидность
withdraw - вывести ликвидность
token_to_liq - указываем токен/токены для добавления в ликвидность (если указано несколько будет выбран рандомный токен) либо оставляем пустым и указываем для каждого декса свои токены
liquidity_amount - указываем от сколько до скольки (вместе с эквивалентом в эфире) добавлять в ликвидность
ВНИМАНИЕ! Если на кошельке отсутсвует токен, cкрипт покупает его на том же дексе где и лочит ликвидность.
Настройка бриджей
Указываем нужны нам bridge_mode, выбираем amount.
Для орбитера доступны переводы между сетями: opti arbi stark zk eth
Настройка нфт и офферов
Указываем контракты через запятую в unframed_contracts и в flexing_contracts Указываем offers_amount и listing_amount. use_cancel_order - включаем или выключаем по желанию, либо указываем рандомно
Настройка Dmail
указываем от и до скольки сообщений отправлять в dmail_msgs, эти сообщения будут отправляться в разнобой с другими модулями
количество сообщений выбранное скриптом, добавит количество транзакций для выполнения в общее количество транзакций если вы их указали
Настройка ZkLend
use_collateral - использовать ли коллатерал? создает дополнительную транзу при депозите и выводе
use_withdraw - выводить ли ликвидность, после прогона? если отключено, то можно будет вывести только указав модуль вывода эфира
указываем zk_lend_amount_mode и тут же в zk_lend_amount сумму что мы будем депозититить
use_borrow_for_make_volume - начинать ли прогон с займа usdc ? если да то скрипт займет максимально возможное количество usdc, и после прогона погасит долг. тут же указываем zk_lend_dexs_for_buy_debt - дексы где скрипт будет покупать usdc для погашения долга
zk_lend_volume - сколько набивать объёма используя депозит и вывод из лендинга, работает в разнобой с другими модулями
Настройка Okx
add zeros - если ваши адреса занесены в вайтлист в формате как ниже, те есть в формате 0x0АДРЕС то включаем эту функцию, если используем адреса сгенерированные скриптом (формат 0xAДРЕСС без 0 после 0x) то выключаем
указываем прокси если нужно в okx_proxy в формате log:pass@ip:port (ОБЯЗАТЕЛЬНО HTTP)
далее указываем данные от Окх, указываем сеть и withdraw_amount
Настройка трансферов
transfer_procent - либо указываем сколько процентов баланса будет выводиться
hold_amount - либо оставляем transfer_procent пустым и пишем тут от скольки и до скольки эфира оставлять на кошельке
Настройка прокси
Мы также можем использовать мобильные прокси вместо обычных.
Формат прокси log:pass@ip:port (ОБЯЗАТЕЛЬНО HTTP)
Также в скрипте есть проксичекер, который проверяет работоспособность прокси перед работой
Если у вас обычные то вставляете их файл proxies.txt, если мобильные
то вам нужно будет по порядку вставить их в массивы:
в mobile proxy сами прокси в таком формате если у вас их несколько - ['first', 'second', 'third']
в url_for_change_ip вставляем также в том же порядке ссылки на смену айпи - ['first', 'second', 'third']
а также все равно добавить все ваши мобильные прокси в файл proxies.txt.
Также при запуске скрипта, и его завершении создаётся excel файл в котором появляется все информация о прогоне. Чекайте папку wallets_run_excel_info, она в самом низу
Приступим к запуску:
Ищем терминал, и выбираем windows powershell
Вводим в терминале: python main.py
Далее выбираем модули, есть готовые предзадачи :
1 ) круговой прогон, вам нужно только указать модули которые будут использоваться в самом старкнете, и заполнить данные для окха и трансфера
2 ) вывод с окха в эфире -> загон в старк через оф мост -> ваши модули
3 ) дешёвые модули которые вы указывали в конфиге
4 ) просто ваши модули которые вы заполнили
5 ) чекер балансов и количества транз на кошельках