Skip to content

Latest commit

 

History

History
109 lines (82 loc) · 5.17 KB

submit-a-transaction.md

File metadata and controls

109 lines (82 loc) · 5.17 KB
Raw

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

{% tabs %} {% tab title="Java" %}

//Create the transaction
AccountCreateTransaction transaction = new AccountCreateTransaction()
        .setKey(newPublicKey)
        .setInitialBalance(new Hbar(1000));

//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

{% endtab %}

{% tab title="JavaScript" %}

//Create the transaction
const transaction = new AccountCreateTransaction()
        .setKey(newPublicKey)
        .setInitialBalance(new Hbar(1000));

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

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

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

//Get the transaction hash
const transactionHash = txResponse.transactionHash;

console.log("The transaction ID is " +transactionId);
console.log("The transaction hash is " +transactionHash);
console.log("The node ID is " +nodeId);

//v2.0.0

{% endtab %}

{% tab title="Go" %}

//Create the transaction
transaction := hedera.NewAccountCreateTransaction().
        SetKey(publicKey).
        SetInitialBalance(hedera.NewHbar(1000))

//Sign with client operator private key and submit the transaction to a Hedera network
txResponse, err := transaction.Execute(client)

if err != nil {
        panic(err)
}

//Get the transaction ID
transactionId := txResponse.TransactionID

//Get the account ID of the node that processed the transaction
transactionNodeId := txResponse.NodeID

//Get the transaction hash
transactionHash := txResponse.Hash

fmt.Printf("The transaction id is %v\n", transactionId)
fmt.Printf("The transaction hash is %v\n", transactionHash)
fmt.Printf("The node id is %v\n", transactionNodeId)

//v2.0.0

{% endtab %} {% endtabs %}