Module com.hedera.hashgraph.sdk

Package com.hedera.hashgraph.sdk

Class TokenDissociateTransaction

java.lang.Object

com.hedera.hashgraph.sdk.Executable<TokenDissociateTransaction,Transaction,TransactionResponse,TransactionResponse>

com.hedera.hashgraph.sdk.Transaction<TokenDissociateTransaction>

com.hedera.hashgraph.sdk.TokenDissociateTransaction

public class TokenDissociateTransaction
extends Transaction<TokenDissociateTransaction>

Dissociate an account from one or more HTS tokens. If the identified account is not found, the transaction SHALL return `INVALID_ACCOUNT_ID`.
If the identified account has been deleted, the transaction SHALL return `ACCOUNT_DELETED`.
If any of the identified tokens is not found, the transaction SHALL return `INVALID_TOKEN_REF`.
If any of the identified tokens has been deleted, the transaction SHALL return `TOKEN_WAS_DELETED`.
If an association does not exist for any of the identified tokens, the transaction SHALL return `TOKEN_NOT_ASSOCIATED_TO_ACCOUNT`.
If the identified account has a nonzero balance for any of the identified tokens, and that token is neither deleted nor expired, the transaction SHALL return `TRANSACTION_REQUIRES_ZERO_TOKEN_BALANCES`.
If one of the identified tokens is a fungible/common token that is expired, the account MAY disassociate from that token, even if that token balance is not zero for that account.
If one of the identified tokens is a non-fungible/unique token that is expired, the account MUST NOT disassociate if that account holds any individual NFT of that token. In this situation the transaction SHALL return `TRANSACTION_REQUIRED_ZERO_TOKEN_BALANCES`.
The identified account MUST sign this transaction. ### Block Stream Effects None

Nested Class Summary

Nested classes/interfaces inherited from class com.hedera.hashgraph.sdk.Transaction

Transaction.SignableNodeTransactionBodyBytes

Nested classes/interfaces inherited from class com.hedera.hashgraph.sdk.Executable

Executable.GrpcRequest

Field Summary

Fields inherited from class com.hedera.hashgraph.sdk.Transaction

customFeeLimits, DEFAULT_AUTO_RENEW_PERIOD, defaultMaxTransactionFee, DUMMY_ACCOUNT_ID, DUMMY_TRANSACTION_ID, frozenBodyBuilder, innerSignedTransactions, outerTransactions, publicKeys, regenerateTransactionId, signers, sigPairLists, sourceTransactionBody, transactionIds

Fields inherited from class com.hedera.hashgraph.sdk.Executable

attemptedAllNodes, blockingUnaryCall, grpcDeadline, logger, maxAttempts, maxBackoff, minBackoff, nodeAccountIds, nodes, random, RST_STREAM

Constructor Summary

Constructors

Constructor	Description
TokenDissociateTransaction()	Constructor.
TokenDissociateTransaction(TransactionBody txBody)	Constructor.
TokenDissociateTransaction(LinkedHashMap<TransactionId,LinkedHashMap<AccountId,Transaction>> txs)	Constructor.

Method Summary

Modifier and Type	Method	Description
(package private) TokenDissociateTransactionBody.Builder	build()	Build the transaction body.
AccountId	getAccountId()	Extract the account id.
(package private) io.grpc.MethodDescriptor<Transaction,TransactionResponse>	getMethodDescriptor()	Called to direct the invocation of the query to the appropriate gRPC service.
List<TokenId>	getTokenIds()	Extract the list of token id's.
(package private) void	initFromTransactionBody()	Initialize from the transaction body.
(package private) void	onFreeze(TransactionBody.Builder bodyBuilder)	Called in Transaction.freezeWith(Client) just before the transaction body is built.
(package private) void	onScheduled(SchedulableTransactionBody.Builder scheduled)	Called in Transaction.schedule() when converting transaction into a scheduled version.
TokenDissociateTransaction	setAccountId(AccountId accountId)	An account identifier.
TokenDissociateTransaction	setTokenIds(List<TokenId> tokens)	A list of token identifiers.
(package private) void	validateChecksums(Client client)

Methods inherited from class com.hedera.hashgraph.sdk.Transaction

