CLI означает «интерфейс командной строки» (также известный как «консоль»), в отличие от GUI — «графический пользовательский интерфейс».
Загрузите ZIP-архив предварительно скомпилированных файлов последней версии из официального репозитория и распакуйте их в любое удобное для вас место. Выберите подходящую версию для вашей ОС: xxx-win64.zip для пользователей Windows, xxx-osx.zip для пользователей Mac, xxx-linux.zip для Linux. Убедитесь, что вы не загружаете релиз для тестнета (тот, что с постфиксом «Testnet» в названии выпуска), это версия для тестовой сети разработчиков, а не для мейннета, которая вам нужна.
В дальнейшем тексте все примеры будут показаны для случая, когда файлы распаковываются в папку C:\Kaspa\. Если вы распакуете архив в другую папку, то замените этот путь в примерах, показанных тут, на свой. Кроме того, все пояснения даны для Microsoft Windows. Для иных операционных систем команды или идеи операций будут в целом те же, но специфика может быть немного другой.
После распаковки в папке C:\Kaspa\ будет 5 файлов: genkeypair.exe, kaspactl.exe, kaspad.exe, kaspaminer.exe и kaspawallet.exe. Файл, который вам нужен — kaspawallet.exe.
CLI-кошелек Каспы не может быть запущен без параметров командной строки. Если просто дважды щелкнуть на kaspawallet.exe, окно консоли с ним появится на долю секунды, и тут же закроется. Вы ничего не успеете понять, хотя фактически оно при этом покажет вам сообщение о невозможности запуска без параметров командной строки.
Если вы привыкли работать с командной строкой, то убедитесь, что рабочий каталог вашей консоли C:\Kaspa\ , и пользуейтесь командами, описанными ниже.
В противном случае рекомендуется создать файл пакетного исполнения Windows (.bat) для каждой из описанных ниже операций. Чтобы создать его, щелкните правой кнопкой мыши в папке C:\Kaspa\, выберите "Создать->Новый текстовый документ" а затем переименуйте созданный файл подходящим образом. Например, дайте имя create-wallet.bat файлу для операции создания кошелька; wallet-daemon.bat — для запуска daemon-а и т. д. Убедитесь, что Windows не скрывает от вас расширения файлов, иначе вы получите файл по имени create-wallet.bat.txt , не поняв этого, а это не то, что вам нужно.
Для каждой операции, описанной ниже, откройте вновь созданный файл на редактирование с помощью Блокнота Windows, и добавьте в него командную строку соответствующей операции. Например, для создания кошелька содержимое .bat-файла должно выглядеть так:
kaspawallet.exe create
pause
Эта 2-я строка, pause, требуется для просмотра того, что программа кошелька выводила в консоль, чтобы вы могли посмотреть и/или скопировать что-то из этого вывода (скажем, ваш баланс, ваш только что созданный каспа-адрес, или сид-фразу), или увидеть сообщение об ошибке в случае, если что-то пойдет не так, до того, как окно консоли закроется.
Создайте файл .bat со следующим содержимым:
kaspawallet.exe createpause
Вас спросят о пароле от вашего кошелька. Постарайтесь не забыть его сразу, как придумали и ввели, иначе вы больше не сможете получить доступ к своему кошельку (если только не сделаете резервную копию своей seed-фразы).
По завершении операции в папке %localappdata%\Kaspawallet\kaspa-mainnet будет создан файл keys.json. В дальнейшем этот файл будет использоваться kaspawallet.exe-ом в качестве источника параметров кошелька (т.к. в нем хранится зашифрованный приватный ключ, счетчики используемых адресов основых и сдачи, и т.п.).
Если вы хотите, чтобы файл кошелька располагался не в месте по умолчанию, используйте при создании кошелька дополнительный параметр комадндной строки: --keys-file <путь и имя файла кошелька>. Если вы пойдете этим путем, то не забудьте добавлять тот же параметр (--keys-file blabla) всякий раз, когда это потребуется.
Есть 2 способа сделать резервную копию вашего кошелька.
%localappdata%\Kaspawallet\kaspa-mainnet) и скопировать свой keys.json файл (вместе с паролем, если боитесь забыть пароль и если не храните пароли более безопасно, с помощью менеджера паролей или что-то подобное) в безопасное место. Лучше сделать 2 или более отдельных копии на разных носителях (резервный жесткий диск, зашифрованная флешка, облачное хранилище и т. д.)..bat следующего содержания:kaspawallet.exe dump-unencrypted-datapauseПозднее вы можете восстановить свой кошелек на любом другом компьютере, на котором существует kaspawallet.exe и откуда доступна нода Каспы с открытым портом RPC, запустив команду kaspawallet.exe create --import.
В этом случае вас попросят ввести сид-фразу. Введите ее так, как она был показана вам после выполнения комадны dump-unencrypted-data. Тогда в папке по умолчанию будет создан новый файл keys.json. В этот раз вас снова попросят ввести пароль. Этот пароль может быть тем же, что вы уже использовали, или другим, это неважно: между исходным кошельком и восстанавливаемым кошельком нет никаких зависимостей, завязанных на пароль, так что здесь полная свобода выбора. Главное, убедитесь, что вы помните и свой новый пароль.
Можете восспользоваться любым из этих методов резервного копирования, или даже обоими сразу.
Проверьте сейчас, помните ли вы все ещё свой пароль! Серьезно. Вызовите kaspawallet.exe dump-unencrypted-data :) Если окажется, что пароль уже забыт — создайте кошелек заново, пока еще не поздно, или импортируйте его из сид-фразы; и на этот раз убедитесь, что вы действительно помните пароль, который выбрали!
С этого момента все операции с кошельком перед своим выполнением потребуют наличия запущенного daemon-а (сервиса) кошелька, а также запущенной и иполностью синхронизированной ноды (поэтому убедитесь, что вы настроили ноду, также не забудьте добавить параметр --utxoindex в командную строку своей ноды, иначе демон кошелькапокажет ошибку и откажется работать. Этот демон будет служить в качестве прокси между kaspawallet.exe, выполняющим запрошенную операцию, и нодой, с которой он взаимодействует.
Для того, чтобы запустить демона, если у вас работает локальная нода (на том же ПК), создайте .bat файл следующего содержания:
kaspawallet.exe start-daemonpause
Двойной щелчок по этому файлу запустит daemon кошелька, и вы увидите следующие строки:
<дата и время> [INF] KSWD: Listening on localhost:8082<дата и время> [INF] KSWD: Connecting to a node at <node IP address and port>...<дата и время> [INF] KSWD: Connected, reading keys file ...<дата и время> [INF] KSWD: Read, syncing the wallet...
Одну или несколько таких строк:
<дата и время> [INF] KSWD: X addresses of XX processed (N.NN%)...
Затем, наконец,
<дата и время> [INF] KSWD: Wallet is synced, ready for queries
Это окно само не закроется: демон, будучи запущен, продолжает работу, пока не будет остановлен вручную. Появление последней строки (...ready for queries) означает, что daemon успешно запустился и ожидает действий от других экземпляров kaspawallet.exe. Закрыть daemon можно, либо нажав на клавиатуре комбинацию Ctrl+C или Ctrl+Break, либо щелкнув мышью по кнопке «закрыть окно» (крестику) окна консоли. Сейчас оставьте его включенным, пока не завершится настройка кошелька.
Если у вас есть нода, работающая на каком-то другом ПК, вы можете направить daemon на эту ноду, добавив следующий параметр в командную строку daemon-а: -s <IP-адрес ноды>, так что командная строка будет выглядеть, например, так:
kaspawallet.exe start-daemon -s 192.168.1.50
Убедитесь, что RPC-порт (порт 16110) того ПК, на котором запущена нода, открыт для входящих соединений, не заблокирован фаерволлом, и что он форвардится роутером локальной сети того ПК, если такой роутер существует.
Вы даже можете, при необходимости, попробовать найти публичную ноду с открытым портом RPC и подключить к ней daemon кошелька.
Убедитесь, что вы добавили параметр --keys-file к перечню параметров демона, если это необходимо.
Учтите, что daemon читает содержимое файла keys.json только один раз: при своём запуске. Поэтому, если вы заменили файл keys.json в то время, пока daemon был активен, нужно перезапустить демона, чтобы он мог использовать новые данные файла вместо предыдущих.
Создавая кошелек, вы, по сути, создали секретный мастер-ключ. Но кошелек Kaspa — это HD-кошелек, совместимый с BIP-39, а это означает, что с помощью своего мастер-ключа вы можете создать практически бесконечное количество публичных адресов, на которые можно майнить и получать монеты. И сгенерировать хотя бы один такой адрес совершенно необходимо. Для этого создайте .bat файл следующего содержания:
kaspawallet.exe new-addresspause
Двойной щелчок по этому файлу покажет в консоли следующее:
New address:kaspa:qblablabla
Здесь kaspa:qblablabla — ваш новый публичный адрес, один из многих и многих возможных. Каждый раз, как вы вызываете kaspawallet.exe new-address, создается новый публичный адрес.
Счетчик созданных общедоступных адресов хранится в файле keys.json. Таким образом, если вы восстановите свой кошелек из сид-фразы, вновь созданныйkeys.json не будет знать о количестве созданных ранее адресов. Но, поскольку эти адреса генерируются по определенному алгоритму, они будут воссозданы в том же порядке, как были создаваны ранее, как только вы начнете создавать их заново, поэтому не беспокойтесь о том, что забудете или потеряете их.
Чтобы просмотреть список сгенерированных публичных адресов, создайте.bat файл следующего содержания:
kaspawallet.exe show-addressespause
Дважды щелкните по нему, и вы увидите свой список.
Для проверки баланса на кошельке создайте .bat файл следующего содержания:
kaspawallet.exe balancepause
Дважды щелкните по нему и наслаждайтесь.
Если вы хотите увидеть балансы, расписанные по публичным адресам (включая балансы адресов, которые автоматически создаются в результате операций по отправке монет и не отображаются командой show-addresses — так называемых “адресов сдачи”), добавьте параметр командной строки -v:
kaspawallet.exe balance -v.
Чтобы отправить монеты на какой-либо публичный адрес, создайте .bat файл следующего содержания:
kaspawallet.exe send -v <количество Каспы для отсылки> -t <публичный адрес кошелька-приемника>pause
Здесь <количество Каспы для отсылки> — это число с плавающей запятой, а <публичный адрес кошелька-приемника> — это адрес в формате kaspa:qblablabla, т.е. в том же виде, как его отображает команда new-address .
Дважды щелкните по .bat-файлу, введите свой пароль при запросе пароля. Просмотрите отчет об операции.
Вы даже можете отправить монеты сами себе: используйте кран Kaspa, чтобы заполучить небольшую часть койна на ранее сгенерированный публичный адрес, а затем отправьте их на этот же самый адрес с помощью .bat-файла.