SuperAPI AI 工具集

walrus-cli

通用与其它

查看项目

更新于 10-16 01:33

技能介绍

Walrus CLI 是操作 Walrus 的主要命令行工具,用于存储和读取 blob、查询 blob 状态、管理 blob 生命周期(延长、删除、销毁、共享)以及处理 quilt。所有命令都支持 JSON 输出,便于脚本化。

安装:用 suiup 安装与升级。 curl -sSfL https://raw.githubusercontent.com/Mystenlabs/suiup/main/install.sh | sh suiup install sui suiup install walrus 更新用 suiup update walrus;切换网络用 suiup install walrus@mainnet 或 suiup install walrus@testnet。

配置:CLI 会从当前目录、$XDG_CONFIG_HOME/walrus/、~/.config/walrus/、~/.walrus/ 读取 client_config.yaml。可用 --config 指定路径,--wallet 指定钱包,--context 切换上下文中。

主要用法: 存储:walrus store myfile.png --epochs 5(支持 glob,--epochs 为必填,最大 53;可选 --permanent/--deletable、--earliest-expiry-time、--end-epoch、--upload-relay)。 读取与状态:walrus read <BLOB_ID>,walrus blob-status --blob-id <BLOB_ID>,可用 --timeout 调整超时。 JSON 模式:walrus json '{...}',或在任意命令加 --json;JSON 模式选项用 camelCase。 系统信息:walrus info 查看当前 epoch、价格与网络参数;子命令有 epoch、committee、bft、coin。 测试网获取 WAL:walrus get-wal --context testnet,仅测试网可用。 网络健康:walrus health --committee,可用 --detail、--json 等;健康故障按 shard 计。

限制与注意事项:所有 blob 是公开的,敏感数据应先加密;blob ID 是内容标识,不等于 Sui 对象 ID;写操作需要 SUI 作为 gas、WAL 作为存储费;epochs 必填且无默认值;存储池目前不是 CLI 功能。