附录 B 常用命令速查

本附录默认 Testnet。生产环境把 --context testnet 改成 --context mainnet 前，先确认钱包、余额和版本。

版本与安装

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

suiup install sui
suiup install walrus
suiup show
suiup which

sui --version
walrus --version

配置

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

sui client
sui client envs
sui client switch --env testnet
sui client active-env
walrus info --context testnet

账户与余额

sui client active-address
sui client addresses
sui client new-address ed25519
sui client balance
walrus get-wal --context testnet

Store

walrus store file.txt --epochs 2 --context testnet
walrus store *.png --epochs 2 --context testnet
walrus store file.txt --epochs max --context testnet
walrus store file.txt --epochs 2 --deletable --context testnet
walrus store file.txt --epochs 2 --permanent --context testnet
walrus store file.txt --epochs 2 --force --context testnet
walrus store file.txt --epochs 2 --permanent --share --context testnet

Read 与 Status

walrus blob-status --blob-id <BLOB_ID> --context testnet
walrus blob-status --file file.txt --context testnet

walrus read <BLOB_ID> --context testnet
walrus read <BLOB_ID> --out downloaded.bin --context testnet
walrus read <BLOB_ID> --out downloaded.bin --strict-consistency-check --context testnet

生命周期管理

walrus extend --blob-obj-id <BLOB_OBJECT_ID> --epochs-extended 3 --context testnet
walrus extend --blob-obj-id <SHARED_BLOB_OBJECT_ID> --epochs-extended 3 --shared --context testnet

walrus delete --blob-id <BLOB_ID> --context testnet
walrus delete --blob-id <BLOB_ID> --yes --context testnet
walrus delete --file file.txt --context testnet
walrus delete --object-id <BLOB_OBJECT_ID> --context testnet

walrus burn-blobs --object-ids <BLOB_OBJECT_ID> --context testnet
walrus burn-blobs --all-expired --context testnet

Shared Blob

walrus share --blob-obj-id <BLOB_OBJECT_ID> --context testnet
walrus share --blob-obj-id <BLOB_OBJECT_ID> --amount <AMOUNT> --context testnet
walrus fund-shared-blob --blob-obj-id <SHARED_BLOB_OBJECT_ID> --amount <AMOUNT> --context testnet

Attributes

walrus set-blob-attribute <BLOB_OBJECT_ID> \
  --attr "content-type" "text/plain" \
  --attr "cache-control" "public, max-age=31536000" \
  --context testnet

walrus get-blob-attribute <BLOB_OBJECT_ID> --context testnet

walrus remove-blob-attribute-fields <BLOB_OBJECT_ID> \
  --keys "cache-control" \
  --context testnet

walrus remove-blob-attribute <BLOB_OBJECT_ID> --context testnet

Quilt

walrus store-quilt \
  --epochs 2 \
  --paths ./site-assets ./metadata.json \
  --context testnet

walrus store-quilt \
  --blobs '{"path":"a.txt","identifier":"a","tags":{"kind":"text"}}' \
          '{"path":"b.json","identifier":"b","tags":{"kind":"json"}}' \
  --epochs 2 \
  --context testnet

walrus list-patches-in-quilt <QUILT_ID> --context testnet

walrus read-quilt \
  --quilt-id <QUILT_ID> \
  --identifiers a b \
  --out ./downloads \
  --context testnet

walrus read-quilt \
  --quilt-id <QUILT_ID> \
  --tag kind json \
  --out ./downloads \
  --context testnet

walrus read-quilt \
  --quilt-patch-ids <PATCH_ID_1> <PATCH_ID_2> \
  --out ./downloads \
  --context testnet

排错入口

walrus --help
walrus store --help
walrus read --help
walrus extend --help
walrus store-quilt --help
sui client --help
suiup doctor