hedera-docs
hedera-docs copied to clipboard
Add HIP-367: Unlimited Token Associations Per Account
HIP-367 deprecates a few fields in HAPI queries. There will be a deprecation period announced before Services either stops populating these fields or removes the field entirely.
First, when an account has more than 1000 tokens associated to it, the getAccountInfo, getContractInfo, and getAccountBalance queries will not support fetching all of those associations. Rather the number of token associations that will be fetched from the queries will be dictated by the dynamic property tokens.maxRelsPerInfoQuery. The token associations returned by these queries will have at most 1000 associations. They may come in any particular order. (As noted above, this HIP officially deprecates the token association data in these three queries. Clients should plan migration strategies to begin getting this information from mirror nodes, c.f. this issue.)
SDK APIs impacted by this change:
-
TokenInfoQuery
-
AccountInfoQuery
-
ContractInfoQuery
### Tasks
- [ ] When the deprecation timeline is announced, identify the needed sections that should have a callout explaining the deprecation period and link the related blog
- [ ] When the deprecation period ends, remove the callout, note property is not to be used, and mention the mirror node rest API that should be used to get the data
- [ ] Callout on getAccountInfo, getContractInfo, getTokenInfo SDK pages
- [ ] Delete token relations HIP
https://hips.hedera.com/hip/hip-367