Freeze an account

Freezes 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 Frozen and will not be able to receive or send tokens unless unfrozen.

• 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 the base transaction fee

• Please use the Hedera fee estimator to estimate your transaction fee cost

Methods

Method	Type	Description	Requirement
setTokenId(<tokenId>)	TokenId	The token for this account to be frozen	Required
setAccountId(<accountId>)	AccountId	The account to be frozen	Required

Java

//Freeze an account from transferring a token
TokenFreezeTransaction transaction = new TokenFreezeTransaction()
    .setAccountId(accountId)
    .setTokenId(tokenId);

//Freeze the unsigned transaction, sign with the sender freeze private key of the token, submit the transaction to a Hedera network
TransactionResponse txResponse = transaction.freezeWith(client).sign(freezeKey).execute(client);
    
//Request the receipt of the transaction
TransactionReceipt receipt = txResponse.getReceipt(client);
    
//Obtain the transaction consensus status
Status transactionStatus = receipt.status;
    
System.out.print("The transaction consensus status is " +transactionStatus);
//v2.0.1

JavaScript

Go