Struct ManagedAddress

pub struct ManagedAddress<M: ManagedTypeApi> { /* private fields */ }

Implementations

impl<M> ManagedAddress<M>

where M: ManagedTypeApi,

pub fn from_address(address: &Address) -> Self

pub fn zero() -> Self

pub fn to_address(&self) -> Address

pub fn is_zero(&self) -> bool

pub fn new_from_bytes(bytes: &[u8; 32]) -> Self

pub unsafe fn new_uninit() -> Self

Creates a new object, without initializing it.

Safety

The value needs to be initialized after creation, otherwise the VM will halt the first time the value is attempted to be read.

pub unsafe fn temp_const_ref( raw_handle: RawHandle, ) -> ManagedRef<'static, M, ManagedAddress<M>>

Creates a shared managed reference to a given raw handle.

Safety

The reference points to a shared value. Make sure the handle is not leaked.

pub fn as_managed_buffer(&self) -> &ManagedBuffer<M>

pub fn as_managed_byte_array(&self) -> &ManagedByteArray<M, 32>

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

impl<M: ManagedTypeApi> ManagedAddress<M>

pub fn hex_expr(&self) -> ManagedBuffer<M>

Trait Implementations

impl<Env> AnnotatedValue<Env, ManagedAddress<<Env as TxEnv>::Api>> for &Address

where Env: TxEnv,

fn annotation(&self, _env: &Env) -> ManagedBuffer<Env::Api>

fn to_value(&self, _env: &Env) -> ManagedAddress<Env::Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn into_value(self, env: &Env) -> T

Consumes annotated value to produce actual value.

fn with_value_ref<F, R>(&self, env: &Env, f: F) -> R

where F: FnOnce(&T) -> R,

Can be used when working with references only.

impl<Env> AnnotatedValue<Env, ManagedAddress<<Env as TxEnv>::Api>> for &ManagedAddress<Env::Api>

where Env: TxEnv,

fn annotation(&self, _env: &Env) -> ManagedBuffer<Env::Api>

fn to_value(&self, _env: &Env) -> ManagedAddress<Env::Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn into_value(self, _env: &Env) -> ManagedAddress<Env::Api>

Consumes annotated value to produce actual value.

fn with_value_ref<F, R>(&self, _env: &Env, f: F) -> R

where F: FnOnce(&ManagedAddress<Env::Api>) -> R,

Can be used when working with references only.

impl<Env> AnnotatedValue<Env, ManagedAddress<<Env as TxEnv>::Api>> for Address

where Env: TxEnv,

fn annotation(&self, _env: &Env) -> ManagedBuffer<Env::Api>

fn to_value(&self, _env: &Env) -> ManagedAddress<Env::Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn into_value(self, env: &Env) -> T

Consumes annotated value to produce actual value.

fn with_value_ref<F, R>(&self, env: &Env, f: F) -> R

where F: FnOnce(&T) -> R,

Can be used when working with references only.

impl<Env> AnnotatedValue<Env, ManagedAddress<<Env as TxEnv>::Api>> for ESDTSystemSCAddress

where Env: TxEnv,

fn annotation(&self, _env: &Env) -> ManagedBuffer<Env::Api>

fn to_value(&self, _env: &Env) -> ManagedAddress<Env::Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn into_value(self, env: &Env) -> T

Consumes annotated value to produce actual value.

fn with_value_ref<F, R>(&self, env: &Env, f: F) -> R

where F: FnOnce(&T) -> R,

Can be used when working with references only.

impl<Env> AnnotatedValue<Env, ManagedAddress<<Env as TxEnv>::Api>> for ManagedAddress<Env::Api>

where Env: TxEnv,

fn annotation(&self, _env: &Env) -> ManagedBuffer<Env::Api>

fn to_value(&self, _env: &Env) -> ManagedAddress<Env::Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn into_value(self, _env: &Env) -> ManagedAddress<Env::Api>

Consumes annotated value to produce actual value.

fn with_value_ref<F, R>(&self, _env: &Env, f: F) -> R

where F: FnOnce(&ManagedAddress<Env::Api>) -> R,

