Struct exonum::runtime::CallerAddress

pub struct CallerAddress(_);

Uniform presentation of a Caller.

Converting to Address

The address for a Caller is defined as the SHA-256 digest of its Protobuf serialization. This ensures that addresses are unique, collision-resistant and domain-separated for different Caller types.

For example, to compute an address from a public key, you can use CallerAddress::from_key() (in Rust code), or create and hash a Caller Protobuf message (in any programming language).

let public_key = crypto::KeyPair::random().public_key();
let address = CallerAddress::from_key(public_key);
let caller = Caller::Transaction { author: public_key };
// Obtain Protobuf serialization of the `Caller`.
let caller_pb = caller.to_bytes();
assert_eq!(address.as_ref(), &crypto::hash(&caller_pb)[..]);

Methods

impl CallerAddress

pub fn from_key(public_key: PublicKey) -> Self

Converts a public key to an address.

Trait Implementations

impl AsRef<[u8]> for CallerAddress

fn as_ref(&self) -> &[u8]

Performs the conversion.

impl BinaryKey for CallerAddress

fn size(&self) -> usize

Returns the size of the serialized key in bytes.

fn write(&self, buffer: &mut [u8]) -> usize

Serializes the key into the specified buffer of bytes.

fn read(buffer: &[u8]) -> Self::Owned

Deserializes the key from the specified buffer of bytes.

impl BinaryValue for CallerAddress

fn to_bytes(&self) -> Vec<u8>

Serializes the given value to the vector of bytes.

fn from_bytes(value: Cow<[u8]>) -> Result<Self, Error>

Deserializes the value from the given bytes array.

fn into_bytes(self) -> Vec<u8>

Consumes and serializes the given value to the vector of bytes. This method is faster with the wrapped values, thus if you wouldn't use value after serialization use it.

impl Clone for CallerAddress

fn clone(&self) -> CallerAddress

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for CallerAddress

impl Debug for CallerAddress

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CallerAddress

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

Deserialize this value from the given Serde deserializer.

impl Eq for CallerAddress

impl Hash for CallerAddress

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl ObjectHash for CallerAddress

fn object_hash(&self) -> Hash

Returns a hash of the value.

impl Ord for CallerAddress

fn cmp(&self, other: &CallerAddress) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<CallerAddress> for CallerAddress

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

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

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

This method tests for !=.

impl PartialOrd<CallerAddress> for CallerAddress

fn partial_cmp(&self, other: &CallerAddress) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &CallerAddress) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &CallerAddress) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &CallerAddress) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &CallerAddress) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl ProtobufConvert for CallerAddress

type ProtoStruct = Hash

Type generated from the Protobuf definition.

fn to_pb(&self) -> Self::ProtoStruct

Performs conversion to the type generated from Protobuf.

fn from_pb(pb: Self::ProtoStruct) -> Result<Self>

Performs conversion from the type generated from Protobuf.

impl RawKey for CallerAddress

fn to_raw_key(&self) -> [u8; 32]

Returns the key bytes.

impl Serialize for CallerAddress

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

Serialize this value into the given Serde serializer.

impl StructuralEq for CallerAddress

impl StructuralPartialEq for CallerAddress