In this tutorial, you'll learn how to create and sign a scheduled transaction. Scheduled Transactions enable multiple parties to easily, inexpensively, and natively schedule and execute any type of Hedera transaction together. Once a transaction is scheduled, additional signatures can be submitted via a ScheduleSign transaction. After the last signature is received within the allotted timeframe, the scheduled transaction will execute.
Prerequisites
We recommend you complete the following introduction to get a basic understanding of Hedera transactions. This example does not build upon the previous examples.
First, you will need to build the transaction to schedule. In the example below, you will create a transfer transaction. The sender account has a threshold key structure that requires 2 out of the 3 keys to sign the transaction to authorize the transfer amount.
//Create a transaction to scheduleTransferTransaction transaction =newTransferTransaction().addHbarTransfer(senderAccount,Hbar.fromTinybars(-1)).addHbarTransfer(recipientAccount,Hbar.fromTinybars(1));
//Create a transaction to scheduleconsttransaction=newTransferTransaction().addHbarTransfer(senderAccount,Hbar.fromTinybars(-1)).addHbarTransfer(recipientAccount,Hbar.fromTinybars(1));
//Create a transaction to scheduletransaction := hedera.NewTransferTransaction(). AddHbarTransfer(senderAccount, hedera.HbarFromTinybar(-1)). AddHbarTransfer(recipientAccount, hedera.HbarFromTinybar(1))
2. Schedule the transfer transaction
Next, you will schedule the transfer transaction by submitting a ScheduleCreate transaction to the network. Once the transfer transaction is scheduled, you can obtain the schedule ID from the receipt of the ScheduleCreate transaction. The schedule ID identifies the schedule that scheduled the transfer transaction. The schedule ID can be shared with the three signatories. The schedule is immutable unless the admin key is specified during creation.
The scheduled transaction ID of the transfer transaction can also be returned from the receipt of the ScheduleCreate transaction. You will notice that the transaction ID for a scheduled transaction includes a ?scheduled flag e.g. 0.0.9401@1620177544.531971543?scheduled. All transactions that have been scheduled will include this flag.
You can optionally add signatures you may have during the creation of the ScheduleCreate transaction by calling .freezeWith(client) and .sign() methods. This might make sense if you are one of the required signatures for the scheduled transaction.
Visit the page below to view additional properties that can be set when building a ScheduleCreate transaction.
//Schedule a transactionTransactionResponse scheduleTransaction =newScheduleCreateTransaction().setScheduledTransaction(transaction).execute(client);//Get the receipt of the transactionTransactionReceipt receipt =scheduleTransaction.getReceipt(client);//Get the schedule IDScheduleId scheduleId =receipt.scheduleId;System.out.println("The schedule ID is "+scheduleId);//Get the scheduled transaction IDTransactionId scheduledTxId =receipt.scheduledTransactionId;System.out.println("The scheduled transaction ID is "+scheduledTxId);
//Schedule a transactionconstscheduleTransaction=awaitnewScheduleCreateTransaction().setScheduledTransaction(transaction).execute(client);//Get the receipt of the transactionconstreceipt=awaitscheduleTransaction.getReceipt(client);//Get the schedule IDconstscheduleId=receipt.scheduleId;console.log("The schedule ID is "+scheduleId);//Get the scheduled transaction IDconstscheduledTxId=receipt.scheduledTransactionId;console.log("The scheduled transaction ID is "+scheduledTxId);
//Schedule a transactionscheduleTransaction, err := hedera.NewScheduleCreateTransaction(). SetScheduledTransaction(transaction)if err !=nil {panic(err)}submitScheduleTx, err := scheduleTransaction.Execute(client)if err !=nil {panic(err)}//Get the receipt of the transactionreceipt, err := submitScheduleTx.GetReceipt(client)if err !=nil {panic(err)}//Get the schedule IDscheduleId := receipt.ScheduleIDfmt.Printf("The schedule ID %v\n", scheduleId)//Get the scheduled transaction IDscheduleTxId := receipt1.ScheduledTransactionIDfmt.Printf("The scheduled transaction ID is %v\n", scheduleTxId)
3. Submit Signatures
Submit one of the required signatures for the transfer transaction
The signatures are submitted to the network via a ScheduleSign transaction. The ScheduleSign transaction requires the schedule ID of the schedule and the signature of one or more of the required keys. The scheduled transaction has 30 minutes from the time it is scheduled to receive all of its signatures; if the signature requirements are not met, the scheduled transaction will expire.
In the example below, you will submit one signature, confirm the transaction was successful, and get the schedule info to verify the signature was added to the schedule. To verify the signature was added, you can compare the public key of the submitted signature to the public key that is returned from the schedule info request.
//Submit the first signaturesTransactionResponse signature1 =newScheduleSignTransaction().setScheduleId(scheduleId).freezeWith(client).sign(signerKey1).execute(client);//Verify the transaction was successful and submit a schedule info requestTransactionReceipt receipt1 =signature1.getReceipt(client);System.out.println("The transaction status is "+receipt1.status);ScheduleInfo query1 =newScheduleInfoQuery().setScheduleId(scheduleId).execute(client);//Confirm the signature was added to the schedule System.out.println(query1);
//Submit the first signatureconstsignature1=await (awaitnewScheduleSignTransaction().setScheduleId(scheduleId).freezeWith(client).sign(signerKey1)).execute(client);//Verify the transaction was successful and submit a schedule info requestconstreceipt1=awaitsignature1.getReceipt(client);console.log("The transaction status is "+receipt1.status.toString());constquery1=awaitnewScheduleInfoQuery().setScheduleId(scheduleId).execute(client);//Confirm the signature was added to the schedule console.log(query1);
//Submit the first signaturesignature1, err := hedera.NewScheduleSignTransaction(). SetScheduleID(scheduleId). FreezeWith(client)if err !=nil {panic(err)}//Verify the transaction was successful and submit a schedule info requestsubmitTx, err := signature1.Sign(signerKey1).Execute(client)if err !=nil {panic(err)}receipt1, err := submitTx.GetReceipt(client)if err !=nil {panic(err)}status := receipt1.Statusfmt.Printf("The transaction status is %v\n", status)query1, err := hedera.NewScheduleInfoQuery(). SetScheduleID(scheduleId). Execute(client)//Confirm the signature was added to the schedule fmt.Print(query1)
Submit the second signature
Next, you will submit the second signature and verify the transaction was successful by requesting the receipt. For example purposes, you have access to all three signing keys. But the idea here is that each signer can independently submit their signature to the network.
Java
//Submit the second signatureTransactionResponse signature2 =newScheduleSignTransaction().setScheduleId(scheduleId).freezeWith(client).sign(signerKey2).execute(client);//Verify the transaction was successfulTransactionReceipt receipt2 =signature2.getReceipt(client);System.out.println("The transaction status"+receipt2.status);
//Submit the second signatureconstsignature2=await (awaitnewScheduleSignTransaction().setScheduleId(scheduleId).freezeWith(client).sign(signerKey2)).execute(client);//Verify the transaction was successfulconstreceipt2=awaitsignature2.getReceipt(client);console.log("The transaction status "+receipt2.status.toString());
//Submit the second signaturesignature2, err := hedera.NewScheduleSignTransaction(). SetScheduleID(scheduleId). FreezeWith(client)if err !=nil {panic(err)}//Verify the transaction was successful and submit a schedule info requestsubmitTx2, err := signature2.Sign(signerKey2).Execute(client)if err !=nil {panic(err)}receipt2, err := submitTx2.GetReceipt(client)if err !=nil {panic(err)}status2 := receipt2.Statusfmt.Printf("The transaction status is %v\n", status2)
4. Verify the schedule was triggered
The schedule is triggered after it meets its minimum signing requirements. As soon as the last required signature is submitted, the schedule executes the scheduled transaction. To verify the schedule was triggered, query for the schedule info. When the schedule info is returned, you should notice both public keys that signed in the signatories field and the timestamp recorded for when the schedule transaction was executed in the executedAt field.
//Get the schedule infoScheduleInfo query2 =newScheduleInfoQuery().setScheduleId(scheduleId).execute(client);System.out.println(query2);
//Get the schedule infoconstquery2=awaitnewScheduleInfoQuery().setScheduleId(scheduleId).execute(client);console.log(query2);
//Get the schedule infoquery2, err := hedera.NewScheduleInfoQuery(). SetScheduleID(scheduleId). Execute(client)fmt.Print(query2)
5. Verify the scheduled transaction executed
When the scheduled transaction (transfer transaction) executes a record is produced that contains the transaction details. The scheduled transaction record can be requested immediately after the transaction has executed and includes the corresponding schedule ID. If you do not know when the scheduled transaction will execute, you can always query a mirror node using the scheduled transaction ID without the ?scheduled flag to get a copy of the transaction record.
//Get the scheduled transaction recordTransactionRecord scheduledTxRecord =TransactionId.fromString(scheduledTxId.toString()).getRecord(client);System.out.println("The scheduled transaction record is: "+scheduledTxRecord);
//Get the scheduled transaction recordconstscheduledTxRecord=awaitTransactionId.fromString(scheduledTxId.toString()).getRecord(client);console.log("The scheduled transaction record is: "+scheduledTxRecord);
scheduledTxRecord, err := scheduledTransactionId.GetRecord(client)fmt.Printf("The scheduled transaction record is %v\n", scheduledTxRecord)