Sui 安装与使用指南

CryptoBox
发布于 1天前
阅读 76

Sui安装与使用指南安装Sui安装Sui的最快方式是使用每个版本附带的二进制文件。如果需要更多对安装过程的控制，可以从源代码进行安装。为了充分利用容器化，你可以使用sui存储库的docker文件夹中的Docker镜像。支持的操作系统Sui支持以下操作系统：Linux

# Sui 安装与使用指南

## 安装 Sui

安装 Sui 的最快方式是使用每个版本附带的二进制文件。如果需要更多对安装过程的控制，可以从源代码进行安装。为了充分利用容器化，你可以使用 sui 存储库的 docker 文件夹中的 Docker 镜像。

### 支持的操作系统

Sui 支持以下操作系统：

* Linux - Ubuntu 版本 20.04 (Bionic Beaver)
* macOS - macOS Monterey
* Microsoft Windows - Windows 10 和 11

### 使用 Homebrew 安装

如果你使用 Homebrew，可以通过以下命令安装 Sui：

```bash
brew tap mystenlabs/tap
brew install mystenlabs/tap/sui
```

### 从二进制文件安装

每个 Sui 版本都提供了一组适用于多个操作系统的二进制文件。你可以从 GitHub 下载这些二进制文件并安装 Sui。

1. 转到 https\://github.com/MystenLabs/sui
2. 在右侧窗格中，找到 Releases 部分。
3. Sui 二进制文件需要一些时间来下载和安装，请确保分配足够的时间完成安装。实际完成时间取决于你的网络连接和计算机规格。

#### 确认安装

要确认 Sui 安装正确，请执行以下命令：

```bash
sui --version
```

你应该看到有关已安装的 Sui 版本的消息以及使用 Sui 命令的帮助信息。

### 从源代码安装

按照本节中的说明安装与 Sui 网络交互所需的 Rust crates（包），包括 Sui CLI。要从源代码安装 Sui，首先需要为你的操作系统安装其先决条件。

#### 先决条件

##### Rust 和 Cargo

Sui 在所有支持的操作系统上都需要 Rust 和 Cargo（Rust 的包管理器）。推荐使用 rustup 安装 Rust：

在 macOS 或 Linux 上：

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

