Guida all'emittente di importi UI scalati

Come utilizzare l'estensione Scaled UI Amount

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

Abilitare l'estensione Scaled UI Amount su un token mint

Per abilitare l'estensione Scaled UI Amount su un token mint, 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, è opzionale 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 un'idiosincrasia nel processo di aggiornamento del moltiplicatore UI scalato. Al momento, se fai quanto segue:

1. Imposti un moltiplicatore UI scalato per il futuro
2. Il tempo passa oltre questo orario di aggiornamento
3. Imposti un altro moltiplicatore UI scalato per il futuro
4. Quindi il moltiplicatore UI scalato precedente viene sovrascritto dal nuovo, eliminandolo di fatto.

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

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

1. Impostare nuovamente il moltiplicatore precedente con il timestamp allo stesso timestamp originariamente impostato nel passaggio 1 (questo imposterà correttamente il moltiplicatore come moltiplicatore corrente)
2. Impostare 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, è necessario utilizzare il comando balance.

$ spl-token balance 66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM