Struct FileUploadResult 

#[non_exhaustive]
pub struct FileUploadResult {
    pub data_map: DataMap,
    pub chunks_stored: usize,
    pub chunks_failed: usize,
    pub total_chunks: usize,
    pub payment_mode_used: PaymentMode,
    pub storage_cost_atto: String,
    pub gas_cost_wei: u128,
    pub data_map_address: Option<[u8; 32]>,
}

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

Marked #[non_exhaustive] so adding a new field in future is not a breaking change for downstream consumers that construct or pattern-match on this struct.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

data_map: DataMap

The data map containing chunk metadata for reconstruction.

chunks_stored: usize

Number of chunks stored on the network.

chunks_failed: usize

Number of chunks that failed to store. Always 0 for a successful upload — partial-failure information is conveyed via crate::data::Error::PartialUpload instead.

total_chunks: usize

Total number of chunks the upload attempted to store. On full success this equals chunks_stored.

payment_mode_used: PaymentMode

Which payment mode was actually used (not just requested).

storage_cost_atto: String

Total storage cost paid in token units (atto). “0” if all chunks already existed.

gas_cost_wei: u128

Total gas cost in wei. 0 if no on-chain transactions were made.

data_map_address: Option<[u8; 32]>

Chunk address of the serialized DataMap, set only for Visibility::Public uploads. Some means this address is retrievable from the network (via Client::data_map_fetch), not necessarily that this upload paid to store it — if the serialized DataMap hashed to a chunk that was already on the network (same file uploaded before; deterministic via self-encryption), the address is still returned but no storage payment was made for it.

Trait Implementations

impl Clone for FileUploadResult

fn clone(&self) -> FileUploadResult

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileUploadResult

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.