drt_sc_snippets::imports

Struct DcdtTokenPayment

pub struct DcdtTokenPayment<M>where
    M: ManagedTypeApi,{
    pub token_identifier: TokenIdentifier<M>,
    pub token_nonce: u64,
    pub amount: BigUint<M>,
}

Fields§

§token_identifier: TokenIdentifier<M>§token_nonce: u64§amount: BigUint<M>

Implementations§

impl<M> DcdtTokenPayment<M>
where M: ManagedTypeApi,

pub fn new( token_identifier: TokenIdentifier<M>, token_nonce: u64, amount: BigUint<M>, ) -> DcdtTokenPayment<M>

pub fn token_type(&self) -> DcdtTokenType

pub fn into_tuple(self) -> (TokenIdentifier<M>, u64, BigUint<M>)

impl<M> DcdtTokenPayment<M>
where M: ManagedTypeApi,

pub fn backwards_compatible_dep_decode_or_handle_err<I, H>( input: &mut I, h: H, ) -> Result<DcdtTokenPayment<M>, <H as DecodeErrorHandler>::HandledErr>
where I: NestedDecodeInput, H: DecodeErrorHandler,

Deserializer version that accepts bytes encoded with an older version of the code. It uses some assumptions about the possible values of the token identifier to figure it out.

More specifically:

The old encoding added an extra first byte, indicating the token type.
Token identifiers cannot be empty and cannot be very long …
… therefore if the bytes are shifted by 1, we should get an invalid token identifier length.

Even more specifically:

having the first byte > 0 can only be explained by an older encoding
having the las byte zero can only mean 2 things:
- the token identifier is empty - but this is invalid
- we are reading an older encoding and the las token identifier length byte is the 5th instead of the 4th.

Please do not call directly in contracts, use it via the dcdt-token-payment-legacy-decode feature flag instead.

It is only publicly exposed for testing.

impl<M> DcdtTokenPayment<M>
where M: ManagedTypeApi,

pub fn as_refs(&self) -> DcdtTokenPaymentRefs<'_, M>

Trait Implementations§

impl<M> Clone for DcdtTokenPayment<M>
where M: Clone + ManagedTypeApi,

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

Returns a copy of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

impl<M> Debug for DcdtTokenPayment<M>
where M: Debug + ManagedTypeApi,

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

Formats the value using the given formatter. Read more

impl<M> ExternallyMergeable<M> for DcdtTokenPayment<M>
where M: ManagedTypeApi,

fn can_be_merged_externally_with(&self, other: &DcdtTokenPayment<M>) -> bool

fn error_if_not_externally_mergeable(&self, other: &Self)

impl<M> From<(TokenIdentifier<M>, u64, BigUint<M>)> for DcdtTokenPayment<M>
where M: ManagedTypeApi,

fn from(value: (TokenIdentifier<M>, u64, BigUint<M>)) -> DcdtTokenPayment<M>

Converts to this type from the input type.

impl<M> From<DcdtTokenPayment<M>> for DcdtTokenPaymentMultiValue<M>
where M: ManagedTypeApi,

fn from(obj: DcdtTokenPayment<M>) -> DcdtTokenPaymentMultiValue<M>

Converts to this type from the input type.

impl<M> From<DcdtTokenPayment<M>> for ManagedVec<M, DcdtTokenPayment<M>>
where M: ManagedTypeApi,

fn from(value: DcdtTokenPayment<M>) -> ManagedVec<M, DcdtTokenPayment<M>>

Converts to this type from the input type.

impl<M> From<DcdtTokenPayment<M>> for RewaOrDcdtTokenPayment<M>
where M: ManagedTypeApi,

fn from(dcdt_payment: DcdtTokenPayment<M>) -> RewaOrDcdtTokenPayment<M>

Converts to this type from the input type.

impl<M> From<DcdtTokenPayment<M>> for TxDCDT
where M: ManagedTypeApi,

fn from(value: DcdtTokenPayment<M>) -> TxDCDT

Converts to this type from the input type.

impl<M> IntoMultiValue for DcdtTokenPayment<M>
where M: ManagedTypeApi,

type MultiValue = DcdtTokenPaymentMultiValue<M>

fn into_multi_value(self) -> <DcdtTokenPayment<M> as IntoMultiValue>::MultiValue

impl<M> ManagedVecItem for DcdtTokenPayment<M>
where M: ManagedTypeApi,

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<16>

Type managing the underlying binary representation in a ManagedVec..

