Release Notes
Release notes from Walrus and Walrus Memory.
- Walrus Platform
- Walrus Memory
Walrus v1.50.0
Mainnet June 24, 2026 | GitHub
A maintenance release on Testnet with no user-facing changes documented in the release notes; see the full commit log for internal updates.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.50.0
Walrus v1.49.1
Mainnet May 27, 2026 | GitHub
A maintenance release on Mainnet with no user-facing changes documented in the release notes; see the full commit log for internal updates.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.49.1
Walrus v1.48.1
Mainnet May 13, 2026 | GitHub
A maintenance release on Mainnet with no user-facing changes documented in the release notes; see the full commit log for internal updates.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.48.1
Walrus v1.47.1
Mainnet April 29, 2026 | GitHub
Enables storage pool support in the storage node and makes the aggregator return a retryable HTTP
503 BLOB_UNAVAILABLE (instead of 500) when a blob is only temporarily unretrievable. Blob
attribute headers such as Content-Type are now correctly included on range requests when reading
by object ID.
Storage node
#3256: enable storage pool support in storage node
Aggregator
#3284: The GET /v1/blobs/{blob_id} endpoint now returns
HTTP 503 with reason BLOB_UNAVAILABLE when a blob is temporarily
unretrievable (for example, mid-upload, mid-expiry, or when too many
storage nodes are unreachable to reconstruct the blob or determine a
definitive status). Previously these cases returned HTTP 500. The
terminal 404 BLOB_NOT_FOUND response for blobs that do not exist
is unchanged. Clients and CDNs should treat 503 as retryable with
backoff.
#3084: Blob attribute headers (such as Content-Type) are now correctly included on range request responses when reading blobs by object ID.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.47.1
Walrus v1.47.0
Testnet April 22, 2026 | GitHub
The Testnet preview of storage pool support in the storage node, plus the aggregator's new retryable
HTTP 503 BLOB_UNAVAILABLE response for temporarily unretrievable blobs. Range requests by object
ID now return blob attribute headers such as Content-Type correctly.
Storage node
#3256: enable storage pool support in storage node
Aggregator
#3284: The GET /v1/blobs/{blob_id} endpoint now returns
HTTP 503 with reason BLOB_UNAVAILABLE when a blob is temporarily
unretrievable (for example, mid-upload, mid-expiry, or when too many
storage nodes are unreachable to reconstruct the blob or determine a
definitive status). Previously these cases returned HTTP 500. The
terminal 404 BLOB_NOT_FOUND response for blobs that do not exist
is unchanged. Clients and CDNs should treat 503 as retryable with
backoff.
#3084: Blob attribute headers (such as Content-Type) are now correctly included on range request responses when reading blobs by object ID.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.47.0
Walrus v1.46.1
Mainnet April 15, 2026 | GitHub
Adds a reuse_resources query parameter so the publisher and daemon can resume an existing,
unfinished upload pipeline instead of starting over.
Publisher
#3202: allow publisher and daemon to add reuse_resources query parameters to try to reuse existing (unfinished) upload pipeline
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.46.1
Walrus v1.45.2
Mainnet April 1, 2026 | GitHub
Raises the storage node's RocksDB background threads from 2 to 16 and adds the opt-in
garbage_collection.enable_immediate_data_deletion parameter. Also fixes a combined-daemon body
size limit that was silently rejecting uploads with 413 errors and adds a walrus info coin CLI
subcommand.
Storage node
#3155: Increases the number of RocksDB background threads from 2 (RocksDB default) to 16. Can be configured through the config file.
#3160: Add a new configuration parameter garbage_collection.enable_immediate_data_deletion, which defaults to false. When processing a BlobDeleted event, data is only deleted immediately if this parameter is set to true.
Publisher
#3072: Fixed body size limit in combined daemon mode (running publisher and aggregator together). The limit was set 1024x too small, causing uploads to be silently rejected with 413 Payload Too Large. Standalone publisher mode was not affected.
CLI
#3122: Added a new info subcommand to the CLI. walrus info coin provides the StructTag of the walrus coin given the CLI's configured context.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.45.2
Walrus v1.45.1
Testnet March 25, 2026 | GitHub
The Testnet preview that raises RocksDB background threads from 2 to 16 and adds the opt-in
garbage_collection.enable_immediate_data_deletion parameter. Includes the combined-daemon 413
upload fix and the new walrus info coin CLI subcommand.
Storage node
#3155: Increases the number of RocksDB background threads from 2 (RocksDB default) to 16. Can be configured through the config file.
#3160: Add a new configuration parameter garbage_collection.enable_immediate_data_deletion, which defaults to false. When processing a BlobDeleted event, data is only deleted immediately if this parameter is set to true.
Publisher
#3072: Fixed body size limit in combined daemon mode (running publisher and aggregator together). The limit was set 1024x too small, causing uploads to be silently rejected with 413 Payload Too Large. Standalone publisher mode was not affected.
CLI
#3122: Added a new info subcommand to the CLI. walrus info coin provides the StructTag of the walrus coin given the CLI's configured context.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.45.1
Walrus v1.44.3
Mainnet March 19, 2026 | GitHub
Fixes a storage node crash caused by outdated epoch state, raises RocksDB background threads from 2
to 16, and adds the opt-in garbage_collection.enable_immediate_data_deletion parameter.
Storage node
#3005: Fixed an issue that crashed storage nodes due to outdated epoch state.
#3156: Increases the number of RocksDB background threads from 2 (RocksDB default) to 16. Can be configured through the config file.
#3161: Add a new configuration parameter garbage_collection.enable_immediate_data_deletion, which defaults to false. When processing a BlobDeleted event, data is only deleted immediately if this parameter is set to true.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.44.3
Walrus v1.44.2
Mainnet March 19, 2026 | GitHub
Storage node
#3005: Fixed an issue that crashed storage nodes due to outdated epoch state.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.44.2
Walrus v1.44.1
Testnet March 11, 2026 | GitHub
Storage node
#3005: Fixed an issue that crashed storage nodes due to outdated epoch state.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.44.1
Walrus v1.43.1
Mainnet March 4, 2026 | GitHub
Allows storage nodes to vote on pricing denominated in USD, a capability that becomes usable once the contract adds support for it.
Storage node
#2960: allow storage nodes to vote on pricing based on USD. This functionality can only be used after the contract supports this.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.43.1
Walrus v1.42.1
Mainnet February 18, 2026 | GitHub
A maintenance release on Mainnet with no user-facing changes documented in the release notes; see the full commit log for internal updates.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.42.1
Walrus v1.41.1
Mainnet February 5, 2026 | GitHub
Enables garbage collection by default on Mainnet and adds an alpha /v1alpha/blobs/{blob_id}/stream
endpoint designed to lower time to first byte when streaming blob data.
Storage node
#2851: Garbage collection is now enabled by default on Mainnet.
Aggregator
#2801: There is a new alpha endpoint /v1alpha/blobs/{blob_id}/stream which is intended to reduce latency to first byte, and is intended to be used to stream blob data.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.41.1
Walrus v1.41.0
Testnet January 28, 2026 | GitHub
The Testnet preview enabling garbage collection by default and introducing the alpha
/v1alpha/blobs/{blob_id}/stream endpoint for lower-latency blob streaming.
Storage node
#2851: Garbage collection is now enabled by default on Mainnet.
Aggregator
#2801: There is a new alpha endpoint /v1alpha/blobs/{blob_id}/stream which is intended to reduce latency to first byte, and is intended to be used to stream blob data.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.41.0
Walrus v1.40.3
Mainnet January 21, 2026 | GitHub
Enables database transactions and garbage collection by default on Testnet, both of which can be
turned off in the node configuration; operators using experimental_use_optimistic_transaction_db
should remove that flag.
Storage node
#2772: Enables DB transactions (implemented in #2475) and garbage collection (implemented in #2542, #2599, and #2725) by default on Testnet. The features can be disabled by adding the following to your node configuration:
db_config:
global:
use_optimistic_transaction_db: false
garbage_collection:
enable_blob_info_cleanup: false
enable_data_deletion: false
If you have experimental_use_optimistic_transaction_db: true in your configuration, you should remove that.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.40.3
Walrus v1.39.1
Mainnet January 7, 2026 | GitHub
Storage node operators must remove the obsolete use_legacy_event_provider flag from their
configuration if it is still present.
Storage node
#2730:
Storage nodes will need to remove the use_legacy_event_provider flag from their configuration if it is present.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.39.1
Walrus v1.38.3
Mainnet December 10, 2025 | GitHub
Delivers significant memory-usage reductions across the aggregator, publisher, and CLI, plus lower
upload latency from fewer Sui RPC requests. Adds a new byte-range read API and an alpha
/v1alpha/blobs/concat endpoint, and removes the long-unused get_recovery_symbol endpoint.
Storage node
#2715: remove deprecated get_recovery_symbol endpoint, which has not been used for several months
Aggregator
#2687: Significant reduction in memory usage when reading blobs with strict consistency check.
#2676:
Includes a new endpoint /v1alpha/blobs/concat handling GET and POST methods. This endpoint streams the given blobs back as one concatenated response. This is an alpha endpoint and is not yet stable. We're looking for feedback!
#2724: introduce a new aggregator API to read byte ranges of a blob
Publisher
#2687: Significant reduction in memory usage and slight performance improvements when storing large blobs.
#2717: Reduce number of Sui RPC requests and slightly decrease upload latency.
CLI
#2687: Significant reduction in memory usage and slight performance improvements when storing blobs, computing the blob ID, and reading blobs with strict consistency check.
#2710:
Add optional static parameters n_shards and max_epochs_ahead to the client_config.yaml to reduce CLI start-up time. You can obtain the latest version of the config file at http://docs.wal.app/setup/client_config.yaml.
#2717: Reduce number of Sui RPC requests and decrease latency when storing blobs.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.38.3
Walrus v1.38.2
Testnet December 9, 2025 | GitHub
The Testnet build with major memory-usage reductions across the aggregator, publisher, and CLI and
reduced upload latency. Adds a byte-range read API and the alpha /v1alpha/blobs/concat endpoint
while removing the deprecated get_recovery_symbol endpoint.
Storage node
#2715: remove deprecated get_recovery_symbol endpoint, which has not been used for several months
Aggregator
#2687: Significant reduction in memory usage when reading blobs with strict consistency check.
#2676:
Includes a new endpoint /v1alpha/blobs/concat handling GET and POST methods. This endpoint streams the given blobs back as one concatenated response. This is an alpha endpoint and is not yet stable. We're looking for feedback!
#2724: introduce a new aggregator API to read byte ranges of a blob
Publisher
#2687: Significant reduction in memory usage and slight performance improvements when storing large blobs.
#2717: Reduce number of Sui RPC requests and slightly decrease upload latency.
CLI
#2687: Significant reduction in memory usage and slight performance improvements when storing blobs, computing the blob ID, and reading blobs with strict consistency check.
#2710:
Add optional static parameters n_shards and max_epochs_ahead to the client_config.yaml to reduce CLI start-up time. You can obtain the latest version of the config file at http://docs.wal.app/setup/client_config.yaml.
#2717: Reduce number of Sui RPC requests and decrease latency when storing blobs.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.38.2
Walrus v1.38.1
Testnet December 3, 2025 | GitHub
An earlier Testnet build of the memory-usage and latency improvements across the aggregator,
publisher, and CLI, alongside the new byte-range read API and alpha /v1alpha/blobs/concat
endpoint.
Storage node
#2715: remove deprecated get_recovery_symbol endpoint, which has not been used for several months
Aggregator
#2687: Significant reduction in memory usage when reading blobs with strict consistency check.
#2676:
Includes a new endpoint /v1alpha/blobs/concat handling GET and POST methods. This endpoint streams the given blobs back as one concatenated response. This is an alpha endpoint and is not yet stable. We're looking for feedback!
#2724: introduce a new aggregator API to read byte ranges of a blob
Publisher
#2687: Significant reduction in memory usage and slight performance improvements when storing large blobs.
#2717: Reduce number of Sui RPC requests and slightly decrease upload latency.
CLI
#2687: Significant reduction in memory usage and slight performance improvements when storing blobs, computing the blob ID, and reading blobs with strict consistency check.
#2710:
Add optional static parameters n_shards and max_epochs_ahead to the client_config.yaml to reduce CLI start-up time. You can obtain the latest version of the config file at http://docs.wal.app/setup/client_config.yaml.
#2717: Reduce number of Sui RPC requests and decrease latency when storing blobs.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.38.1
Walrus v1.37.0
Mainnet November 19, 2025 | GitHub
Changes the default consistency check on reads; the previous strict behavior can be restored with
the strict_consistency_check=true query option or the --strict-consistency-check CLI flag.
Aggregator
#2624:
Warning: The default consistency check changes slightly in this release (v1.37). The previous "strict" consistency check can be enabled by using the query option strict_consistency_check=true. See the encoding documentation for the details of the different consistency checks.
CLI
#2624:
Warning: The default consistency check changes slightly in this release (v1.37). The previous "strict" consistency check can be enabled by using the CLI option --strict-consistency-check. See the encoding documentation for the details of the different consistency checks.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.37.0
Walrus v1.36.1
Mainnet November 7, 2025 | GitHub
Adds a skip_consistency_check option (and --skip-consistency-check CLI flag) for use only with
trusted writers, and trims server_address and server_port labels from request-duration metrics
for fast, successful responses.
Storage node
#2576:
The http_client_request_duration_* metrics now omit the server_address and server_port labels for fast, successful responses.
Aggregator
#2622:
Add a new query option skip_consistency_check=true to skip blob consistency checks. This should only be used if the writer of the corresponding blob is trusted. See the encoding documentation for the details of the different consistency checks.
#2576:
The http_client_request_duration_* metrics now omit the server_address and server_port labels for fast, successful responses.
Publisher
#2576:
The http_client_request_duration_* metrics now omit the server_address and server_port labels for fast, successful responses.
CLI
#2622:
Add a new CLI option --skip-consistency-check. to skip blob consistency checks. This should only be used if the writer of the corresponding blob is trusted. See the encoding documentation for the details of the different consistency checks.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.36.1
Walrus v1.35.2
Mainnet October 29, 2025 | GitHub
Brings the trusted-writer skip_consistency_check option and --skip-consistency-check CLI flag to
Mainnet, and removes server_address and server_port labels from metrics for fast, successful
responses.
Storage node
#2576:
The http_client_request_duration_* metrics now omit the server_address and server_port labels for fast, successful responses.
Aggregator
#2622:
Add a new query option skip_consistency_check=true to skip blob consistency checks. This should only be used if the writer of the corresponding blob is trusted. See the encoding documentation for the details of the different consistency checks.
#2576:
The http_client_request_duration_* metrics now omit the server_address and server_port labels for fast, successful responses.
Publisher
#2576:
The http_client_request_duration_* metrics now omit the server_address and server_port labels for fast, successful responses.
CLI
#2622:
Add a new CLI option --skip-consistency-check. to skip blob consistency checks. This should only be used if the writer of the corresponding blob is trusted. See the encoding documentation for the details of the different consistency checks.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.35.2
Walrus v1.35.1
Mainnet October 23, 2025 | GitHub
Delivers a major reduction in memory usage when reading large blobs and adds the sliver range to
store-quilt output. Note the warning that the default consistency check will change in v1.37.
Aggregator
#2549: Major reduction in memory usage for large blobs.
#2592:
Warning: The default consistency check will change slightly in v1.37. The current strict consistency check can be enabled by the new query option strict_consistency_check=true. See the encoding documentation for the details of the different consistency checks.
CLI
#2549: Major reduction in memory usage when reading large blobs.
#2561: Added range of slivers for store-quilt command in the output.
#2592:
Warning: The default consistency check will change slightly in v1.37. The current strict consistency check can be enabled by the new CLI option --strict-consistency-check. See the encoding documentation for the details of the different consistency checks.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.35.1
Walrus v1.35.0
Testnet October 16, 2025 | GitHub
The Testnet preview with a major reduction in memory usage for large blobs and sliver-range
information in store-quilt output, plus advance notice that the default consistency check changes
in v1.37.
Aggregator
#2549: Major reduction in memory usage for large blobs.
#2592:
Warning: The default consistency check will change slightly in v1.37. The current strict consistency check can be enabled by the new query option strict_consistency_check=true. See the encoding documentation for the details of the different consistency checks.
CLI
#2549: Major reduction in memory usage when reading large blobs.
#2561: Added range of slivers for store-quilt command in the output.
#2592:
Warning: The default consistency check will change slightly in v1.37. The current strict consistency check can be enabled by the new CLI option --strict-consistency-check. See the encoding documentation for the details of the different consistency checks.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.35.0
Walrus v1.34.2
Mainnet October 9, 2025 | GitHub
Adds an aggregator --max-blob-size option to cap the size of requestable blobs. Note the warning
that blobs are stored as deletable by default starting in v1.33; pass permanent=true to keep the
old behavior.
Aggregator
#2554:
Adds a --max-blob-size option to limit the size of blobs that can be requested through the aggregator.
Publisher
#2444:
Warning: Starting with this release (v1.33), blobs are stored as deletable by default; if you want to keep the previous behavior, you need to add the permanent=true query parameter.
CLI
#2444:
Warning: Starting with this release (v1.33), blobs are stored as deletable by default; if you want to keep the previous behavior, you need to add the --permanent option when storing blobs.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.34.2
Walrus v1.34.1
Testnet October 1, 2025 | GitHub
The Testnet build adding the aggregator --max-blob-size option, with a reminder that blobs become
deletable by default in v1.33 unless permanent=true is set.
Aggregator
#2554:
Adds a --max-blob-size option to limit the size of blobs that can be requested through the aggregator.
Publisher
#2444:
Warning: Starting with this release (v1.33), blobs are stored as deletable by default; if you want to keep the previous behavior, you need to add the permanent=true query parameter.
CLI
#2444:
Warning: Starting with this release (v1.33), blobs are stored as deletable by default; if you want to keep the previous behavior, you need to add the --permanent option when storing blobs.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.34.1
Walrus v1.33.3
Mainnet September 29, 2025 | GitHub
Adds the aggregator --max-blob-size option and marks the switch to deletable-by-default blobs;
pass permanent=true (or --permanent) to retain permanent storage.
Aggregator
#2554:
Adds a --max-blob-size option to limit the size of blobs that can be requested through the aggregator.
Publisher && CLI
#2523 & #2444:
Warning: Starting with this release (v1.33), blobs are stored as deletable by default; if you want to keep the previous behavior, you need to add the permanent=true query parameter.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.33.3
Walrus v1.33.2
Testnet September 25, 2025 | GitHub
Marks the Testnet switch to deletable-by-default blob storage; add permanent=true or the
--permanent CLI option to keep blobs permanent.
Publisher
#2523: Warning: Starting with this release (v1.33), blobs are stored as deletable by default; if you want to keep the previous behavior, you need to add the permanent=true query parameter.
CLI
#2523: Warning: Starting with this release (v1.33), blobs are stored as deletable by default; if you want to keep the previous behavior, you need to add the --permanent option when storing blobs.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.33.2
Walrus v1.33.1
Testnet September 17, 2025 | GitHub
An earlier Testnet build introducing deletable-by-default blob storage, with permanent=true or
--permanent available to preserve the previous behavior.
Publisher
#2523:
Warning: Starting with this release (v1.33), blobs are stored as deletable by default; if you want to keep the previous behavior, you need to add the permanent=true query parameter.
CLI
#2523:
Warning: Starting with this release (v1.33), blobs are stored as deletable by default; if you want to keep the previous behavior, you need to add the --permanent option when storing blobs.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.33.1
Walrus v1.32.0
Mainnet September 15, 2025 | GitHub
Adds an aggregator endpoint, /quilts/<quilt-id>/patches, that lists all patches contained in a
quilt.
Aggregator
#2405: Added new endpoint in aggregator: /quilts/<quilt-id>/patches to list all patches in a quilt.
CLI
#2427: Note: This change is an internal code quality improvement and does not affect user-facing functionality. No release notes are required as the changes do not impact the external API or user experience.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.32.0
Walrus v1.31.1
Mainnet August 28, 2025 | GitHub
An advance warning that blobs become deletable by default in v1.33; operators who want to keep
permanent storage should begin adding the permanent=true query parameter now.
Publisher & CLI
#2424:
Warning: In v1.33, blobs will be stored as deletable by default; if you want to keep the current behavior, you should already start to add the permanent=true query parameter.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.31.1
Walrus v1.30.1
Mainnet August 14, 2025 | GitHub
Storage nodes now restart on a TLS certificate update only when the certificate is near expiry or its subject or extensions have changed, and they emit warning and error logs for nearly expired certificates.
Storage node
#2360: When the TLS certificate is updated, only restart the node if the currently loaded certificate is about to expire or the subject or extensions have changed. Also, add warning and error logs for (almost) expired certificates.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.30.1
Walrus v1.30.0
Testnet August 6, 2025 | GitHub
The Testnet preview of smarter TLS certificate handling, where a node restarts only on meaningful certificate changes and logs warnings for nearly expired certificates.
Storage node
#2360: When the TLS certificate is updated, only restart the node if the currently loaded certificate is about to expire or the subject or extensions have changed. Also, add warning and error logs for (almost) expired certificates.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.30.0
Walrus v1.29.2
Mainnet July 31, 2025 | GitHub
Brings Quilt batch storage to Mainnet with new publisher, aggregator, and CLI support for storing
and reading quilts, plus an --upload-relay option. Also fixes startup issues with deleted event
databases and lets new nodes start beyond MAX_EPOCHS_AHEAD.
Storage node
#2273: Fixes an issue that can occur when a node starts with deleted events and event_blob_writer DBs.
#2193: New storage nodes can start in epochs later than MAX_EPOCHS_AHEAD (53 on the current Testnet and Mainnet) without any additional action.
#2290: Add a new configuration parameter for the event processor config to control the interval at which sampled logs are emitted, with a default of 1 hour (previously 30s).
Aggregator
- Added
/v1/blobs/by-quilt-patch-id/{quilt_patch_id}endpoint to read a blob from a quilt by itsQuiltPatchId - Added
/v1/blobs/by-quilt-id/{quilt_id}/{identifier}endpoint to read a blob from a quilt by itsquilt_id and identifier
Publisher
#2281: Add a permanent query parameter. Warning: In the future, blobs will be stored as deletable by default; to keep the current behavior, you need to add the permanent=true query parameter.
#2279: Added "/v1/quilts" publisher endpoint to store quilts.
CLI
- Added walrus store-quilt command, to store multiple blobs as a single Quilt to Walrus
- Added walrus read-quilt command to read one or more blobs in a Quilt from Walrus
- Added walrus list-patches-in-quilt to check the blobs in a quilt
#2151: use subsidies contract to proxy register blob call
#2281: Add a --permanent option to the store and store-quilt commands. Warning: In the future, blobs will be stored as deletable by default; to keep the current behavior, you need to add the --permanent option when storing blobs.
#2384: Add the --upload-relay option to the store and store-quilt commands to allow uploading to Walrus via an Upload Relay.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.29.2
Walrus v1.29.1
Testnet July 23, 2025 | GitHub
Introduces Quilt, a batch storage solution for storing and accessing many small files efficiently,
with new store-quilt, read-quilt, and quilt read endpoints across the CLI, publisher, and
aggregator. Also fixes deleted-event-database startup issues and relaxes the MAX_EPOCHS_AHEAD
constraint for new nodes.
📣📣📣 As part of this release we are introducing Quilt - a batch storage solution with an intuitive API, designed to make storing and accessing large numbers of small files on Walrus both incredibly convenient, efficient, and cost-effective. For more details please see https://www.walrus.xyz/blog/introducing-quilt.
Storage node
#2273: Fixes an issue that can occur when a node starts with deleted events and event_blob_writer DBs.
#2193: New storage nodes can start in epochs later than MAX_EPOCHS_AHEAD (53 on the current Testnet and Mainnet) without any additional action.
#2290: Add a new configuration parameter for the event processor config to control the interval at which sampled logs are emitted with a default of 1 hour (previously 30s).
Aggregator
- Added
/v1/blobs/by-quilt-patch-id/{quilt_patch_id}endpoint to read a blob from a quilt by itsQuiltPatchId - Added
/v1/blobs/by-quilt-id/{quilt_id}/{identifier}endpoint to read a blob from a quilt by itsquilt_id and identifier
Publisher
#2281: Add a permanent query parameter. Warning: In the future, blobs will be stored as deletable by default; to keep the current behavior, you need to add the permanent=true query parameter.
#2279: Added "/v1/quilts" publisher endpoint to store quilts.
CLI
- Added walrus store-quilt command, to store multiple blobs as a single Quilt to Walrus
- Added walrus read-quilt command to read one or more blobs in a Quilt from Walrus
- Added walrus list-patches-in-quilt to check the blobs in a quilt
#2151: Use subsidies contract to proxy register blob call
#2281: Add a --permanent option to the store and store-quilt commands. Warning: In the future, blobs will be stored as deletable by default; to keep the current behavior, you need to add the --permanent option when storing blobs.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.29.1
Walrus v1.28.4
Mainnet July 15, 2025 | GitHub
Fixes an issue where a blob could be reported as non-existent immediately after certification, affecting both the aggregator and the CLI.
Aggregator
#2205: Fixes an issue where a blob was sometimes reported as non-existing immediately after certification.
CLI
#2205: Fixes an issue where a blob was sometimes reported as non-existing immediately after certification.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.28.4
Walrus v1.28.3
Testnet July 11, 2025 | GitHub
Aggregator and CLI
#2205: Fixes an issue where a blob was sometimes reported as non-existent immediately after certification.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.28.3
Walrus v1.28.2
Testnet July 10, 2025 | GitHub
Aggregator
#2205: Fixes an issue where a blob was sometimes reported as non-existing immediately after certification.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.28.2
Walrus v1.28.1
Testnet July 2, 2025 | GitHub
Fixes a storage node startup problem with deleted events and event_blob_writer databases, along
with the post-certification blob existence reporting fix.
Storage node
#2274:
Fixes an issue that can occur when a node starts with deleted events and event_blob_writer DBs.
#2274:
Fixes an issue that can occur when a node starts with deleted events and event_blob_writer DBs.
#2274:
Fixes an issue that can occur when a node starts with deleted events and event_blob_writer DBs.
#2274:
Fixes an issue that can occur when a node starts with deleted events and event_blob_writer DBs.
#2274:
Fixes an issue that can occur when a node starts with deleted events and event_blob_writer DBs.
Aggregator
#2205: Fixes an issue where a blob was sometimes reported as non-existing immediately after certification.
CLI
#2205: Fixes an issue where a blob was sometimes reported as non-existing immediately after certification.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.28.1
Walrus v1.27.2
Mainnet June 26, 2025 | GitHub
Adds a CheckpointManager and a node admin socket for direct operator interaction with a running
node, and fixes a crash affecting recovering nodes after restart as well as a checkpoint-lag
miscalculation.
Storage node
- Added a
CheckpointManagercomponent, which provides- Periodic checkpoint of the main database
- Interface for manual checkpoint
- Introduced a
node admin socketso that operators can interact directly with a running node- Added Checkpoint commands in walrus-node command tool
#2179: Fixes an issue where recovering nodes crash after being restarted.
#2188: Fixes a bug in computing checkpoint lag that sometimes resulted in very high values.
CLI
#2140: Adds node-admin command to compute package digest
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.27.2
Walrus v1.27.1
Testnet June 18, 2025 | GitHub
The Testnet preview adding the CheckpointManager component and node admin socket, plus fixes for
recovering-node restart crashes and inflated checkpoint-lag values.
Storage node
- Added a
CheckpointManagercomponent, which provides- Periodic checkpoint of the main database
- Interface for manual checkpoint
- Introduced a
node admin socketso that operators can interact directly with a running node- Added Checkpoint commands in walrus-node command tool
#2179: Fixes an issue where recovering nodes crash after being restarted.
#2188: Fixes a bug in computing checkpoint lag that sometimes resulted in very high values.
CLI
#2140: Adds node-admin command to compute package digest
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.27.1
Walrus v1.26.4
Mainnet June 10, 2025 | GitHub
Adds multi-URL Sui RPC configuration via rpc_urls and removes the implicit fallback to the public
Testnet full node. Note the breaking change where metrics and REST API endpoints now bind to the
configured address rather than always to 0.0.0.0.
Storage node
#1630:
Use the metrics and REST API address from the configuration file instead of always binding to 0.0.0.0. Note that this bugfix may break some setups that relied on the previous incorrect behavior. To get the old behavior, set the metrics_address and rest_api_address to 0.0.0.0:<port> explicitly.
#2072:
Increase default value of http2_max_pending_accept_reset_streams parameter to disable warnings from the h2 crate.
#2067: Reduce verbosity levels of problems with metrics and config sync from ERROR to WARN.
#2182: Fixes an issue where recovering nodes crash after being restarted.
Aggregator
#2066: Allow specifying Sui RPC URL in the configuration file in addition to the CLI option.
#1630:
Use the metrics address specified through the CLI options file instead of always binding to 0.0.0.0. Note that this bugfix may break some setups that relied on the previous incorrect behavior. To get the old behavior, use --metrics-address 0.0.0.0:<port> when starting the aggregator.
Publisher
#1630:
Use the metrics address specified through the CLI options file instead of always binding to 0.0.0.0. Note that this bugfix may break some setups that relied on the previous incorrect behavior. To get the old behavior, use --metrics-address 0.0.0.0:<port> when starting the aggregator.
CLI
#2066:
Add a new rpc_urls field to the client config, which allows setting multiple Sui RPC URLs. The Sui RPC URL(s) used for reads are now selected in the following order: (1) CLI argument, (2) client configuration file, (3) wallet config. If none of these are set, the client will no longer fall back to the fullnode.testnet.sui.io but instead exit with an error.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.26.4
Walrus v1.26.3
Mainnet June 5, 2025 | GitHub
Rate-limits concurrent blob recovery during node recovery and adds multi-URL Sui RPC configuration.
Includes the breaking change where services bind to the configured address instead of always to
0.0.0.0.
Storage node
#2159: feat: rate limit concurrent blob recovery during node recovery
#1630: Use the metrics and REST API address from the configuration file instead of always binding to 0.0.0.0. Note that this bugfix may break some setups that relied on the previous incorrect behavior. To get the old behavior, set the metrics_address and rest_api_address to 0.0.0.0:<port> explicitly.
#2072: Increase default value of http2_max_pending_accept_reset_streams parameter to disable warnings from the h2 crate.
#2067: Reduce verbosity levels of problems with metrics and config sync from ERROR to WARN.
Aggregator
#2066: Allow specifying Sui RPC URL in the configuration file in addition to the CLI option.
#1630: Use the metrics address specified through the CLI options file instead of always binding to 0.0.0.0. Note that this bugfix may break some setups that relied on the previous incorrect behavior. To get the old behavior, use --metrics-address 0.0.0.0:<port> when starting the aggregator.
Publisher
#1630: Use the metrics address specified through the CLI options file instead of always binding to 0.0.0.0. Note that this bugfix may break some setups that relied on the previous incorrect behavior. To get the old behavior, use --metrics-address 0.0.0.0:<port> when starting the aggregator.
CLI
#2066: Add a new rpc_urls field to the client config, which allows setting multiple Sui RPC URLs. The Sui RPC URL(s) used for reads are now selected in the following order: (1) CLI argument, (2) client configuration file, (3) wallet config. If none of these are set, the client will no longer fall back to the fullnode.testnet.sui.io but instead exit with an error.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.26.3
Walrus v1.26.2
Testnet May 28, 2025 | GitHub
The Testnet build introducing multi-URL Sui RPC configuration and the breaking change where metrics
and REST API endpoints bind to the configured address rather than always to 0.0.0.0.
Storage node
#1630:
Use the metrics and REST API address from the configuration file instead of always binding to 0.0.0.0. Note that this bugfix may break some setups that relied on the previous incorrect behavior. To get the old behavior, set the metrics_address and rest_api_address to 0.0.0.0:<port> explicitly.
#2072:
Increase default value of http2_max_pending_accept_reset_streams parameter to disable warnings from the h2 crate.
#2067: Reduce verbosity levels of problems with metrics and config sync from ERROR to WARN.
Aggregator
#2066: Allow specifying Sui RPC URL in the configuration file in addition to the CLI option.
#1630:
Use the metrics address specified through the CLI options file instead of always binding to 0.0.0.0. Note that this bugfix may break some setups that relied on the previous incorrect behavior. To get the old behavior, use --metrics-address 0.0.0.0:<port> when starting the aggregator.
Publisher
#1630:
Use the metrics address specified through the CLI options file instead of always binding to 0.0.0.0. Note that this bugfix may break some setups that relied on the previous incorrect behavior. To get the old behavior, use --metrics-address 0.0.0.0:<port> when starting the aggregator.
CLI
#2066:
Add a new rpc_urls field to the client config, which allows setting multiple Sui RPC URLs. The Sui RPC URL(s) used for reads are now selected in the following order: (1) CLI argument, (2) client configuration file, (3) wallet config. If none of these are set, the client will no longer fall back to the fullnode.testnet.sui.io but instead exit with an error.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.26.2
Walrus v1.25.1
Mainnet May 22, 2025 | GitHub
A bug fix adding options to tune compaction write throttling and setting a high write-stalling threshold on the metadata table.
Bug Fix
#2121: add options to update compaction write throttling, and set high write stalling threshold in metadata table
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.25.1
Walrus v1.25.0
Mainnet May 22, 2025 | GitHub
Speeds up batch blob operations by optimizing storage selection, with no change to the user workflow.
CLI
#2010: Improved performance for batch blob operations by optimizing storage selection. Operations with multiple blobs are now significantly faster with no change to the user workflow.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.25.0
Walrus v1.24.2
Mainnet May 12, 2025 | GitHub
Adds a publisher force store option and a CLI completion command, and substantially reduces SUI
gas costs when registering multiple blobs at once.
Aggregator
#2005: Improved documentation for shared blob retrieval.
Publisher
#2015: Adds the possibility to force a store operation, like with the CLI.
CLI
#2004: Major reduction of SUI gas cost when registering multiple blobs simultaneously.
#2003: Add new completion command to generate completion scripts for various shells.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.24.2
Walrus v1.24.1
Testnet May 6, 2025 | GitHub
The Testnet preview adding a publisher force store option and CLI completion command, with a
major SUI gas reduction for registering multiple blobs simultaneously.
Aggregator
#2005: Improved documentation for shared blob retrieval.
Publisher
#2015: Adds the possibility to force a store operation, like with the CLI.
CLI
#2004: Major reduction of SUI gas cost when registering multiple blobs simultaneously.
#2003: Add new completion command to generate completion scripts for various shells.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.24.1
Walrus v1.22.1
Mainnet April 25, 2025 | GitHub
Reduces SUI gas costs for simultaneous blob registration, surfaces storage node checkpoint progress
in the health command, and fixes default-location Sui wallet creation. Operators must remove the
experimental_batch_symbol_recovery config field.
Storage node
#1976: Remove the experimental_batch_symbol_recovery config variable; operators must ensure that the field is not present in their configs.
CLI
#1973: Fetch the checkpoint progress info for storage nodes, in the health command.
#1943: Fix a bug that prevented the creation of a Sui wallet at the default location through walrus generate-sui-wallet.
#2008: Major reduction of SUI gas cost when registering multiple blobs simultaneously.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.22.1
Walrus v1.21.2
Mainnet April 17, 2025 | GitHub
Storage node
#1934: Optimized default parameters for shard transfer and recovery.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.21.2
Walrus v1.21.1
Testnet April 15, 2025 | GitHub
Storage node
#1934: Optimized default parameters for shard transfer and recovery.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.21.1
Walrus v1.20.2
Mainnet April 10, 2025 | GitHub
Adds the latest checkpoint sequence number and an estimated checkpoint lag to the CLI health
output.
CLI
#1805: Added Latest checkpoint sequence number and Estimated checkpoint lag in health output.
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.20.2
Walrus v1.18.2
Mainnet March 25, 2025 | GitHub
Adds TLS certificate monitoring with automatic reboot, new --network-key-path and
--certificate-path setup options, and a configurable checkpoint request timeout. The publisher's
JWT token now includes a size field.
Storage node
#1703: Storage node monitors TLS certificate and reboots storage node upon changes.
#1715: Added optional --network-key-path and --certificate-path options to the setup command, removed --use-legacy-event-provider and --disable-event-blob-writer. Adjusted defaults for storage prices and commission rates.
#1793: Adds a configurable timeout to checkpoint requests.
Publisher
#1613: Add size field of JWTToken
Full Log: https://github.com/MystenLabs/walrus/commits/mainnet-v1.18.2
Walrus v1.18.1
Testnet March 20, 2025 | GitHub
The Testnet preview of TLS certificate monitoring with automatic reboot and the new key and
certificate setup options, plus the publisher JWT token size field.
Storage node
#1703: Storage node monitors TLS certificate and reboots storage node upon changes.
#1715: Added optional --network-key-path and --certificate-path options to the setup command, removed --use-legacy-event-provider and --disable-event-blob-writer. Adjusted defaults for storage prices and commission rate.
Publisher
#1613: Add size field of JWTToken
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.18.1
Walrus v1.17.2
Testnet March 15, 2025 | GitHub
Adds --network-key-path and --certificate-path options to the setup command, removes legacy
event-provider flags, and adjusts default storage prices and commission rates.
Storage node
#1717:
Added optional --network-key-path and --certificate-path options to the setup command, removed --use-legacy-event-provider and --disable-event-blob-writer. Adjusted defaults for storage prices and commission rate.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.17.2
Walrus v1.17.1
Testnet March 12, 2025 | GitHub
CLI
#1685: Fixes a bug where an explicitly set wallet path through the --wallet CLI option was ignored.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.17.1
Walrus v1.16.1
Testnet March 5, 2025 | GitHub
Lets the CLI delete command accept multiple files, blob IDs, or object IDs (a breaking change to
the delete JSON API) and adds multi-context configuration with a --context override. The publisher
now keeps created Blob objects by default, replacing --keep with --burn-after-store.
Storage node
#1592: Enabling updating storage node metadata via local storage node config file.
#1640: Fixes a bug in the blob info tracking, where the initial certified epoch was not updated correctly.
Publisher
#1628:
Changes the default post-store behavior of the publisher to keeping the created Blob objects in the main publisher wallet, instead of burning them immediately. Replaces the --keep flag with a --burn-after-store flag.
CLI
#1644:
Allow passing multiple files/blob IDs/object IDs to the walrus delete command.
There is a breaking change for the delete json API,
The current syntax is:
{
"command": {
"delete": {
"file": [...],
"blobId": [...],
"objectId": [...],
"yes": true,
"noStatusCheck": false,
}
}
}
While one previous example could be:
{
"command": {
"delete": {
"file": "/path/to/file.txt",
"blobId": "VWr-EVsFCJCl1mdPM8cBZ_c4LkRcpUbmRxjGpiEPQ3w",
"yes": true,
"noStatusCheck": false
}
}
}
#1532: support has been introduced for multiple contexts, and a default_context for walrus client invocations. Context can be overriden with the new --context <context> argument.
Here is an example (with some fake addresses) multi-context config file.
---
contexts:
testnet:
system_object: 0x98ebc47370603fe81d9e15491b2f1443d619d1dab720d586e429ed233e1255c1
staking_object: 0x20266a17b4f1a216727f3eef5772f8d486a9e3b5e319af80a5b75809c035561d
exchange_objects:
- 0x59ab926eb0d94d0d6d6139f11094ea7861914ad2ecffc7411529c60019133997
- 0x89127f53890840ab6c52fca96b4a5cf853d7de52318d236807ad733f976eef7b
- 0x9f9b4f113862e8b1a3591d7955fadd7c52ecc07cf24be9e3492ce56eb8087805
- 0xb60118f86ecb38ec79e74586f1bb184939640911ee1d63a84138d080632ee28a
wallet_config:
path: ~/.sui/sui_config/client.yaml
active_env: testnet
devnet:
system_object: 0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
staking_object: 0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb
exchange_objects:
- 0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
- 0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd
- 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
- 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
wallet_config:
path: ~/.sui/sui_config/client.yaml
active_env: devnet
default_context: testnet
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.16.1
Walrus v1.15.4
Testnet February 28, 2025 | GitHub
Fixes an issue where keys were not loaded into memory when on-chain config parameters were updated, and makes the publisher use the correct default encoding type.
Storage node
#1655: Fix an issue where keys were not properly loaded into memory when updating on-chain config parameters.
Publisher
#1655: Use the correct encoding type by default.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.15.4
Walrus v1.15.3
Testnet February 27, 2025 | GitHub
Adds support for multiple encoding types across the storage node, publisher, and CLI, and lets the
aggregator return allow-listed blob attributes as response headers. Storage nodes can now
auto-reload configuration changes from disk, and the CLI gains --sort-by and --desc options for
health and info.
Storage node
#1548: Automatically reload the StorageNodeConfig from disk and update the on-chain configuration when changes are detected. Some changes may result in an automatic restart of the storage nodes.
#1608: Storage node now supports multiple encoding types. Depending on features selected at compile time, it accepts a subset of them.
Aggregator
#1591: Exposed the aggregator endpoint to allow fetching blobs with associated attributes; if the attribute fields are in the allow-list, they will be included in the response headers. The current allow-list is:
- "content-disposition"
- "content-encoding"
- "content-language"
- "content-location"
- "content-type"
- "link"
Publisher
#1608: Added encoding_type query parameter. Added additional variants for the encoding type.
CLI
#1591: Added the allowed-headers option for daemon commands, allowing operators to specify custom allowed headers to filter key-value pairs from the blob attribute.
#1594: Added --sort-by and --desc options for walrus health and walrus info commands, to sort the storage nodes by node-id, node-name, node-status, or node-url.
#1606: Fix walrus store behavior when blobs can be extended.
#1608: The CLI supports multiple encoding types for reads and writes. Depending on features selected at compile time, it uses a different default type and accepts a subset of them for writes.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.16.0
Walrus v1.14.0
Testnet February 19, 2025 | GitHub
Enables batch symbol recovery by default and adds CLI commands to set, get, and remove blob
attributes. The walrus store command now extends the lifetime of matching owned blobs instead of
re-registering them.
Storage node
#1568: The new batch symbol recovery is enabled by default.
CLI
#1546: Added the following new commands for blob attribute:
walrus set-blob-attribute <BLOB_OBJ_ID>walrus get-blob-attribute [OPTIONS] <BLOB_OBJ_ID>walrus remove-blob-attribute-fields [OPTIONS] <BLOB_OBJ_ID>walrus remove-blob-attribute [OPTIONS] <BLOB_OBJ_ID>
#1535: The walrus store command now checks for matching owned Blob objects and extends their lifetime if necessary instead of registering the blob again.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.14.0
Walrus v1.13.2
Testnet February 13, 2025 | GitHub
Fixes the blob-certified metric so it updates only for event blobs and makes the publisher retry when a refresh fails.
#1576: fix: Update blob certified metric only if it is event blob
#1575: fix(publisher): retry if refresh fails
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.13.2
Walrus v1.13.1
Testnet February 12, 2025 | GitHub
Reworks TLS configuration by removing the tls.pem_files block in favor of tls.certificate_path
and network_key_pair.path, and enables automatic rotation of the protocol key pair. Adds a CLI
--ignore-resources flag.
Storage node
#1509:
The config block tls.pem_files has been removed. Provide a TLS certificate path by the tls.certificate_path config argument, and the PKCS#8 PEM-encoded TLS private using network_key_pair.path.
#1461:
Storage nodes automatically update and rotate the protocol key pair. This only requires setting the next_protocol_key_pair in the config file.
CLI
#1551:
introduces the --ignore-resources flag.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.13.1
Walrus v1.12.0
Testnet February 6, 2025 | GitHub
Lets the walrus health command accept a list of node IDs or URLs; this is a breaking change for
JSON mode, where nodeId and nodeUrl become nodeIds and nodeUrls.
CLI
#1486:
Adds the ability to provide a list of node IDs or URLs for the walrus health command. This is a breaking change for the JSON mode because nodeId and nodeUrl are changed to nodeIds and nodeUrls, respectively. The "normal" CLI is backwards-compatible because --node-id and --node-url are set as aliases for the new options.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.12.0
Walrus v1.11.0
Testnet January 29, 2025 | GitHub
Adds a CLI health command and the ability to extend owned blobs with WAL, and lets storage node
operators change several config parameters by editing the local file and restarting. Deprecates the
recovery symbol endpoint in favor of a new one.
Storage node
#1455: -- Added the feature to change storage node config parameter as following, by changing the local config file and restart node.
#1463:
Allow setting the metrics push configuration directly in the walrus-node setup command.
#1476:
Correctly set walrus_current_node_status metric during startup.
#1456: Deprecate the recovery symbol endpoint in favour of a new endpoint. Integrations using recovery symbols should migrate to the new endpoint.
CLI
#1406: Add option to extend owned blobs with WAL
#1398:
adds the health command to the CLI.
#1428:
Add --earliest-expiry-time to store command so a unix timestamp in ms can be specified. Show human readable time in GMT for estimated expiry time in blob-status command.
#1474:
Allow specifying 'global' options like --json anywhere in the command, for example walrus info --json.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.11.0
Walrus v1.10.0
Testnet January 23, 2025 | GitHub
Makes storage node error responses machine-readable, adds error statuses and richer OpenAPI schemas
to the aggregator and publisher, and introduces an optional JWT auth layer for the publisher. Also
adds a walrus-backup entrypoint and several CLI fixes and options, including staking with multiple
nodes.
Storage node
#1407: Update error responses returned by storage nodes to be machine-readable and contain more details
Aggregator
#1407: Add error statuses to the responses of failed requests; update endpoint URLs; and add more detailed OpenAPI schemas.
Publisher
#1407: Add error statuses to the responses of failed requests; update endpoint URLs; and add more detailed OpenAPI schemas.
#1345: Add optional JWT auth layer for the publisher
CLI
#1402: This fixes the cost computation for the store --dry-run command.
#1404: Allows staking with multiple nodes simultaneously.
#1421: Fix serialization of JSON output for the walrus store command.
#1425: Adds the option to specify max as the number of epochs.
#1388: changes to the syntax and output of the info command
Backup node
#1397: an entrypoint called walrus-backup will now be included in the build process. It has minimal (tailing Walrus-related Sui events) functionality at this point.
Full Log: https://github.com/MystenLabs/walrus/commits/testnet-v1.10.0
- MCP
- TypeScript SDK
- Python SDK
- OpenClaw
Walrus Memory MCP v0.0.5
June 12, 2026 | GitHub
Adds the automatic memory plugin for Claude Code, Codex, Cursor, and Antigravity, along with new
memwal_remember_bulk and memwal_health tools and proactive memory behavior. Also fixes the
plugin bundle so it ships .mcp.json correctly.
0.0.5
Added
- Automatic memory plugin for Claude Code, Codex, Cursor, and Antigravity.
- New
memwal_remember_bulkandmemwal_healthtools.
Fixed
- Ship the plugin's
.mcp.jsonin the marketplace bundle. A root gitignore rule excluded it, so plugin installs loaded the lifecycle hooks but never registered the MCP server.
Changed
- Memory tools are now proactive — agents recall and save context on their own.
Fixed
- Plugin bundle now ships its
.mcp.jsonso the MCP server registers on install. - Automatically recover from dropped relayer connections that could hang tool calls.
Walrus Memory MCP v0.0.4
June 5, 2026 | GitHub
Fixes HTTPS dashboard sign-in callbacks and credential reload after login so tools work without restarting the MCP client.
0.0.4
Fixed
- Accept HTTPS dashboard sign-in callbacks to the local
127.0.0.1MCP listener. - Reload credentials after
memwal_loginso memory tools work without restarting the MCP client.
Walrus Memory MCP v0.0.3
June 4, 2026 | GitHub
Rebrands package metadata from MemWal to Walrus Memory throughout the MCP server.
0.0.3
Changed
- Rebranded package metadata and documentation from MemWal to Walrus Memory.
Walrus Memory MCP v0.0.2
May 25, 2026 | GitHub
Adds relayer compatibility checks and rebrands from MemWal to Walrus Memory across the MCP server package.
0.0.2
Added
- Added relayer compatibility metadata checks before opening the MCP bridge.
Changed
- Rebranded package metadata and documentation from MemWal to Walrus Memory.
Walrus Memory MCP v0.0.1
May 15, 2026 | GitHub
Initial release of the MCP server with stdio transport, browser wallet login, and inline session tools. Includes memory tools for remember, recall, analyze, and restore.
0.0.1
Initial Release
- Stdio MCP server for MemWal with browser-based wallet login.
- Inline
memwal_loginandmemwal_logoutsession tools. - Memory tools for remember, recall, analyze, and restore through the MemWal relayer.
- Environment presets for production, dev, staging, and local relayers.
Walrus Memory TypeScript SDK v0.0.7
June 2, 2026 | GitHub
Adds an optional occurredAt parameter to analyze() for temporal anchoring of extracted facts.
Relative date references are now resolved into absolute dates.
0.0.7
Patch Changes
-
#218
333d327Thanks @hungtranphamminh! - Add optionaloccurredAttoanalyze()andanalyzeAndWait()for temporal anchoring of extracted facts.- New
AnalyzeOptionsoverload:analyze(text, { namespace, occurredAt })acceptsDateor RFC-3339 string. The legacyanalyze(text, namespace?)signature still works unchanged. - When
occurredAtis supplied, the server resolves in-turn relative references ("last Friday", "yesterday") into absolute dates inside the extracted fact text before embedding and encryption. - Wire format is RFC-3339 UTC with millisecond precision (e.g.
"2023-05-25T17:50:00.000Z"). - Invalid
Dateinstances (constructed from malformed input) now throw a diagnosticTypeErrorfrom the SDK rather than an opaqueRangeErrorfromtoISOString(). - Field is omitted from the request body when not supplied — existing callers see byte-identical wire payloads.
- New
Walrus Memory TypeScript SDK v0.0.6
May 28, 2026 | GitHub
Adds RecallParams for object-style recall calls and deprecates the positional recall overload.
Also documents restore() response fields.
0.0.6
Added
- Added
RecallParamsfor object-stylerecall(...)calls.
Changed
- Marked the positional
recall(...)overload as deprecated in favor ofrecall({ query, limit, namespace }). - Documented
restore()response fields, default limit, pagination behavior, and performance expectations.
Walrus Memory TypeScript SDK v0.0.5
May 25, 2026 | GitHub
Adds relayer compatibility checks, RecallOptions for topK/namespace/maxDistance filtering,
and prefers Sui gRPC for SEAL sessions. This release also rebrands from MemWal to Walrus Memory.
0.0.5
Added
- Added relayer compatibility metadata checks before protected requests.
- Added
compatibility()and exported compatibility types/errors so callers can inspect SDK/relayer support explicitly. - Added
RecallOptionsfortopK, namespace override, andmaxDistance.
Changed
- Prefer Sui gRPC for SEAL sessions, with JSON-RPC fallback.
- Updated docs/examples for
MEMWAL_PRIVATE_KEYand hosted relayer defaults. - Rebranded package metadata and documentation from MemWal to Walrus Memory.
Fixed
- Made
401relayer errors more actionable.
Walrus Memory TypeScript SDK v0.0.4
May 15, 2026 | GitHub
Adds getRememberStatus for polling async job state and SealServerConfig for manual SEAL
configuration. Manual mode validates API key pairs.
0.0.4
Added
- Added
getRememberStatus(jobId)so clients can poll and display the full async remember state machine. - Added
SealServerConfigandsealServerConfigsfor manual-mode SEAL committee aggregator configuration.
Changed
- Manual mode now normalizes full SEAL server configs, validates optional API key pairs, and caps the default threshold to configured server weight.
- Manual mode keeps testnet defaults on the legacy independent key servers for compatibility with hosted testnet relayer data.
Walrus Memory TypeScript SDK v0.0.3
May 8, 2026 | GitHub
Updates remember() for the async relayer flow and introduces rememberAsync,
waitForRememberJob, rememberAndWait, and bulk remember helpers. Also adds async analysis with
analyzeAndWait.
0.0.3
Changed
- Updated
remember()for the relayer's async/api/rememberflow. It now returns the accepted job payload immediately. - Added
rememberAsync(),waitForRememberJob(), andrememberAndWait()for callers that need the finalblob_id. - Added bulk remember helpers:
rememberBulk(),rememberBulkAsync(),waitForRememberJobs(), andrememberBulkAndWait(). - Updated
analyze()for async fact storage and addedanalyzeAndWait().
Compatibility
recall()andrestore()remain wire-compatible with the existing relayer responses.- The SDK continues to use
x-seal-sessionfor relayer-mode decrypt credentials.
Walrus Memory TypeScript SDK v0.0.2
April 30, 2026 | GitHub
Adds per-request nonce signing to block replay attacks and replaces delegate key transport with ephemeral SEAL sessions. SDK versions that do not include a nonce are rejected with HTTP 426.
0.0.2
Security
- Added per-request
x-noncesigning to block replay within the timestamp window. - Added
x-account-idto the canonical signed message so account hints cannot be rebound in transit. - Replaced relayer-mode
x-delegate-keytransport with ephemeralx-seal-session; manual-mode requests no longer send delegate private key material. - SDK versions that do not send
x-nonceare no longer supported by the server and receive426 Upgrade Required.
Walrus Memory python v0.1.4
June 2, 2026 | GitHub
A patch release for the Walrus Memory Python SDK.
Release memwal Python SDK v0.1.4
Walrus Memory python v0.1.3
May 28, 2026 | GitHub
A patch release for the Walrus Memory Python SDK.
Release memwal Python SDK v0.1.3
Walrus Memory python v0.1.2
May 25, 2026 | GitHub
A patch release for the Walrus Memory Python SDK.
Release memwal Python SDK v0.1.2
Walrus Memory python v0.1.0
May 21, 2026 | GitHub
Initial release of the Walrus Memory Python SDK.
Release memwal Python SDK v0.1.0
Walrus Memory SDK v0.0.5
June 15, 2026 | GitHub
Fixes a workspace dependency that broke npm installs outside the monorepo and switches the release workflow to pnpm publish.
0.0.5
Patch Changes
- Fix unresolvable
workspace:*dependency in the published package. The release workflow usednpm publish, which shipspackage.jsonverbatim and cannot rewrite theworkspace:protocol, so the published artifact carried"@mysten-incubation/memwal": "workspace:*"and failed to install outside the monorepo (Unsupported URL Type 'workspace:'). Switched the release workflows topnpm publish, which rewritesworkspace:*to the concrete dependency version at pack time.
Walrus Memory SDK v0.0.4
June 2, 2026 | GitHub
Adds temporal anchoring through occurredAt to the memory_store tool. The auto-capture hook now
passes the current timestamp, and the SDK is bumped for the new AnalyzeOptions.
0.0.4
Patch Changes
-
#218
333d327Thanks @hungtranphamminh! - Wire temporal anchoring through the agent-side memory tools.Added
memory_storetool now accepts an optionaloccurredAtargument (RFC-3339 / ISO-8601 string) so agents can anchor recounted past events to the date they actually occurred. Description tells the LLM to omit it when unknown rather than guess.
Changed
- Auto-capture hook (
agent_end) now passesnew Date()asoccurredAttoanalyze(). Every captured conversation now gets temporal anchoring automatically — the server extractor resolves in-turn relative references ("yesterday", "last Friday") into absolute dates inside the stored fact text. Facts captured by this version now carry resolved dates. - SDK dependency bumped from published
^0.0.2toworkspace:*to consume the newAnalyzeOptionssignature.
-
Updated dependencies [
333d327]:- @mysten-incubation/memwal@0.0.7
Walrus Memory SDK v0.0.3
May 25, 2026 | GitHub
Rebrands from MemWal to Walrus Memory across the OpenClaw memory plugin.
0.0.3
Patch Changes
- Rebrand package metadata and documentation from MemWal to Walrus Memory.
Walrus Memory SDK v0.0.2
April 30, 2026 | GitHub
Initial release of the OpenClaw memory plugin with automatic recall and capture hooks, session summary, CLI commands, and LLM tools.
0.0.1
Initial Release
- NemoClaw/OpenClaw memory plugin powered by MemWal
- Automatic memory recall via
before_prompt_buildhook - Automatic fact capture via
agent_endhook - Session summary on
before_resethook - CLI commands:
openclaw memwal stats,openclaw memwal search - LLM tools:
memory_search,memory_store