> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/vi/ung-dung-tren-rome/bloom/issuing.md).

# Phát hành

Bloom cho phép bạn phát hành một **tài sản thực tế được cấp quyền** dưới dạng một hợp đồng Solidity thông thường trên một chuỗi Rome, và quản lý nó từ một bảng điều khiển riêng cho từng tài sản. Tài sản này có thể truy cập từ cả ví EVM và Solana, nhưng **việc phát hành chỉ dành cho EVM** — ví Solana chỉ nắm giữ tài sản; nó không tạo ra chúng. Hướng dẫn này bao gồm bảng điều khiển của nhà phát hành, trình hướng dẫn tạo, cổng đăng nhập của bảng điều khiển, và từng thẻ quản trị trong số sáu thẻ.

> **Bạn không đưa cho Bloom bất kỳ tài liệu hay dữ liệu cá nhân nào, và nhà đầu tư của bạn cũng vậy.** Bloom ghi lại *kết quả* của quyết định tuân thủ của bạn; chuỗi ghi một giá trị boolean cho mỗi địa chỉ. Quy trình KYC/AML của bạn — nhà cung cấp, hồ sơ, thời hạn lưu giữ — hoàn toàn nằm trong hệ thống của chính bạn. Mô hình đầy đủ nằm trong [COMPLIANCE.md](https://docs.rome.builders/vi/ung-dung-tren-rome/bloom/compliance.md); hướng dẫn này chỉ dẫn đến đó thay vì nhắc lại.

***

## Những gì bạn có thể làm

Với tư cách là quản trị viên của một tài sản, mọi thứ dưới đây đều là việc bạn có thể làm từ bảng điều khiển — và mỗi việc trong số đó đều là một giao dịch thực sự trên chuỗi, được liên kết trên [Bằng chứng](https://docs.rome.builders/vi/ung-dung-tren-rome/bloom/evidence.md) trang:

* **Phát hành một tài sản** — trình hướng dẫn triển khai nó thành ba hợp đồng (bên dưới).
* **Xem xét đơn đăng ký** — phê duyệt hoặc từ chối từng đơn (một lời từ chối đi kèm lý do mà người nộp đơn có quyền được biết), và cho phép một địa chỉ đã được phê duyệt vào danh sách cho phép.
* **Quản lý danh sách cho phép** — thêm một địa chỉ, thêm **một loạt địa chỉ trong một giao dịch duy nhất** (`batchAddToWhitelist`), hoặc xóa một địa chỉ; token thực thi danh sách này ở mỗi lần chuyển.
* **Đặt cổng cho tài sản** — hạn chế chuyển nhượng chỉ cho danh sách cho phép (điều này làm cho nguồn cung trở nên cố định), hoặc gỡ bỏ hạn chế.
* **Quản lý nguồn cung** — xem tổng số, và đúc hoặc đốt khi bạn giữ vai trò đó.
* **Vận hành đợt bán** — mở một đợt bán (số lượng và giá), đóng nó, thu hồi hàng tồn chưa bán, và rút tiền thu được.
* **Thiết lập và phân phối lợi suất** — đặt loại tiền chi trả, rồi phân phối một khoản chi trả, khoản này đi qua từng người nắm giữ theo từng giao dịch một; các người nắm giữ bị loại trừ sẽ bị bỏ qua.
* **Quản lý vai trò** — cấp một vai trò cho một địa chỉ, thu hồi một vai trò, hoặc từ bỏ vai trò của chính bạn.

Mỗi mục được trình bày chi tiết bên dưới, cùng với những gì chuỗi thực thi, trong thẻ mà nó thuộc về.

***

## Bảng điều khiển của nhà phát hành

![Bảng điều khiển của nhà phát hành tại /issuer, liệt kê các tài sản mà lần triển khai này biết đến và trạng thái bán của chúng.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-c94de7c7a94a287a4d9b90a92b2b16022213b702%2Fissuer-console.png?alt=media\&token=657509e2-8263-4579-b54b-b6b4af33b6d6)

`/issuer` liệt kê các tài sản bạn đã phát hành trên chuỗi này và cho phép bạn bắt đầu một tài sản mới.

* Kết nối một **Ví EVM**.
* Bảng liệt kê mỗi tài sản với **tên và ký hiệu**, vòng đời của nó **giai đoạn**, và **Bán** trạng thái (một *Mở* huy hiệu hoặc *Đã đóng*).

Hai cột — **Người nắm giữ** và **Cần xem xét** — hiển thị dấu gạch ngang. Số người nắm giữ cần việc liệt kê của danh sách cho phép, còn hàng đợi xem xét là một kho lưu trữ ngoài chuỗi mà bạn đăng nhập theo từng tài sản; dấu gạch ngang có nghĩa là *chưa được yêu cầu* nơi mà một `0` sẽ khẳng định một sự thật mà ứng dụng chưa đọc.

Nhấn **Phát hành một tài sản** để mở trình hướng dẫn, hoặc chọn một hàng để mở bảng điều khiển của tài sản đó.

***

## Tạo một tài sản: trình hướng dẫn

![Trình hướng dẫn tạo tại /create: các trường của tài sản, rồi sáu thẻ sáng lên khi các giao dịch của chúng được ghi nhận.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-94683a3a49ac2418aed8cc66dbf47fad940814f7%2Fcreate-wizard.png?alt=media\&token=38b47568-d343-483d-8ce1-f437164bdeae)

`/create` thu thập bốn trường rồi triển khai tài sản của bạn.

| Trường           | Quy tắc                    |
| ---------------- | -------------------------- |
| **Tên**          | Bắt buộc.                  |
| **Ký hiệu**      | Bắt buộc.                  |
| **Nguồn cung**   | Một số nguyên lớn hơn 0.   |
| **Số thập phân** | Một số nguyên từ 0 đến 18. |

Nhấn **Bắt đầu**. Nếu một trường không hợp lệ, trình hướng dẫn sẽ cho bạn biết trường nào và vì sao thay vì ngồi sau một nút bị vô hiệu hóa. Khi bản nháp hợp lệ, ví của bạn sẽ được yêu cầu ký từng bước một.

### Vì sao nó triển khai theo từng phần

> **Một token được triển khai thành ba hợp đồng qua nhiều giao dịch — không bao giờ chỉ một.** Một giao dịch duy nhất của Arc `createToken` sẽ cần **77 khóa tài khoản**, và Rome giới hạn một giao dịch đơn lẻ ở **62 lock**. Vì vậy, trình hướng dẫn triển khai từng phần trong giao dịch riêng của nó và sau đó đạt trạng thái factory thông qua `ArcTokenFactoryV2.registerToken`. Đây là một ràng buộc của Rome được hiển thị ra, không phải một tối ưu hóa tùy chọn — và các lớp bảo vệ giữ nguyên chính xác mô hình bảo mật của Arc ở thượng nguồn (proxy chuẩn, triển khai trong danh sách cho phép, người gọi giữ vai trò quản trị của token, đăng ký chỉ một lần). Xem [COMPLIANCE.md](https://docs.rome.builders/vi/ung-dung-tren-rome/bloom/compliance.md#what-rome-adds-and-what-registertoken-preserves).

### Sáu thẻ

Trình hướng dẫn hiển thị sáu thẻ, theo dõi tiến trình triển khai. Một thẻ chuyển từ **Đang chờ** vào **Đang ký…** vào **Hoàn tất** (hoặc **Thất bại**) khi giao dịch của nó được ghi nhận.

| # | Thẻ                                   | Nó làm gì                                                                                                                             |
| - | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | **Phần triển khai**                   | Phần triển khai dùng chung của tài sản cho chuỗi này — đã được phân giải, không cần ký gì. (Hoàn tất trước khi bất kỳ bước nào chạy.) |
| 2 | **Tài sản**                           | Triển khai tài sản của bạn và đặt tên, ký hiệu, nguồn cung và số thập phân trong một bước.                                            |
| 3 | **Ai có thể nắm giữ nó**              | Triển khai mô-đun quyền riêng của tài sản này, với bạn là quản trị viên của nó.                                                       |
| 4 | **Áp dụng nó cho việc chuyển nhượng** | Trỏ tài sản vào mô-đun đó, որպեսզի mọi lần chuyển đều được chính tài sản kiểm tra.                                                    |
| 5 | **Quy tắc lợi suất**                  | Triển khai và liên kết mô-đun quyết định ai được chi trả.                                                                             |
| 6 | **Đăng ký**                           | Đăng ký tài sản — đây là bước mở đợt bán và cho phép bạn nâng cấp nó sau này.                                                         |

Sáu thẻ gộp thành tám bước triển khai bên dưới, nên một lần **Bắt đầu** dẫn đến **tám chữ ký**. Một lưu ý dưới nút ghi *"Ví của bạn sẽ yêu cầu bạn ký từng bước. Dừng ở bất kỳ điểm nào và tiếp tục từ chỗ bạn đã dừng — không có gì bị mất."* Việc đăng ký là bước cuối cùng là lý do tại sao việc dừng lại là an toàn: tài sản là một lần triển khai thực sự ở mỗi giai đoạn, và được đăng ký ở cuối.

Khi quá trình hoàn tất, trình hướng dẫn đọc *"Đã phát hành. Tài sản của bạn hiện hoạt động tại …"* kèm liên kết đến bảng điều khiển của tài sản tại `/token/[address]`.

> **`khởi tạo` cấp cho bạn mọi vai trò.** Người điều khiển trình hướng dẫn — địa chỉ EVM của bạn — nhận các vai trò quản trị, đúc/đốt, quản lý/phân phối lợi suất và nâng cấp của token, cùng với vai trò quản trị của mô-đun danh sách cho phép. Vì vậy, việc bạn quản lý khóa là một phần trong tư thế tuân thủ của tài sản: ví nhà đầu tư bị mất chỉ có thể khôi phục thông qua hành động quản trị của bạn, và thẻ **Quyền** cho thấy từng người nắm giữ của mỗi quyền. (`UPGRADER_ROLE` là *không phải* được cấp tự động cho factory — hãy cấp rõ ràng nếu bạn muốn các bản nâng cấp do factory trung gian.)

***

## Bảng điều khiển riêng cho từng tài sản, và cổng đăng nhập

![Cổng đăng nhập của bảng điều khiển: ký một thông điệp bằng ví của bạn — không có mật khẩu.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-a9377e3cad8460af1d9bb4eb3cf6f2a6a8f28b22%2Fconsole-signin.png?alt=media\&token=fdc19e4f-8724-4d36-999b-def1990685f9)

Mở `/token/[address]` không **không phải** hiển thị ngay bảng điều khiển. Nó hiển thị một **cổng đăng nhập**:

> *"Đăng nhập để quản lý tài sản này. Ký một thông điệp bằng ví của bạn — không có mật khẩu. Thẩm quyền của bạn đến từ chính tài sản, và nó được kiểm tra lại ở mọi hành động, nên việc thu hồi có hiệu lực ngay lập tức."*

Nhấn **Đăng nhập bằng ví của bạn**. Đây là chính xác những gì xảy ra:

1. Ví của bạn được yêu cầu `personal_sign` một tuyên bố ngắn, dễ hiểu (mở đầu bằng *"Bloom — chứng minh bạn quản lý tài sản này"*) nêu rõ hành động duy nhất mà nó cho phép — đọc hàng đợi đơn đăng ký của tài sản này — cùng với địa chỉ tài sản, chain id, và dấu thời gian.
2. Ứng dụng gửi tuyên bố đã ký đó đến `GET /api/applications`.
3. Các **máy chủ** xác minh nó: nó khôi phục địa chỉ của bạn từ chữ ký, xác nhận tuyên bố dành cho chuỗi này và vẫn còn mới (nó cho phép trong một cửa sổ hai phút, không phải một phiên), đọc **mô-đun danh sách cho phép của chính token** từ chuỗi, và kiểm tra rằng địa chỉ của bạn giữ vai trò mà việc ghi danh sách cho phép thực sự yêu cầu — `MANAGER_ROLE` trên mô-đun đó.
4. Nếu bạn giữ nó, hàng đợi được trả về và bảng điều khiển hiển thị. Nếu không, máy chủ từ chối với `403` và một lý do.

![Cổng hiển thị một lời từ chối được trích dẫn: một ví không quản lý tài sản này sẽ bị từ chối.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-99040b8d3c752f0f84615b913d6b75fb0d36f81b%2Fconsole-refusal.png?alt=media\&token=29c3ffcf-b826-4aa7-b9da-41bdc3ec2e1e)

> **Tài sản quyết định ai được quản trị nó — không phải ứng dụng này.** Vai trò được kiểm tra trên danh sách cho phép **module**, không phải trên token, và việc giữ một vai trò cùng tên trên token thì *không phải* không được chuyển qua — đó là những thẩm quyền khác nhau. Không có tài khoản và không có phiên: mọi yêu cầu tiếp theo đều mang theo chữ ký mới của riêng nó, đó là điều mà *"được kiểm tra lại ở mọi hành động"* có nghĩa. Thu hồi vai trò của một ví trên chuỗi và nó sẽ lập tức không còn đăng nhập được.

Một lời từ chối hiển thị lý do **được trích dẫn** — Bloom không bao giờ viết một câu giải thích vì sao một ví bị từ chối. Nếu bạn từ chối ký trong ví của mình, đó là *"không"* của bạn, không phải của tài sản, và nó không được báo cáo như một lời từ chối.

> **Cổng là của-bảng-điều-khiển-nào, không phải bí mật-gì.** Nguồn cung, trạng thái bán, danh sách các địa chỉ được cho phép và các vai trò đều là các lượt đọc công khai trên chuỗi mà bất kỳ trình khám phá nào cũng trả lời được. Điều chữ ký mua được là **hàng đợi đơn đăng ký** — các tuyên bố của người khác — và quyền được hiển thị bảng điều khiển ngay từ đầu.

### Tiêu đề bảng điều khiển

Sau khi đăng nhập, tiêu đề nêu tên tài sản và hiển thị **giai đoạn** — sự thật có ý nghĩa nhất mà nó có:

| Giai đoạn         | Ý nghĩa                                                                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Bản nháp**      | Chưa có mô-đun quyền nào được liên kết, nên không có gì hạn chế ai có thể giữ nó.                                                                             |
| **Mở**            | Việc chuyển nhượng mở và nguồn cung vẫn có thể thay đổi. Việc đặt cổng cho tài sản làm cho nguồn cung của nó trở nên cố định, và điều đó không thể đảo ngược. |
| **Được đặt cổng** | Chỉ các địa chỉ trong danh sách cho phép mới có thể giữ nó, **và nguồn cung của nó là cố định** — không thể đúc thêm hay đốt bớt nữa, vĩnh viễn.              |

Phía trên các thẻ, một bảng tóm tắt hiển thị bốn chỉ số — **Người nắm giữ · Cần xem xét · Đã bán · Lợi suất đã chi trả**. Hai chỉ số được đọc từ chuỗi và kho (*Cần xem xét* sau khi bạn đã đăng nhập; *Đã bán* từ cửa hàng); *Người nắm giữ* đang chờ số lượng người nắm giữ của bản xem trước lợi suất, và *Lợi suất đã chi trả* đang chờ con trỏ lịch sử chi trả vẫn còn ở phía trước. Mỗi ô đang chờ hiển thị một dấu gạch ngang và giải thích nó cần gì, thay `0` sẽ khẳng định một sự thật mà không ai hỏi chuỗi về.

***

## Sáu thẻ

Bảng điều khiển có sáu thẻ, theo thứ tự này: **Đơn đăng ký · Ai được phép giữ · Nguồn cung · Bán · Lợi suất · Quyền.**

Mọi thao tác ghi trên các thẻ này đều dùng chung một điều khiển hiển thị **các điều kiện tiên quyết được đặt tên** và **các hệ quả** *trước* nút bấm, và nêu giai đoạn của nó khi chạy (*“Đang chờ ví của bạn…”*, *“Đang lên chuỗi…”*). Không điều gì nên bị revert chỉ để dạy bạn những gì lẽ ra có thể được kiểm tra trước.

### Đơn đăng ký — hàng đợi xem xét

![Thẻ Đơn đăng ký — hàng đợi xem xét, với một đơn đang chờ để phê duyệt hoặc từ chối, và mạch tuân thủ.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-8249de8b76f757101cc945ca4a2687103428839c%2Ftab-applications.png?alt=media\&token=ab0def9b-0bcb-49eb-b785-fd78e6fa2f92)

Thẻ này liệt kê những ai đã đăng ký để nắm giữ tài sản. Mỗi hàng hiển thị địa chỉ của người nộp đơn, khu vực pháp lý, loại người nắm giữ, một **Kiểm tra** cột (*Đã vượt qua* nếu nhà cung cấp của bạn đã ghi nhận kết quả, nếu không thì *Đã khai báo*), và một **Trạng thái** (*Cần xem xét*, *Đã phê duyệt*, *Bị từ chối*). Mở rộng một hàng để xem các thông tin và hai điều khiển của nó: **Phê duyệt — được phép giữ** và **Từ chối**. Một lời từ chối cần một lý do, chính là câu trả lời cho người nộp đơn.

> **Phê duyệt là hai hành động riêng biệt, và thẻ này giữ chúng minh bạch.** Nhấn **Phê duyệt** *ghi lại* quyết định của bạn trong kho ứng dụng. Đưa địa chỉ vào danh sách cho phép của tài sản trên chuỗi là một **chữ ký thứ hai** — `batchAddToWhitelist` — và cho đến khi nó được ghi nhận, hàng đó sẽ nói như vậy. Khi quyết định đã ghi và chuỗi không khớp nhau, thẻ sẽ nêu tên khoảng trống và cung cấp thao tác ghi để đóng nó lại: **Cho phép vào** để thêm một địa chỉ đã được phê duyệt vào danh sách cho phép, hoặc (đối với một địa chỉ bị từ chối nhưng vẫn còn trong danh sách) điều khiển để xóa nó. Địa chỉ không thể nắm giữ tài sản cho đến khi thao tác ghi danh sách cho phép được ghi nhận.

Một ghi chú cố định trên thẻ này — **mạch tuân thủ** — nêu rõ nơi quy trình của riêng bạn cắm vào:

> *"Không có tài liệu nào được yêu cầu hay lưu giữ ở đây — các kiểm tra là của riêng bạn. Kết nối nhà cung cấp của bạn phía sau giao diện `Đơn đăng ký` hoặc nhập các quyết định bạn đã thực hiện. Bloom ghi lại kết quả và chuỗi ghi một giá trị có hoặc không cho địa chỉ."*

Đó là giao diện mà một nhà phát hành tự lưu trữ thay thế: thay việc triển khai kho ứng dụng bằng kho bền vững của chính bạn và không có người gọi nào thay đổi. Bloom không thực hiện kiểm tra nào và không giữ tài liệu nào.

### Ai được phép giữ nó — cổng chuyển nhượng

![Thẻ Ai-được-phép-giữ-nó — số lượng trong danh sách cho phép và điều khiển hạn chế chuyển nhượng, cho thấy các hệ quả một chiều của nó.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-d32c410e3b5798d86dc5b914bce2f927eb4b1620%2Ftab-holders.png?alt=media\&token=aefe491d-2ce8-4478-a776-b9e612536d60)

Thẻ này báo cáo có bao nhiêu địa chỉ nằm trong danh sách cho phép của tài sản, và cho phép bạn bật hoặc tắt việc danh sách cho phép có được **thực thi**:

* Khi chuyển nhượng **không bị hạn chế**, nó sẽ đề nghị **hạn chế chuyển nhượng chỉ cho danh sách cho phép**. Hệ quả của thao tác ghi nói rằng việc đó làm cho nguồn cung trở nên cố định và là con đường một chiều đối với người không phải quản trị viên.
* Khi chuyển nhượng **bị hạn chế**, nó sẽ đề nghị **gỡ bỏ hạn chế**. Hệ quả của nó nói rất rõ rằng đây không phải là hoàn tác.

Trên một *không có rào cản* (bản nháp) tài sản chưa có mô-đun quyền nào được liên kết, thẻ sẽ nói như vậy — *"Chưa có mô-đun quyền nào được liên kết, nên không có gì hạn chế ai có thể giữ nó"* — và nút chuyển đổi sẽ không hiển thị.

> **Token kiểm tra cả hai phía của mọi lần chuyển.** Trong khi tài sản được đặt cổng, một lần chuyển mà bất kỳ bên nào không có trong danh sách cho phép sẽ bị revert trên chuỗi với lỗi có kiểu. Cổng này chạy giống nhau cho việc chuyển từ ví EVM, chuyển có chữ ký Solana, giao dịch bán trên cửa hàng, và lần chuyển thanh khoản ban đầu — không có lối đi vòng nào ngoài quyền quản trị của chính bạn.

### Nguồn cung

![Thẻ Nguồn cung — tổng số đơn vị đang tồn tại.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-29eb2d741e5193eef3ea94a214a199f2eb404fe7%2Ftab-supply.png?alt=media\&token=2ab35474-ed9a-4d30-b978-5f69e1c0e7b9)

Thẻ này báo cáo tổng nguồn cung đang tồn tại, tính theo đơn vị nguyên.

### Bán — mở, đóng và nhận tiền thu được

![Thẻ Bán — một đợt bán đang mở, với các điều khiển đóng bán, thu hồi hàng chưa bán và rút tiền thu được.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-573a99f9028a984b038162dc885a16b715673293%2Ftab-sale.png?alt=media\&token=18f59a19-9d83-4780-abf2-47e4a3e37d14)

Thẻ này vận hành đợt bán chính thông qua hợp đồng storefront.

* **Khi chưa có đợt bán nào mở**, nó đề nghị mở một đợt: nhập **Số đơn vị để bán** và **Giá mỗi đơn vị** (trong `wUSDC`), rồi nhấn **Mở đợt bán**. Các điều kiện tiên quyết của thao tác ghi được hiển thị trước — token phải được đăng ký, storefront phải nắm giữ hàng tồn của đợt bán, và storefront cũng phải nằm trong danh sách cho phép trên token mà nó bán — nên một đợt bán chưa thể mở sẽ nói chính xác nó cần gì.
* **Khi một đợt bán đang mở**, nó cho biết còn bao nhiêu đơn vị của lời chào bán và đề nghị **Đóng đợt bán này**.
* **Thu hồi các đơn vị chưa bán** chuyển hàng tồn chưa bán từ storefront trở lại một người nhận (mặc định là bạn). Đây không phải **không phải** một đóng — đợt bán vẫn được bật, và hệ quả của thao tác ghi nói như vậy, nên việc thu hồi không thể bị hiểu nhầm là hủy bỏ.
* **Rút tiền thu được** gửi số tiền thu được của storefront đến một địa chỉ (mặc định là bạn). Tiền thu được tích lũy độc lập với trạng thái của đợt bán, nên có thể rút dù đợt bán đang mở hay đã đóng.

### Lợi suất — trả cho người nắm giữ, mỗi giao dịch một người

![Thẻ Lợi suất — trường số tiền phân phối, kèm nhắc nhở phải đặt loại tiền chi trả trước.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-cc8150ea6fee72d99bd5a2254073779cbd896c11%2Ftab-yield.png?alt=media\&token=d190f7bd-1a1c-4ed2-b9a2-d27a399602f6)

Thẻ này phân phối một khoản chi trả lợi suất cho người nắm giữ.

> **Một lần phân phối là một cuộc đi qua, không phải một cú nhấp.** Trên Rome, `distributeYieldWithLimit` chi trả **một người nắm giữ cho mỗi giao dịch** (giới hạn tài khoản), nên một khoản chi trả là một chuỗi các cửa sổ, mỗi cửa sổ là một chữ ký riêng. Bạn nhập số tiền một lần, tính theo đơn vị nguyên của loại tiền chi trả, và nó sẽ bị khóa khi cuộc đi qua bắt đầu. Cửa sổ **đầu tiên** lấy toàn bộ khoản chi trả từ bạn và trả cho người nắm giữ đầu tiên; mỗi cửa sổ sau đó chỉ chuyển số tiền đã ở trong hợp đồng token. Bloom đọc lại con trỏ từ chuỗi sau mỗi cửa sổ — tập hợp người nắm giữ sắp xếp lại khi số dư thay đổi, và gửi một chỉ mục cũ sẽ khởi động lại từ số không và rút tiền của bạn lần thứ hai.

Thẻ hiển thị tiến trình — *"Đang trả cho người nắm giữ N trong M"* — và kết thúc khi con trỏ quay vòng. Nếu tài sản chưa đặt loại tiền chi trả, thẻ sẽ nói như vậy; việc đặt loại tiền chi trả là trường duy nhất của một lần phân phối mà chỉ bạn mới có thể chọn.

> **Phần của người nắm giữ bị hạn chế sẽ ở lại trong hợp đồng.** Một địa chỉ bị mô-đun chặn lợi suất loại trừ sẽ bị bỏ qua, và phần chia theo tỷ lệ của nó sẽ ở lại trong hợp đồng token thay vì được chi trả.

Các khoản chi trả trước đây vẫn chưa được hiển thị — việc đọc chúng sẽ lần ngược các sự kiện phân phối về đến khối đầu tiên của tài sản, điều này cần một con trỏ lịch sử vẫn còn ở phía trước. Thẻ này nói điều đó ngay trong chính nó thay vì hiển thị một `0`.

### Quyền — các vai trò

![Thẻ Quyền — mọi vai trò và việc nó có đang được nắm giữ hay không, cùng điều khiển cấp / thu hồi / từ bỏ.](https://4233397286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-fb54f6c73c2d194dd5b6321bc3cb0af825f6f637%2Ftab-rights.png?alt=media\&token=6f545a79-96f8-4c9e-ac38-ce435e547deb)

Thẻ này liệt kê mọi vai trò mà token khai báo và liệu chúng có đang được nắm giữ hay không, mỗi vai trò được đọc bằng một `hasRole` gọi trực tiếp lên token. Một vai trò **không phải** đang được nắm giữ sẽ hiển thị như vậy thay vì bị bỏ qua — trên thẻ quyền, một hàng bị thiếu và một *"không"* là hai sự thật khác nhau.

Bên dưới danh sách, một điều khiển sẽ thay đổi các vai trò:

| Hành động                    | Áp dụng cho                                                       | Thẩm quyền           |
| ---------------------------- | ----------------------------------------------------------------- | -------------------- |
| **Cấp cho một tài khoản**    | Một địa chỉ bạn nhập                                              | `DEFAULT_ADMIN_ROLE` |
| **Thu hồi từ một tài khoản** | Một địa chỉ bạn nhập                                              | `DEFAULT_ADMIN_ROLE` |
| **Từ bỏ của chính bạn**      | Chính bạn (OpenZeppelin yêu cầu người xác nhận phải là người gọi) | Bạn                  |

Các lựa chọn vai trò là của chính token, nên điều khiển không bao giờ có thể đưa ra một vai trò mà token không có. Cũng như mọi thao tác ghi, hàng thẩm quyền và hệ quả được hiển thị trước nút bấm, nên cánh cửa và tính một chiều của nó được nêu rõ trước khi bạn ký.

***

## Điều gì không bao giờ chạm vào Bloom hoặc chuỗi

Để nói thật rõ nơi tuân thủ tồn tại:

| Mục                                             | Nơi nó tồn tại                                                                                                         |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Tài liệu KYC/AML và dữ liệu PII                 | Hệ thống của riêng bạn, với nhà cung cấp và thời hạn lưu giữ của riêng bạn — **không bao giờ** ứng dụng này hoặc chuỗi |
| Quyết định của bạn về việc cho phép một địa chỉ | Một bản ghi ngoài chuỗi; bạn sở hữu kho lưu trữ                                                                        |
| Hiệu lực trên chuỗi của quyết định đó           | Một giá trị boolean — `isWhitelisted(address)` — được ghi bởi `batchAddToWhitelist`                                    |
| Việc thực thi quy tắc                           | Hợp đồng tài sản, ở mọi lần chuyển                                                                                     |
| Ai được phép quản trị tài sản                   | Vai trò được nắm giữ trên mô-đun danh sách cho phép của tài sản, được kiểm tra ở mọi yêu cầu                           |

Đối với mô hình tuân thủ đầy đủ, hãy đọc [COMPLIANCE.md](https://docs.rome.builders/vi/ung-dung-tren-rome/bloom/compliance.md); đối với cơ chế hai luồng (EVM và Solana) mà người nắm giữ của bạn sử dụng, hãy đọc [LANES.md](https://docs.rome.builders/vi/ung-dung-tren-rome/bloom/lanes.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/vi/ung-dung-tren-rome/bloom/issuing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
