The [Walrus system object](https://github.com/MystenLabs/walrus/blob/main/contracts/walrus/sources/system/system_state_inner.move) contains metadata about available and used storage and the price of storage per KiB in [FROST](/docs/walrus-client/storing-blobs). These values are determined by 2/3 agreement between storage nodes for each storage epoch. You can pay to purchase storage space for specified durations. These space resources can be split, merged, and transferred, and can later be used to place a blob ID into Walrus.

Each Walrus storage epoch is represented by the Walrus system object, which contains a storage committee and various metadata about storage nodes, including the mapping between shards and storage nodes, available space, and current costs. Committee changes between epochs are managed by a set of [staking contracts](https://github.com/MystenLabs/walrus/tree/main/contracts/walrus/sources/staking) that implement a full delegated proof-of-stake system based on the WAL token.

## `walrus info`

You can view information about the Walrus system through the `walrus info` command. It provides an overview of current system parameters, such as the current epoch, the number of storage nodes and shards in the system, the maximum blob size, and the current cost in WAL for storing blobs:

```sh
$ walrus info
```

The console responds:
```sh
Walrus system information

Epochs and storage duration
Current epoch: 1
Start time: 2025-03-25 15:00:24.408 UTC
End time: 2025-04-08 15:00:24.408 UTC
Epoch duration: 14days
Blobs can be stored for at most 53 epochs in the future.

Storage nodes
Number of storage nodes: 103
Number of shards: 1000

Blob size
Maximum blob size: 13.6 GiB (14,599,533,452 B)
Storage unit: 1.00 MiB

Storage prices per epoch
(Conversion rate: 1 WAL = 1,000,000,000 FROST)
Price per encoded storage unit: 0.0001 WAL
Additional price for each write: 20,000 FROST

...
```

You can view additional information with various subcommands:

| Command | Description |
|---|---|
| `all` | Print all information listed below |
| `epoch` | Print epoch information |
| `storage` | Print storage information |
| `size` | Print size information |
| `price` | Print price information |
| `bft` | Print byzantine fault tolerance (BFT) information |
| `committee` | Print committee information |
| `help` | Print help for the given subcommand |

| Parameter | Required/Optional | Description |
|---|---|---|
| `--config <CONFIG>` | Optional | Path to the Walrus configuration file. Defaults to `client_config.yaml` / `client_config.yml` in the current directory, `$XDG_CONFIG_HOME/walrus/`, `~/.config/walrus/`, or `~/.walrus/` |
| `--rpc-url <RPC_URL>` | Optional | URL of the Sui RPC node. Defaults to `rpc_url` in client config or wallet config |
| `--context <CONTEXT>` | Optional | Configuration context to use; defaults to `default_context` |
| `--wallet <WALLET>` | Optional | Path to the Sui wallet configuration file. Defaults through config parameter, Walrus config path, `./sui_config.yaml`, then `~/.sui/sui_config/client.yaml` |
| `--gas-budget <GAS_BUDGET>` | Optional | Gas budget for transactions. Estimated automatically if not specified |
| `--json` | Optional | Write output as JSON |
| `--trace-cli <TRACE_CLI>` | Optional | Enable tracing output. Values: `otlp` (sends to OTLP collector) or `file=path` (writes gzipped JSON traces to file) |
| `-h`, `--help` | Optional | Print help | 

## `walrus health`

You can check the health of storage nodes with the `walrus health` command. This command accepts different options to select which nodes to check. 

| Parameter | Required or optional | Description |
|---|---|---|
| `--node-ids <NODE_IDS>...` | Required | The IDs of the storage nodes to be selected |
| `--node-urls <NODE_URLS>...` | Required | The URLs of the storage nodes to be selected |
| `--committee` | Required | Select all storage nodes in the current committee |
| `--active-set` | Required | Select all storage nodes in the active set |
| `--config <CONFIG>` | Optional | Path to the Walrus configuration file. Defaults to `client_config.yaml` in the current directory, `$XDG_CONFIG_HOME/walrus/`, `~/.config/walrus/`, or `~/.walrus/` |
| `--rpc-url <RPC_URL>` | Optional | URL of the Sui RPC node. Defaults to `rpc_url` in client config or wallet config |
| `--context <CONTEXT>` | Optional | Configuration context to use; defaults to `default_context` |
| `--wallet <WALLET>` | Optional | Path to the Sui wallet configuration file. Defaults through config parameter, Walrus config path, `./sui_config.yaml`, then `~/.sui/sui_config/client.yaml` |
| `--gas-budget <GAS_BUDGET>` | Optional | Gas budget for transactions. Estimated automatically if not specified |
| `--json` | Optional | Write output as JSON |
| `--detail` | Optional | Print detailed health information |
| `--sort-by <SORT_BY>` | Optional | Field to sort by. Possible values: `status`, `id`, `name`, `url` |
| `--desc` | Optional | Sort in descending order |
| `--concurrent-requests <CONCURRENT_REQUESTS>` | Optional | Number of concurrent requests to send to storage nodes. Default: `60` |
| `--trace-cli <TRACE_CLI>` | Optional | Enable tracing output. Values: `otlp` (sends to OTLP collector) or `file=path` (writes gzipped JSON traces to file) |
| `-h`, `--help` | Optional | Print help |