numbat_codec/
top_de_input.rs

1use crate::num_conv::bytes_to_number;
2use crate::transmute::vec_into_boxed_slice;
3use alloc::boxed::Box;
4use alloc::vec::Vec;
5
6/// Trait that abstracts away an underlying API for a top-level object deserializer.
7/// The underlying API can provide pre-parsed i64/u64 or pre-bundled boxed slices.
8pub trait TopDecodeInput: Sized {
9	/// Length of the underlying data, in bytes.
10	fn byte_len(&self) -> usize;
11
12	/// Provides the underlying data as an owned byte slice box.
13	/// Consumes the input object in the process.
14	fn into_boxed_slice_u8(self) -> Box<[u8]>;
15
16	/// Retrieves the underlying data as a pre-parsed u64.
17	/// Expected to panic if the conversion is not possible.
18	///
19	/// Consumes the input object in the process.
20	fn into_u64(self) -> u64 {
21		bytes_to_number(&*self.into_boxed_slice_u8(), false)
22	}
23
24	/// Retrieves the underlying data as a pre-parsed i64.
25	/// Expected to panic if the conversion is not possible.
26	///
27	/// Consumes the input object in the process.
28	fn into_i64(self) -> i64 {
29		bytes_to_number(&*self.into_boxed_slice_u8(), true) as i64
30	}
31
32	/// Unless you're developing numbat-wasm, please ignore.
33	///
34	/// Shortcut for sending a BigInt managed by the API to the API directly via its handle.
35	///
36	/// - AndesBigInt + finish API
37	/// - AndesBigInt + set storage
38	/// Not used for:
39	/// - RustBigInt
40	/// - async call
41	#[doc(hidden)]
42	#[inline]
43	fn try_get_big_int_handle(&self) -> (bool, i32) {
44		(false, -1)
45	}
46
47	/// Unless you're developing numbat-wasm, please ignore.
48	///
49	/// Shortcut for sending a BigUint managed by the API to the API directly via its handle.
50	///
51	/// Used for:
52	/// - AndesBigUint + finish API
53	/// - AndesBigUint + set storage
54	/// Not used for:
55	/// - RustBigUint
56	/// - async call
57	/// - anything else
58	///
59	#[doc(hidden)]
60	#[inline]
61	fn try_get_big_uint_handle(&self) -> (bool, i32) {
62		(false, -1)
63	}
64}
65
66impl TopDecodeInput for Box<[u8]> {
67	fn byte_len(&self) -> usize {
68		self.len()
69	}
70
71	fn into_boxed_slice_u8(self) -> Box<[u8]> {
72		self
73	}
74}
75
76impl TopDecodeInput for Vec<u8> {
77	fn byte_len(&self) -> usize {
78		self.len()
79	}
80
81	fn into_boxed_slice_u8(self) -> Box<[u8]> {
82		vec_into_boxed_slice(self)
83	}
84}
85
86impl<'a> TopDecodeInput for &'a [u8] {
87	fn byte_len(&self) -> usize {
88		self.len()
89	}
90
91	fn into_boxed_slice_u8(self) -> Box<[u8]> {
92		Box::from(self)
93	}
94}
numbat_codec/top_de_input.rs

numbat_codec/
top_de_input.rs
