Как восстановить кошелёк Maiar с помощью открытого инструмента: пошаговое руководство

Введение

Maiar — это некастодиальный кошелёк экосистемы MultiversX, который позже был интегрирован в xPortal. Если у вас есть законная резервная копия мнемонической фразы, но старый клиент недоступен, открытый Maiar Recovery Tool может помочь восстановить доступ. Ниже — пошаговое руководство по установке, настройке и безопасному восстановлению.

Используйте инструкцию только для собственного кошелька. Никогда не публикуйте и не передавайте мнемоническую фразу.

Что понадобится

• Компьютер с Node.js LTS, Git и npm или yarn.
• Официальный или проверенный репозиторий открытого инструмента.
• Резервная копия 24 слов BIP39 в правильном порядке.
• BIP39 passphrase, если вы её задавали.
• Изолированная среда: виртуальная машина, отдельный пользователь или офлайн-система.

Шаг 1. Установка инструмента

Сначала найдите официальный репозиторий через GitHub-организацию MultiversX или страницу проекта. Не используйте зеркала и сборки из непроверенных источников.

git clone <URL-официального-репозитория>
cd maiar-recovery
npm install
npm run build

Если проект использует yarn:

yarn install
yarn build

Проверьте зависимости и не запускайте скрипты, которые запрашивают отправку seed на сервер.

Шаг 2. Настройка окружения

Создайте файл .env в корне проекта. Не записывайте в него мнемоническую фразу.

NETWORK=mainnet
API_URL=https://api.multiversx.com
EXPORT_DIR=./recovered

Для тестов можно указать testnet и соответствующий API. Основные параметры восстановления: сеть, индекс аккаунта и путь деривации. Для MultiversX обычно используется путь m/44'/508'/0'/0'/0', но проверьте это в документации инструмента.

Шаг 3. Запуск восстановления

Запустите инструмент:

npm run recover

Или, если так указано в репозитории:

node dist/index.js --network mainnet

Далее следуйте подсказкам:

1. Введите 24 слова мнемонической фразы строго по порядку.
2. Укажите BIP39 passphrase, если она была.
3. Выберите индекс аккаунта: 0, 1, 2 и так далее.
4. Дождитесь расчёта адреса erd1... и, при наличии сети, баланса.
5. Сравните полученный адрес с адресом в старой резервной копии.

Если адрес совпал, инструмент сможет экспортировать ключи. Если нет — проверьте порядок слов, язык, passphrase и индекс.

Шаг 4. Экспорт и импорт

После успешного восстановления экспортируйте кошелёк в безопасный формат:

npm run recover -- --export keystore --out ./recovered/wallet.json

Задайте длинный уникальный пароль для keystore. Дополнительно можно сохранить PEM или QR-код, если инструмент поддерживает такие форматы. Импортируйте keystore в xPortal, MultiversX Web Wallet или совместимый кошелёк. После импорта проверьте адрес и активы.

Шаг 5. Проверка активов

• Откройте адрес в обозревателе MultiversX.
• Проверьте баланс EGLD, токенов, NFT и историю транзакций.
• Если токены не видны в кошельке, добавьте их вручную по идентификатору.
• Проверьте стейкинг, делегирование и активные контракты.
• Для теста отправьте небольшую сумму на новый адрес и убедитесь, что транзакция прошла.

Частые проблемы

• Адрес не совпадает. Ошибка в мнемонической фразе, passphrase, индексе аккаунта или пути деривации.
• Нет баланса. Выбрана неверная сеть, устаревший API или другой индекс аккаунта.
• Ошибки установки. Проверьте версию Node.js, удалите node_modules и package-lock.json, повторите npm install.
• Инструмент просит seed в сеть. Немедленно остановитесь: это признак вредоносной сборки.

Безопасность

• Работайте в офлайн- или изолированной среде, когда это возможно.
• Проверяйте исходный код, коммиты и хэши перед запуском.
• Не используйте публичный Wi-Fi и чужие компьютеры.
• После восстановления удалите временные файлы и очистите буфер обмена.
• Переведите крупные активы на новый кошелёк с новой seed-фразой.
• Используйте аппаратный кошелёк для долгосрочного хранения.

Заключение

Открытый Maiar Recovery Tool — полезный инструмент для законного восстановления доступа к кошельку Maiar при наличии резервной копии. Главное — скачивать код только из проверенного источника, не раскрывать мнемоническую фразу и проверять результат по адресу и истории операций.