Запуск локального тестнета
Вы можете запустить локальный тестнет блокчейна Aptos. Эта локальная тестовая сеть не будет подключена к сети разработчиков Aptos. Она будет работать на вашем локальном компьютере независимо от других сетей Aptos. Вы можете использовать ее для тестирования и разработки.
Вы можете запустить локальный тестнет двумя способами:
Используя исходные файлы Aptos. Этот подход полезен для тестирования модификаций в кодовой базе Aptos-core или в Aptos Framework.
Используя Docker. Это особенно полезно для создания сервисов вдобавок к Aptos Blockchain или Aptos Framework, поскольку нет дополнительных затрат на сборку, а реестр сохраняется при перезапуске сети (по умолчанию).
Остальная часть этого документа описывает:
Как запустить локальный тестнет с одной валидирующей нодой, используя оба метода
Как запустить сервис Faucet и подключить его к вашему локальному тестнету
Использование исходных файлов Aptos
Создайте новое ответвление и клонируйте репозиторий Aptos.
Создайте ответвление репозитория Aptos Core, щелкнув Fork в правом верхнем углу данной страницы репозитория: https://github.com/aptos-labs/aptos-core.
Клонируйте ответвление.
2. Перейдите cd
в каталог aptos-core
.
3. Запустите bash-скрипт scripts/dev_setup.sh
, как показано ниже. Это подготовит вашу среду разработчика.
4. Обновите текущую оболочку среды.
5. Теперь, когда ваша среда разработки готова, вы можете запустить тестнет. Прежде чем продолжить, обратите внимание на следующее:
После выполнения команды запуска локального тестнета, данной ниже, ваш терминал перейдет в интерактивный режим с возможностью завершения тестовой сети. Следовательно, вам нужно будет открыть другой терминал оболочки для последующих шагов, описанных в этом разделе.
После запуска приведенной ниже команды, вам нужно будет скопировать информацию
Config path
из вывода терминала для следующих шагов.
Чтобы запустить тестнет локально, выполните следующую команду:
Ниже приведен пример частичного вывода. Сделайте заметку о Config path
из выходных данных.
ПРИМЕЧАНИЕ: Приведенная выше команда запускает локальный тестнет с одной валидирующей нодой. Команда запускает aptos-node
только из реестра в состоянии генезиса. Если вы хотите повторно использовать состояние реестра, созданное предыдущим запуском aptos-node
, используйте:
Подключение Faucet к тестнету
Faucets — это сервисы без сохранения состояния, которые можно запускать параллельно с тестнетом. Faucet — это способ создания тестовых монет Aptos, не имеющих реальной стоимости. Вы можете использовать Faucet, отправив запрос на создание монет и перевод их на указанный счет от вашего имени.
Убедитесь, что вы запустили локальный тестнет, как это описано в Шаге 5 выше.
Откройте новый терминал оболочки.
Скопируйте путь к корневому ключу Aptos со своего терминала, где вы запустили тестовую сеть, и используйте его для замены
mint-key-file-path
в приведенной ниже команде.Выполните следующую команду, чтобы запустить Faucet:
Это запустит Faucet, работающий локально, без каких-либо ограничений на токены, которые можно запрашивать и создавать. Сервис Faucet будет так же доступен, как и тестнет, который вы запустили ранее.
Использование Docker
В этом разделе описывается, как начать локальное тестирование с помощью Docker.
Установите Docker , включая Docker-Compose.
Создайте каталог для локальной сети тестового валидатора и перейдите в него
cd
.Загрузите файлы настройки YAML для:
4. Запустите Docker Compose, запустив команду:
Пример
Последовательность команд для вышеуказанных Шагов со 2 по 4 показана ниже:
Это запустит и валидирующую ноду и Faucet сервис.
Конечная точка REST валидатора будет доступна на
http://127.0.0.1:8080
Faucet доступен на
http://127.0.0.1:8000
Устранение ошибок
Поскольку программное обеспечение еще находится на ранних стадиях разработки, возможны критические изменения. Если программное обеспечение не запускается, выполните следующие действия:
Сначала запросите в Docker контейнеры и тома с помощью
docker container ls -a
anddocker volume ls
.Затем удалите их, используя
docker container rm $id
anddocker volume rm $name
.Альтернативно вы можете начать с нуля, очистив локальное docker-состояние, выполнив следующую команду:
ПРИМЕЧАНИЕ
Если вы собираетесь использовать свою тестовую сеть в течение длительного периода времени, вам следует привязать образы к определенному ID. Идентификаторы можно получить с помощью docker container ls
и добавить в файл docker compose.
Взаимодействие с локальным тестнетом
После запуска локального тестнета, вы увидите следующее:
Используйте Aptos CLI tool для взаимодействия с локальным тестнетом. Приведенный выше результат выполнения содержит информацию, которую вы будете использовать для запуска Aptos CLI tool.
Aptos root key path
: корневой ключ (известный также как mint или faucet key) контролирует аккаунт, который может чеканить токены. Доступен в папке docker compose с именемaptos_root_key
.Waypoint
: поддающаяся проверке контрольная точка блокчейна (доступна в папке docker compose с именем waypoint.txt)REST endpoint
: конечная точка для REST сервиса, например:http://127.0.0.1:8080
ChainId
: ID цепи однозначно отличает эту сеть от других сетей блокчейна
Следующие шаги
На этом этапе у вас будет специальный корневой аккаунт 0x1
, который может выполнять операцию чеканки. Дальнейшая работа:
Ваша первая транзакция, чтобы научиться отправлять транзакции
Ваш первый модуль Move, чтобы научиться создавать модули Move
Взаимодействие с блокчейном Aptos, чтобы узнать, как чеканить монеты
Last updated