/** *** Copyright (c) 2016-2019, Jaguar0625, gimre, BloodyRookie, Tech Bureau, Corp. *** Copyright (c) 2020-present, Jaguar0625, gimre, BloodyRookie. *** All rights reserved. *** *** This file is part of Catapult. *** *** Catapult is free software: you can redistribute it and/or modify *** it under the terms of the GNU Lesser General Public License as published by *** the Free Software Foundation, either version 3 of the License, or *** (at your option) any later version. *** *** Catapult is distributed in the hope that it will be useful, *** but WITHOUT ANY WARRANTY; without even the implied warranty of *** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *** GNU Lesser General Public License for more details. *** *** You should have received a copy of the GNU Lesser General Public License *** along with Catapult. If not, see . **/ import { EmbeddedTransactionBuilder } from './EmbeddedTransactionBuilder'; import { GeneratorUtils } from './GeneratorUtils'; import { NamespaceIdDto } from './NamespaceIdDto'; import { NamespaceMetadataTransactionBodyBuilder } from './NamespaceMetadataTransactionBodyBuilder'; import { NetworkTypeDto } from './NetworkTypeDto'; import { PublicKeyDto } from './PublicKeyDto'; import { Serializer } from './Serializer'; import { TransactionTypeDto } from './TransactionTypeDto'; import { UnresolvedAddressDto } from './UnresolvedAddressDto'; /** * Embedded version of NamespaceMetadataTransaction. **/ export class EmbeddedNamespaceMetadataTransactionBuilder extends EmbeddedTransactionBuilder implements Serializer { /** Namespace metadata transaction body. **/ readonly namespaceMetadataTransactionBody: NamespaceMetadataTransactionBodyBuilder; /** * Constructor. * * @param signerPublicKey Public key of the signer of the entity.. * @param version Version of this structure.. * @param network Network on which this entity was created.. * @param type Transaction type. * @param targetAddress Account owning the namespace whose metadata should be modified.. * @param scopedMetadataKey Metadata key scoped to source, target and type.. * @param targetNamespaceId Namespace whose metadata should be modified.. * @param valueSizeDelta Change in value size in bytes, compared to previous size.. * @param value Difference between existing value and new value. \note When there is no existing value, this array is directly used and `value_size_delta`==`value_size`. \note When there is an existing value, the new value is the byte-wise XOR of the previous value and this array.. */ public constructor( signerPublicKey: PublicKeyDto, version: number, network: NetworkTypeDto, type: TransactionTypeDto, targetAddress: UnresolvedAddressDto, scopedMetadataKey: number[], targetNamespaceId: NamespaceIdDto, valueSizeDelta: number, value: Uint8Array, ) { super(signerPublicKey, version, network, type); this.namespaceMetadataTransactionBody = new NamespaceMetadataTransactionBodyBuilder( targetAddress, scopedMetadataKey, targetNamespaceId, valueSizeDelta, value, ); } /** * Load from binary array - Creates an object from payload. * * @param payload - Byte payload to use to serialize the object. */ public static loadFromBinary(payload: Uint8Array): EmbeddedNamespaceMetadataTransactionBuilder { const byteArray = Array.from(payload); const superObject = EmbeddedTransactionBuilder.loadFromBinary(payload); byteArray.splice(0, superObject.getSize()); const namespaceMetadataTransactionBody: NamespaceMetadataTransactionBodyBuilder = NamespaceMetadataTransactionBodyBuilder.loadFromBinary(Uint8Array.from(byteArray)); byteArray.splice(0, namespaceMetadataTransactionBody.getSize()); return new EmbeddedNamespaceMetadataTransactionBuilder( superObject.signerPublicKey, superObject.version, superObject.network, superObject.type, namespaceMetadataTransactionBody.targetAddress, namespaceMetadataTransactionBody.scopedMetadataKey, namespaceMetadataTransactionBody.targetNamespaceId, namespaceMetadataTransactionBody.valueSizeDelta, namespaceMetadataTransactionBody.value, ); } /** * Creates an instance of EmbeddedNamespaceMetadataTransactionBuilder. * * @param signerPublicKey Public key of the signer of the entity.. * @param version Version of this structure.. * @param network Network on which this entity was created.. * @param type Transaction type. * @param targetAddress Account owning the namespace whose metadata should be modified.. * @param scopedMetadataKey Metadata key scoped to source, target and type.. * @param targetNamespaceId Namespace whose metadata should be modified.. * @param valueSizeDelta Change in value size in bytes, compared to previous size.. * @param value Difference between existing value and new value. \note When there is no existing value, this array is directly used and `value_size_delta`==`value_size`. \note When there is an existing value, the new value is the byte-wise XOR of the previous value and this array.. * @return Instance of EmbeddedNamespaceMetadataTransactionBuilder. */ public static createEmbeddedNamespaceMetadataTransactionBuilder( signerPublicKey: PublicKeyDto, version: number, network: NetworkTypeDto, type: TransactionTypeDto, targetAddress: UnresolvedAddressDto, scopedMetadataKey: number[], targetNamespaceId: NamespaceIdDto, valueSizeDelta: number, value: Uint8Array, ): EmbeddedNamespaceMetadataTransactionBuilder { return new EmbeddedNamespaceMetadataTransactionBuilder( signerPublicKey, version, network, type, targetAddress, scopedMetadataKey, targetNamespaceId, valueSizeDelta, value, ); } /** * Gets Account owning the namespace whose metadata should be modified.. * * @return Account owning the namespace whose metadata should be modified.. */ public getTargetAddress(): UnresolvedAddressDto { return this.namespaceMetadataTransactionBody.getTargetAddress(); } /** * Gets Metadata key scoped to source, target and type.. * * @return Metadata key scoped to source, target and type.. */ public getScopedMetadataKey(): number[] { return this.namespaceMetadataTransactionBody.getScopedMetadataKey(); } /** * Gets Namespace whose metadata should be modified.. * * @return Namespace whose metadata should be modified.. */ public getTargetNamespaceId(): NamespaceIdDto { return this.namespaceMetadataTransactionBody.getTargetNamespaceId(); } /** * Gets Change in value size in bytes, compared to previous size.. * * @return Change in value size in bytes, compared to previous size.. */ public getValueSizeDelta(): number { return this.namespaceMetadataTransactionBody.getValueSizeDelta(); } /** * Gets Difference between existing value and new value. \note When there is no existing value, this array is directly used and `value_size_delta`==`value_size`. \note When there is an existing value, the new value is the byte-wise XOR of the previous value and this array.. * * @return Difference between existing value and new value. \note When there is no existing value, this array is directly used and `value_size_delta`==`value_size`. \note When there is an existing value, the new value is the byte-wise XOR of the previous value and this array.. */ public getValue(): Uint8Array { return this.namespaceMetadataTransactionBody.getValue(); } /** * Gets the size of the object. * * @return Size in bytes. */ public getSize(): number { let size = super.getSize(); size += this.namespaceMetadataTransactionBody.getSize(); // namespaceMetadataTransactionBody return size; } /** * Gets the body builder of the object. * * @return Body builder. */ public getBody(): NamespaceMetadataTransactionBodyBuilder { return this.namespaceMetadataTransactionBody; } /** * Serializes an object to bytes. * * @return Serialized bytes. */ public serialize(): Uint8Array { let newArray = Uint8Array.from([]); const superBytes = super.serialize(); newArray = GeneratorUtils.concatTypedArrays(newArray, superBytes); const namespaceMetadataTransactionBodyBytes = this.namespaceMetadataTransactionBody.serialize(); newArray = GeneratorUtils.concatTypedArrays(newArray, namespaceMetadataTransactionBodyBytes); return newArray; } }