TTv1 and TTv2 Compatibility: Cross-Version Transaction Signing

Overview

This guide explains how to enable cross-version transaction signing between Transaction Tool V1 and Transaction Tool V2. If you're using TTv1 and need to sign transactions created in TTv2, or if you're working in a team where some users are on TTv1 and others on TTv2, this workflow allows seamless collaboration.

The workflow involves creating a transaction in TTv2 with a complex key structure, exporting it to TTv1's input folder, signing it in TTv1, and importing the signature back into TTv2 for execution.

---

Prerequisites

Before you begin, ensure you have completed the following:

• Transaction Tool V2 (TTv2) Setup: Follow the New User Installation Guide or Install: Existing Users.

• TTv1 Shared Folder Configuration: Set up your application configuration directory with the required folder structure:

  • Review the folder structure requirements to understand the setup

  • Configure the shared folder path in TTv1 by following the Storage and Drives setup guide

  • Ensure your directory contains InputFiles and OutputFiles subdirectories

• Set up an orginazation and upload a key.

• Fee Payer Account: A Hedera account with sufficient HBAR balance to pay transaction fees.

---

Step-by-Step Guide

Step 1: Create Transaction with Complex Key Structure in TTv2

• Create your desired transaction in Transaction Tool V2. This workflow supports any transaction type that TTv1 can sign.

• For this example, we'll use updating an existing account. Follow the Updating an Existing Account guide to create the update transaction in TTv2.

Specific to this example: You'll need an existing Hedera account that has a complex/threshold key structure.

• Select Create and Share to prepare the transaction.

The transaction is only shared for signing and not sent to the network until all required signatures are collected.

---

Step 2: Export Transaction from TTv2

• After creating the transaction, you will be directed to the transaction details view.

• Select the three-dot menu (⋮) in the upper right corner of the screen.

• From the dropdown menu, select Export.

• Choose the export destination as the InputFiles subdirectory within your TTv1 shared folder.

• At the bottom of the export window, locate the Format dropdown menu.

• Select Transaction Tool (.tx) format.

• Select Export to save the transaction file to TTv1's input folder.

The .tx format is compatible with TTv1. The .tx2 format is only for TTv2-to-TTv2 workflows and will not work with TTv1.

---

Step 3: Signing the Transaction

After creating the transaction, it needs to be signed by the authorized parties. The signing process depends on which version of the Transaction Tool the signers are using.

Step 3a: Sign Transaction in TTv1

If a signer is using Transaction Tool V1, they will need to sign the exported transaction file:

• Open Transaction Tool v1.

• Navigate to the Home page where you will see the imported transaction from the input folder.

• Review the transaction details to confirm it matches your intended transaction.

• Select the Sign option next to the transaction.

• Enter your password to sign the transaction.

• Once signed, TTv1 will automatically generate a ZIP file containing the signed transaction in the OutputFiles subdirectory of your configured shared folder.

• For more details, refer to the Sign Transactions guide.

• Proceed to Step 4 to import the signed transaction back into TTv2.

The signed ZIP file is created automatically and saved to your OutputFiles folder for import into TTv2.

Step 3b: Sign Transaction in TTv2

If a signer is using Transaction Tool V2, they can sign the transaction directly without exporting:

• Open Transaction Tool V2.

• Navigate to the Transaction tab and locate the transaction under Ready to Sign status.

• Click on Details to review the transaction details carefully and verify their accuracy.

• When ready, click the Sign button.

• For more details, refer to the Sign a Transaction guide.

No further action needed: TTv2 signers work directly within the application. Only TTv1 signers need to use the export/import workflow described in Steps 2 and 4.

---

Step 4: Import Signed Transaction from TTv1 to TTv2

• In Transaction Tool V2, navigate to the transaction tab.

• In the upper right corner, select the Import option.

• Navigate to the OutputFiles subdirectory in your TTv1 shared folder and select the signed ZIP file.

• Import the ZIP file directly without unzipping it.

• A selection screen will appear displaying the transaction(s) from the imported file. You can select individual transactions or use Select all to import all transactions from the ZIP file.

• Select Import to complete the import process.

• Once all required signatures are collected, the transaction will appear in the Ready to Execute section.

• The transaction will execute automatically when the valid start time is reached.

If additional signatures are required based on your threshold configuration, collect them before the valid start time.

---