Руководство по выпуску масштабируемых UI-значений

Как использовать расширение Scaled UI Amount

Чтобы использовать расширение Scaled UI Amount, необходимо включить его для токена или token account. Обратите внимание, что после создания токена вы не сможете изменить, какие расширения включены.

Включение расширения Scaled UI Amount для токена

Чтобы включить расширение Scaled UI Amount для токена, необходимо установить поле scaled_ui_amount_extension в значение true в аккаунте Mint. Вот пример создания токена с включённым расширением Scaled UI Amount с помощью CLI spl-token:

$ spl-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb create-token --ui-amount-multiplier 1.5
Creating token 66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM under program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

Address:  66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM
Decimals:  9

Signature: 2sPziXu9M3duTCvsDvxQE9UKC9nBiLayi8muDvnjhA2qYvfXSZuaUieoq39MFjg4kf8xFrw6crmYSkPyV59dvudF

Обновление множителя UI-значения

Чтобы обновить множитель UI-значения, используйте команду update-ui-amount-multiplier. Метка времени в секундах с начала эпохи Unix является необязательной и может быть использована для задания пользовательского времени старта для нового множителя. Если метка времени не указана, будет использовано текущее время.

Важное замечание: В настоящее время существует особенность в процессе обновления масштабированного множителя пользовательского интерфейса. На данный момент, если вы выполните следующие действия:

1. Установите масштабированный множитель пользовательского интерфейса на будущее время
2. Время проходит за пределы этого времени обновления
3. Установите другой масштабированный множитель пользовательского интерфейса на будущее время
4. Тогда предыдущий масштабированный множитель будет перезаписан новым, фактически удаляя его.

Существует объединённый PR для исправления этой проблемы, чтобы множитель корректно обновлялся до текущего множителя вместо того, чтобы быть перезаписанным, но это исправление пока не внедрено.

До этого времени необходимо выполнить 2 обновления множителя на шаге 3 выше:

1. Снова установите предыдущий множитель с меткой времени, равной той, которая была изначально установлена на шаге 1 (это корректно установит множитель как текущий множитель).
2. Установите новый множитель, как описано на шаге 3 выше.

$ spl-token update-ui-amount-multiplier 66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM 1.2 -- 1746470000 # 1.2 is the current multiplier as described in step 1 above
$ spl-token update-ui-amount-multiplier 66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM 1.5 -- 1746471400

Получение баланса

Чтобы получить баланс, используйте команду balance.

$ spl-token balance 66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM