Struct FileManifest 

pub struct FileManifest {

    pub file_id: String,
    pub owner_fingerprint: String,
    pub network_id: String,
    pub encrypted_name: Vec<u8>,
    pub size_bytes: u64,
    pub chunk_size: usize,
    pub num_chunks: usize,
    pub k: usize,
    pub n: usize,
    pub q: f64,
    pub ph: f64,
    pub pe: f64,
    pub chunks: Vec<ChunkManifest>,
    pub created_at: u64,
}

Complete metadata descriptor for a file stored in a BillPouch network.

Field visibility

Field	Who can read	Why
file_id	All network nodes	Indexing and routing
owner_fingerprint	All	Attribution
encrypted_name	Only nodes with network key	Private metadata
size_bytes	All	Storage planning
k, n, q	All	Codec operation
ph, pe	All	Health monitoring
chunks	All	Fragment routing

Fields

file_id: String

UUID v4 identifying this file in the network.

owner_fingerprint: String

SHA-256(pubkey)[0..8] hex of the uploading user.

network_id: String

Network this file belongs to.

encrypted_name: Vec<u8>

Filename encrypted with the network metadata key.

Use NetworkMetaKey::encrypt / NetworkMetaKey::decrypt with the key from NetworkMetaKey::for_network to read or write.

size_bytes: u64

Original file size in bytes.

chunk_size: usize

Chunk size in bytes used during upload (e.g. 1 MiB = 1_048_576).

num_chunks: usize

Total number of chunks.

k: usize

Recovery threshold: minimum fragments needed to reconstruct any chunk.

Computed at upload time via crate::coding::params::compute_coding_params.

n: usize

Total fragments generated per chunk (= k + redundancy).

q: f64

Effective redundancy overhead fraction: (n − k) / k.

ph: f64

Target recovery probability declared at upload time (e.g. 0.999).

pe: f64

Rolling effective recovery probability, updated by the daemon as QoS measurements evolve. Starts equal to ph at upload.

chunks: Vec<ChunkManifest>

Per-chunk location manifests (one entry per chunk).

created_at: u64

Unix timestamp (seconds) when the file was uploaded.

Implementations

impl FileManifest

pub fn decrypt_name(&self, key: &NetworkMetaKey) -> BpResult<String>

Decrypt and return the original filename.

Errors

Returns Err if the key is wrong or the blob is corrupted.

pub fn set_name(&mut self, filename: &str, key: &NetworkMetaKey)

Set the filename by encrypting it with the given network key.

pub fn conservation_ratio(&self) -> f64

Conservation ratio: fraction of the network’s fragment locations that still hold known-live fragments.

A value of 1.0 means all n × num_chunks fragments are in place. Below k / n the file cannot be recovered.

pub fn is_recoverable(&self) -> bool

Whether every chunk has at least k fragment locations recorded.

pub fn to_json_bytes(&self) -> BpResult<Vec<u8>>

Serialise to a compact JSON byte blob (for gossip / DHT storage).

pub fn from_json_bytes(bytes: &[u8]) -> BpResult<Self>

Deserialise from a JSON byte blob.

Trait Implementations

impl Clone for FileManifest

fn clone(&self) -> FileManifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileManifest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileManifest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FileManifest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.