type Ref<'a> = DcdtTokenPayment<M>

Reference representation of the ManagedVec item. Read more

fn from_byte_reader<Reader>(reader: Reader) -> DcdtTokenPayment<M>
where Reader: FnMut(&mut [u8]),

Parses given bytes as a an owned object.

unsafe fn from_byte_reader_as_borrow<'a, Reader>( reader: Reader, ) -> <DcdtTokenPayment<M> as ManagedVecItem>::Ref<'a>
where Reader: FnMut(&mut [u8]),

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

fn to_byte_writer<R, Writer>(&self, writer: Writer) -> R
where Writer: FnMut(&[u8]) -> R,

fn payload_size() -> usize

impl<M> Mergeable<M> for DcdtTokenPayment<M>
where M: ManagedTypeApi,

fn can_merge_with(&self, other: &DcdtTokenPayment<M>) -> bool

fn merge_with(&mut self, other: DcdtTokenPayment<M>)

fn error_if_not_mergeable(&self, other: &Self)

fn merge_with_multiple(&mut self, others: ManagedVec<M, Self>)
where Self: Sized + ManagedVecItem,

impl<M> NestedDecode for DcdtTokenPayment<M>
where M: ManagedTypeApi,

fn dep_decode_or_handle_err<I, H>( input: &mut I, h: H, ) -> Result<DcdtTokenPayment<M>, <H as DecodeErrorHandler>::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 DcdtTokenPayment<M>
where M: ManagedTypeApi,

fn dep_encode_or_handle_err<O, H>( &self, dest: &mut O, h: H, ) -> Result<(), <H as EncodeErrorHandler>::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<M> PartialEq for DcdtTokenPayment<M>
where M: PartialEq + ManagedTypeApi,

fn eq(&self, other: &DcdtTokenPayment<M>) -> bool

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

1.0.0 · Source§

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> TopDecode for DcdtTokenPayment<M>
where M: ManagedTypeApi,

fn top_decode_or_handle_err<I, H>( top_input: I, h: H, ) -> Result<DcdtTokenPayment<M>, <H as DecodeErrorHandler>::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 DcdtTokenPayment<M>
where M: ManagedTypeApi,

fn top_encode_or_handle_err<O, H>( &self, output: O, h: H, ) -> Result<(), <H as EncodeErrorHandler>::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<Env> TxPayment<Env> for &DcdtTokenPayment<<Env as TxEnv>::Api>
where Env: TxEnv,

fn is_no_payment(&self, _env: &Env) -> bool

Returns true if payment indicates transfer of either non-zero REWA or DCDT amounts.

fn perform_transfer_execute( self, env: &Env, to: &ManagedAddress<<Env as TxEnv>::Api>, gas_limit: u64, fc: FunctionCall<<Env as TxEnv>::Api>, )

Transfer-execute calls have different APIs for different payments types. This method selects between them.

fn with_normalized<From, To, F, R>( self, env: &Env, from: &From, to: To, fc: FunctionCall<<Env as TxEnv>::Api>, f: F, ) -> R
where From: TxFrom<Env>, To: TxToSpecified<Env>, F: FnOnce(&ManagedAddress<<Env as TxEnv>::Api>, &BigUint<<Env as TxEnv>::Api>, FunctionCall<<Env as TxEnv>::Api>) -> R,

Converts an DCDT call to a built-in function call, if necessary.

fn into_full_payment_data( self, _env: &Env, ) -> FullPaymentData<<Env as TxEnv>::Api>

Payment data to be used by the testing framework. Will be refactored.

impl<Env> TxPayment<Env> for DcdtTokenPayment<<Env as TxEnv>::Api>
where Env: TxEnv,

fn is_no_payment(&self, _env: &Env) -> bool

Returns true if payment indicates transfer of either non-zero REWA or DCDT amounts.

fn perform_transfer_execute( self, env: &Env, to: &ManagedAddress<<Env as TxEnv>::Api>, gas_limit: u64, fc: FunctionCall<<Env as TxEnv>::Api>, )

Transfer-execute calls have different APIs for different payments types. This method selects between them.

fn with_normalized<From, To, F, R>( self, env: &Env, from: &From, to: To, fc: FunctionCall<<Env as TxEnv>::Api>, f: F, ) -> R
where From: TxFrom<Env>, To: TxToSpecified<Env>, F: FnOnce(&ManagedAddress<<Env as TxEnv>::Api>, &BigUint<<Env as TxEnv>::Api>, FunctionCall<<Env as TxEnv>::Api>) -> R,

