Guia do Emissor de Quantia com UI Escalada

Como usar a extensão Scaled UI Amount

Para usar a extensão Scaled UI Amount, você precisa habilitá-la em uma mint de token ou em uma token account. Observe que depois que um token é criado, você não pode modificar quais extensões estão habilitadas.

Habilitar a extensão Scaled UI Amount em uma mint de token

Para habilitar a extensão Scaled UI Amount em uma mint de token, você precisa definir o campo scaled_ui_amount_extension como true na conta Mint. Aqui está um exemplo de como criar um token com a extensão Scaled UI Amount habilitada usando a 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

Atualizar o multiplicador de quantia da UI

Para atualizar o multiplicador de quantidade da UI, você precisa usar o comando update-ui-amount-multiplier. Um timestamp, em segundos desde a época Unix, é opcional e pode ser usado para definir um horário de início personalizado para o novo multiplicador. Se nenhum timestamp for fornecido, o timestamp atual será usado.

Nota importante: Atualmente existe uma idiossincrasia no processo de atualização do multiplicador de escala da UI. Neste momento, se você fizer o seguinte:

1. Definir um multiplicador de escala da UI para o futuro
2. O tempo passar além desse horário de atualização
3. Definir outro multiplicador de escala da UI para o futuro
4. Então o multiplicador de escala da UI anterior é substituído pelo novo, efetivamente removendo-o.

Existe um PR mesclado para corrigir isso para que o multiplicador seja atualizado corretamente para o multiplicador atual em vez de ser substituído, mas isso ainda não está ativo.

Até esse momento, é necessário fazer 2 atualizações de multiplicador durante a etapa 3 acima:

1. Definir o multiplicador anterior novamente com o timestamp para o mesmo timestamp que foi originalmente definido na etapa 1 (isso definirá corretamente o multiplicador como o multiplicador atual)
2. Definir o novo multiplicador conforme descrito na etapa 3 acima

$ 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

Consultar o saldo

Para consultar o saldo, você precisa usar o comando balance.

$ spl-token balance 66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM