Встановлення десктопного гаманця NYM

5 min readAug 9, 2023

переклад, оригінал гайду тут

Гаманець Nym Desktop Wallet дозволяє вам взаємодіяти зі своїм вузлом Nym і делегувати частку іншим, переглядати графік отримання токенів і передавати токени. У наступних випусках він також надасть вам доступ до мікснету Nym.
Ви можете завантажити його для Mac, Windows або Linux.

Обхід попереджень безпеки

У Windows ви побачите спливаюче попередження безпеки, коли спробуєте запустити гаманець. Ми зараз отримуємо ключі магазину додатків від Microsoft, щоб цього не сталося. Перегляньте розділ нижче, щоб дізнатися про кроки, як це обійти.

Linux

Вам потрібно буде ввусти команду chmod +x та ім’я файлу у терміналі (або надати йому дозвіл на виконання у вашому файловому менеджері), перш ніж він запуститься.

Windows

Ви все одно будете стикатися з попередженнями під час відкриття гаманця в Windows. Це тому, що, незважаючи на те, що гаманець схвалений Microsoft, на даний момент його завантажено менше 10 тисяч. Коли гаманець перевищить цей поріг, це попередження зникне.

Щоб обійти попередження, виконайте наведені нижче дії.
1. Виберіть додаткову інформацію після запуску msi-інсталятора:

Натисніть “run-anyway”:

Дотримуйтесь інструкцій інсталятора:

Для розробників

Якщо ви хочете скомпілювати гаманець самостійно, дотримуйтесь наведених нижче інструкцій.

Будь ласка, зверніть увагу, що гаманець наразі створено лише на операційних системах, для яких є двійкові файли, перераховані вище. Якщо ви виявите проблему або будь-які додаткові передумови, будь ласка, створіть проблему або повідомте про develop на Github.

Програмні передумови для створення додатку гаманця

git

sudo apt update
sudo apt install git

Переконайтеся, що git встановлено за допомогою:

git version
# Should return: git version X.Y.Z

Yarn
NodeJS >= v16.8.0
Rust & cargo >= v1.56

Ми рекомендуємо використовувати Rust shell script installer. Встановлювати cargo із менеджера пакетів (наприклад, apt) не рекомендується, оскільки пакетні версії зазвичай надто старі.

Якщо ви справді не хочете використовувати програму встановлення сценаріїв оточення, документи встановлення Rust installation docs містять інструкції для багатьох платформ.

Додаткові передумови для систем Ubuntu/Debian

sudo apt update
sudo apt install pkg-config build-essential libssl-dev curl jq

Додаткові передумови для Windows

Під час роботи в Windows вам потрібно буде інсталювати інструменти складання C++.
Простий посібник із запуску та запуску Rust можна знайти тут.
Під час встановлення NodeJS використовуйте версію current features.
Рекомендується використовувати такий менеджер пакетів, як Chocolatey.

Видалення помилок підпису при збиранні в режимі розробки

Якщо ви хочете створити гаманець самостійно, перед цим вам потрібно буде внести кілька змін у файл, розташований за адресою nym-wallet/src-tauri/tauri.conf.json. Це пов’язано з тим, що гаманець приймається магазинами додатків Mac і Windows, і не має відношення до вас, коли ви самостійно створюєте та запускаєте гаманець.
На всіх операційних системах:

встановити значення рядка 49 на false
вилучити рядки 50–54

А також ці модифікації для користувачів MacOS і Windows:

Користувачі MacOS також повинні видалити рядок 39
Користувачі Windows повинні видалити рядки з 42 по 46
монтаж

Інсталяція

Після внесення цих змін у tauri.conf.json у папці nym-wallet виконайте:

yarn install

Запуск у режимі розробки

Перш ніж продовжити, переконайтеся, що ви скопіювали вміст наданого .env.sample у новий файл .env

Ви можете запустити гаманець, не встановлюючи його в режимі розробки, виконавши наступну команду терміналу з папки nym-wallet

yarn dev

Потім буде запущено графічний інтерфейс Wallet GUI і створено двійковий файл у nym-wallet/target/debug/ під назвою nym-wallet.

Запуск у режимі загального користування

Перш ніж продовжити, переконайтеся, що ви скопіювали вміст наданого .env.sample у новий файл .env

Щоб створити та встановити гаманець, запустіть наступну команду терміналу з папки nym-wallet.

yarn build

Це створить виконуваний файл, який можна використовувати для встановлення гаманця на вашій машині. Вихідні дані складатимуть різні типи двійкових файлів залежно від вашого hardware / OS. Після створення двійкових файлів їх можна розташувати наступним чином:

Binary output directory structure
**macos**
|
└─── target/release
|   |─ nym-wallet
└───target/release/bundle/dmg
│   │─ bundle_dmg.sh
│   │─ nym-wallet.*.dmg
└───target/release/bundle/macos/MacOs
│   │─ nym-wallet
|
**Linux**
└─── target/release
|   │─  nym-wallet
└───target/release/bundle/appimage
│   │─  nym-wallet_*_.AppImage
│   │─  build_appimage.sh
└───target/release/bundle/deb
│   │─  nym-wallet_*_.deb
|
**Windows**
└─── target/release
|   │─  nym-wallet.exe
└───target/release/bundle/msi
│   │─  nym-wallet_*_.msi

Імпорт або створення облікових записів, якщо ви ввійшли за допомогою мнемоніки

Щоб імпортувати або створити новий обліковий запис, вам потрібно ввійти в систему за допомогою існуючого пароля або створити новий пароль.

Створення нового пароля перезапише будь-який старий, що зберігається на вашій машині. Переконайтеся, що ви зберегли всі мнемоніки, пов’язані з паролем, перш ніж створювати новий.

Вийти
Натисніть «Забули пароль»
На наступному екрані виберіть «Створити новий пароль»
Дотримуйтесь інструкцій і створіть новий пароль
Увійдіть, використовуючи новий пароль

Інструмент CLI для відновлення зашифрованого файлу гаманця (пароля):

Мнемоніки, які зберігаються в локальному файлі, захищеному паролем, також можна розшифрувати та відновити за допомогою простого інструменту CLI, nym-wallet-recovery-cli.

nym-wallet-recovery –file saved-wallet.json –password foo

Збережений файл гаманця можна знайти в $XDG_DATA_HOME або $HOME/.local/share на Linux, $HOME/Library/Application Support на Mac і C:\Users\username\AppData\Local на Windows.

Гаманець CLI

Якщо ви вже читали нашу документацію з налаштування та обслуговування валідатора, ви побачили, що ми компілюємо та використовуємо двійковий файл nyxd переважно для наших валідаторів. Однак цей двійковий файл можна використовувати для багатьох інших завдань, таких як створення та використання пар ключів для гаманців або автоматизованих налаштувань, які вимагають підписання та трансляції транзакцій.

Використання двійкового файлу nyxd як гаманця CLI

Ви можете використовувати nyxd як мінімальний гаманець CLI, якщо хочете налаштувати обліковий запис (або кілька облікових записів). Просто скомпілюйте двійковий файл відповідно до документації, зупинившись після завершення етапу створення вашого валідатора. Потім ви можете запустити nyxd keys — help, щоб побачити, як можна налаштувати та зберегти різні пари ключів для взаємодії з блокчейном Nyx.