Converts an DCDT call to a built-in function call, if necessary.

fn into_full_payment_data( self, _env: &Env, ) -> FullPaymentData<<Env as TxEnv>::Api>

Payment data to be used by the testing framework. Will be refactored.

impl<M> TypeAbi for DcdtTokenPayment<M>
where M: ManagedTypeApi,

type Unmanaged = DcdtTokenPayment<M>

fn type_name() -> String

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

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.

fn type_names() -> TypeNames

fn type_name_rust() -> String

impl<M> Eq for DcdtTokenPayment<M>
where M: Eq + ManagedTypeApi,

impl<M> StructuralPartialEq for DcdtTokenPayment<M>
where M: ManagedTypeApi,

impl<M> TypeAbiFrom<&DcdtTokenPayment<M>> for DcdtTokenPayment<M>
where M: ManagedTypeApi,

impl<M> TypeAbiFrom<DcdtTokenPayment<M>> for DcdtTokenPayment<M>
where M: ManagedTypeApi,

Auto Trait Implementations§

impl<M> Freeze for DcdtTokenPayment<M>
where <M as HandleTypeInfo>::ManagedBufferHandle: Freeze, <M as HandleTypeInfo>::BigIntHandle: Freeze,

impl<M> RefUnwindSafe for DcdtTokenPayment<M>
where <M as HandleTypeInfo>::ManagedBufferHandle: RefUnwindSafe, <M as HandleTypeInfo>::BigIntHandle: RefUnwindSafe, M: RefUnwindSafe,

impl<M> Send for DcdtTokenPayment<M>
where <M as HandleTypeInfo>::ManagedBufferHandle: Send, <M as HandleTypeInfo>::BigIntHandle: Send, M: Send,

impl<M> Sync for DcdtTokenPayment<M>
where <M as HandleTypeInfo>::ManagedBufferHandle: Sync, <M as HandleTypeInfo>::BigIntHandle: Sync, M: Sync,

impl<M> Unpin for DcdtTokenPayment<M>
where <M as HandleTypeInfo>::ManagedBufferHandle: Unpin, <M as HandleTypeInfo>::BigIntHandle: Unpin, M: Unpin,

impl<M> UnwindSafe for DcdtTokenPayment<M>
where <M as HandleTypeInfo>::ManagedBufferHandle: UnwindSafe, <M as HandleTypeInfo>::BigIntHandle: UnwindSafe, M: UnwindSafe,

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

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

Performs copy-assignment from self to dest. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T> InterpretableFrom<&T> for T
where T: Clone,

fn interpret_from(from: &T, _context: &InterpreterContext) -> T

impl<T> InterpretableFrom<T> for T

fn interpret_from(from: T, _context: &InterpreterContext) -> T

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

impl<T> ReconstructableFrom<&T> for T
where T: Clone,

fn reconstruct_from(from: &T, _builder: &ReconstructorContext) -> T

impl<T> ReconstructableFrom<T> for T

fn reconstruct_from(from: T, _builder: &ReconstructorContext) -> T

impl<T> SCCodec for T
where T: TopEncode,

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

impl<T> Same for T

type Output = T

Should always be Self

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> TopDecodeMulti for T
where T: TopDecode,

const IS_SINGLE_VALUE: bool = true

Used to optimize single value loading of endpoint arguments.

fn multi_decode_or_handle_err<I, H>( input: &mut I, h: H, ) -> Result<T, <H as DecodeErrorHandler>::HandledErr>
where I: TopDecodeMultiInput, H: DecodeErrorHandler,

fn multi_decode<I>(input: &mut I) -> Result<Self, DecodeError>
where I: TopDecodeMultiInput,

impl<T> TopDecodeMultiLength for T
where T: TopEncode + TopDecode,

const LEN: usize = 1usize

fn get_len() -> usize

impl<T> TopEncodeMulti for T
where T: TopEncode,

fn multi_encode_or_handle_err<O, H>( &self, output: &mut O, h: H, ) -> Result<(), <H as EncodeErrorHandler>::HandledErr>
where O: TopEncodeMultiOutput, 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 multi_encode<O>(&self, output: &mut O) -> Result<(), EncodeError>
where O: TopEncodeMultiOutput,

Attempt to serialize the value to ouput.

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

impl<T> ErasedDestructor for T
where T: 'static,

impl<T> MaybeSendSync for T

impl<O, T> ProxyArg<O> for T
where O: TypeAbiFrom<T>, T: TopEncodeMulti,