Module format 

Package File Format

Binary format specification for VeridianOS packages (.vpkg files).

This module is organized into submodules:

• [compression]: LZ4, Zstandard, and Brotli compression implementations
• [signature]: Cryptographic signature structures for package verification

Package Structure

+------------------+
| Header (64 bytes)|
+------------------+
| Metadata (JSON)  |
+------------------+
| Content (files)  |
+------------------+
| Signatures       |
| - Ed25519        |
| - Dilithium      |
+------------------+

Structs

PackageHeader

Package file header (64 bytes)

PackageSignatures

Package signature section

SignaturePolicy

Policy controlling how the package manager enforces signature verification.

TrustedKey

A trusted Ed25519 public key with its SHA-256 fingerprint and trust level.

TrustedKeyRing

Collection of trusted Ed25519 signing keys.

Enums

Compression

Compression algorithms

PackageType

Package types

TrustLevel

Trust level assigned to a signing key.

Constants

VPKG_MAGIC

Package file magic number

VPKG_VERSION

Package format version

Functions

compress

Compress data using specified algorithm

decompress

Decompress data based on compression algorithm