Это руководство описывает end-to-end процесс разработки в локальной тестовой сети.

CLI ИЗ ИСХОДНИКОВ, А НЕ С GITHUB
Это руководство некорректно, если вы используете aptos CLI из релиза на GitHub или из cargo installтолько если вы собираете его самостоятельно из aptos-coreкак описано ниже.

Пожалуйста, внимательно прочитайте это руководство. В этом руководстве рассматривается локальный метод разработки в тестнете. Этот метод не будет работать, если вы создаете в devnet.


Запустите локальный тестнет из aptos-core

Выберите и зайдите в aptos-core:

git clone git@github.com:aptos-labs/aptos-core.git ~/aptos-core && cd ~/aptos-core
Войти в полноэкранный режим

Выйти из полноэкранного режима

Запустите локальную тестовую сеть:

cargo run -p aptos -- node run-local-testnet --with-faucet --faucet-port 8081 --force-restart --assume-yes
Войти в полноэкранный режим

Выйти из полноэкранного режима

Вы можете добавить параметр --release после cargo runесли хотите собрать релизную версию CLI для запуска локального тестнета.

Теперь вы запускаете локальную тестовую сеть, собранную из основы aptos-core.


Typescript: Использование SDK из aptos-core

Важно: В этом методе разработки важно не использовать SDK из npmjs. Вместо этого вы должны использовать тот же SDK, из которого собран aptos CLI, что мы опишем ниже.

Это руководство предполагает, что вы выполнили предыдущий шаг по локальному тестированию. Мы также предполагаем, что у вас установлен yarn.

Сначала зайдите в aptos-core и скомпилируйте SDK:

cd ~/aptos-core/ecosystem/typescript/sdk
yarn install
yarn build
Войти в полноэкранный режим

Выйти из полноэкранного режима

Создайте новый проект, если у вас его еще нет:

mkdir ~/project && cd ~/project
yarn init
Войти в полноэкранный режим

Выйти из полноэкранного режима

Сделайте свой проект целевым для SDK из локального aptos-core:

yarn add ../aptos-core/ecosystem/typescript/sdk
Войти в полноэкранный режим

Выйти из полноэкранного режима

Вы также можете использовать полный путь, например, /home/daniel/aptos-core/ecosystem/typescript/sdk.

Узнайте все:

yarn install
Войти в полноэкранный режим

Выйти из полноэкранного режима

Теперь все готово! Вы должны увидеть в package.jsonчто ваш проект нацелен на локальное aptos-core:

{
  "name": "project",
  "version": "1.0.0",
  "main": "index.js",
  "license": "MIT",
  "dependencies": {
    "aptos": "../a/core/ecosystem/typescript/sdk/"
  }
}
Войти в полноэкранный режим

Выйти из полноэкранного режима

Таким образом, ваша локальная тестовая сеть и SDK, который вы используете, совпадают, что означает, что вы не увидите никаких проблем с совместимостью.

Теперь вы можете использовать модуль aptos в своем коде следующим образом:

import { AptosClient, AptosAccount, FaucetClient } from "aptos";

const NODE_URL = "https://127.0.0.1:8080/v1";
const FAUCET_URL = "https://127.0.0.1:8081";

(async () => {
  const client = new AptosClient(NODE_URL);
  const faucetClient = new FaucetClient(NODE_URL, FAUCET_URL);
})();
Войти в полноэкранный режим

Выйти из полноэкранного режима

Примечание: Обратите внимание, что этот код создает клиентов, которые общаются с вашим локальным testnet, а не devnet.