如果你使用的是 Windows 11，请查看 [Rust 安装程序](https://www.rust-lang.org/tools/install)。安装程序会检查是否存在 C++ 构建工具，并在必要时提示你安装它们。

使用以下命令更新 Rust：

```bash
rustup update stable
```

### Linux 安装先决条件

Linux 操作系统所需的先决条件包括：

* cURL
* Rust 和 Cargo
* Git CLI
* CMake
* GCC
* libssl-dev
* libclang-dev
* libpq-dev
* build-essential

可以通过以下命令一次性安装所有 Linux 先决条件：

```bash
sudo apt-get update
sudo apt-get install curl git-all cmake gcc libssl-dev pkg-config libclang-dev libpq-dev build-essential
```

### macOS 安装先决条件

macOS 操作系统所需的先决条件包括：

* Rust 和 Cargo
* Homebrew
* cURL
* CMake
* Git CLI

安装 Homebrew：

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

安装其他所有 macOS 先决条件：

```bash
brew install curl cmake git
```

### Windows 安装先决条件

Windows 11 操作系统所需的先决条件包括：

* cURL
* Rust 和 Cargo
* Git CLI
* CMake
* C++ 构建工具
* LLVM 编译器

Windows 上的其他工具：

* 仅适用于 Windows on ARM64 - Visual Studio 2022 预览版
* C++ 构建工具（安装 Rust 时需要）
* LLVM 编译器基础设施（下载类似于 LLVM-15.0.7-win64.exe 的文件）
* Protocol Buffers（下载 protoc-xx.x-win32.zip 或 protoc-xx.x-win64.zip 并将 \bin 目录添加到 PATH）

> **已知问题**：在 PowerShell 中，`sui console` 命令可能无法正常工作。

## 安装 Sui 二进制文件

从 testnet 分支安装 Sui 二进制文件：

```bash
cargo install --locked --git https://github.com/MystenLabs/sui.git --branch testnet sui
```

此命令将 Sui 组件安装在 `~/.cargo/bin` 文件夹中。

## 升级 Sui 二进制文件

如果你之前安装过 Sui 二进制文件，可以使用相同的命令将它们更新到最新版本：

```bash
cargo install --locked --git https://github.com/MystenLabs/sui.git --branch devnet sui
```

## 连接到 Sui 网络

### Sui 网络概览

Sui 提供 Mainnet、Devnet 和 Testnet 网络。你可以使用测试网络（Devnet 或 Testnet）来尝试在该网络上运行的 Sui 版本。你还可以启动一个本地 Sui 网络进行本地开发。

Sui Testnet 和 Devnet 网络包括：

* 由 Mysten Labs 操作的四个验证节点
* 客户端通过此端点发送交易和读取请求：`https://fullnode.<SUI-NETWORK-VERSION>.sui.io:443`
* 用于浏览交易历史的公共网络 Sui Explorer

你可以通过 Sui Discord 的 devnet-faucet 和 testnet-faucet 频道申请测试 SUI 代币。如果连接到 Localnet，请使用 cURL 从本地 faucet 请求代币。**这些测试网络上的代币没有财务价值**。Mainnet 没有 faucet 服务。

### 工具

Sui 提供以下工具与 Sui 网络进行交互：

* **Sui 命令行界面 (CLI)**

* 创建和管理你的私钥
  * 创建示例 NFT
  * 调用和发布 Move 模块

* **Sui Explorer** 用于查看网络上的交易和对象

### 环境设置

首先，安装 Sui。安装 Sui 后，通过 Discord 请求你正在使用的网络的 SUI 测试代币：Devnet 或 Testnet。如果连接到 Localnet，请从本地 faucet 请求代币。

要检查 Sui 是否已安装，请运行：

```bash
which sui
```

如果 Sui 已安装，该命令将返回 Sui 二进制文件的路径。如果 Sui 未安装，它将返回 `sui not found`。

### 配置 Sui 客户端

如果之前运行过 `sui genesis` 来创建本地网络，它会创建一个 Sui 客户端配置文件（client.yaml），该文件连接到 localhost 的 `http://0.0.0.0:9000`。

要将 Sui 客户端连接到网络，请运行：

```bash
sui client
```

第一次启动 Sui 客户端时，如果没有 client.yaml 文件，控制台会提示你设置：

```
Config file ["<PATH-TO-FILE>/client.yaml"] doesn't exist, do you want to connect to a Sui Full node server [y/N]?
```

按下 `y` 然后按 Enter 键。然后，进程会请求 RPC 服务器的 URL：

```
Sui Full node server URL (Defaults to Sui Devnet if not specified) :
```

按下 Enter 连接到 Sui Devnet。要使用自定义的 RPC 服务器、Sui Testnet 或 Sui Mainnet，请输入正确的 RPC 端点 URL。

如果输入了 URL，则进程会提示输入环境的别名：

```
Environment alias for [<URL-ENTERED>] :
```

输入别名并按下 Enter。

```
Select key scheme to generate keypair (0 for ed25519, 1 for secp256k1, 2 for secp256r1):
```

按下 0，1 或 2 选择密钥方案，然后按下 Enter。

Sui 将返回类似以下的消息，其中包含地址和地址的 12 个单词的恢复短语：

```
Generated new keypair for address with scheme "ed25519" [0xb9c83a8b40d3263c9ba40d551514fbac1f8c12e98a4005a0dac072d3549c2442]
Secret Recovery Phrase : [cap wheat many line human lazy few solid bored proud speed grocery]
```

### 连接到自定义 RPC 端点

如果之前使用 `sui genesis` 命令并使用强制选项 (`-f` 或 `--force`)，则你的 client.yaml 文件已经包含两个 RPC 端点：localnet 对应 `http://0.0.0.0:9000`，devnet 对应 `https://fullnode.devnet.sui.io:443`。

要检查当前可用的环境别名，请运行：

```bash
sui client envs
```

该命令输出可用的环境别名，其中 (active) 表示当前活动的网络：

```
localnet => http://0.0.0.0:9000 (active)
devnet => https://fullnode.devnet.sui.io:443
```

要添加一个自定义RPC端点的新别名，请运行：

```bash
sui client new-env --alias <ALIAS> --rpc <RPC-SERVER-URL>
```

要切换活动网络，请运行：

```bash
sui client switch --env <ALIAS>
```

如果遇到问题，请删除Sui配置目录 (`~/.sui/sui_config`) 并重新安装最新的 Sui 二进制文件。

## 获取 Sui 地址

### 关于 Sui 地址

地址是在 Sui 区块链网络上唯一且匿名标识账户的方式。换句话说，地址是用户在 Sui 网络上存储和使用代币的一种方式，无需提供任何个人身份信息（如电子邮件地址、电话号码等）。

在 Sui 中，一个地址是 32 字节，通常以带有 0x 前缀的 base58 编码表示。例如：

```
0x59adba41d2b46d161bd570fdd358049fbc801ba0615c973615204c2a0dd4205e
```

你可以使用 Sui Explorer 网站查找有关此地址及其拥有的对象的更多信息。

### 获取地址的方法

#### 通过 Sui 钱包

对于首次使用者而言，通过 Sui 钱包 Chrome 浏览器扩展是获取 Sui 地址的一种直接方式。安装扩展后，有几种方法可以创建地址：

1. 打开 Chrome 中的 Sui 钱包浏览器扩展

2. 选择以下方式之一：

* 使用你的 Gmail/Twitch/Facebook 账户 (ZkLogin) 并按照屏幕上的说明操作
   * 单击 "More Options → Create a new passphrase account"，然后按照屏幕上的说明操作

#### 通过 CPBox 批量生成

如果你需要批量生成多个 Sui 钱包地址，可以使用 CPBox 工具：

1. 访问 https\://www\.cpbox.io/cn/batch/generate-wallet
2. 选择 "Sui" 作为区块链网络
3. 输入想要生成的钱包地址数量
4. 点击生成按钮，即可批量创建 Sui 钱包地址和对应的私钥
5. 将生成的地址和私钥保存在安全的地方

> **安全提示**：使用第三方工具生成地址时，请确保使用受信任的服务，并妥善保管私钥信息。

#### 通过命令行界面

如果你使用 Sui 命令行界面 (CLI) 与 Sui 网络交互，可以使用 `sui client` 命令生成新地址。

要生成新的 Sui 地址，请使用：

```bash
sui client new-address ed25519
```

其中指定了密钥类型为 ed25519。

要查看本地计算机上本地钱包中生成的所有地址，请运行：

```bash
sui keytool list
```

> **重要提示**：与 Sui 地址关联的私钥存储在 CLI 安装的计算机上的本地位置，即 `~/.sui/sui_config/sui.keystore` 文件中。确保不要将其暴露给任何人，因为他们可以使用它来访问你的账户。

## 获取 Sui 代币

### 通过 cURL 请求测试代币

使用以下 cURL 命令直接从水龙头服务器请求代币：

```bash
curl --location --request POST 'https://faucet.devnet.sui.io/gas' \
--header 'Content-Type: application/json' \
--data-raw '{
    "FixedAmountRequest": {
        "recipient": "<YOUR SUI ADDRESS>"
    }
}'
```

如果你正在使用本地网络，请根据运行网络的软件包替换 URL：

* sui-faucet: `http://127.0.0.1:5003/gas`
* sui-test-validator: `http://127.0.0.1:9123/gas`

### 通过 sui client faucet 命令

确保正确配置地址和网络，运行命令：

```bash
sui client faucet
```

成功请求测试代币后，你将看到以下提示：

```
Request successful. It can take up to 1 minute to get the coin. Run sui client gas to check your gas coins.
```

## Sui 客户端常用命令

```bash
# 新建地址
sui client new-address ed25519

# 查询目前拥有的账户列表
sui client addresses

# 切换指定地址
sui client switch --address <YOUR ADDRESS>

# 导入已有地址
sui keytool import "<助记词>" ed25519

# 查看已配置网络
sui client envs

# 切换网络
sui client switch --env <ALIAS>

# 编译一个合约
sui move build

# 发布一个合约
sui client publish --gas-budget <you_expect_gas_budget>

# 调用合约
sui client call \
  --function <函数名> \
  --args <传入的函数参数> \
  --type-args <如果有泛型，请指明泛型类型> \
  --package <包的地址> \
  --module <模块名> \
  --gas-budget <you_expect_gas_budget>
```

Sui 安装与使用指南

安装 Sui

支持的操作系统

Sui 支持以下操作系统：

Linux - Ubuntu 版本 20.04 (Bionic Beaver)
macOS - macOS Monterey
Microsoft Windows - Windows 10 和 11

使用 Homebrew 安装

如果你使用 Homebrew，可以通过以下命令安装 Sui：

brew tap mystenlabs/tap
brew install mystenlabs/tap/sui

从二进制文件安装

每个 Sui 版本都提供了一组适用于多个操作系统的二进制文件。你可以从 GitHub 下载这些二进制文件并安装 Sui。

转到 https\://github.com/MystenLabs/sui
在右侧窗格中，找到 Releases 部分。
Sui 二进制文件需要一些时间来下载和安装，请确保分配足够的时间完成安装。实际完成时间取决于你的网络连接和计算机规格。

确认安装

要确认 Sui 安装正确，请执行以下命令：

sui --version

你应该看到有关已安装的 Sui 版本的消息以及使用 Sui 命令的帮助信息。

从源代码安装

按照本节中的说明安装与 Sui 网络交互所需的 Rust crates（包），包括 Sui CLI。要从源代码安装 Sui，首先需要为你的操作系统安装其先决条件。

先决条件

Rust 和 Cargo

Sui 在所有支持的操作系统上都需要 Rust 和 Cargo（Rust 的包管理器）。推荐使用 rustup 安装 Rust：

在 macOS 或 Linux 上：

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

如果你使用的是 Windows 11，请查看 Rust 安装程序。安装程序会检查是否存在 C++ 构建工具，并在必要时提示你安装它们。

使用以下命令更新 Rust：

rustup update stable

Linux 安装先决条件

Linux 操作系统所需的先决条件包括：

cURL
Rust 和 Cargo
Git CLI
CMake
GCC
libssl-dev
libclang-dev
libpq-dev
build-essential

可以通过以下命令一次性安装所有 Linux 先决条件：

sudo apt-get update
sudo apt-get install curl git-all cmake gcc libssl-dev pkg-config libclang-dev libpq-dev build-essential

macOS 安装先决条件

macOS 操作系统所需的先决条件包括：

Rust 和 Cargo
Homebrew
cURL
CMake
Git CLI

安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装其他所有 macOS 先决条件：

brew install curl cmake git

Windows 安装先决条件

Windows 11 操作系统所需的先决条件包括：

cURL
Rust 和 Cargo
Git CLI
CMake
C++ 构建工具
LLVM 编译器

Windows 上的其他工具：

仅适用于 Windows on ARM64 - Visual Studio 2022 预览版
C++ 构建工具（安装 Rust 时需要）
LLVM 编译器基础设施（下载类似于 LLVM-15.0.7-win64.exe 的文件）
Protocol Buffers（下载 protoc-xx.x-win32.zip 或 protoc-xx.x-win64.zip 并将 \bin 目录添加到 PATH）

已知问题：在 PowerShell 中，sui console 命令可能无法正常工作。

安装 Sui 二进制文件

从 testnet 分支安装 Sui 二进制文件：

cargo install --locked --git https://github.com/MystenLabs/sui.git --branch testnet sui

此命令将 Sui 组件安装在 ~/.cargo/bin 文件夹中。

升级 Sui 二进制文件

如果你之前安装过 Sui 二进制文件，可以使用相同的命令将它们更新到最新版本：

cargo install --locked --git https://github.com/MystenLabs/sui.git --branch devnet sui

连接到 Sui 网络

Sui 网络概览

Sui Testnet 和 Devnet 网络包括：

由 Mysten Labs 操作的四个验证节点
客户端通过此端点发送交易和读取请求：https://fullnode.<SUI-NETWORK-VERSION>.sui.io:443
用于浏览交易历史的公共网络 Sui Explorer

你可以通过 Sui Discord 的 devnet-faucet 和 testnet-faucet 频道申请测试 SUI 代币。如果连接到 Localnet，请使用 cURL 从本地 faucet 请求代币。这些测试网络上的代币没有财务价值。Mainnet 没有 faucet 服务。

工具

Sui 提供以下工具与 Sui 网络进行交互：

Sui 命令行界面 (CLI)
- 创建和管理你的私钥
- 创建示例 NFT
- 调用和发布 Move 模块
Sui Explorer 用于查看网络上的交易和对象

环境设置

首先，安装 Sui。安装 Sui 后，通过 Discord 请求你正在使用的网络的 SUI 测试代币：Devnet 或 Testnet。如果连接到 Localnet，请从本地 faucet 请求代币。

要检查 Sui 是否已安装，请运行：

which sui

如果 Sui 已安装，该命令将返回 Sui 二进制文件的路径。如果 Sui 未安装，它将返回 sui not found。

配置 Sui 客户端

如果之前运行过 sui genesis 来创建本地网络，它会创建一个 Sui 客户端配置文件（client.yaml），该文件连接到 localhost 的 http://0.0.0.0:9000。

要将 Sui 客户端连接到网络，请运行：

sui client

第一次启动 Sui 客户端时，如果没有 client.yaml 文件，控制台会提示你设置：

Config file ["&lt;PATH-TO-FILE>/client.yaml"] doesn't exist, do you want to connect to a Sui Full node server [y/N]?

按下 y 然后按 Enter 键。然后，进程会请求 RPC 服务器的 URL：

Sui Full node server URL (Defaults to Sui Devnet if not specified) :

按下 Enter 连接到 Sui Devnet。要使用自定义的 RPC 服务器、Sui Testnet 或 Sui Mainnet，请输入正确的 RPC 端点 URL。

如果输入了 URL，则进程会提示输入环境的别名：

Environment alias for [&lt;URL-ENTERED>] :

输入别名并按下 Enter。

Select key scheme to generate keypair (0 for ed25519, 1 for secp256k1, 2 for secp256r1):

按下 0，1 或 2 选择密钥方案，然后按下 Enter。

Sui 将返回类似以下的消息，其中包含地址和地址的 12 个单词的恢复短语：

Generated new keypair for address with scheme "ed25519" [0xb9c83a8b40d3263c9ba40d551514fbac1f8c12e98a4005a0dac072d3549c2442]
Secret Recovery Phrase : [cap wheat many line human lazy few solid bored proud speed grocery]

连接到自定义 RPC 端点

如果之前使用 sui genesis 命令并使用强制选项 (-f 或 --force)，则你的 client.yaml 文件已经包含两个 RPC 端点：localnet 对应 http://0.0.0.0:9000，devnet 对应 https://fullnode.devnet.sui.io:443。

要检查当前可用的环境别名，请运行：

sui client envs

该命令输出可用的环境别名，其中 (active) 表示当前活动的网络：

localnet => http://0.0.0.0:9000 (active)
devnet => https://fullnode.devnet.sui.io:443

要添加一个自定义RPC端点的新别名，请运行：

sui client new-env --alias &lt;ALIAS> --rpc &lt;RPC-SERVER-URL>

要切换活动网络，请运行：

sui client switch --env &lt;ALIAS>

如果遇到问题，请删除Sui配置目录 (~/.sui/sui_config) 并重新安装最新的 Sui 二进制文件。

获取 Sui 地址

关于 Sui 地址

在 Sui 中，一个地址是 32 字节，通常以带有 0x 前缀的 base58 编码表示。例如：

0x59adba41d2b46d161bd570fdd358049fbc801ba0615c973615204c2a0dd4205e

你可以使用 Sui Explorer 网站查找有关此地址及其拥有的对象的更多信息。

获取地址的方法

通过 Sui 钱包

对于首次使用者而言，通过 Sui 钱包 Chrome 浏览器扩展是获取 Sui 地址的一种直接方式。安装扩展后，有几种方法可以创建地址：

打开 Chrome 中的 Sui 钱包浏览器扩展
选择以下方式之一：
- 使用你的 Gmail/Twitch/Facebook 账户 (ZkLogin) 并按照屏幕上的说明操作
- 单击 "More Options → Create a new passphrase account"，然后按照屏幕上的说明操作

通过 CPBox 批量生成

如果你需要批量生成多个 Sui 钱包地址，可以使用 CPBox 工具：

访问 https\://www.cpbox.io/cn/batch/generate-wallet
选择 "Sui" 作为区块链网络
输入想要生成的钱包地址数量
点击生成按钮，即可批量创建 Sui 钱包地址和对应的私钥
将生成的地址和私钥保存在安全的地方

安全提示：使用第三方工具生成地址时，请确保使用受信任的服务，并妥善保管私钥信息。

通过命令行界面

如果你使用 Sui 命令行界面 (CLI) 与 Sui 网络交互，可以使用 sui client 命令生成新地址。

要生成新的 Sui 地址，请使用：

sui client new-address ed25519

其中指定了密钥类型为 ed25519。

要查看本地计算机上本地钱包中生成的所有地址，请运行：

sui keytool list

重要提示：与 Sui 地址关联的私钥存储在 CLI 安装的计算机上的本地位置，即 ~/.sui/sui_config/sui.keystore 文件中。确保不要将其暴露给任何人，因为他们可以使用它来访问你的账户。

获取 Sui 代币

通过 cURL 请求测试代币

使用以下 cURL 命令直接从水龙头服务器请求代币：

curl --location --request POST 'https://faucet.devnet.sui.io/gas' \
--header 'Content-Type: application/json' \
--data-raw '{
    "FixedAmountRequest": {
        "recipient": "&lt;YOUR SUI ADDRESS>"
    }
}'

