Update a token
A transaction that updates the properties of an existing token. The admin key must sign this transaction to update any of the token properties. The admin key can update exisitng keys, but cannot add new keys if they were not set during the creation of the token. If no value is given for a field, that field is left unchanged.
For an immutable token (that is, a token created without an admin key), only the expiry may be updated. Setting any other field, in that case, will cause the transaction status to resolve to TOKEN_IS_IMMUTABlE
.
Property | Description |
---|---|
Name | The new name of the token. The token name is specified as a string of UTF-8 characters in Unicode. UTF-8 encoding of this Unicode cannot contain the 0 byte ( |
Symbol | The new symbol of the token. The token symbol is specified as a string of UTF-8 characters in Unicode. UTF-8 encoding of this Unicode cannot contain the 0 byte ( |
Treasury Account | The new treasury account of the token. If the provided treasury account is not existing or deleted, the response will be |
Admin Key | The new admin key of the token. If the token is immutable (no Admin Key was assigned during token creation), the transaction will resolve to |
KYC Key | The new KYC key of the token. If the token does not have currently a KYC key, the transaction will resolve to |
Freeze Key | The new freeze key of the token. If the token does not have currently a freeze key, the transaction will resolve to |
Fee Schedule Key | If set, the new key to use to update the token's custom fee schedule; if the token does not currently have this key, transaction will resolve to |
Pause Key | Update the token's existing pause key. The pause key has the ability to pause or unpause a token. |
Wipe Key | The new wipe key of the token. If the token does not have currently a wipe key, the transaction will resolve to |
Supply Key | The new supply key of the token. If the token does not have currently a supply key, the transaction will resolve to |
Expiration Time | The new expiry time of the token. Expiry can be updated even if the admin key is not set. If the provided expiry is earlier than the current token expiry, the transaction will resolve to |
Auto Renew Account | The new account which will be automatically charged to renew the token's expiration, at autoRenewPeriod interval. |
Auto Renew Period | The new interval at which the auto-renew account will be charged to extend the token's expiry. The default auto-renew period is 7,890,000 seconds. Currently, rent is not enforced for tokens so auto-renew payments will not be made. NOTE: The minimum period of time is approximately 30 days (2592000 seconds) and the maximum period of time is approximately 92 days (8000001 seconds). Any other value outside of this range will return the following error: AUTORENEW_DURATION_NOT_IN_RANGE. |
Memo | Short publicly visible memo about the token. No guarantee of uniqueness. (100 characters max) |
Transaction Signing Requirements
Admin key is required to sign to update any token properties
Updating the admin key requires the new admin key to sign
If a new treasury account is set, the new treasury key is required to sign
The account that is paying for the transaction fee
Transaction Fees
the Please see the transaction and query fees table for base transaction fee
Please use the Hedera fee estimator to estimate your transaction fee cost
Methods
Method | Type | Requirement |
---|---|---|
| Required | |
| String | Optional |
| String | Optional |
| Optional | |
| Key | Optional |
| Key | Optional |
| Key | Optional |
| Key | Optional |
| Key | Optional |
| Key | Optional |
| Key | Optional |
| Instant | Optional |
| String | Optional |
| Optional | |
| Duration | Optional |
Last updated