Struct safe_app::MDataInfo

pub struct MDataInfo {
    pub address: Address,
    pub enc_info: Option<(Key, [u8; 16])>,
    pub new_enc_info: Option<(Key, [u8; 16])>,
}

Information allowing to locate and access mutable data on the network.

Fields

address: Address

Address of the mutable data, containing its name, type tag, and whether it is sequenced.

enc_info: Option<(Key, [u8; 16])>

Key to encrypt/decrypt the directory content and the nonce to be used for keys

new_enc_info: Option<(Key, [u8; 16])>

Future encryption info, used for two-phase data reencryption.

Methods

impl MDataInfo

pub fn new_private(address: Address, enc_info: (Key, [u8; 16])) -> MDataInfo

Construct MDataInfo for private (encrypted) data with a provided private key.

pub fn new_public(address: Address) -> MDataInfo

Construct MDataInfo for public data.

pub fn random_private(kind: Kind, type_tag: u64) -> Result<MDataInfo, CoreError>

Generate random MDataInfo for private (encrypted) mutable data.

pub fn random_public(kind: Kind, type_tag: u64) -> Result<MDataInfo, CoreError>

Generate random MDataInfo for public mutable data.

pub fn name(&self) -> XorName

Returns the name.

pub fn type_tag(&self) -> u64

Returns the type tag.

pub fn address(&self) -> &Address

Returns the address of the data.

pub fn kind(&self) -> Kind

Returns the kind.

pub fn enc_key(&self) -> Option<&Key>

Returns the encryption key, if any.

pub fn nonce(&self) -> Option<&[u8; 16]>

Returns the nonce, if any.

pub fn enc_entry_key(&self, plain_text: &[u8]) -> Result<Vec<u8>, CoreError>

Encrypt the key for the mdata entry accordingly.

pub fn enc_entry_value(&self, plain_text: &[u8]) -> Result<Vec<u8>, CoreError>

Encrypt the value for this mdata entry accordingly.

pub fn decrypt(&self, cipher: &[u8]) -> Result<Vec<u8>, CoreError>

Decrypt key or value of this mdata entry.

pub fn start_new_enc_info(&mut self)

Start the encryption info re-generation by populating the new_enc_info field with random keys, unless it's already populated.

pub fn commit_new_enc_info(&mut self)

Commit the encryption info re-generation by replacing the current encryption info with new_enc_info (if any).

pub fn into_repr_c(self) -> MDataInfo

Construct FFI wrapper for the native Rust object, consuming self.

Trait Implementations

impl Clone for MDataInfo

fn clone(&self) -> MDataInfo

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MDataInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MDataInfo

fn deserialize<__D>(
    __deserializer: __D
) -> Result<MDataInfo, <__D as Deserializer<'de>>::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Eq for MDataInfo

impl PartialEq<MDataInfo> for MDataInfo

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl ReprC for MDataInfo

type C = *const MDataInfo

C representation of the type.

type Error = IpcError

Error type.

unsafe fn clone_from_repr_c(
    repr_c: <MDataInfo as ReprC>::C
) -> Result<MDataInfo, <MDataInfo as ReprC>::Error>

Convert from a raw FFI type into a native Rust type by cloning the data.

impl Serialize for MDataInfo

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

Serialize this value into the given Serde serializer.

impl StructuralEq for MDataInfo

impl StructuralPartialEq for MDataInfo