Module file 

File operations using streaming self-encryption.

Upload files directly from disk without loading them entirely into memory. Uses stream_encrypt to process files in 8KB chunks, encrypting and uploading each piece as it’s produced.

Encrypted chunks are spilled to a temporary directory during encryption so that peak memory usage is bounded to one wave (~256 MB for 64 × 4 MB chunks) regardless of file size.

For in-memory data uploads, see the data module.

Structs

FileUploadResult

Result of a file upload: the DataMap needed to retrieve the file.

PreparedUpload

Prepared upload ready for external payment.

UploadCostEstimate

Estimated cost of uploading a file, returned by Client::estimate_upload_cost.

Enums

DownloadEvent

Progress events emitted during file download for UI feedback.

ExternalPaymentInfo

Payment information for external signing — either wave-batch or merkle.

UploadEvent

Progress events emitted during file upload for UI feedback.

Visibility

Whether the data map is published to the network for address-based retrieval.