com.concordium.sdk.transactions

Class TransactionHeaderV1

java.lang.Object

com.concordium.sdk.transactions.TransactionHeaderV1

public class TransactionHeaderV1
extends Object

The transaction header used for the extended transaction format, used for AccountTransactionV1.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TransactionHeaderV1.TransactionHeaderV1Builder

Field Summary

Fields

Modifier and Type	Field and Description
static int	BYTES_WITH_SPONSOR
static int	BYTES_WITHOUT_SPONSOR

Constructor Summary

Constructors

Constructor and Description
TransactionHeaderV1(@NonNull AccountAddress sender, @NonNull Nonce nonce, @NonNull UInt64 maxEnergyCost, @NonNull UInt32 payloadSize, @NonNull Expiry expiry, AccountAddress sponsor)

Method Summary

Modifier and Type	Method and Description
static TransactionHeaderV1.TransactionHeaderV1Builder	builder()
static UInt64	calculateMaxEnergyCost(int senderSignatureCount, int sponsorSignatureCount, int payloadSize, UInt64 transactionSpecificCost) Calculate the maximum amount of energy that can be spent on executing a transaction.
protected boolean	canEqual(Object other)
boolean	equals(Object o)
static TransactionHeaderV1	fromBytes(ByteBuffer source)
byte[]	getBytes()
@NonNull Expiry	getExpiry() A Unix timestamp indicating when the transaction should expire.
@NonNull UInt64	getMaxEnergyCost() The amount of energy allocated for executing this transaction.
@NonNull Nonce	getNonce() The sequence number of the transaction, sender (source) account nonce.
@NonNull UInt32	getPayloadSize() The size of the transaction payload in bytes.
@NonNull AccountAddress	getSender() The address of the account that is the source of the transaction.
Optional<AccountAddress>	getSponsor()
int	hashCode()
TransactionHeaderV1.TransactionHeaderV1Builder	toBuilder()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

BYTES_WITHOUT_SPONSOR

public static int BYTES_WITHOUT_SPONSOR

BYTES_WITH_SPONSOR

public static int BYTES_WITH_SPONSOR

Constructor Detail

TransactionHeaderV1

public TransactionHeaderV1(@NonNull
                           @NonNull AccountAddress sender,
                           @NonNull
                           @NonNull Nonce nonce,
                           @NonNull
                           @NonNull UInt64 maxEnergyCost,
                           @NonNull
                           @NonNull UInt32 payloadSize,
                           @NonNull
                           @NonNull Expiry expiry,
                           @Nullable
                           AccountAddress sponsor)

Method Detail

getSponsor

public Optional<AccountAddress> getSponsor()

getBytes

public byte[] getBytes()

fromBytes

public static TransactionHeaderV1 fromBytes(ByteBuffer source)

calculateMaxEnergyCost

public static UInt64 calculateMaxEnergyCost(int senderSignatureCount,
                                            int sponsorSignatureCount,
                                            int payloadSize,
                                            UInt64 transactionSpecificCost)

Calculate the maximum amount of energy that can be spent on executing a transaction.

Parameters:

senderSignatureCount - number of signatures by the sender in the transaction (TransactionSigner.size())

sponsorSignatureCount - number of signatures by the sponsor in the transaction (TransactionSigner.size())

payloadSize - size of the transaction payload in bytes

transactionSpecificCost - cost of the specific transaction (payload) type

Returns:

the energy cost for the transaction, to be set in the transaction header.

See Also:

TransactionTypeCost

builder

public static TransactionHeaderV1.TransactionHeaderV1Builder builder()

toBuilder

public TransactionHeaderV1.TransactionHeaderV1Builder toBuilder()

getSender

@NonNull
public @NonNull AccountAddress getSender()

The address of the account that is the source of the transaction.

getNonce

@NonNull
public @NonNull Nonce getNonce()

The sequence number of the transaction, sender (source) account nonce. Transactions executed on an account must have sequential sequence numbers, starting from 1.

getMaxEnergyCost

@NonNull
public @NonNull UInt64 getMaxEnergyCost()

The amount of energy allocated for executing this transaction. This is the maximum amount of energy that can be spent on executing this transaction.

See Also:

calculateMaxEnergyCost(int, int, int, UInt64)

getPayloadSize

@NonNull
public @NonNull UInt32 getPayloadSize()

The size of the transaction payload in bytes.

getExpiry

@NonNull
public @NonNull Expiry getExpiry()

A Unix timestamp indicating when the transaction should expire. A transaction cannot be included in a block with a timestamp later than the transaction’s expiry time.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

canEqual

protected boolean canEqual(Object other)

hashCode

public int hashCode()

Overrides:

hashCode in class Object