スケールドUI金額発行者ガイド

スケールドUI金額拡張機能の使用方法

スケールドUI金額拡張機能を使用するには、トークンミントまたはトークンアカウントで有効にする必要があります。トークンが作成された後は、有効になっている拡張機能を変更することはできないことに注意してください。

トークンミントでスケールドUI金額拡張機能を有効にする

トークンミントでスケールドUI金額拡張機能を有効にするには、Mintアカウントのscaled_ui_amount_extensionフィールドをtrueに設定する必要があります。以下はspl-token CLIを使用してスケールドUI金額拡張機能を有効にしたトークンを作成する例です：

$ 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エポックからの秒単位のタイムスタンプはオプションで、新しい乗数のカスタム開始時間を設定するために使用できます。タイムスタンプが提供されない場合は、現在のタイムスタンプが使用されます。

重要な注意点： 現在、スケールドUI乗数を更新するプロセスには特異な点があります。現時点では、以下の操作を行うと：

1. 将来のスケールドUI乗数を設定する
2. この更新時間を超えて時間が経過する
3. 将来の別のスケールドUI乗数を設定する
4. すると、以前のスケールドUI乗数は新しい乗数によって上書きされ、実質的に削除されます。

乗数が上書きされるのではなく、現在の乗数に適切に更新されるように修正PRがマージされましたが、これはまだ本番環境では利用できません。

この時点までは、上記のステップ3の間に2回の乗数更新を行う必要があります：

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