catbuffer_rust/
namespace_metadata_transaction_body_builder.rs

1/*
2 * // Copyright (c) 2016-2019, Jaguar0625, gimre, BloodyRookie, Tech Bureau, Corp.
3 * // Copyright (c) 2020-present, Jaguar0625, gimre, BloodyRookie.
4 * // All rights reserved.
5 * //
6 * // This file is part of Catapult.
7 * //
8 * // Catapult is free software: you can redistribute it and/or modify
9 * // it under the terms of the GNU Lesser General Public License as published by
10 * // the Free Software Foundation, either version 3 of the License, or
11 * // (at your option) any later version.
12 * //
13 * // Catapult is distributed in the hope that it will be useful,
14 * // but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * // GNU Lesser General Public License for more details.
17 * //
18 * // You should have received a copy of the GNU Lesser General Public License
19 * // along with Catapult. If not, see <http://www.gnu.org/licenses/>.
20 */
21
22use super::generator_utils::*;
23use super::namespace_id_dto::*;
24use super::unresolved_address_dto::*;
25
26/// Binary layout for a namespace metadata transaction.
27#[derive(Debug, Clone)]
28pub struct NamespaceMetadataTransactionBodyBuilder {
29    /// Metadata target address.
30    pub target_address: UnresolvedAddressDto,
31    /// Metadata key scoped to source, target and type.
32    pub scoped_metadata_key: u64,
33    /// Target namespace identifier.
34    pub target_namespace_id: NamespaceIdDto,
35    /// Change in value size in bytes.
36    pub value_size_delta: u16,
37    /// Difference between existing value and new value \note when there is no existing value, new value is same this value \note when there is an existing value, new value is calculated as xor(previous-value, value).
38    pub value: Vec<u8>,
39}
40
41impl NamespaceMetadataTransactionBodyBuilder {
42    /// Creates an instance of NamespaceMetadataTransactionBodyBuilder from binary payload.
43    /// payload: Byte payload to use to serialize the object.
44    /// # Returns
45    /// A NamespaceMetadataTransactionBodyBuilder.
46    pub fn from_binary(payload: &[u8]) -> Self {
47        let mut _bytes = payload.to_vec();
48        let target_address = UnresolvedAddressDto::from_binary(&_bytes); // kind:CUSTOM1
49        _bytes = _bytes[target_address.get_size()..].to_vec();
50        let buf = fixed_bytes::<8>(&_bytes);
51        let scoped_metadata_key = u64::from_le_bytes(buf); // kind:SIMPLE
52        _bytes = (&_bytes[8..]).to_vec();
53        let target_namespace_id = NamespaceIdDto::from_binary(&_bytes); // kind:CUSTOM1
54        _bytes = _bytes[target_namespace_id.get_size()..].to_vec();
55        let buf = fixed_bytes::<2>(&_bytes);
56        let value_size_delta = u16::from_le_bytes(buf); // kind:SIMPLE
57        _bytes = (&_bytes[2..]).to_vec();
58        let buf = fixed_bytes::<2>(&_bytes);
59        let value_size = u16::from_le_bytes(buf); // kind:SIZE_FIELD
60        _bytes = (&_bytes[2..]).to_vec();
61        let value = (&_bytes[..value_size as usize]).to_vec(); // kind:BUFFER
62        _bytes = (&_bytes[value_size as usize..]).to_vec();
63        // create object and call.
64        NamespaceMetadataTransactionBodyBuilder { target_address, scoped_metadata_key, target_namespace_id, value_size_delta, value } // TransactionBody
65    }
66
67    /// Gets the size of the type.
68    ///
69    /// Returns:
70    /// A size in bytes.
71    pub fn get_size(&self) -> usize {
72        let mut size = 0;
73        size += self.target_address.get_size(); // target_address_size;
74        size += 8;  // scoped_metadata_key;
75        size += self.target_namespace_id.get_size(); // target_namespace_id_size;
76        size += 2;  // value_size_delta;
77        size += 2;  // value_size;
78        size += self.value.len();
79        size
80    }
81
82    /// Serializes self to bytes.
83    ///
84    /// # Returns
85    /// A Serialized bytes.
86    pub fn serializer(&self) -> Vec<u8> {
87        let mut buf: Vec<u8> = vec![];
88        buf.append(&mut self.target_address.serializer()); // kind:CUSTOM
89        buf.append(&mut self.scoped_metadata_key.to_le_bytes().to_vec()); // serial_kind:SIMPLE
90        buf.append(&mut self.target_namespace_id.serializer()); // kind:CUSTOM
91        buf.append(&mut self.value_size_delta.to_le_bytes().to_vec()); // serial_kind:SIMPLE
92        let size_value: u16 = self.value.len() as u16;
93        buf.append(&mut size_value.to_le_bytes().to_vec()); // kind:SIZE_FIELD
94        buf.append(&mut self.value.clone()); // kind:BUFFER
95        buf
96    }
97}
98