mainnet-v2.0.0

Walrus Sites mainnet-v2.0.0

Overview

This major release transitions the site-builder CLI to exclusively use Quilts for site data
storage. This change significantly reduces costs and increases the speed of publishing new sites,
especially for larger sites.

Due to current implementation constraints, updates will re-upload all site data.
Optimizations to reduce redundant uploads are planned for future releases.

Recommendations for users concerned about redundant uploads on update:

• Test the update on testnet first to verify behavior with your specific site.
• Consider republishing to a new Site and pointing SuiNS after publishing is successful.
• Use the earlier version mainnet-v1.3.1, if redundant uploads are a concern for your use case.

Note: All changes in this release apply to the site-builder CLI.

Requirements: Walrus CLI v1.35.0 or later

Breaking Changes

Removed flags

The following flags are no longer relevant with Quilt-based storage and have been removed:

• --check-extend
• --watch
• --parallel-stores
• --max-concurrent

Command renamed: update-resource → update-resources

The site-builder update-resource command has been redesigned and renamed to update-resources to
optimize for Quilt-based workflows. The new command accepts multiple resources in a single
operation.

Syntax: site-builder update-resources --resources path/to/local/file1:/site/path/of/file1 path/to/local/file2:/site/path/of/file2

Each resource is specified as a local_path:site_path pair, where:

• local_path: Path to the file on your local filesystem
• site_path: Destination path in the site (must include a leading /)

Multiple resources can be provided separated by spaces. For paths containing spaces, use quotes. To
escape literal colons in filenames, use a backslash (file\:name.html:/site/path.html).

Default Quilt size limit

A default size limit of 512 MiB per Quilt is now enforced to prevent excessive RAM usage during
upload. This limit currently also restricts the maximum individual file size, which will be
addressed in a future release.

To override this limit, use the --max-quilt-size flag with values in KB/MB/GB (decimal) or
KiB/MiB/GiB (binary) units, or as plain byte numbers (e.g., "1GB", "512MiB", "1048576").

Note: Larger sizes require more memory during storage operations and may increase storage
overhead.

Features

• Multi-resource updates: The update-resources command now accepts multiple files in a single
  operation, enabling efficient Quilt packaging and resource updates. (#596)
• Quilts only: Removed the experimental-quilts feature flag and legacy Blob publishing. All
  sites now use Quilts for storage. The portal remains compatible with both Quilts and legacy
  Blob-based sites. (#594)
• Configurable Quilt size limits: New --max-quilt-size argument allows fine-tuning of the
  maximum cumulative size of files stored in a single Quilt. (#587)
• Improved patch identifiers: Quilt patch file identifiers now use the resource's site-path
  instead of base36 conversion, improving clarity and debugging. (#592)

Bug Fixes

• StoredQuiltPatch compatibility: Added the range field to StoredQuiltPatch structure,
  ensuring compatibility with Walrus CLI v1.35 and later. (#593)

Tests

• Added comprehensive test coverage for max-quilt-size limit enforcement. (#591)

Chores

• Updated Sui and Walrus dependencies. (#598)
• Reduced code duplication in Quilt update tests, improving maintainability. (#590)
• Updated github-action, removed --check-extend. (#600)

---

Full Changelog: mainnet-v1.3.1...mainnet-v2.0.0