Guida per emittenti Scaled UI Amount

Come utilizzare l'estensione Scaled UI Amount

Per utilizzare l'estensione Scaled UI Amount, devi abilitarla su un mint di token o su un account token. Nota che una volta creato un token, non puoi modificare quali estensioni sono abilitate.

Abilitare l'estensione Scaled UI Amount su un mint di token

Per abilitare l'estensione Scaled UI Amount su un mint di token, devi impostare il campo scaled_ui_amount_extension su true nell'account Mint. Ecco un esempio di come creare un token con l'estensione Scaled UI Amount abilitata utilizzando la 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

Aggiornare il moltiplicatore dell'importo UI

Per aggiornare il moltiplicatore dell'importo UI, devi utilizzare il comando update-ui-amount-multiplier. Un timestamp, in secondi dall'epoca Unix, è facoltativo e può essere utilizzato per impostare un orario di inizio personalizzato per il nuovo moltiplicatore. Se non viene fornito alcun timestamp, verrà utilizzato il timestamp corrente.

Nota importante: attualmente esiste una particolarità nel processo di aggiornamento del moltiplicatore scaled ui. Al momento, se esegui le seguenti operazioni:

1. Imposti un moltiplicatore scaled ui per il futuro
2. Il tempo passa oltre questo orario di aggiornamento
3. Imposti un altro moltiplicatore scaled ui per il futuro
4. Allora il precedente moltiplicatore scaled ui viene sovrascritto da quello nuovo, rimuovendolo di fatto.

C'è una PR unita per risolvere questo problema in modo che il moltiplicatore si aggiorni correttamente al moltiplicatore attuale invece di essere sovrascritto, ma non è ancora attiva.

Fino a quel momento è necessario effettuare 2 aggiornamenti del moltiplicatore durante il passaggio 3 sopra:

1. Imposta nuovamente il moltiplicatore precedente con il timestamp allo stesso timestamp originariamente impostato nel passaggio 1 (questo imposterà correttamente il moltiplicatore come moltiplicatore attuale)
2. Imposta il nuovo moltiplicatore come descritto nel passaggio 3 sopra

$ 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

Recuperare il saldo

Per recuperare il saldo, devi utilizzare il comando balance.

$ spl-token balance 66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM