基于本地测试网的开发流程

本教程描述了使用本地测试网进行开发的端到端流程。

• 注意：本教程使用的 Aptos-CLI 来自源代码编译，而不是 github release 的版本

  如果你使用来自 GitHub 发布的 aptos CLI 或来自 cargo install 的 aptos CLI，本指南是不正确的，只有当你按照下面的描述从 aptos-core 中自己构建它的时候才是正确的。

请仔细阅读本指南。本指南特别针对本地测试网的开发流程。如果你在 devnet 上构建，这个流程将无法工作。

基于 aptos-core 运行一个本地测试网

clone 代码并且进入 aptos-core 工程路径：

 git clone [e-mail]: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

如果你想启动一个基于 CLI 的发布版来运行本地测试网，你可以在cargo run 后面加上

--release 标志。

现在你正在运行一个由 aptos-core main 构建的本地测试网。

Typescript: 使用 aptos-core 的 SDK

重要提示：在这个开发流程中，你必须不使用 npmjs 的 SDK。相反，你必须使用与 aptos CLI 构建来源的相同的 SDK，我们将在下面介绍。

本指南假设你已经完成了前面的本地测试网步骤。我们还假设你已经安装了 yarn。

首先：进入 aptos-core 路径，构建 SDK

cd ~/aptos-core/ecosystem/typescript/sdk
yarn install
yarn build

如果你没有的话，创建一个新工程路径

mkdir ~/project && cd ~/project
yarn init

使你的项目指向本地 aptos-core 的SDK。

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。