Delete a topic

A transaction that deletes a topic from the Hedera network. Once a topic is deleted, the topic cannot be recovered to receive messages and all submitMessage calls will fail. Older messages can still be accessed, even after the topic is deleted, via the mirror node.
Transaction Signing Requirements
If the adminKey was set upon the creation of the topic, the adminKey is required to sign to successfully delete the topic
If no adminKey was set upon the creating of the topic, you cannot delete the topic and will receive an UNAUTHORIZED error
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
V2
V1
Constructor
Description
new TopicDeleteTransaction()
Initializes a TopicDeleteTransaction object
new TopicDeleteTransaction()
Methods
Method
Type
Description
Requirement
setTopicId(<topicId>)
TopicId
The ID of the topic to delete
Required
Java
//Create the transaction
TopicDeleteTransaction transaction = new TopicDeleteTransaction()
    .setTopicId(newTopicId);
        
//Sign the transaction with the admin key, sign with the client operator and submit the transaction to a Hedera network, get the transaction ID
TransactionResponse txResponse = transaction.freezeWith(client).sign(adminKey).execute(client);
​
//Request the receipt of the transaction
TransactionReceipt receipt = txResponse.getReceipt(client);
​
//Get the transaction consensus status
Status transactionStatus = receipt.status;
​
System.out.println("The transaction consensus status is " +transactionStatus);
​
//V2.0.0
JavaScript
//Create the transaction
const transaction = await new TopicDeleteTransaction()
    .setTopicId(newTopicId)
    .freezeWith(client);
        
//Sign the transaction with the admin key
const signTx = await transaction.sign(adminKey);
    
//Sign with the client operator private key and submit to a Hedera network
const txResponse = await signTx.execute(client);
​
//Request the receipt of the transaction
const receipt = await txResponse.getReceipt(client);
​
//Get the transaction consensus status
const transactionStatus = receipt.status;
​
console.log("The transaction consensus status is " +transactionStatus);
​
//v2.0.5
Go
//Create the transaction and freeze the transaction to prepare for signing
transaction := hedera.NewTopicDeleteTransaction().
		SetTopicID(topicID).
		FreezeWith(client)
		
​
//Sign the transaction with the admin key, sign with the client operator and submit the transaction to a Hedera network, get the transaction ID
txResponse, err := transaction.Sign(adminKey).Execute(client)
if err != nil {
		panic(err)
}
​
//Request the receipt of the transaction
receipt, err = txResponse.GetReceipt(client)
if err != nil {
		panic(err)
}
​
//Get the transaction consensus status
transactionStatus := receipt.Status
​
fmt.Printf("The transaction consensus status is %v\n", transactionStatus)
​
//v2.0.0
Constructor
Description
new ConsensusTopicDeleteTransaction()
Initializes a ConsensusTopicDeleteTransaction object
new ConsensusTopicDeleteTransaction()
Methods
Method
Type
Description
setTopicId(<topicId>)
TopicId
The ID of the topic to delete
Java
ConsensusTopicDeleteTransaction transaction = new ConsensusTopicDeleteTransaction()
     .setTopicId(newTopicId);
​
//Sign the transaction with the admin key, sign with the client operator and submit the transaction to a Hedera network, get the transaction ID
TransactionId txId = transaction.build(client).sign(adminKey).execute(client);
​
//Request the receipt of the transaction
TransactionReceipt receipt = txId.getReceipt(client);
​
//Get the transaction consensus status
Status transactionStatus = receipt.status;
​
System.out.println("The transaction consensus status is " +transactionStatus);
​
//v1.3.2
JavaScript
const transaction = new ConsensusTopicDeleteTransaction()
     .setTopicId(newTopicId);
​
//Sign the transaction with the admin key, sign with the client operator and submit the transaction to a Hedera network, get the transaction ID
const txId = await transaction.build(client).sign(adminKey).execute(client);
​
//Request the receipt of the transaction
const receipt = await txId.getReceipt(client);
​
//Get the transaction consensus status
const transactionStatus = receipt.status;
​
console.log("The transaction consensus status is " +transactionStatus);
​
//v1.4.4
Get transaction values
V2
Method
Type
Description
Requirement
getTopicId(<topicId>)
TopicId
The ID of the topic to delete
Required
Java
//Create the transaction
TopicDeleteTransaction transaction = new TopicDeleteTransaction()
    .setTopicId(newTopicId);
​
//Get topic ID
TopicId getTopicId = transaction.getTopicId(); 
​
//v2.0.0
JavaScript
//Create the transaction
const transaction = new TopicDeleteTransaction()
    .setTopicId(newTopicId);
​
//Get topic ID
const getTopicId = transaction.getTopicId();
​
//v2.0.0
Go
//Create the transaction
transaction := hedera.NewTopicDeleteTransaction().
		SetTopicID(topicID)
​
//Get topic ID
getTopicId := transaction.GetTopicID()
​
//v2.0.0
​

Submit a message

Get topic messages

Last modified 1mo ago

Copy link

Edit on GitHub

Outline

Get transaction values

Methods

Methods

Get transaction values

​