TokenUpdate

Updates an already created 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 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

The Token to be updated

N/A

symbol

string

The new publicly visible symbol of the token. The token name is specified as a Unicode string. Its UTF-8 encoding cannot exceed 100 bytes, and cannot contain the 0 byte (NUL).

N/A

name

string

The new publicly visible name of the token. The token name is specified as a Unicode string. Its UTF-8 encoding cannot exceed 100 bytes, and cannot contain the 0 byte (NUL).

N/A

treasury

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

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

If updated, required

kycKey

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

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

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

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

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

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

N/A

pause_key

Key

The Key which can pause and unpause the Token. If the Token does not currently have a pause key, transaction will resolve to TOKEN_HAS_NO_PAUSE_KEY

N/A

Last updated

#2871: HIP-423 long term scheduled transactions

Change request updated