Начало работы с узлом разработки Moonbeam

Перевод оффициальной документации мунбим. Ознакомится с оригиналом можете по ссылке - https://docs.moonbeam.network/builders/get-started/moonbeam-dev/

Вступление

В этом руководстве описаны шаги, необходимые для создания узла разработки для тестирования функций совместимости с Ethereum в Moonbeam.

Узел разработки Moonbeam - это ваша собственная среда разработки для создания и тестирования приложений на Moonbeam. Для разработчиков Ethereum это сравнимо с Ganache. Это позволяет вам быстро и легко приступить к работе без дополнительных затрат на релейную цепочку. Вы можете развернуть свой узел с помощью параметра --sealing, чтобы создавать блоки мгновенно, вручную или с заданным интервалом после получения транзакций. По умолчанию при получении транзакции создается блок, что похоже на функцию Instamine в Ganache.

Если вы проследите до конца этого руководства, у вас будет узел разработки Moonbeam, работающий в вашей локальной среде, с 10 предварительно профинансированными учетными записями, и вы сможете подключить его к графическому интерфейсу Polkadot.js по умолчанию.

Есть два способа начать запуск узла Moonbeam: вы можете использовать Docker для запуска предварительно созданного двоичного файла или вы можете скомпилировать двоичный файл локально и самостоятельно настроить узел разработки. Использование Docker - это быстрый и удобный способ начать работу, поскольку вам не нужно устанавливать Substrate и все зависимости, а также вы можете пропустить сборку процесса узла. Это требует установки Docker. С другой стороны, если вы решите, что хотите пройти процесс создания собственного узла разработки, это может занять примерно 30 минут или больше в зависимости от вашего оборудования.

Начало работы с Docker

Использование Docker позволяет развернуть узел за считанные секунды. После установки Docker вы можете выполнить следующую команду, чтобы загрузить соответствующий образ:

docker pull purestake/moonbeam:v0.14.2

Конец журнала консоли должен выглядеть так:

После загрузки образа Docker следующим шагом будет его запуск.

Вы можете запустить образ Docker, используя следующее:

docker run --rm --name moonbeam_development --network host \ purestake/moonbeam:v0.14.2 \ --dev

docker run --rm --name moonbeam_development -p 9944:9944 -p 9933:9933 \ purestake/moonbeam:v0.14.2 \ --dev --ws-external --rpc-external

docker run --rm --name moonbeam_development -p 9944:9944 -p 9933:9933 ^ purestake/moonbeam:v0.14.2 ^ --dev --ws-external --rpc-external

Это должно запустить узел разработки Moonbeam в режиме мгновенной печати для локального тестирования, чтобы блоки создавались мгновенно по мере получения транзакций. В случае успеха вы должны увидеть вывод, показывающий состояние ожидания, ожидающее создания блоков:

Для получения дополнительной информации о некоторых флагах и параметрах, использованных в примере, ознакомьтесь с разделом «Флаги и параметры». Если вы хотите увидеть полный список всех флагов, параметров и подкоманд, откройте меню справки, выполнив:

docker run --rm --name moonbeam_development \ 
purestake/moonbeam \ 
--help

Чтобы продолжить обучение, следующий раздел не нужен, поскольку вы уже создали узел с помощью Docker. Вы можете сразу перейти к подключению приложений Polkadot.js к локальному узлу Moonbeam.

Начало работы с двоичным файлом

Во-первых, начните с клонирования определенного тега репозитория Moonbeam, который вы можете найти здесь:

git clone -b v0.14.2 https://github.com/PureStake/moonbeam
cd moonbeam

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

source $HOME/.cargo/env

cargo build --release

Вот как должен выглядеть конец вывода сборки:

Затем вы захотите запустить узел в режиме разработки, используя следующую команду:

./target/release/moonbeam --dev

Вы должны увидеть вывод, который выглядит следующим образом, показывая состояние ожидания, пока не будут созданы блоки:

Для получения дополнительной информации о некоторых флагах и параметрах, использованных в примере, ознакомьтесь с разделом «Флаги и параметры». Если вы хотите увидеть полный список всех флагов, параметров и подкоманд, откройте меню справки, выполнив:

./target/release/moonbeam --help

Подключение приложений Polkadot.js к локальному узлу Moonbeam

Узел разработки - это узел на основе подложки, поэтому вы можете взаимодействовать с ним, используя стандартные инструменты подложки. Две предоставленные конечные точки RPC:

HTTP - http://127.0.0.1:9933
WS - WS: //127.0.0.1: 9944

Начните с подключения к нему с помощью приложений Polkadot.js. Откройте в браузере: https://polkadot.js.org/apps/#/explorer. Это откроет приложения Polkadot.js, которые автоматически подключатся к Polkadot MainNet.

Щелкните в верхнем левом углу, чтобы открыть меню для настройки сетей, а затем перейдите вниз, чтобы открыть подменю «Разработка». Там вы захотите переключить опцию «Локальный узел», которая указывает приложениям Polkadot.js на ws: //127.0.0.1: 9944. Затем нажмите кнопку «Переключить», и сайт должен подключиться к вашему узлу разработки Moonbeam.

