Руководство по выпуску масштабируемых 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-значения

Чтобы обновить множитель суммы пользовательского интерфейса, вам нужно использовать команду 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