Struct HexCallDataDeserializer

pub struct HexCallDataDeserializer<'a> { /* private fields */ }

Deserializes from the MultiversX smart contract call format.

This format consists of the function name, followed by ‘@’, follwed by hex-encoded argument bytes separated by ‘@’ characters. Example: “funcName@00000@aaaa@1234@@”. Arguments can be empty. Argument hex encodings must always have an even number of digits.

HexCallDataDeserializer borrows its input and will allocate new Vecs for each output.

Converting from bytes to specific argument types is not in scope. The TopDecodeMulti trait deals with that.

Currently not used anywhere in the framework, but the functionality is available for anyone who needs it.

Implementations

impl<'a> HexCallDataDeserializer<'a>

pub fn new(source: &'a [u8]) -> Self

pub fn get_func_name(&self) -> &'a [u8]

Gets the first component of the call data, which is the function name. Unlike the arguments, this can be called at any time.

pub fn has_next(&self) -> bool

pub fn next_argument(&mut self) -> Result<Option<Vec<u8>>, &'static str>

Gets the next argument, deserializes from hex and returns the resulting bytes.

Trait Implementations

impl TopDecodeMultiInput for HexCallDataDeserializer<'_>

type ValueInput = Box<[u8]>

fn has_next(&self) -> bool

Check if there are more arguments that can be loaded.

fn next_value_input<H>( &mut self, h: H, ) -> Result<Self::ValueInput, H::HandledErr>

where H: DecodeErrorHandler,

Retrieves an input for deserializing an argument. If the loader is out of arguments, it will crash by itself with an appropriate error, without returning. Use if the next argument is optional, use has_next beforehand.

fn next_value<T, H>( &mut self, h: H, ) -> Result<T, <H as DecodeErrorHandler>::HandledErr>

where T: TopDecode, H: DecodeErrorHandler,

fn assert_no_more_args<H>( &self, h: H, ) -> Result<(), <H as DecodeErrorHandler>::HandledErr>

where H: DecodeErrorHandler,

Called after retrieving all arguments to validate that extra arguments were not provided.

fn flush_ignore<H>( &mut self, h: H, ) -> Result<(), <H as DecodeErrorHandler>::HandledErr>

where H: DecodeErrorHandler,

Consumes all inputs and ignores them. After executing this, assert_no_more_args should not fail.