При подключении приложений Polkadot.js вы увидите узел разработки Moonbeam, ожидающий прибытия транзакций, чтобы начать производство блоков.

Запрос состояния учетной записи

С выпуском Moonbase Alpha v3 , Moonbeam теперь работает в формате единой учетной записи, который представляет собой H160 в стиле Ethereum и теперь также поддерживается в приложениях Polkadot.js. Чтобы проверить баланс адреса, вы можете просто импортировать свою учетную запись во вкладке «Учетные записи». Дополнительную информацию можно найти в разделе «Единые учетные записи».

Тем не менее, используя все возможности Ethereum RPC Moonbeam, вы также можете использовать MetaMask для проверки баланса этого адреса. Кроме того, вы также можете использовать другие инструменты разработки, такие как Remix и Truffle.

Команды, флаги и параметры

Очистка вашего узла

При запуске узла через двоичный файл данные хранятся в локальном каталоге, обычно расположенном в ~ / .local / shared / moonbeam / chain / development / db. Если вы хотите запустить новый экземпляр узла, вы можете либо удалить содержимое папки, либо выполнить следующую команду внутри папки moonbeam:

./target/release/moonbeam purge-chain --dev -y

Это приведет к удалению папки данных, обратите внимание, что все данные цепочки теперь потеряны. Чтобы узнать больше обо всех доступных командах очистки цепочки, вы можете проверить раздел «Очистка двоичных данных» нашей документации.

Если вы развернули свой узел с помощью Docker вместе с флагом -v, чтобы указать смонтированный каталог для вашего контейнера, вам нужно будет очистить этот каталог. Для этого вы можете запустить следующую команду:

sudo rm -rf /var/lib/alphanet-data/*

Если вы следовали инструкциям в этом руководстве и не использовали флаг -v, вы можете остановить и удалить контейнер Docker. Связанные данные будут удалены вместе с ним. Для этого вы можете запустить следующую команду:

sudo docker stop CONTAINER_ID && docker rm CONTAINER_ID

Флаги узлов

Флаги не принимают аргументов. Чтобы использовать флаг, добавьте его в конец команды. Например:

./target/release/moonbeam --dev

--dev - указывает цепочку разработки
--no-telemetry - отключить подключение к серверу телеметрии Substrate. Для глобальных сетей телеметрия включена по умолчанию. Телеметрия недоступна, если вы используете узел разработки (--dev).
--tmp - запускает временный узел, на котором вся конфигурация будет удалена в конце процесса.
--rpc-external - прослушивать все интерфейсы RPC
--ws-external - прослушивать все интерфейсы Websocket

Параметры узла

Опции принимают аргумент справа от опции. Например:

./target/release/moonbeam --dev --sealing 6000

-l <log pattern> or --log <log pattern>  - устанавливает настраиваемый фильтр ведения журнала. Синтаксис шаблона журнала: <цель> = <уровень>. Например, чтобы распечатать все журналы RPC, команда будет выглядеть так: -l rpc=trace
--sealing <interval> - когда блоки должны быть запечатаны в сервисе dev. Допустимые аргументы для интервала: мгновенный, ручной или число, представляющее интервал таймера в миллисекундах (например, 6000 заставит узел создавать блоки каждые 6 секунд). По умолчанию мгновенно
--rpc-port <port> - устанавливает TCP-порт HTTP RPC-сервера. Принимает порт в качестве аргумента
--ws-port <port>: устанавливает TCP-порт RPC-сервера WebSockets. Принимает порт в качестве аргумента

API отладки, трассировки и TxPool

Вы также можете получить доступ к некоторым нестандартным методам RPC, запустив узел трассировки, который позволяет разработчикам проверять и отлаживать транзакции во время выполнения. Узлы трассировки используют образ Docker, отличный от стандартного узла разработки Moonbeam.

Чтобы узнать, как запустить узел трассировки разработки Moonbeam, ознакомьтесь с руководством «Запуск узла трассировки» и обязательно переключитесь на вкладку «Узел разработки Moonbeam» во всех инструкциях. Затем, чтобы получить доступ к нестандартным методам RPC с помощью вашего узла трассировки, ознакомьтесь с руководством по отладке и трассировке.

Предварительно финансируемые счета

bottom drive obey lake curtain smoke basket hold race lonely fit walk

Загляните в раздел Использование MetaMask, чтобы начать взаимодействие с вашими учетными записями.

Кроме того, в узел разработки входит предварительно профинансированная учетная запись, используемая для целей тестирования:

Исследовать блоки

Для узла разработки Moonbeam вы можете использовать любой из следующих обозревателей блоков:

Substrate API - приложения Polkadot.js на WS-порт 9944
Ethereum API на основе JSON-RPC - Moonbeam Basic Explorer на HTTP-порту 9933