/** *** 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 { AmountDto } from './AmountDto'; import { GeneratorUtils } from './GeneratorUtils'; import { LinkActionDto } from './LinkActionDto'; import { NetworkTypeDto } from './NetworkTypeDto'; import { PublicKeyDto } from './PublicKeyDto'; import { Serializer } from './Serializer'; import { SignatureDto } from './SignatureDto'; import { TimestampDto } from './TimestampDto'; import { TransactionBuilder } from './TransactionBuilder'; import { TransactionTypeDto } from './TransactionTypeDto'; import { VrfKeyLinkTransactionBodyBuilder } from './VrfKeyLinkTransactionBodyBuilder'; /** * Link an account with a VRF public key required for harvesting. Announce a VrfKeyLinkTransaction to link an account with a VRF public key. The linked key is used to randomize block production and leader/participant selection. This transaction is required for all accounts wishing to [harvest](/concepts/harvesting.html). **/ export class VrfKeyLinkTransactionBuilder extends TransactionBuilder implements Serializer { /** Vrf key link transaction body. **/ readonly vrfKeyLinkTransactionBody: VrfKeyLinkTransactionBodyBuilder; /** * Constructor. * * @param signature Entity's signature generated by the signing account.. * @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 fee Transaction fee. * @param deadline Transaction deadline. * @param linkedPublicKey Linked VRF public key.. * @param linkAction Account link action.. */ public constructor( signature: SignatureDto, signerPublicKey: PublicKeyDto, version: number, network: NetworkTypeDto, type: TransactionTypeDto, fee: AmountDto, deadline: TimestampDto, linkedPublicKey: PublicKeyDto, linkAction: LinkActionDto, ) { super(signature, signerPublicKey, version, network, type, fee, deadline); this.vrfKeyLinkTransactionBody = new VrfKeyLinkTransactionBodyBuilder(linkedPublicKey, linkAction); } /** * Load from binary array - Creates an object from payload. * * @param payload - Byte payload to use to serialize the object. */ public static loadFromBinary(payload: Uint8Array): VrfKeyLinkTransactionBuilder { const byteArray = Array.from(payload); const superObject = TransactionBuilder.loadFromBinary(payload); byteArray.splice(0, superObject.getSize()); const vrfKeyLinkTransactionBody: VrfKeyLinkTransactionBodyBuilder = VrfKeyLinkTransactionBodyBuilder.loadFromBinary( Uint8Array.from(byteArray), ); byteArray.splice(0, vrfKeyLinkTransactionBody.getSize()); return new VrfKeyLinkTransactionBuilder( superObject.signature, superObject.signerPublicKey, superObject.version, superObject.network, superObject.type, superObject.fee, superObject.deadline, vrfKeyLinkTransactionBody.linkedPublicKey, vrfKeyLinkTransactionBody.linkAction, ); } /** * Creates an instance of VrfKeyLinkTransactionBuilder. * * @param signature Entity's signature generated by the signing account.. * @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 fee Transaction fee. * @param deadline Transaction deadline. * @param linkedPublicKey Linked VRF public key.. * @param linkAction Account link action.. * @return Instance of VrfKeyLinkTransactionBuilder. */ public static createVrfKeyLinkTransactionBuilder( signature: SignatureDto, signerPublicKey: PublicKeyDto, version: number, network: NetworkTypeDto, type: TransactionTypeDto, fee: AmountDto, deadline: TimestampDto, linkedPublicKey: PublicKeyDto, linkAction: LinkActionDto, ): VrfKeyLinkTransactionBuilder { return new VrfKeyLinkTransactionBuilder( signature, signerPublicKey, version, network, type, fee, deadline, linkedPublicKey, linkAction, ); } /** * Gets Linked VRF public key.. * * @return Linked VRF public key.. */ public getLinkedPublicKey(): PublicKeyDto { return this.vrfKeyLinkTransactionBody.getLinkedPublicKey(); } /** * Gets Account link action.. * * @return Account link action.. */ public getLinkAction(): LinkActionDto { return this.vrfKeyLinkTransactionBody.getLinkAction(); } /** * Gets the size of the object. * * @return Size in bytes. */ public getSize(): number { let size = super.getSize(); size += this.vrfKeyLinkTransactionBody.getSize(); // vrfKeyLinkTransactionBody return size; } /** * Gets the body builder of the object. * * @return Body builder. */ public getBody(): VrfKeyLinkTransactionBodyBuilder { return this.vrfKeyLinkTransactionBody; } /** * 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 vrfKeyLinkTransactionBodyBytes = this.vrfKeyLinkTransactionBody.serialize(); newArray = GeneratorUtils.concatTypedArrays(newArray, vrfKeyLinkTransactionBodyBytes); return newArray; } }