TokenUpdate

Updates an already created Token.

If no value is given for a field, that field is left unchanged. For an immutable tokens (that is, a token created without an adminKey), only the expiry may be updated. Setting any other field in that case will cause the transaction status to resolve to TOKEN_IS_IMMUTABlE.

TokenUpdateTransactionBody

Field

Type

Description

Signature Required

token

TokenID

The Token to be updated

N/A

symbol

string

The new Symbol of the Token. Must be UTF-8 capitalized alphabetical string identifying the token.

N/A

name

string

The new Name of the Token. Must be a string of ASCII characters.

N/A

treasury

AccountID

The new Treasury account of the Token. If the provided treasury account is not existing or deleted, the response will be INVALID_TREASURY_ACCOUNT_FOR_TOKEN. If successful, the Token balance held in the previous Treasury Account is transferred to the new one.

If updated, required

adminKey

Key

The new Admin key of the Token. If Token is immutable, transaction will resolve to TOKEN_IS_IMMUTABlE.

If updated, required

kycKey

Key

The new KYC key of the Token. If Token does not have currently a KYC key, transaction will resolve to TOKEN_HAS_NO_KYC_KEY.

If updated, required

freezeKey

Key

The new Freeze key of the Token. If the Token does not have currently a Freeze key, transaction will resolve to TOKEN_HAS_NO_FREEZE_KEY.

If updated, required

wipeKey

Key

The new Wipe key of the Token. If the Token does not have currently a Wipe key, transaction will resolve to TOKEN_HAS_NO_WIPE_KEY.

If updated, required

supplyKey

Key

The new Supply key of the Token. If the Token does not have currently a Supply key, transaction will resolve to TOKEN_HAS_NO_SUPPLY_KEY.

If updated, required

autoRenewAccount

AccountID

The new account which will be automatically charged to renew the token's expiration, at autoRenewPeriod interval.

N/A

autoRenewPeriod

uint64

The new interval at which the auto-renew account will be charged to extend the token's expiry.

N/A

expiry

uint64

The new expiry time of the token. Expiry can be updated even if admin key is not set. If the provided expiry is earlier than the current token expiry, transaction wil resolve to INVALID_EXPIRATION_TIME

N/A

memo

string

The memo associated with the token (UTF-8 encoding max 100 bytes)

N/A

feeScheduleKey

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 TOKEN_HAS_NO_FEE_SCHEDULE_KEY

If updated, required