Guide de l'émetteur pour le montant d'interface utilisateur mis à l'échelle

Comment utiliser l'extension Scaled UI Amount

Pour utiliser l'extension Scaled UI Amount, vous devez l'activer sur un mint de token ou un token account. Notez qu'une fois qu'un token est créé, vous ne pouvez pas modifier les extensions activées.

Activer l'extension Scaled UI Amount sur un mint de token

Pour activer l'extension Scaled UI Amount sur un mint de token, vous devez définir le champ scaled_ui_amount_extension à true dans le compte Mint. Voici un exemple de création d'un token avec l'extension Scaled UI Amount activée en utilisant le 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

Mettre à jour le multiplicateur de montant d'interface utilisateur

Pour mettre à jour le multiplicateur de montant UI, vous devez utiliser la commande update-ui-amount-multiplier. Un horodatage, en secondes depuis l'epoch Unix, est optionnel et peut être utilisé pour définir une heure de début personnalisée pour le nouveau multiplicateur. Si aucun horodatage n'est fourni, l'horodatage actuel sera utilisé.

Note importante : Il existe actuellement une particularité dans le processus de mise à jour du multiplicateur UI mis à l'échelle. Actuellement, si vous faites ce qui suit :

1. Définir un multiplicateur UI mis à l'échelle pour le futur
2. Le temps passe au-delà de cette heure de mise à jour
3. Définir un autre multiplicateur UI mis à l'échelle pour le futur
4. Alors le multiplicateur UI mis à l'échelle précédent est remplacé par le nouveau, l'effaçant effectivement.

Il existe une PR fusionnée pour corriger cela afin que le multiplicateur se mette à jour correctement vers le multiplicateur actuel au lieu d'être remplacé, mais ce n'est pas encore en production.

Jusqu'à ce moment, il est nécessaire de faire 2 mises à jour du multiplicateur pendant l'étape 3 ci-dessus :

1. Définir à nouveau le multiplicateur précédent avec l'horodatage au même horodatage initialement défini à l'étape 1 (cela définira correctement le multiplicateur comme multiplicateur actuel)
2. Définir le nouveau multiplicateur comme décrit à l'étape 3 ci-dessus

$ 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

Récupérer le solde

Pour récupérer le solde, vous devez utiliser la commande balance.

$ spl-token balance 66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM