Struct MapData 

pub struct MapData {
    pub version: u32,
    pub legacy_salt: Option<Vec<u8>>,
    pub legacy_key_encrypted: Option<Vec<u8>>,
    pub entries: Vec<MapEntry>,
    pub stopped_at: Option<u32>,
}

A decoded maps file.

Fields

version: u32

Telegram Desktop version stored in the TDF$ header.

legacy_salt: Option<Vec<u8>>

The legacy salt; None for a null array.

legacy_key_encrypted: Option<Vec<u8>>

The legacy local key wrap; None for a null array.

entries: Vec<MapEntry>

The decoded entries in file order.

stopped_at: Option<u32>

The unknown key type the entries stopped at, if any; everything after it is ignored.

Implementations

impl MapData

pub fn parse_entries(data: &[u8]) -> Result<(Vec<MapEntry>, Option<u32>)>

Decodes a decrypted map (the data part of the encrypted blob) into its entries and the unknown key type they stopped at.

A key type that cannot be read in full ends the entries like an unknown one, since a short value reads as 0 (lskUserMap).

Errors

Error::QDataStreamFailed when an entry of a known type is cut short or holds an invalid string.

pub fn read(dir: impl AsRef<Path>, local_key: &AuthKey) -> Result<Self>

Reads and decrypts the maps file in the account folder dir (MapData.read with a local key).

Errors

• Error::ReadMapDataFailed when the file is missing or invalid, or the map does not decrypt under local_key.
• Error::QDataStreamFailed when the three arrays or an entry are cut short.

pub fn new_account() -> Self

The map of a new account: only the NEW_ACCOUNT_SETTINGS_KEY user settings key, APP_VERSION, and no legacy arrays.

pub fn encode_entries(&self) -> Result<Vec<u8>>

Encodes the decrypted map, which is not a copy of the entries: they are first folded into one field per file key slot.

• File keys land in their named slots, a later entry overwriting an earlier one; lskStickersOld fills the installed stickers key and lskBackgroundOldOld the day background key. The three old skip types and the two legacy wallet keys are dropped, and so are legacy locations.
• Draft, draft cursor, and bot storage pairs are keyed by peer id (PeerId.FromSerialized, legacy layouts converted); a repeated peer keeps its first position and its last file key. Peers are written with the serialized-id flag set (PeerId.Serialize).
• The self user, the web view tokens, and the wallet engine storages keep the last entry; wallet entries are written sorted by name, a null name as an empty one.

The output follows a fixed type order and writes a key type only when one of its keys is non-zero, the self user only when it is non-empty, the web view tokens only when one is non-empty, and the wallet engine storages only when there is one.

Errors

Error::QDataStreamFailed when a count or blob does not fit a u32.

Trait Implementations

impl Clone for MapData

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MapData

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

Formats the value using the given formatter.

impl Default for MapData

fn default() -> Self

Returns the “default value” for a type.

impl Eq for MapData

impl PartialEq for MapData

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for MapData