addSignature, addSignature, batchify, buildAllTransactions, buildTransaction, doSchedule, estimateFee, freeze, freezeWith, fromBytes, fromScheduledTransaction, generateTransactionIds, getBatchKey, getDefaultMaxTransactionFee, getExecutionState, getHighVolume, getMaxTransactionFee, getRegenerateTransactionId, getRequiredChunks, getSignableNodeBodyBytesList, getSignatures, getSignaturesAtOffset, getTransactionBodySize, getTransactionHash, getTransactionHashPerNode, getTransactionId, getTransactionIdInternal, getTransactionMemo, getTransactionSize, getTransactionValidDuration, hash, isBatchedAndNotBatchTransaction, isFrozen, keyAlreadySigned, makeRequest, mapResponse, mapResponseStatus, onExecute, onExecuteAsync, regenerateTransactionId, requireNotFrozen, requireOneNodeAccountId, schedule, setBatchKey, setHighVolume, setMaxTransactionFee, setNodeAccountIds, setRegenerateTransactionId, setTransactionId, setTransactionMemo, setTransactionValidDuration, sign, signTransaction, signWith, signWithOperator, spawnBodyBuilder, toBytes, toString, wipeTransactionLists

Methods inherited from class com.hedera.hashgraph.sdk.Executable

advanceRequest, checkNodeAccountIds, execute, execute, executeAsync, executeAsync, executeAsync, executeAsync, executeAsync, executeAsync, getGrpcRequest, getMaxAttempts, getMaxBackoff, getMaxRetry, getMinBackoff, getNodeAccountIds, getNodeForExecute, grpcDeadline, logTransaction, mergeFromClient, setGrpcDeadline, setLogger, setMaxAttempts, setMaxBackoff, setMaxRetry, setMinBackoff, setNodesFromNodeAccountIds, setRequestListener, setResponseListener, shouldRetryExceptionally

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

TokenDissociateTransaction

public TokenDissociateTransaction()

Constructor.

TokenDissociateTransaction

TokenDissociateTransaction(LinkedHashMap<TransactionId,LinkedHashMap<AccountId,Transaction>> txs)
                    throws com.google.protobuf.InvalidProtocolBufferException

Constructor.

Parameters:

txs - Compound list of transaction id's list of (AccountId, Transaction) records

Throws:

com.google.protobuf.InvalidProtocolBufferException - when there is an issue with the protobuf

TokenDissociateTransaction

TokenDissociateTransaction(TransactionBody txBody)

Constructor.

Parameters:

txBody - protobuf TransactionBody

Method Details

getAccountId

@Nullable
public AccountId getAccountId()

Extract the account id.

Returns:

the account id

setAccountId

public TokenDissociateTransaction setAccountId(AccountId accountId)

An account identifier.

The identified account SHALL be dissociated from each of the tokens identified in the `tokens` field. This field is REQUIRED and MUST be a valid account identifier.
The identified account MUST exist in state.
The identified account MUST NOT be deleted.
The identified account MUST NOT be expired.

Parameters:

accountId - the account id

Returns:

this

getTokenIds

public List<TokenId> getTokenIds()

Extract the list of token id's.

Returns:

the list of token id's

setTokenIds

public TokenDissociateTransaction setTokenIds(List<TokenId> tokens)

A list of token identifiers.

Each token identified in this list SHALL be dissociated from the account identified in the `account` field.
This list MUST NOT be empty. Each entry in this list MUST be a valid token identifier.
Each entry in this list MUST be currently associated to the account identified in `account`.
Entries in this list MAY be expired, if the token type is fungible/common.
Each entry in this list MUST NOT be deleted.

Parameters:

tokens - the list of token id's.

Returns:

this

initFromTransactionBody

void initFromTransactionBody()

Initialize from the transaction body.

build

TokenDissociateTransactionBody.Builder build()

Build the transaction body.

Returns:

TokenDissociateTransactionBody

validateChecksums

void validateChecksums(Client client)
                throws BadEntityIdException

Specified by:

validateChecksums in class Transaction<TokenDissociateTransaction>

Throws:

BadEntityIdException

getMethodDescriptor

io.grpc.MethodDescriptor<Transaction,TransactionResponse> getMethodDescriptor()

Description copied from class: Executable

Called to direct the invocation of the query to the appropriate gRPC service.

Specified by:

getMethodDescriptor in class Executable<TokenDissociateTransaction,Transaction,TransactionResponse,TransactionResponse>

onFreeze

void onFreeze(TransactionBody.Builder bodyBuilder)

Description copied from class: Transaction

Called in Transaction.freezeWith(Client) just before the transaction body is built. The intent is for the derived class to assign their data variant to the transaction body.

Specified by:

onFreeze in class Transaction<TokenDissociateTransaction>

onScheduled

void onScheduled(SchedulableTransactionBody.Builder scheduled)

Description copied from class: Transaction

Called in Transaction.schedule() when converting transaction into a scheduled version.

Specified by:

onScheduled in class Transaction<TokenDissociateTransaction>