Can be used when working with references only.

impl<Env> AnnotatedValue<Env, ManagedAddress<<Env as TxEnv>::Api>> for TestAddress<'_>

where Env: TxEnv,

fn annotation(&self, _env: &Env) -> ManagedBuffer<Env::Api>

fn to_value(&self, _env: &Env) -> ManagedAddress<Env::Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn into_value(self, env: &Env) -> T

Consumes annotated value to produce actual value.

fn with_value_ref<F, R>(&self, env: &Env, f: F) -> R

where F: FnOnce(&T) -> R,

Can be used when working with references only.

impl<Env> AnnotatedValue<Env, ManagedAddress<<Env as TxEnv>::Api>> for TestSCAddress<'_>

where Env: TxEnv,

fn annotation(&self, _env: &Env) -> ManagedBuffer<Env::Api>

fn to_value(&self, _env: &Env) -> ManagedAddress<Env::Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn into_value(self, env: &Env) -> T

Consumes annotated value to produce actual value.

fn with_value_ref<F, R>(&self, env: &Env, f: F) -> R

where F: FnOnce(&T) -> R,

Can be used when working with references only.

impl<Api> AnnotatedValue<TxScEnv<Api>, ManagedAddress<Api>> for ToCaller

where Api: CallTypeApi + BlockchainApi,

fn annotation(&self, env: &TxScEnv<Api>) -> ManagedBuffer<Api>

fn to_value(&self, _env: &TxScEnv<Api>) -> ManagedAddress<Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn with_value_ref<F, R>(&self, _env: &TxScEnv<Api>, f: F) -> R

where F: FnOnce(&ManagedAddress<Api>) -> R,

Can be used when working with references only.

fn into_value(self, env: &Env) -> T

Consumes annotated value to produce actual value.

impl<Api> AnnotatedValue<TxScEnv<Api>, ManagedAddress<Api>> for ToSelf

where Api: CallTypeApi + BlockchainApi,

fn annotation(&self, env: &TxScEnv<Api>) -> ManagedBuffer<Api>

fn to_value(&self, _env: &TxScEnv<Api>) -> ManagedAddress<Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn with_value_ref<F, R>(&self, _env: &TxScEnv<Api>, f: F) -> R

where F: FnOnce(&ManagedAddress<Api>) -> R,

Can be used when working with references only.

fn into_value(self, env: &Env) -> T

Consumes annotated value to produce actual value.

impl<M: Clone + ManagedTypeApi> Clone for ManagedAddress<M>

fn clone(&self) -> ManagedAddress<M>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<M: ManagedTypeApi> Debug for ManagedAddress<M>

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

Formats the value using the given formatter.

impl<M> Default for ManagedAddress<M>

where M: ManagedTypeApi,

fn default() -> Self

Returns the “default value” for a type.

impl<M> From<&[u8; 32]> for ManagedAddress<M>

where M: ManagedTypeApi,

fn from(bytes: &[u8; 32]) -> Self

Converts to this type from the input type.

impl<M> From<&Address> for ManagedAddress<M>

where M: ManagedTypeApi,

fn from(address: &Address) -> Self

Converts to this type from the input type.

impl<M> From<[u8; 32]> for ManagedAddress<M>

where M: ManagedTypeApi,

fn from(bytes: [u8; 32]) -> Self

Converts to this type from the input type.

impl<M> From<Address> for ManagedAddress<M>

where M: ManagedTypeApi,

fn from(address: Address) -> Self

Converts to this type from the input type.

impl<M> From<ManagedByteArray<M, 32>> for ManagedAddress<M>

where M: ManagedTypeApi,

fn from(value: ManagedByteArray<M, 32>) -> Self

Converts to this type from the input type.

impl<M> ManagedType<M> for ManagedAddress<M>

where M: ManagedTypeApi,

type OwnHandle = <M as HandleTypeInfo>::ManagedBufferHandle

fn get_handle(&self) -> M::ManagedBufferHandle

unsafe fn forget_into_handle(self) -> Self::OwnHandle

