Submit a transaction

The execute() method submits a transaction to a Hedera network. This method will create the transaction ID from the client operator account ID, sign with the client operator private key, and pick a node from the defined network on the client to submit the transaction to. The transaction is also automatically signed with the client operator account private key. You do not need to manually sign transactions if this key is the required key on any given transaction. Once you submit the transaction, the response will include the following:

  • The transaction ID of the transaction

  • The node ID of the node the transaction was submitted to

  • The transaction hash

Transaction Signing Requirements

  • Please refer to the specific transaction type and defined key structure of the account, topic, token, file, or smart contract to understand the signing requirements

Method
Type
Description

execute(<client>)

Client

Sign with the client operator and submit to a Hedera network

execute(<client, timeout>)

Client, Duration

The duration of times the client will try to submit the transaction upon the network being busy

executeWithSigner(<signer>)

Sign the transaction with a local wallet. This feature is available in the Hedera JavaScript SDK only. >=v2.11.0

<transactionResponse>.transactionId

TransactionId

Returns the transaction ID of the transaction

<transactionResponse>.nodeId

AccountId

Returns the node ID of the node that processed the transaction

<transactionResponse>.transactionHash

byte [ ]

Returns the hash of the transaction

<transactionResponse>.setValidateStatus(<validateStatus>)

boolean

Whether getReceipt() or getRecord() will throw an exception if the receipt status is not SUCCESS

<transactionResponse>.getValidateStatus

boolean

Return whether getReceipt() or getRecord() will throw an exception if the receipt status is not SUCCESS

Account Alias

If an alias is set during account creation, it becomes immutable, meaning it cannot be changed. If you plan to update or rotate keys in the future, do not set the alias at the time of initial account creation. The alias can be set after finalizing all key updates.

//Create the transaction
AccountCreateTransaction transaction = new AccountCreateTransaction()
        .setKey(ecdsaPublicKey)
        //do not set if you need to rotate keys in the future
        .setAlias(ecdsaPublicKey.toEvmAddress())
        .setInitialBalance(new Hbar(1));

//Sign with client operator private key and submit the transaction to a Hedera network
TransactionResponse txResponse = transaction.execute(client);

//Get the transaction ID
TransactionId transactionId = txResponse.transactionId;

//Get the account ID of the node that processed the transaction
AccountId nodeId = txResponse.nodeId;

//Get the transaction hash
byte [] transactionHash = txResponse.transactionHash;

System.out.println("The transaction ID is " +transactionId);
System.out.println("The transaction hash is " +transactionHash);
System.out.println("The node ID is " +nodeId);

//v2.0.0

Last updated