Skip to main content

连接到 Sui 网络

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

Sui Testnet 和 Devnet 网络包括：

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

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

在 Discord 频道 #announcements 中查看有关 Sui 的公告。

查看使用 Sui 网络的服务条款。

工具​

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

环境设置​

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

要检查 Sui 是否已安装，请运行以下命令：

which sui

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

查看 Sui Releases 页面，以查看每个 Sui 发布版本的更改。

配置 Sui 客户端​

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

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

sui client

如果在控制台中收到 sui-client 的帮助输出，说明你已经有了一个 client.yaml 文件。请参阅 连接到自定义 RPC 端点 以添加新的环境别名或切换当前活动的网络。

第一次启动 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 然后按下 Enter。

如果输入了 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。你可以使用 sui client envs 命令查看已定义的环境，并使用 sui client switch 命令在它们之间切换。

如果之前安装了连接到 Sui 网络的 Sui 客户端，或者创建了本地网络，你可以修改现有的 client.yaml 文件以更改配置的 RPC 端点。与环境相关的 sui client 命令从和写入 client.yaml 文件。

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

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 <ALIAS> --rpc <RPC-SERVER-URL>

要切换活动网络，请运行以下命令：

sui client switch --env <ALIAS>

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