Forgets current object (does not run destructor), but extracts the handle.

fn transmute_from_handle_ref(handle_ref: &M::ManagedBufferHandle) -> &Self

Implement carefully, since the underlying transmutation is an unsafe operation. For types that wrap a handle to some VM-managed data, make sure the type only contains the handle (plus ZSTs if necessary). For types that just wrap another managed type it is easier, call for the wrapped object.

fn transmute_from_handle_ref_mut( handle_ref: &mut M::ManagedBufferHandle, ) -> &mut Self

fn get_raw_handle(&self) -> RawHandle

fn as_ref(&self) -> ManagedRef<'_, M, Self>

impl<M: ManagedTypeApi> ManagedVecItem for ManagedAddress<M>

const SKIPS_RESERIALIZATION: bool = false

If true, then the encoding of the item is identical to the payload, and no further conversion is necessary (the underlying buffer can be used as-is during serialization). False for all managed types, but true for basic types (like u32).

type PAYLOAD = ManagedVecItemPayloadBuffer<4>

Type managing the underlying binary representation in a ManagedVec..

type Ref<'a> = ManagedRef<'a, M, ManagedAddress<M>>

Reference representation of the ManagedVec item.

fn read_from_payload(payload: &Self::PAYLOAD) -> Self

Parses given bytes as a an owned object.

unsafe fn borrow_from_payload<'a>(payload: &Self::PAYLOAD) -> Self::Ref<'a>

Parses given bytes as a representation of the object, either owned, or a reference.

fn save_to_payload(self, payload: &mut Self::PAYLOAD)

Converts the object into bytes.

fn payload_size() -> usize

impl<M> NestedDecode for ManagedAddress<M>

where M: ManagedTypeApi,

fn dep_decode_or_handle_err<I, H>( input: &mut I, h: H, ) -> Result<Self, H::HandledErr>

where I: NestedDecodeInput, H: DecodeErrorHandler,

Version of dep_decode that can handle errors as soon as they occur. For instance in can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

fn dep_decode<I>(input: &mut I) -> Result<Self, DecodeError>

where I: NestedDecodeInput,

Attempt to deserialise the value from input, using the format of an object nested inside another structure. In case of success returns the deserialized value and the number of bytes consumed during the operation.

impl<M> NestedEncode for ManagedAddress<M>

where M: ManagedTypeApi,

fn dep_encode_or_handle_err<O, H>( &self, dest: &mut O, h: H, ) -> Result<(), H::HandledErr>

where O: NestedEncodeOutput, H: EncodeErrorHandler,

Version of dep_encode that can handle errors as soon as they occur. For instance in can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

fn dep_encode<O>(&self, dest: &mut O) -> Result<(), EncodeError>

where O: NestedEncodeOutput,

NestedEncode to output, using the format of an object nested inside another structure. Does not provide compact version.

impl<Api: ManagedTypeApi> PartialEq<ManagedAddress<Api>> for TestAddress<'_>

fn eq(&self, other: &ManagedAddress<Api>) -> 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<Api: ManagedTypeApi> PartialEq<ManagedAddress<Api>> for TestSCAddress<'_>

fn eq(&self, other: &ManagedAddress<Api>) -> 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<'a, Api: ManagedTypeApi> PartialEq<TestAddress<'a>> for ManagedAddress<Api>

