Skip to content

Latest commit

 

History

History
86 lines (65 loc) · 4.16 KB

associate-tokens-to-an-account.md

File metadata and controls

86 lines (65 loc) · 4.16 KB

Associate tokens to an account

Associates the provided Hedera account with the provided Hedera token(s). Hedera accounts must be associated with a fungible or non-fungible token first before you can transfer tokens to that account. In the case of NON_FUNGIBLE Type, once an account is associated, it can hold any number of NFTs (serial numbers) of that token type. The Hedera account that is being associated with a token is required to sign the transaction.

  • 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 any of the provided tokens is not found, the transaction will resolve to INVALID_TOKEN_REF.
  • If any of the provided tokens has been deleted, the transaction will resolve to TOKEN_WAS_DELETED.
  • If an association between the provided account and any of the tokens already exists, the transaction will resolve to TOKEN_ALREADY_ASSOCIATED_TO_ACCOUNT.
  • If the provided account's associations count exceeds the constraint of maximum token associations per account, the transaction will resolve to TOKENS_PER_ACCOUNT_LIMIT_EXCEEDED.
  • On success, associations between the provided account and tokens are made and the account is ready to interact with the tokens.

{% hint style="info" %} There is no limit on the number of token IDs that can be associated to an account. Reference HIP-367. {% endhint %}

Transaction Signing Requirements

  • The key of the account the token is being associated to
  • 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 TokenAssociateTransaction() Initializes a TokenAssociateTransaction object 
new TokenAssociateTransaction()

Methods

{% tabs %} {% tab title="V1" %}

Method Type Description Requirement
setAccountId(<accountId>) AccountId The account to be associated with the provided tokens Required
addTokenId(<tokenId>) TokenId The tokens to be associated with the provided account Required

{% code title="Java" %}

//Associate a token to an account
TokenAssociateTransaction transaction = new TokenAssociateTransaction()
        .setAccountId(accountId)
        .addTokenId(tokenId);

//Build the unsigned transaction, sign with the private key of the account that is being associated to a token, submit the transaction to a Hedera network
TransactionId transactionId = transaction.build(client).sign(accountKey).execute(client);

//Request the receipt of the transaction
TransactionReceipt getReceipt = transactionId.getReceipt(client);

//Obtain the transaction consensus status
Status transactionStatus = getReceipt.status;

System.out.println("The transaction consensus status " +transactionStatus);
//Version: 1.2.2

{% endcode %}

{% code title="JavaScript" %}

//Associate a token to an account 
const transaction = new TokenAssociateTransaction()
        .setAccountId(accountId)
        .addTokenId(tokenId); //Will change to addTokenId()

//Build the unsigned transaction, sign with the private key of the account that is being associated to a token, submit the transaction to a Hedera network
const transactionId = await transaction.build(client).sign(accountKey).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 " +transactionStatus);
//Version 1.4.2

{% endcode %} {% endtab %} {% endtabs %}