(source)

Table of Contents

RFC-0135: Compressed Blob Prefixes

Start Date2025-01-06
DescriptionStandardize compressed blob prefixes
Authorss0me0ne-unkn0wn (13WGadgNgqSjiGQvfhimw9pX26mvGdYQ6XgrjPANSEDRoGMt)

Summary

This RFC proposes a change that makes it possible to identify types of compressed blobs stored on-chain, as well as used off-chain, without the need for decompression.

Motivation

Currently, a compressed blob does not give any idea of what's inside because the only thing that can be inside, according to the spec, is Wasm. In reality, other blob types are already being used, and more are to come. Apart from being error-prone by itself, the current approach does not allow to properly route the blob through the execution paths before its decompression, which will result in suboptimal implementations when more blob types are used. Thus, it is necessary to introduce a mechanism allowing to identify the blob type without decompressing it.

This proposal is intended to:

  1. Fill up gaps in the Polkadot spec, increasing its preciseness and putting it in line with mechanisms already being used in practice but not yet standardized;
  2. Support future work enabling Polkadot to execute PolkaVM and, more generally, other-than-Wasm parachain runtimes;
  3. Allow developers to introduce compression methods other than zstd seamlessly in the future.

Stakeholders

Node developers are the main stakeholders for this proposal. It also creates a foundation on which parachain runtime developers will build.

Explanation

Overview

The current approach to compressing binary blobs is defined in subsection 2.6.2 of Polkadot spec. It involves using zstd compression, and the resulting compressed blob is prefixed with a unique 64-bit magic value specified in that subsection. Said subsection only defines the means of compressing Wasm code blobs; no other compression procedure is currently defined by the spec.

However, in practice, the current de facto protocol uses the said procedure to compress not only Wasm code blobs but also proofs-of-validity. Such a usage is not stipulated by the spec. Currently, having solely a compressed blob, it's impossible to tell what's inside it without decompression, a Wasm blob, or a PoV. That doesn't cause any problems in the current de facto protocol, as Wasm blobs and PoV blobs take completely different execution paths, and it's impossible to mix them.

Changes proposed below are intended to:

  • Bring the spec into line with the currently used de facto protocol;
  • Define the means for distinguishing compressed blob types in a backward-compatible and future-proof way;
  • Implement the means defined;
  • Deprecate the legacy compression/decompression mechanism in favor of the proposed one.

Proposed spec changes

  • Add a subsection titled "Blob Compression" and describe how the binary data is compressed generally and list the following well-known prefixes:
Prefix namePrefix bytesDescription
CBLOB_ZSTD_WASM_OR_POV82, 188, 83, 118, 70, 219, 142, 5Wasm code blob or PoV, zstd-compressed
CBLOB_ZSTD_WASM_CODE82, 188, 83, 118, 70, 219, 142, 6Wasm code blob, zstd-compressed
CBLOB_ZSTD_PVM_CODE82, 188, 83, 118, 70, 219, 142, 7PolkaVM code blob, zstd-compressed
  • Amend subsection 2.6.2 "Loading the Runtime Code" and make it reference the newly created "Blob Compression" subsection instead of specifying the prefix and the compression method explicitly;
  • Amend subsection 8.3.2 "Runtime Compression", which currently reads "Not documented yet", and make it describe the actual parachain runtime compression technics, referencing the newly created "Blob Compression" subsection;
  • In section 8, "Availability & Validity", either in a separate new subsection or in one of the existing ones, introduce a PoV compression concept, linking it to the newly created "Blob Compression" subsection.

Proposed code changes

No runtime code is changed. Node-side changes are trivial; a PoC already implemented as a part of SDK PR#6704 may be used as an example.

Timeline

  1. The proposed prefix changes are implemented and released. No logic changes yet;
  2. After the supermajority of production networks' nodes upgrades, one more change is released that adds CBLOB_ZSTD_WASM_CODE prefix instead of CBLOB_ZSTD_WASM_OR_POV when compiling and compressing Wasm parachain runtimes;
  3. Conservatively, wait until no more PVFs prefixed with CBLOB_ZSTD_WASM_OR_POV remain on-chain. That may take quite some time. Alternatively, create a migration that alters prefixes of existing blobs;
  4. Rename CBLOB_ZSTD_WASM_OR_POV to CBLOB_ZSTD_POV, as the PoVs remain the only entity compressed with this prefix by that time. Thus no collator protocol changes are needed.

Drawbacks

Currently, the only requirement for a compressed blob prefix is not to coincide with Wasm magic bytes (as stated in code comments). Changes proposed here increase prefix collision risk, given that arbitrary data may be compressed in the future. However, it must be taken into account that:

  • Collision probability per arbitrary blob is ≈5,4×10⁻²⁰ for a single random 64-bit prefix (current situation) and ≈1,6×10⁻¹⁹ for the proposed set of three 64-bit prefixes (proposed situation), which is still low enough;
  • The current de facto protocol uses the current compression implementation to compress PoVs, which are arbitrary binary data, so the collision risk already exists and is not introduced by changes proposed here.

Testing, Security, and Privacy

As the change increases granularity, it will positively affect both testing possibilities and security, allowing developers to check what's inside a given compressed blob precisely. Testing the change itself is trivial. Privacy is not affected by this change.

Performance, Ergonomics, and Compatibility

Performance

The current implementation's performance is not affected by this change. Future implementations allowing for the execution of other-than-Wasm parachain runtimes will benefit from this change performance-wise.

Ergonomics

The end-user ergonomics is not affected. The ergonomics for developers will benefit from this change as it enables exact checks and less guessing.

Compatibility

The change is designed to be backward-compatible.

Prior Art and References

SDK PR#6704 (WIP) introduces a mechanism similar to that described in this proposal and proves the necessity of such a change.

Unresolved Questions

None

This proposal creates a foundation for two future work directions:

  • Proposing to introduce other-than-Wasm code executors, including PolkaVM, allowing parachain runtime authors to seamlessly change execution platform using the existing mechanism of runtime upgrades;
  • Proposing to use new compression methods that are faster/better/more secure than zstd as soon as they appear, streamlining the adoption of new methods and deprecation of the old ones.