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

FileChunkPeerReport

Closest-peer GET results for one file chunk.

FileChunkPeerReportPeer

One peer result in a FileChunkPeerReport.

FileChunkPeerSweepReport

One all-peer diagnostic GET sweep for a file chunk.

FileDownloadWithPeerReport

File download result when peer-health diagnostics are enabled.

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

CostEstimateConfidence

Confidence attached to an UploadCostEstimate’s storage_cost_atto.

DownloadEvent

Progress events emitted during file download for UI feedback.

ExternalPaymentInfo

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

FileChunkPeerStatus

Peer-level file chunk GET diagnostic status.

UploadEvent

Progress events emitted during file upload for UI feedback.

Visibility

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