Hướng dẫn người phát hành số lượng UI được chia tỷ lệ

Cách sử dụng tiện ích mở rộng Scaled UI Amount

Để sử dụng tiện ích mở rộng Scaled UI Amount, bạn cần kích hoạt nó trên một token mint hoặc token account. Lưu ý rằng sau khi token được tạo, bạn không thể sửa đổi các tiện ích mở rộng đã được kích hoạt.

Kích hoạt tiện ích mở rộng Scaled UI Amount trên token mint

Để kích hoạt tiện ích mở rộng Scaled UI Amount trên token mint, bạn cần đặt scaled_ui_amount_extension thành true trong tài khoản Mint. Dưới đây là ví dụ về cách tạo token với tiện ích mở rộng Scaled UI Amount được kích hoạt sử dụng 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

Cập nhật bội số UI amount

Để cập nhật bội số lượng UI, bạn cần sử dụng lệnh update-ui-amount-multiplier. Một mốc thời gian, tính bằng giây kể từ thời điểm epoch Unix, là tùy chọn và có thể được sử dụng để đặt thời gian bắt đầu tùy chỉnh cho bội số mới. Nếu không cung cấp mốc thời gian, mốc thời gian hiện tại sẽ được sử dụng.

Lưu ý quan trọng: Hiện tại có một đặc điểm khác thường trong quá trình cập nhật bội số ui được chia tỷ lệ. Hiện tại nếu bạn thực hiện các bước sau:

1. Đặt một bội số ui được chia tỷ lệ cho tương lai
2. Thời gian trôi qua vượt quá thời điểm cập nhật này
3. Đặt một bội số ui được chia tỷ lệ khác cho tương lai
4. Sau đó bội số ui được chia tỷ lệ trước đó sẽ bị ghi đè bởi bội số mới và thực sự bị xóa bỏ.

Đã có một PR đã được hợp nhất để sửa lỗi này để bội số cập nhật đúng cách thành bội số hiện tại thay vì bị ghi đè, nhưng điều này chưa được triển khai.

Cho đến lúc đó, cần thiết phải thực hiện 2 lần cập nhật bội số trong bước 3 ở trên:

1. Đặt lại bội số trước đó với mốc thời gian giống với mốc thời gian ban đầu được đặt trong bước 1 (điều này sẽ đặt bội số đúng cách như bội số hiện tại)
2. Đặt bội số mới như mô tả trong bước 3 ở trên

$ 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

Truy vấn số dư

Để truy vấn số dư, bạn cần sử dụng lệnh balance.

$ spl-token balance 66EV4CaihdqyQ1fbsr51wBsoqKLgAG5KiYz7r5XNrxUM