NEAR Protocol - Як запустити локальну мережу nearcore (localnet)
NEAR Protocol - Як запустити локальну мережу nearcore (localnet)
Цей документ надає покроковий процес налаштування та конфігурації NEAR Protocol на локальному комп'ютері за допомогою Docker. Він включає завантаження останньої стабільної версії, налаштування Docker-середовища та конфігурацію локальної мережі для взаємодії з вузлами NEAR Protocol.
Крок 1 - Налаштування Docker
Перейдіть на Docker Hub і знайдіть образ nearprotocol/nearcore. Переконайтеся, що Docker встановлено на вашій системі і перейдемо до наступного кроку.
Крок 2 - Вибір версії nearcore
Ви можете знайти теги релізів nearcore, такі як 2.7.0-rc.3 (кандидати в реліз, які використовуються на testnet перед рекомендацією до застосування на mainnet) або 2.6.5 (стабільний реліз для mainnet).
Крок 3 - Запуск nearcore в Docker контейнері
На даний момент остання стабільна версія - 2.6.5. Завантажимо її. Якщо використовуєте архітектуру arm64 (наприклад, Mac з процесорами серії M), вкажіть параметр --platform з linux/amd64. Це повинно працювати однаково на Windows, Linux і macOS. Отже, безпечно використовувати цей параметр всюди.
Також потрібно відкрити порт. За замовчуванням JSON RPC порт для взаємодії з вузлом nearcore - 3030, і давайте запустимо bash у інтерактивному режимі, щоб виконати конфігурацію вузла і мати можливість перезапустити вузол без втрати даних між запусками.
docker run --platform linux/amd64 -it --rm -p 3030:3030 nearprotocol/nearcore:2.6.5 bash
Всередині контейнера використовуйте команду neard. Давайте впевнимось що neard працює і має версію що відповідає версії Docker образу.
Настав час ініціалізувати його для localnet. Давайте використаємо /tmp/neard як домашній каталог для налаштувань nearcore:
neard --home /tmp/neard init
Ви можете знайти config.json, genesis.json, node_key.json та validator_key.json, створені в домашній директорії.
Доречі, все що відрізняє mainnet, testnet, та нашу нову мережу localnet - це ось ці 4 файли. Якщо взяти config.json та genesis.json відповідні до для mainnet чи testnet, то ви можете приєднатись до вже існуючої мережі.
Зараз немає потреби перевіряти ці конфігурації. Перейдіть до негайного запуску вузла.
neard --home /tmp/neard run
Крок 4 - Перевіряємо що localnet працює
Давайте перевіримо що вузол працює і доступний для RPC запитів. Для цього скористаємось командою curl і запитаємо статус.
curl http://localhost:3030/status
Крок 5 - Налаштовуємо NEAR CLI для localnet
Давайте спробуємо повзаємодіяти з нашим вузлом через утіліту командного рядка NEAR CLI. Для цього нам потрібно додати нове з'єднання. Викличте команду near без параметрів та оберіть в меню config -> add-connection, а далі вкажіть ім'я мережі (localnet), RPC URL (http://localhost:3030), та пропустіть всі інші налаштування, оскільки вони не застосовні.
Тепер використовуйте NEAR CLI для доступу до інформації про акаунт test.near на localnet, отримуючи кількість доступних локальних NEAR токенів (ці NEAR токени не мають цінності, бо вони не існують в mainnet мережі). Просто введіть команду near і слідуйте інтерактивним підказкам -> "account" -> "view-account-summary" ... або використовуйте команду з повними параметрами:
near account view-account-summary test.near network-config localnet now
Крок 6 - Тестова транзакція на localnet
Давайте відправимо транзакції з цими токенами, використовуючи акаунт test.near.
Ми надішлемо NEAR на інший акаунт, і оскільки в нашій localnet є лише один інший акаунт, ми його використовуємо - near. Підписуйте транзакції, використовуючи plaintext приватний ключ акаунта test.near - ви можете отримати його з validator_key.json в домашній папці /tmp/neard.
Після успішного підписання транзакції відправте її. Тут ми бачимо, що транзакція переказу токенів успішно підписана і відправлена в мережу. Переказ успішний!
