用 CLI 运行本地测试网

💡 用源代码或 Docker 来运行本地测试网

如果你想用 Docker 或者 aptos-core 源代码来启动并运行本地测试网，参阅用验证器运行本地测试网。

运行 Aptos 区块链的本地测试网，不会被连接到 Aptos 开发网，它将在你的本地机器上运行，独立于其他的 Aptos 网络。你可以使用这个本地测试网进行测试和开发。本地测试网可以针对已知版本的代码库进行本地开发，而不需要与实时网络互动或处理实时网络的现实成本。

💡 Aptos CLI 文档 如果你还不了解 Aptos CLI，可以先看看这份全面的 Aptos CLI 文档。

从水龙头开始一个本地测试网

可以用下面这条命令来开始一个本地测试网：

aptos node run-local-testnet --with-faucet

上面的命令回启动一个本地验证器节点，并且会显示类似下面的终端输出：

Completed generating configuration:
        Log file: "/Users/greg/.aptos/testnet/validator.log"
        Test dir: "/Users/greg/.aptos/testnet"
        Aptos root key path: "/Users/greg/.aptos/testnet/mint.key"
        Waypoint: 0:74c9d14285ec19e6bd15fbe851007ea8b66efbd772f613c191aa78721cadac25
        ChainId: TESTING
        REST API endpoint: 0.0.0.0:8080
        Fullnode network: /ip4/0.0.0.0/tcp/6181

Aptos is running, press ctrl-c to exit

Faucet is running.  Faucet endpoint: 0.0.0.0:8081

上述命令将使用验证器节点的默认配置。

不要在同一时间使用同一命令的两个实例

注意，同一命令的两个实例不能同时运行。这会导致验证器节点的端口冲突。

用本地测试网进行测试

你可以使用 Aptos CLI 进行全方位的本地测试网操作。关于如何配置 CLI，请先看下文。

配置 Aptos CLI 来使用本地测试网

你可以添加一个单独的配置文件，如下所示：

aptos init --profile local --rest-url <http://localhost:8080> --faucet-url <http://localhost:8081>

会得到如下的输出。在 Enter your private key... 命令提示符i啊，按回车键生成一个随机的新密钥。

Configuring for profile local
Using command line argument for rest URL <http://localhost:8080/>
Using command line argument for faucet URL <http://localhost:8081/>
Enter your private key as a hex literal (0x...) [Current: None | No input: Generate new key (or keep one if present)]

这将创建一个新的账户，并以默认的代币数量为其提供资金，如下所示：

No key given, generating key...
Account 7100C5295ED4F9F39DCC28D309654E291845984518307D3E2FE00AEA5F8CACC1 doesn't exist, creating it and funding it with 10000 coins
Aptos is now set up for account 7100C5295ED4F9F39DCC28D309654E291845984518307D3E2FE00AEA5F8CACC1!  Run `aptos help` for more information about commands
{
  "Result": "Success"
}

此时，你应该在命令中添加 --profile local 以便在本地测试网上运行这些命令。

创建帐户并为帐户注资

要在本地测试网上创建新帐户，我们建议使用上述说明并使用不同的配置文件名称：

PROFILE=local
aptos init --profile $PROFILE --rest-url <http://localhost:8080> --faucet-url <http://localhost:8081>

为帐户注资：

aptos account fund --profile $PROFILE --account $PROFILE

创建资源帐户：

aptos account create-resource-account --profile $PROFILE --seed 1

将模块发布到本地测试网

可以通过添加 --profile $PROFILE 标志来运行任何命令。在这种情况下，我们也使用 $PROFILE 来作为 HelloBlockchain 示例中的命名地址。

aptos move publish --profile $PROFILE --package-dir /opt/git/aptos-core/aptos-move/move-examples/hello_blockchain --named-addresses HelloBlockchain=$PROFILE
{
  "Result": {
    "changes": [
      {
        "address": "7100c5295ed4f9f39dcc28d309654e291845984518307d3e2fe00aea5f8cacc1",
        "data": {
          "authentication_key": "0x7100c5295ed4f9f39dcc28d309654e291845984518307d3e2fe00aea5f8cacc1",
          "coin_register_events": {
            "counter": "1",
            "guid": {
              "id": {
                "addr": "0x7100c5295ed4f9f39dcc28d309654e291845984518307d3e2fe00aea5f8cacc1",
                "creation_num": "0"
              }
            }
          },
          "sequence_number": "4"
        },
        "event": "write_resource",
        "resource": "0x1::account::Account"
      },
    ...
    ],
    "gas_used": 59,
    "success": true,
    "version": 6261,
    "vm_status": "Executed successfully"
  }
}

重置本地状态

如果你更新了你的代码库，并进行了向后不兼容的修改，或者只是想重新开始，你可以用 --force-restart 标志运行命令：

aptos node run-local-testnet --with-faucet --force-restart

然后，它将提示你是否真的要重新启动链，以确保你不会意外地删除你的工作。

Are you sure you want to delete the existing chain? [yes/no] >

常见问题

提示地址已被使用该怎么办？

如果你得到一个类似这样的错误：

'panicked at 'error binding to 0.0.0.0:9101: error creating server listener: Address already in use (os error 48)'

这意味着你要么已经在运行一个节点，要么你有另一个进程在该端口上运行。

在 macOS 和 Linux 上，你可以运行以下命令来获得使用该端口的进程的名称和 PID：

PORT=9101
lsof -i :$PORT

在哪里可以得到关于 run-local-testnet 命令的更多信息？

更多 CLI 帮助可以运行这个命令看到：

aptos node run-local-testnet --help

这将提供关于该命令的每个标志的信息。