第 2 章 安装 Sui、Walrus 与环境配置

学习目标

• 用 suiup 安装最新稳定的 Sui 和 Walrus CLI。
• 配置 Walrus Testnet 客户端文件。
• 初始化 Sui 钱包并检查环境是否正确。

前置条件

• macOS、Linux 或 WSL。
• 终端可以访问 GitHub 和 Walrus 文档站。
• 推荐安装 curl、jq、diffutils。

安装 suiup

官方推荐用 suiup 管理 Sui 生态 CLI：

curl -sSfL https://raw.githubusercontent.com/Mystenlabs/suiup/main/install.sh | sh

安装完成后，重新打开终端，或者按安装脚本提示把 suiup 所在目录加入 PATH。

检查：

suiup --version
suiup list

安装 sui 和 walrus

默认安装当前推荐版本：

suiup install sui
suiup install walrus

查看实际命中的二进制：

suiup show
suiup which
sui --version
walrus --version

如果你需要明确锁定 Testnet 线，先用 suiup list 查看可用版本，再安装对应项。不要混用 Mainnet Walrus CLI 和 Testnet 配置做本书练习。

配置 Walrus Testnet

下载官方预填配置：

curl --create-dirs \
  https://docs.wal.app/setup/client_config.yaml \
  -o ~/.config/walrus/client_config.yaml

检查文件存在：

test -f ~/.config/walrus/client_config.yaml
walrus info --context testnet

walrus info --context testnet 应该能显示当前 Walrus 网络信息。Testnet 的 Epoch 时长通常显示为 1day。

初始化 Sui Testnet 钱包

首次运行：

sui client

交互输入建议：

Connect to a Sui Full Node server? Y
Full node server URL: https://fullnode.testnet.sui.io:443
Environment alias: testnet
Select key scheme: 0

已有钱包时，确认当前环境：

sui client envs
sui client switch --env testnet
sui client active-env
sui client active-address

获取测试资产

先复制地址：

sui client active-address

到 Sui Testnet faucet 领取测试 SUI：

https://faucet.sui.io/

检查余额：

sui client balance

把一部分测试 SUI 换成测试 WAL：

walrus get-wal --context testnet
sui client balance

余额里应能看到 Sui 和 WAL Token。

输出解读

sui client active-env

应输出：

testnet

walrus info --context testnet

重点看：

• 当前连接的 Walrus context 是 testnet。
• Epoch 信息能正常加载。
• 没有 RPC、钱包、配置文件错误。

常见坑

• walrus: command not found：终端没有加载 suiup 修改后的 PATH，重开终端或检查 shell 配置。
• No such file or directory ~/.config/walrus/client_config.yaml：重新运行下载配置命令。
• Insufficient balance：先领 Testnet SUI，再运行 walrus get-wal --context testnet。
• 当前 Sui 环境不是 Testnet：执行 sui client switch --env testnet。
• Mainnet 操作会花真实资产：本书命令都显式带 --context testnet，生产前再改成 mainnet。

下一步

下一章整理账户、网络、Token 和费用模型，并准备后续 CLI 章节使用的工作目录。