fn eq(&self, other: &TestAddress<'a>) -> 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<'a, Api: ManagedTypeApi> PartialEq<TestSCAddress<'a>> for ManagedAddress<Api>

fn eq(&self, other: &TestSCAddress<'a>) -> 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<M> PartialEq for ManagedAddress<M>

where M: ManagedTypeApi,

fn eq(&self, other: &Self) -> 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<M: ManagedTypeApi> SCLowerHex for ManagedAddress<M>

fn fmt<F: FormatByteReceiver>(&self, f: &mut F)

impl<M> TopDecode for ManagedAddress<M>

where M: ManagedTypeApi,

fn top_decode_or_handle_err<I, H>(input: I, h: H) -> Result<Self, H::HandledErr>

where I: TopDecodeInput, H: DecodeErrorHandler,

Version of top_decode that can handle errors as soon as they occur. For instance it can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

fn top_decode<I>(input: I) -> Result<Self, DecodeError>

where I: TopDecodeInput,

Attempt to deserialize the value from input.

impl<M> TopEncode for ManagedAddress<M>

where M: ManagedTypeApi,

fn top_encode_or_handle_err<O, H>( &self, output: O, h: H, ) -> Result<(), H::HandledErr>

where O: TopEncodeOutput, H: EncodeErrorHandler,

Version of top_encode that can handle errors as soon as they occur. For instance in can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

fn top_encode<O>(&self, output: O) -> Result<(), EncodeError>

where O: TopEncodeOutput,

Attempt to serialize the value to ouput.

impl<M> TryFrom<ManagedBuffer<M>> for ManagedAddress<M>

where M: ManagedTypeApi,

type Error = DecodeError

The type returned in the event of a conversion error.

fn try_from(value: ManagedBuffer<M>) -> Result<Self, Self::Error>

Performs the conversion.

impl<Env> TxFrom<Env> for &ManagedAddress<Env::Api>

where Env: TxEnv,

fn resolve_address(&self, _env: &Env) -> ManagedAddress<Env::Api>

impl<Env> TxFrom<Env> for ManagedAddress<Env::Api>

where Env: TxEnv,

fn resolve_address(&self, _env: &Env) -> ManagedAddress<Env::Api>

impl<Env> TxToSpecified<Env> for &ManagedAddress<Env::Api>

where Env: TxEnv,

fn with_address_ref<F, R>(&self, env: &Env, f: F) -> R

where F: FnOnce(&ManagedAddress<Env::Api>) -> R,

Avoids a clone when performing transfer-execute.

impl<Env> TxToSpecified<Env> for ManagedAddress<Env::Api>

where Env: TxEnv,

fn with_address_ref<F, R>(&self, env: &Env, f: F) -> R

where F: FnOnce(&ManagedAddress<Env::Api>) -> R,

Avoids a clone when performing transfer-execute.

impl<M> TypeAbi for ManagedAddress<M>

where M: ManagedTypeApi,

fn type_name() -> TypeName

"Address" instead of "array32<u8>".

type Unmanaged = Address

fn type_name_rust() -> TypeName

fn type_names() -> TypeNames

fn provide_type_descriptions<TDC: TypeDescriptionContainer>( accumulator: &mut TDC, )

A type can provide more than its own name. For instance, a struct can also provide the descriptions of the type of its fields. TypeAbi doesn’t care for the exact accumulator type, which is abstracted by the TypeDescriptionContainer trait.

impl<M> Eq for ManagedAddress<M>

where M: ManagedTypeApi,

impl<Env> TxFromSourceValue<Env> for ManagedAddress<Env::Api>

where Env: TxEnv,

impl<Env> TxFromSpecified<Env> for &ManagedAddress<Env::Api>

where Env: TxEnv,

impl<Env> TxFromSpecified<Env> for ManagedAddress<Env::Api>

where Env: TxEnv,

impl<Env> TxTo<Env> for &ManagedAddress<Env::Api>

where Env: TxEnv,

impl<Env> TxTo<Env> for ManagedAddress<Env::Api>

where Env: TxEnv,

impl<M> TypeAbiFrom<&Address> for ManagedAddress<M>

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<&ManagedAddress<M>> for Address

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<&ManagedAddress<M>> for ManagedAddress<M>

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<[u8; 32]> for ManagedAddress<M>

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<Address> for ManagedAddress<M>

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<ESDTSystemSCAddress> for ManagedAddress<M>

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<ManagedAddress<M>> for Address

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<ManagedAddress<M>> for ManagedAddress<M>

where M: ManagedTypeApi,

impl<Api> TypeAbiFrom<TestAddress<'_>> for ManagedAddress<Api>

where Api: ManagedTypeApi,

impl<Api> TypeAbiFrom<TestSCAddress<'_>> for ManagedAddress<Api>

where Api: ManagedTypeApi,