如果你正在使用本地网络，请根据运行网络的软件包替换 URL：

sui-faucet: http://127.0.0.1:5003/gas
sui-test-validator: http://127.0.0.1:9123/gas

通过 sui client faucet 命令

确保正确配置地址和网络，运行命令：

sui client faucet

成功请求测试代币后，你将看到以下提示：

Request successful. It can take up to 1 minute to get the coin. Run sui client gas to check your gas coins.

Sui 客户端常用命令

# 新建地址
sui client new-address ed25519

# 查询目前拥有的账户列表
sui client addresses

# 切换指定地址
sui client switch --address &lt;YOUR ADDRESS>

# 导入已有地址
sui keytool import "&lt;助记词>" ed25519

# 查看已配置网络
sui client envs

# 切换网络
sui client switch --env &lt;ALIAS>

# 编译一个合约
sui move build

# 发布一个合约
sui client publish --gas-budget &lt;you_expect_gas_budget>

# 调用合约
sui client call \
  --function &lt;函数名> \
  --args &lt;传入的函数参数> \
  --type-args &lt;如果有泛型，请指明泛型类型> \
  --package &lt;包的地址> \
  --module &lt;模块名> \
  --gas-budget &lt;you_expect_gas_budget>

原创
学分: 3
分类: Sui
标签:

本文参与登链社区写作激励计划，好文好收益，欢迎正在阅读的你也加入。

Sui 安装与使用指南

Sui 安装与使用指南

安装 Sui

支持的操作系统

使用 Homebrew 安装

从二进制文件安装

确认安装

从源代码安装

先决条件

Rust 和 Cargo

Linux 安装先决条件

macOS 安装先决条件

Windows 安装先决条件

安装 Sui 二进制文件

升级 Sui 二进制文件

连接到 Sui 网络

Sui 网络概览

工具

环境设置

配置 Sui 客户端

连接到自定义 RPC 端点

获取 Sui 地址

关于 Sui 地址

获取地址的方法

通过 Sui 钱包

通过 CPBox 批量生成

通过命令行界面

获取 Sui 代币

通过 cURL 请求测试代币

通过 sui client faucet 命令

Sui 客户端常用命令

0 条评论

文章目录