Struct Measurement

pub struct Measurement(/* private fields */);

An enclave measurement.

Get the current enclave measurement with [measurement]. Get the current signer measurement with [signer].

Implementations

impl Measurement

pub const MOCK_ENCLAVE: Measurement

pub const MOCK_SIGNER: Measurement

pub const DEV_SIGNER: Measurement

The enclave signer measurement our debug enclaves are signed with. This is also the measurement of the fortanix/rust-sgx dummy key: https://github.com/fortanix/rust-sgx/blob/master/intel-sgx/enclave-runner/src/dummy.key

Running an enclave with run-sgx .. --debug will automatically sign with this key just before running.

pub const PROD_SIGNER: Measurement

The enclave signer measurement our production enclaves should be signed with. Inside an enclave, get the signer with [signer].

pub const fn expected_signer(use_sgx: bool, env: DeployEnv) -> Measurement

Return the expected signer measurement by [DeployEnv] and whether we’re in mock or sgx mode.

pub fn compute_from_sgxs(sgxs_reader: impl Read) -> Result<Measurement, Error>

Compute an enclave measurement from an .sgxs file stream std::io::Read.

• Enclave binaries are first converted to .sgxs files, which exactly mirror the memory layout of the loaded enclave binaries right before running.
• Conveniently, the SHA-256 hash of an enclave .sgxs binary is exactly the same as the actual enclave measurement hash, since the memory layout is identical (caveat: unless we use some more sophisticated extendable enclave features).

pub const fn new(bytes: [u8; 32]) -> Measurement

pub fn short(&self) -> MrShort

Trait Implementations

impl AsRef<[u8]> for Measurement

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

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<[u8; 32]> for Measurement

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

Converts this type into a shared reference of the (usually inferred) input type.

impl ByteArray<32> for Measurement

fn from_array(array: [u8; 32]) -> Measurement

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

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

fn from_array_ref(array: &[u8; N]) -> &Self

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

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

fn try_from_slice(slice: &[u8]) -> Result<Self, TryFromSliceError>

fn try_from_vec(vec: Vec<u8>) -> Result<Self, TryFromSliceError>

fn hex_display(&self) -> HexDisplay<'_>

fn try_from_hexstr(s: &str) -> Result<Self, DecodeError>

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

impl Clone for Measurement

fn clone(&self) -> Measurement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Measurement

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Measurement

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Measurement

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

Formats the value using the given formatter.

impl FromHex for Measurement

fn from_hex(s: &str) -> Result<Measurement, DecodeError>

impl FromStr for Measurement

type Err = DecodeError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Measurement, <Measurement as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for Measurement

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

where __H: Hasher,

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Measurement

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Measurement

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Measurement

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl RefCast for Measurement

type From = [u8; 32]

fn ref_cast(_from: &<Measurement as RefCast>::From) -> &Measurement

fn ref_cast_mut(_from: &mut <Measurement as RefCast>::From) -> &mut Measurement

impl Serialize for Measurement

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 Copy for Measurement

impl Eq for Measurement

impl StructuralPartialEq for Measurement