New updates and improvements at Walrus
The portal gains a glob-based route/redirect matcher behind a flag (first step of the routing migration), and the site-builder migrates off JSON-RPC-only client methods ahead of the JSON-RPC deprecation.
The portal now talks to Sui over gRPC instead of JSON-RPC, in preparation for the JSON-RPC deprecation.
A maintenance release on Testnet with no user-facing changes documented in the release notes; see the full commit log for internal updates.
View on GitHub →Fixes a workspace dependency that broke npm installs outside the monorepo and switches the release workflow to pnpm publish.
View on 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.
View on GitHub →Fixes HTTPS dashboard sign-in callbacks and credential reload after login so tools work without restarting the MCP client.
View on GitHub →Portal aggregator timing rework: a per-attempt fetch timeout plus a Bun `idleTimeout` sized from the worst-case retry budget close the gap where a slow aggregator could trip the inbound connection mid-flight and surface a generic upstream proxy error instead of the portal's own `aggregatorFail()` page. Sui and Walrus deps bumped to their current testnet releases. No Move contract changes. > ℹ️ **Portal operators**: each aggregator attempt is now bounded at 10s and fails over to the next URL; Bun's `idleTimeout` is sized from the full retry chain so the portal can return its own response. Tune via `AGGREGATOR_REQUEST_TIMEOUT_MS` (default `10000`) and `PORTAL_IDLE_TIMEOUT_MAX_S` (default `100`); resolved values logged at startup.
Rebrands package metadata from MemWal to Walrus Memory throughout the MCP server.
View on 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`.
A patch release for the Walrus Memory Python SDK.
View on GitHub →Adds an optional `occurredAt` parameter to `analyze()` for temporal anchoring of extracted facts. Relative date references are now resolved into absolute dates.
Adds `RecallParams` for object-style recall calls and deprecates the positional recall overload. Also documents `restore()` response fields.
View on GitHub →A patch release for the Walrus Memory Python SDK.
View on GitHub →A maintenance release on Mainnet with no user-facing changes documented in the release notes; see the full commit log for internal updates.
View on GitHub →Rebrands from MemWal to Walrus Memory across the OpenClaw memory plugin.
View on GitHub →Adds relayer compatibility checks and rebrands from MemWal to Walrus Memory across the MCP server package.
View on 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.
View on GitHub →A patch release for the Walrus Memory Python SDK.
View on GitHub →Patch release with a portal SuiNS resolution fix and a site-builder dependency bump. No new features, no breaking changes, and no Move contract changes.
Initial release of the Walrus Memory Python SDK.
View on GitHub →Adds `getRememberStatus` for polling async job state and `SealServerConfig` for manual SEAL configuration. Manual mode validates API key pairs.
View on 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.
View on GitHub →A maintenance release on Mainnet with no user-facing changes documented in the release notes; see the full commit log for internal updates.
View on GitHub →Updates `remember()` for the async relayer flow and introduces `rememberAsync`, `waitForRememberJob`, `rememberAndWait`, and bulk remember helpers. Also adds async analysis with `analyzeAndWait`.
View on GitHub →Patch release with portal observability and configuration fixes, plus dependency bumps and CI hardening. No new features, no breaking changes, and no Move contract changes. > ℹ️ **walrus-upgrade**: drop `walrus_package` from your `sites-config.yaml` (to auto-resolve), or update it to the latest package id from the Walrus `staking_object` in `~/.config/walrus/client_config.yaml`.
Initial release of the OpenClaw memory plugin with automatic recall and capture hooks, session summary, CLI commands, and LLM tools.
View on 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.
View on 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.
Site builder performance and reliability improvements: resource dynamic field fetching now uses a single batched `multi_get` call instead of chunked per-resource queries with inter-batch delays, and the `sitemap` subcommand correctly respects the active wallet environment instead of whichever env happened to be listed first in the config.
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.
Adds a `reuse_resources` query parameter so the publisher and daemon can resume an existing, unfinished upload pipeline instead of starting over.
This release adds server-side redirect support to Walrus Sites. Redirect rules are stored as dynamic fields on the on-chain `Site` object, configurable via `ws-resources.json` with glob pattern matching. The portal evaluates redirects before resource fetching and serves 3xx response. **This release includes a Move contract upgrade** — the `walrus_site` package is upgraded to add redirect storage on-chain. To use the new redirects feature, update the `package_id` in your `sites-config.yaml` to point to the latest package ID, or remove the `package_id` field entirely so that MVR can resolve it automatically. **Portal config change:** `site_package` has been renamed to `original_package_id` as this is what actually matters of it. The portal has also been updated to Mysten SDK v2.
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.
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.
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.
Site builder reliability improvements: large sites (500+ routes/resources) no longer fail with `InsufficientGas` errors due to PTB byte-size overflow, and Site deploying is more resilient to transient Sui object version conflicts with automatic retry and exponential backoff.
Allows storage nodes to vote on pricing denominated in USD, a capability that becomes usable once the contract adds support for it.
The portal configuration is now loaded from a YAML file instead of environment variables. Env vars can still be used as overrides. This simplifies deployment (single ConfigMap vs many env vars) and enables structured configuration (URL arrays with priority/retries are native YAML lists instead of pipe-delimited strings).
A maintenance release on Mainnet with no user-facing changes documented in the release notes; see the full commit log for internal updates.
View on 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.
Requires Walrus CLI v1.37.0 or later
The Testnet preview enabling garbage collection by default and introducing the alpha `/v1alpha/blobs/{blob_id}/stream` endpoint for lower-latency blob streaming.
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.
This release introduces an optimization for site updates: files that remain unchanged during an update are no longer re-uploaded into new Quilts. Only new and modified files are uploaded.
Storage node operators must remove the obsolete `use_legacy_event_provider` flag from their configuration if it is still present.
View on 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.
View on 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.
View on GitHub →This is a bugfix release for the Portal component and does not impact Site Builder.
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.
View on 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.
View on GitHub →This major release transitions the `site-builder` CLI to exclusively use **Quilts** for site data
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.
View on GitHub →Work for feature flag `quilts-experimental`. Mainly testing and bug-fixes.
View on 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.
View on 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.
View on 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.
View on 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.
View on 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.
View on 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.
View on GitHub →Marks the Testnet switch to deletable-by-default blob storage; add `permanent=true` or the `--permanent` CLI option to keep blobs permanent.
Further support of quilts under the `quilts-experimental` feature. > **Note** > Header and ignore-file matching in ws-resources.json, now uses **glob patterns** (e.g. `*.md`, `docs/**`) instead of regular expressions. > Regex support was never intentional, so if you were using advanced regex, please update your configs to glob style.([#556](https://github.com/MystenLabs/walrus-sites/pull/556)).
An earlier Testnet build introducing deletable-by-default blob storage, with `permanent=true` or `--permanent` available to preserve the previous behavior.
View on GitHub →Adds an aggregator endpoint, `/quilts/<quilt-id>/patches`, that lists all patches contained in a quilt.
This release introduces a new publishing and deployment method for Walrus Sites using [quilts](https://docs.wal.app/usage/quilt.html) instead of blobs. Multiple resources are now bundled as quilt patches on Walrus, significantly reducing the cost of site publishing. You can use this feature with: `site-builder publish-quilts --epochs=<EPOCHS> <YOUR-BUILD-DIR>`. > ⚠️ **Important note**: This feature is only available when building `site-builder` from source with `cargo build --features quilts-experimental`.
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.
View on 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.
The Testnet preview of smarter TLS certificate handling, where a node restarts only on meaningful certificate changes and logs warnings for nearly expired certificates.
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`.
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.
Fixes an issue where a blob could be reported as non-existent immediately after certification, affecting both the aggregator and the CLI.
View on GitHub →Fixes an issue where a blob was sometimes reported as non-existing immediately after certification.
View on GitHub →Fixes a storage node startup problem with deleted `events` and `event_blob_writer` databases, along with the post-certification blob existence reporting fix.
View on 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.
View on GitHub →The Testnet preview adding the `CheckpointManager` component and node admin socket, plus fixes for recovering-node restart crashes and inflated checkpoint-lag values.
View on GitHub →🚀 Welcome to the very first official release of Walrus Sites! This marks the production-ready milestone for the project. Starting with this release, each version will include all the necessary components for deploying (via the site-builder) and accessing (via the portals) your Walrus Sites. We are committed to following [semantic versioning](https://semver.org/) conventions for all future releases, ensuring clarity and consistency in version updates.
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`.
View on 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`.
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`.
View on GitHub →A bug fix adding options to tune compaction write throttling and setting a high write-stalling threshold on the metadata table.
Speeds up batch blob operations by optimizing storage selection, with no change to the user workflow.
Adds a publisher `force` store option and a CLI `completion` command, and substantially reduces SUI gas costs when registering multiple blobs at once.
The Testnet preview adding a publisher `force` store option and CLI `completion` command, with a major SUI gas reduction for registering multiple blobs simultaneously.
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.
Adds the latest checkpoint sequence number and an estimated checkpoint lag to the CLI `health` output.
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.
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.
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.
View on 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`.
View on 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.
View on 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`.
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.
Fixes the blob-certified metric so it updates only for event blobs and makes the publisher retry when a refresh fails.
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.
View on 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`.
View on 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.
View on 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.