Hedera
Search…
Pause a token
A token pause transaction prevents the token from being involved in any kind of operation. The token's pause key is required to sign the transaction. This is a key that is specified during the creation of a token. If a token has no pause key, you will not be able to pause the token. If the pause key was not set during the creation of a token, you will not be able to update the token to add this key.
The following operations cannot be performed when a token is paused and will result in a TOKEN_IS_PAUSED status.
  • Updating the token
  • Transfering the token
  • Transferring any other token where it has its paused key in a custom fee schedule
  • Deleting the token
  • Minting or burning a token
  • Freezing or unfreezing an account that holds the token
  • Enabling or disabling KYC
  • Associating or disassociating a token
  • Wiping a token
Once a token is paused, token status will update to paused. To verify if the token's status has been updated to paused, you can request the token info via the SDK or use the token info mirror node query. If the token is not paused the token status will be unpaused. The token status for tokens that do not have an assigned pause key will state PauseNotApplicable.
Transaction Signing Requirements:
  • The pause key of the token
  • Transaction fee payer account key
Constructor
Description
new TokenPauseTransaction()
Initializes the TokenPauseTransaction object
1
new TokenPauseTransaction()
Copied!

Methods

V2
Method
Type
Description
Requirement
setTokenId(<tokenId>)
TokenId
The ID of the token to pause
Required
Java
1
//Create the token pause transaction and specify the token to pause
2
TokenPauseTransaction transaction = new TokenPauseTransaction()
3
.setTokenId(tokenId);
4
​
5
//Freeze the unsigned transaction, sign with the pause key, submit the transaction to a Hedera network
6
TransactionResponse txResponse = transaction.freezeWith(client).sign(pauseKey).execute(client);
7
​
8
//Request the receipt of the transaction
9
TransactionReceipt receipt = txResponse.getReceipt(client);
10
​
11
//Obtain the transaction consensus status
12
Status transactionStatus = receipt.status;
13
​
14
System.out.println("The transaction consensus status is: " +transactionStatus);
15
//v2.2.0
Copied!
JavaScript
1
//Create the token pause transaction, specify the token to pause, freeze the unsigned transaction for signing
2
const transaction = new TokenPauseTransaction()
3
.setTokenId(tokenId);
4
.freezeWith(client);
5
​
6
//Sign with the pause key
7
const signTx = await transaction.sign(pauseKey);
8
​
9
//Submit the transaction to a Hedera network
10
const txResponse = await signTx.execute(client);
11
​
12
//Request the receipt of the transaction
13
const receipt = await txResponse.getReceipt(client);
14
​
15
//Get the transaction consensus status
16
const transactionStatus = receipt.status;
17
​
18
console.log("The transaction consensus status " +transactionStatus.toString());
19
​
20
//v2.2.0
Copied!
Go
1
//Create the token pause transaction, specify the token to pause, freeze the unsigned transaction for signing
2
transaction, err := hedera.NewTokenPauseTransaction().
3
SetTokenID(tokenId).
4
FreezeWith(client)
5
​
6
if err != nil {
7
panic(err)
8
}
9
​
10
//Sign with the pause key
11
txResponse, err = transaction.Sign(pauseKey).Execute(client)
12
​
13
if err != nil {
14
panic(err)
15
}
16
​
17
//Get the receipt of the transaction
18
receipt, err = txResponse.GetReceipt(client)
19
​
20
if err != nil {
21
panic(err)
22
}
23
​
24
//Get the transaction consensus status
25
status := receipt.Status
26
​
27
fmt.Printf("The transaction consensus status is %v\n", status)
28
​
29
//v2.3.0
Copied!
Last modified 3mo ago
Copy link
Contents
Methods