Unfreezes transfers of the specified token for the account. The transaction must be signed by the token's Freeze Key.
- If the provided account is not found, the transaction will resolve to INVALID_ACCOUNT_ID.
- If the provided account has been deleted, the transaction will resolve to ACCOUNT_DELETED.
- If the provided token is not found, the transaction will resolve to INVALID_TOKEN_ID.
- If the provided token has been deleted, the transaction will resolve to TOKEN_WAS_DELETED.
- If an Association between the provided token and account is not found, the transaction will resolve to TOKEN_NOT_ASSOCIATED_TO_ACCOUNT.
- If no Freeze Key is defined, the transaction will resolve to TOKEN_HAS_NO_FREEZE_KEY.
- Once executed the Account is marked as Unfrozen and will be able to receive or send tokens. The operation is idempotent.
Transaction Signing Requirements
- Freeze key
- Transaction fee payer account key
Transaction Fees
- Please see the transaction and query fees table for base transaction fee
- Please use the Hedera fee estimator to estimate your transaction fee cost
Constructor | Description |
---|---|
new TokenUnfreezeTransaction() |
Initializes the TokenUnfreezeTransaction object |
new TokenUnfreezeTransaction()
{% tabs %} {% tab title="V1" %}
Method | Type | Description | Requirement |
---|---|---|---|
setTokenId(<tokenId>) |
TokenId | The token for this account to unfreeze | Required |
setAccountId(<accountId>) |
AccountId | The account to unfreeze | Required |
{% code title="Java" %}
//Unfreeze an account
TokenUnfreezeTransaction transaction = new TokenUnfreezeTransaction()
.setAccountId(newAccountId)
.setTokenId(newTokenId);
//Build the unsigned transaction, sign with the sender freeze private key of the token, submit the transaction to a Hedera network
TransactionId transactionId = transaction.build(client).sign(freezeKey).execute(client);
//Request the receipt of the transaction
TransactionReceipt getReceipt = transactionId.getReceipt(client);
//Obtain the transaction consensus status
Status transactionStatus = getReceipt.status;
System.out.print("The transaction consensus status is " +transactionStatus);
//Version: 1.2.2
{% endcode %}
{% code title="JavaScript" %}
//Unfreeze an account
const transaction = new TokenUnfreezeTransaction()
.setAccountId(newAccountId)
.setTokenId(newTokenId);
//Build the unsigned transaction, sign with the freeze private key of the token, submit the transaction to a Hedera network
const transactionId = await transaction.build(client).sign(freezeKey).execute(client);
//Request the receipt of the transaction
const getReceipt = await transactionId.getReceipt(client);
//Obtain the transaction consensus status
const transactionStatus = getReceipt.status;
console.log("The transaction consensus status is " +transactionStatus);
//Version 1.4.2
{% endcode %} {% endtab %} {% endtabs %}