¶ Что это такое?
KDX (аббревиатура от Kaspa Desktop eXperience) — это утилита с графическим интерфейсом 3-в-1. который объединяет все три основных компонента Kaspa (нода, кошелек и майнер) в единое средство на основе графического интерфейса. Начиная с версии 2.10.5 (05 июня 2022 г.) входящие в него компоненты:
¶ Как это использовать?
¶ Запуск приложения
Скачайте его, установите и запустите.
¶ Ожидание синхронизации нода с сетью
KDX — это «полный кошелек» по терминологии Биткойна, и поэтому он содержит полную ноду Kaspa-ы и запрашивает баланс адресов от этого узла. Чтобы узнать истинный текущий баланс любого адреса, нода должна сначала синхронизироваться с остальной частью сети. Поэтому обратите внимание, что ни кошелек, ни майнер не будут работать, пока нода KDX не будет полностью синхронизированны. В частности, вы не увидите свой правильный баланс, пока DAG не будет синхронизирован на 100%.
Чтобы увидеть ход процесса синхронизации, следите за индикатором «Синхронизация DAG» на главной вкладке, он должен стать 100%. Строка «Кошелек онлайн» на вкладке «Кошелек» может вводить в заблуждение в этом отношении: он онлайн только в том смысле, что внутри него есть работающая нода, но не сообщает, синхронизированна ли она. Также убедитесь, что значение индикатора «Blue score» на главной вкладке не менее 42 000 000 (на 28 марта 2023 года и даже больше на будущие даты), а значение индикатора «DAA score» на вкладке «Кошелек» не менее 43 555 000 (на 28 марта 2023 года и даже больше на будущие даты). Темп роста этих значений составляет около 1 в секунду, согласно текущему блокрейту Kaspa, поэтому каждый день они увеличиваются примерно на 86400.
¶ Сведения о ходе синхронизации
Для подробного просмотра этапов синхронизации установите флажок «Дополнительные настройки» на вкладке «Настройки» KDX. Вы увидите новую вкладку под названием KASPADkd0. Там будет отображаться журнал встроенной в KDX ноды Kaspa. В этой статье вы узнаете, что к чему, из каких этапов состоит процесс синхронизации и сколько времени они занимают.
¶ Получение окончательного баланса
KDX также требуется некоторое время для сканирования и сбора баланса. Все это время кошелек будет оставаться в состоянии «Offline». Если баланс не отображается правильно после того, как кошелек переходит в состояние «Онлайн», может помочь перезапуск KDX, а затем, он все еще не правильный, попробуйте использовать кнопку «Сканировать больше адресов» в разделе «Debug» вкладки «Кошелек» и пусть KDX обрабатывает эту задачу примерно 10 минут. После этого можно снова перезапустить KDX.
¶ Рабочий режим по умолчанию
В KDX есть несколько шаблонов конфигурации, из которых вы можете выбирать; по умолчанию он запускается в режиме «Kaspad node» в основной сети (не в тестовой сети, devnet), где он не майнит, но вы все равно можете использовать кошелек для отправки и получения монет. В этом режиме ПК с запущенным KDX можно использовать в качестве поставщика узлов для ваших майнинговых ферм.
¶ Майнинг с KDX
Если вы хотите, чтобы KDX майнил, измените его рабочий режим в настройках на «GPU miner» и установите флажок «Включить майнинг» в настройках (обратите внимание, что это одиночный майнинг, в котором может быть очень сложно найти блок). с вашим единственным графическим процессором в наши дни, когда хешрейт сети чрезвычайно высок.Возможно, вместо этого вам следует придерживаться майнинга в пуле, см. “Майнинг" на Wiki.
¶ Особенности майнинга на графических процессорах AMD
cuda-workload parameterТолько одно: чтобы иметь возможность майнить на графических процессорах AMD, вам нужно нажать кнопку: Settings изменить там в Service configuration поле редактирования cuda-workload линию opencl-workload , оставив соседнее числовое значение нетронутым (см. скриншот справа).
В KDX тоже есть CPU-майнер, но смысла в его использовании нет, т.к.
- это скорее концептуальный майнер из набора основных файлов Kaspa, он медленный и неоптимизированный, и
- Эпоха майнинга на GPU в Kaspa уже давно началась, майнинг на CPU крайне убыточен. Лучше майнить Monero, продавать его и покупать Kaspa, так за тот же период времени будет приобретено больше Kaspa.
¶ Проблема с KDX v.2.11.1 в паре с нодай v.0.12.6
Есть несколько сообщений о том, что во время обновления kaspad v.0.12.6 зависает и возникают какие-то проблемы с базой данных. При этом KDX зависает при попытке использовать кнопку "Удалить папку данных", так как пытается остановить зависший kaspad. Решение состоит в том, чтобы полностью выйти из KDX и вручную удалить папку данных. Папка данных находится в домашней папке пользователя в его .kdx/data подкаталоге ( %userprofile%/.kdx/data в случае Windows). Папки, начинающиеся с точки, скрыты в системах Unix. В OSX Finder есть ярлык для их отображения (Command+Shift+.) (последняя клавиша Dot/Period).
¶ Установка для пользователей Mac
Когда вы загрузите версию KDX для Mac, вы увидите сообщение: "KDX cannot be opened because the developer cannot be verified" (см. снимок экрана «Предупреждение о версии KDX для Mac»). то потому, что приложение не подписано. Это не значит, что это небезопасно, просто вся процедура подписания требует времени, денег и бюрократических усилий, поэтому не выполняется.
Таким образом, чтобы установить KDX на платформу Mac, вам нужно перейти в настройки безопасности вашего Mac и разрешить это. Быстрый поиск в Google объяснит, как это сделать.
Windows делает так же, но когда он запрашивает, он предлагает приложение для запуска, тогда как Mac просто блокирует неподписанные приложения и требует, чтобы пользователи прошли через настройки безопасности, чтобы разрешить это.
¶ Установка для пользователей Linux на базе Ubuntu
Это пошаговое руководство по установке KDX в Linux. Вам понадобится root-доступ с помощью «sudo». Следуйте инструкциям по копированию команд в вашу оболочку. Вы можете вставить его в оболочку с помощью CTRL+SHIFT+V.
¶ Пошаговое руководство
1. Откройте шелл с помощью комбинации клавиш CTRL + ALT + T.
2. Загрузить информацию о пакете из всех настроенных источников
sudo apt update3. Установите необходимые пакеты: curl, gcc, make, git и golang.
sudo apt install -y curl gcc make git golang4. Установитe RUST
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shВведите 1 и нажмите ENTER, когда появится запрос
5. Закройте шелл
exit6. Откройте новый шелл с помощью комбинации клавиш CTRL + ALT + T.
7. Установите NodeJS
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt-get install -y nodejs8. Закройте шелл
exit9. Откройте новый шелл с помощью комбинации клавиш CTRL + ALT + T.
10. Установите nwjs
Проверьте последнюю версию nwjs на https://dl.nwjs.io/ и соответственно обновите первую строку:
nwjsVersion=v0.75.0
mkdir ~/bin
cd ~/bin
wget https://dl.nwjs.io/${nwjsVersion}/nwjs-sdk-${nwjsVersion}-linux-x64.tar.gz
tar xvf nwjs-sdk-${nwjsVersion}-linux-x64.tar.gz
ln -s nwjs-sdk-${nwjsVersion}-linux-x64 nwjs
echo 'export PATH=/home/${USER}/bin/nwjs:$PATH' >> ~/.bashrc11. Закройте шелл
exit12. Откройте новую оболочку с помощью комбинации клавиш CTRL + ALT + T.
13. Установите эманатор - глобально
git clone https://github.com/aspectron/emanator
cd emanator
npm install
sudo npm link14. Перейдите в домашнюю папку
cd ~15. Клонировайте репозиторий Aspectron KDX на github
git clone https://github.com/aspectron/kdx.git16. Установите KDX
cd kdx
npm install17. Установите бинарники kaspad
emanate --local-binaries18. Запустите KDX
nw .
¶ Создание ярлыка на рабочем столе
Чтобы создать на рабочем столе ярлык для запуска KDX, откройте шелл и введите:
cd ~/kdx && echo -e '#! /bin/sh\n~/bin/nwjs/nw ~/kdx/.' >> kdx.sh && chmod +x kdx.sh
echo -e "[Desktop Entry]\nName=KDX\nExec=$HOME/kdx/kdx.sh\nIcon=$HOME/kdx/resources/images/kdx-icon.png\nTerminal=false\nType=Application" >> ~/Desktop/kdx.desktopДважды щелкните новый значок KDX на рабочем столе и выберите «Пометить как доверенный» во всплывающем окне.
Дважды щелкните значок еще раз, и KDX должен нормально работать.
¶ Ручное обновление набора файлов ядра Kaspa в установленном KDX
Иногда выпуск версии KDX задерживается по сравнению с выпуском более новой версии набора файлов ядра Kaspa, а иногда этот выпуск ядра лучше установить как можно скорее, потому что он решает, скажем, определенные проблемы со стабильностью сети Kaspa. В этом случае ручная замена основных файлов, установленных при установке KDX, является самым быстрым способом перехода на новейшую версию ядра.
Для замены набора файлов выполните следующие действия:
- остановите работу KDX полностью;
- загрузите новейший набор файлов ядра Kaspa (архив предварительно скомпилированных двоичных файлов) с Kaspa github: https://github.com/kaspanet/kaspad/releases/latest;
- распакуйте этот архив и замените существующий набор старых файлов ядра разархивированными файлами в папке файлов ядра KDX:
%programfiles%\Kaspa\KDX\bin\windows-x64; - снова запустите KDX.
В случае каких-либо проблем снова остановите работу KDX, удалите все файлы из папки базы данных ноды. %userprofile%/.kdx/data, снова запустите KDX и дайте ему выполнить повторную синхронизацию с нуля.
¶ Взаимодействие с основным CLI кошельком набора основных файлов Kaspa
Вы не можете использовать основной кошелек CLI из основных файлов Kaspa, установленных для работы с монетами KDX/веб-кошелька. Эти два типа кошельков несовместимы и даже имеют разный формат исходной фразы: 12 слов для KDX/web и 24 слова для основного CLI. Единственный способ использовать монеты с одного из кошельков на другом — это создать второй и перевести туда монеты. (см. статью Настройка кошелька CLI, чтобы узнать, как создать основной кошелек CLI.).
¶ Шаблоны конфигурации
На вкладке «Настройки» графического интерфейса KDX доступно несколько шаблонов конфигурации. Их значение следующее:
- Kaspad Node —базовая функциональность, просто узел kaspad, работающий в фоновом режиме KDX, и функции кошелька, выполняемые KDX. В терминологии Биткойн это называется «полный кошелек»;
- CPU Miner — то же, что и предыдущий, плюс майнер сообщества с открытым исходным кодом в режиме одиночного майнинга ЦП, майнинг на локальный узел KDX. Вы можете настроить количество ядер ЦП, которые он использует, установив соответствующее значение для
threadsпараметер в"gpuminer:km0"-"args"раздел файла конфигурации json в поле редактирования, расположенном над раскрывающимся списком шаблонов конфигурации; - GPU Miner — 1-й плюс майнер сообщества в одиночном режиме GPU-майнинга, майнинг на локальную ноду KDX.
- Self-Contained Kaspad Mining — первый плюс проверенный однопоточный майнер процессора golang из набора файлов ядра Kaspa, который в настоящее время не имеет практического применения, если только вы не собираетесь использовать его в среде тестовой сети, где он, наоборот, очень полезен ;
- Kaspad Archival Node —1-й, но узел не выполняет обрезку данных, которая по умолчанию выполняется каждые 24 часа. Обычно не требуется, если только вы не знаете, что по какой-то причине вам нужна история всех транзакций (обратите внимание, что до сих пор нет удобного набора инструментов для работы с этой историей).
- Kaspa Archival Node + Miner — то же, что и предыдущий, плюс майнер сообщества с открытым исходным кодом в режиме одиночного майнинга ЦП, майнинг на локальный узел KDX.
¶ Восстановление кошелька из seed фразы
Чтобы восстановить кошелек из сид-фразы из 12 слов, выполните следующие действия:
- Полностью закройте KDX, не позволяя ему работать в фоновом режиме;
- Запустите его снова;
- Перейдите на вкладку «Кошелек»;
- Нажмите «Новый кошелек», затем «У меня есть кошелек»;
- Введите сид фразу.
¶ Переключение между разными кошельками
В настоящее время (04 сентября 2022 г.) KDX не поддерживает эту функцию. Самое близкое, что вы можете сделать, это переключить кошельки, восстановив их из их сид фраз, по одному. см. предыдущую главу, чтобы узнать, как это сделать.
¶ Некоторые технические детали
Расположение и имя файла ключа кошелька KDX: %appdata%\Kaspa\kaspa.kpk. Подсказка: если вы удалите ключевой файл, то KDX запросит новый кошелек.
См. раздел часто задаваемых вопросов о KDX и веб-кошельках, чтобы узнать больше информации об их функциональности.
¶ Ссылки
Новейшие выпуски KDX можно в любое время найти здесь.: https://kdx.app/
Исходники KDX доступны здесь: https://github.com/aspectron/kdx
¶ Другие кошельки, связанные с KDX
¶ Веб-кошелек
Веб-кошелек разделяет кодовую базу KDX во многих аспектах, поэтому, как правило, большую часть того, что вы знаете и что можно сказать о KDX, можно также сказать и о веб-кошельке. Его исходники доступны здесь: https://github.com/aspectron/kaspa-wallet-pwa
¶ Кошелек CLI, совместимый с KDX/web
Для тех, кто более комфортно работает с инструментальной цепочкой CLI, есть CLI-кошелек, совместимый с KDX/web, и его источник можно увидеть на https://github.com/aspectron/kaspa-wallet-cli
Пример командной строки: node kaspa-wallet.js --rpc 10.0.0.8:16110 info
Пример запуска команды: `node pwa.js --host 10.0.0.6 --grpc 10.0.0.8`
¶ Проблемы
В случае, если у вас есть проблема с кошельком KDX — скажем, он не показывает «Адрес получения» или окно транзакций пусто, что может произойти после восстановления с исходной фразы — решение состоит в том, чтобы остановить приложение, удалить все файлы из %localappdata%\kdx\User Data folder and start KDX again.