> 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/zh/rome-shang-de-ying-yong/bloom/issuing.md).

# 发行

Bloom 让您发行一个 **受权限控制的现实世界资产** 作为 Rome 链上的普通 Solidity 合约，并可通过按资产的控制台进行管理。该资产可从 EVM 和 Solana 钱包访问，但 **发行仅限 EVM** — Solana 钱包只持有资产；它不会创建资产。本指南涵盖发行方控制台、创建向导、控制台登录门，以及六个管理选项卡中的每一个。

> **您无需向 Bloom 提交任何文件或个人数据，您的投资者也无需提交。** Bloom 记录 *结果* 您的合规决策；链上则为每个地址记录一个布尔值。您的 KYC/AML 流程——供应商、文件、保留策略——完全保留在您自己的系统中。完整模型见 [COMPLIANCE.md](https://docs.rome.builders/zh/rome-shang-de-ying-yong/bloom/compliance.md)；本指南仅指向该模型，而不重复其内容。

***

## 您可以执行的操作

作为资产管理员，以下所有操作都可由您在控制台中完成——而且每一项都是实际的链上交易，并链接在 [证据](https://docs.rome.builders/zh/rome-shang-de-ying-yong/bloom/evidence.md) 页面：

* **发行资产** — 向导会将其部署为三个合约（如下所示）。
* **审核申请** — 批准或拒绝每一项（拒绝需附带申请人应得的理由），并将已批准地址加入允许列表。
* **管理允许列表** — 添加一个地址，添加 **一批地址到单笔交易中** (`batchAddToWhitelist`），或移除一个地址；代币会在每次转账时强制执行该列表。
* **对资产设置门控** — 将转账限制为仅允许列表内地址（这将使供应量最终固定），或解除该限制。
* **管理供应量** — 读取总量，并在您持有相应角色后铸造或销毁。
* **运行销售** — 开启销售（数量和价格）、关闭销售、召回未售库存，并提取收益。
* **设置并分配收益** — 设置支付币种，然后分配一笔收益；分配会逐个持有人逐笔交易地进行；被排除的持有人会被跳过。
* **管理角色** — 向某地址授予角色、撤销某角色，或放弃您自己的角色。

每项内容都在下方对应选项卡中详细说明，包括链上强制执行的内容。

***

## 发行方控制台

![/issuer 处的发行方控制台，列出此部署已知的资产及其销售状态。](https://4058553919-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` 列出您在此链上发行的资产，并允许您启动新的发行。

* 连接一个 **EVM 钱包**。未连接的访客，或 Solana 钱包，看到的是提示其连接正确类型钱包的提示，而不是空控制台——Solana 钱包无法发行，这是一条由链作为第二道独立防线强制执行的产品边界。
* 该表列出每项资产的 **名称和符号**、其生命周期 **阶段**，以及其 **销售** 状态（一个 *打开* 徽标或 *已关闭*).

两列—— **持有人** 和 **待审核** — 显示为破折号。持有人数量需要允许列表的枚举，而审核队列是您按资产登录的链下存储；破折号表示 *未请求* 其中一个 `0` 会声称应用尚未读取的事实。

点击 **发行资产** 以打开向导，或选择一行以打开该资产的控制台。

***

## 创建资产：向导

![/create 处的创建向导：先是资产字段，然后是六张卡片，随着各自的交易落链而点亮。](https://4058553919-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` 收集四个字段，然后部署您的资产。

| 字段      | 规则            |
| ------- | ------------- |
| **名称**  | 必填。           |
| **符号**  | 必填。           |
| **供应量** | 大于零的整数。       |
| **小数位** | 0 到 18 之间的整数。 |

点击 **开始**。如果某个字段无效，向导会告诉您是哪一项以及原因，而不是让您面对一个禁用按钮。草稿有效后，系统会依次请求您的钱包为每一步签名。

### 为什么要分步骤部署

> **一个代币会通过多笔交易部署为三个合约——绝不会一次完成。** Arc 的单笔交易 `createToken` 需要 **77 个账户锁**，而 Rome 将单笔交易上限设为 **62 个锁定**。因此，向导会将每个部分分别放在各自的交易中部署，并在之后通过 `ArcTokenFactoryV2.registerToken`。这是将 Rome 的约束显性化，而非可选优化——并且这些防护会严格保留 Arc 上游的安全模型（规范代理、白名单实现、调用方持有代币的管理员角色、注册仅限一次）。参见 [COMPLIANCE.md](https://docs.rome.builders/zh/rome-shang-de-ying-yong/bloom/compliance.md#what-rome-adds-and-what-registertoken-preserves).

### 六张卡片

向导会显示六张卡片，按部署进度依次变化。卡片会从 **等待中** 到 **签名中…** 到 **完成** （或 **失败**）随着其交易落链而变化。

| # | 卡片           | 功能                                  |
| - | ------------ | ----------------------------------- |
| 1 | **实现**       | 此链共享的资产实现——已解析，无需签名。（在任何步骤运行前即已完成。） |
| 2 | **资产**       | 一步部署您的资产，并设置其名称、符号、供应量和小数位。         |
| 3 | **谁可以持有它**   | 部署此资产自己的权限模块，并由您担任管理员。              |
| 4 | **在转账中强制执行** | 将资产指向该模块，使每笔转账都由资产本身进行检查。           |
| 5 | **收益规则**     | 部署并链接决定向谁支付的模块。                     |
| 6 | **注册**       | 注册该资产——这会开启销售，并允许您稍后对其升级。           |

六张卡片涵盖了底层八个部署步骤，因此一次 **开始** 会导致 **八次签名**。按钮下方的说明写着 *“您的钱包会要求您为每一步签名。您可以在任何时候停止，并从离开的地方继续——不会丢失任何内容。”* 注册是最后一步，这就是中途停止也是安全的原因：资产在每个阶段都是真实部署的，并在最后完成注册。

当执行完成时，向导显示 *“已发行。您的资产已上线于 …”* 并附带资产控制台链接，地址为 `/token/[address]`.

> **`初始化` 授予您所有角色。** 向导操作者——您的 EVM 地址——将获得代币的管理员、铸造/销毁、收益管理/分配和升级者角色，以及允许列表模块的管理员角色。因此，您的密钥托管是资产合规态势的一部分：丢失的投资者钱包只能通过您的管理员操作恢复，而控制台的 **权限** 选项卡会显示每项权限的持有人。（`UPGRADER_ROLE` 为 *不* 会自动授予工厂——如果您希望通过工厂进行升级，请显式授予它。）

***

## 按资产的控制台，以及登录门

![控制台登录门：使用您的钱包签名一条消息——无需密码。](https://4058553919-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)

打开 `/token/[address]` 并不会 **不** 立即显示控制台。它显示一个 **登录门**:

> *“登录以管理此资产。使用您的钱包签名一条消息——无需密码。您的权限来自资产本身，并且会在每次操作时重新检查，因此撤销后会立即生效。”*

点击 **使用您的钱包登录**。具体流程如下：

1. 系统会请求您的钱包 `personal_sign` 一段简短、可读的人类可读声明（标题为 *“Bloom——证明您正在管理此资产”*），该声明会写明其授权的唯一操作——读取该资产的申请队列——以及资产地址、链 ID 和时间戳。
2. 应用将该已签名声明发送到 `GET /api/applications`.
3. 这些 **服务器** 进行验证：从签名中恢复您的地址，确认该声明属于此链且仍然有效（它只授权两分钟窗口，而不是一个会话），读取 **代币自身的允许列表模块** 的链上状态，并检查您的地址是否持有该允许列表写操作实际需要的角色—— `MANAGER_ROLE` 在该模块上。
4. 如果您持有该角色，则返回队列并渲染控制台。若没有，服务器会拒绝并返回 `403` 以及一条理由。

![显示带引号拒绝信息的门禁：不管理此资产的钱包会被拒之门外。](https://4058553919-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)

> **决定谁可以管理该资产的是资产本身——而不是此应用。** 该角色在允许列表上进行检查 **模块**，而不是在代币上检查；即便在代币上持有同名角色，也不会 *不* 自动继承——它们是不同的权限。这里没有账户，也没有会话：后续每个请求都携带其自身的新签名，这正是 *“在每次操作时重新检查”* 的含义。在链上撤销某钱包的角色后，它将立即无法登录。

拒绝会显示理由 **以引号显示** — Bloom 从不写明钱包为何被拒绝。如果您在钱包中拒绝签名，那是您的 *“否”*，而不是资产的；这也不会被报告为拒绝。

> **这个门控关注的是“这是谁的控制台”，而不是“什么是秘密”。** 供应量、销售状态、允许列表名录和角色都是公开的链上读取，任何浏览器都能查看。签名带来的权限是 **申请队列** ——即他人的声明——以及被显示控制台的权利。

### 控制台标题栏

登录后，标题栏会显示资产名称及其 **阶段** ——这是它最关键的状态：

| 阶段      | 含义                                                  |
| ------- | --------------------------------------------------- |
| **草稿**  | 尚未链接权限模块，因此没有任何限制谁可以持有它。                            |
| **打开**  | 转账是开放的，供应量仍可变化。对资产设置门控会使其供应量最终固定，且不可撤销。             |
| **已门控** | 只有在允许列表中的地址才能持有它， **且其供应量已最终固定** ——不能再铸造或销毁，且是永久性的。 |

在选项卡上方，会显示四个汇总数据—— **持有人 · 待审核 · 已售出 · 已支付收益**。其中两项来自链上和存储（*待审核* 在您登录之后； *已售出* 来自 storefront）； *持有人* 等待收益预览中的持有人数量，而 *已支付收益* 则等待尚未到来的支付历史游标。每个等待中的单元格都会显示一个破折号并说明其所需内容，而不是显示一个 `0` 会宣称一个无人向链查询过的事实。

***

## 六个选项卡

控制台按以下顺序包含六个选项卡： **申请 · 谁可持有 · 供应量 · 销售 · 收益 · 权限。**

这些选项卡中的每次写入都使用一个共享控件来显示写入的 **命名先决条件** 及其 **后果** *在* 按钮之前，并在其运行时标明阶段（*“等待你的钱包……”*, *“正在上链……”*）。不应通过回滚来告诉您本可以先检查什么。

### 申请——审核队列

![申请选项卡——审核队列，包含待批准或拒绝的申请，以及合规接口。](https://4058553919-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)

此选项卡列出已申请持有该资产的人员。每一行显示申请人的地址、司法辖区、持有人类型，以及一个 **检查** 列（*已通过* 如果您的提供方记录了结果，否则为 *已声明*），以及一个 **状态** (*待审核*, *已批准*, *已拒绝*）。展开某一行可查看其事实和两个控件： **批准——可持有** 和 **拒绝**。拒绝需要给出理由，该理由将成为申请人的答复。

> **批准是两个独立的操作，而该选项卡会确保它们保持一致。** 按下 **授权** *会记录* 您在申请存储中的决定。将该地址加入资产链上允许列表则是一个 **第二次签名** —— `batchAddToWhitelist` ——在其落链之前，该行会明确显示这一点。当记录的决定与链上状态不一致时，选项卡会指出差异，并提供用于弥合差异的写操作： **准入** 用于将已批准地址添加到允许列表，或（对于仍在列表中的已拒绝地址）用于将其移除。直到允许列表写操作落链前，该地址都不能持有该资产。

该选项卡上的固定说明—— **合规接口** ——说明您自己的流程接入之处：

> *“此处不要求也不持有任何文件——检查由您自己完成。请在 `申请` 接口之后连接您的提供方，或导入您已经作出的决定。Bloom 记录结果，链上则针对该地址记录一个是或否。”*

这正是自托管发行方要替换的接口：将申请存储的实现替换为您自己的持久实现，调用方无需更改。Bloom 不执行任何检查，也不持有任何文件。

### 谁可持有——转账门控

![“谁可持有”选项卡——允许列表数量及限制转账控制，展示其单向门的后果。](https://4058553919-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)

此选项卡报告该资产上有多少地址被列入允许列表，并允许您切换允许列表是否 **强制执行**:

* 当转账处于 **无限制**状态时，它会提供 **将转账限制为仅允许列表**。该写操作的后果说明，这样做会使供应量最终固定，并对非管理员而言是一条单向门。
* 当转账处于 **受限**状态时，它会提供 **解除限制**。其后果明确表明这不是撤销。

在一个 *无门槛的* （草稿）且未链接权限模块的资产上，该选项卡会明确说明—— *“尚未链接权限模块，因此没有任何限制谁可以持有它”* ——并且不会显示切换控件。

> **代币会检查每次转账的双方。** 在资产处于门控状态时，若任一方不在允许列表中，转账将以带类型的错误在链上回滚。同一道门控同样适用于 EVM 钱包转账、Solana 签名转账、店面销售以及初始流动性移动——除了您自己的管理员权限，没有任何绕过途径。

### 供应量

![供应量选项卡——当前存在的总单位数。](https://4058553919-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)

此选项卡以整数单位报告当前存在的总供应量。

### 销售——开启、关闭并提取收益

![销售选项卡——一个已开启的销售，包含关闭销售、召回未售出和提取收益控件。](https://4058553919-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)

此选项卡通过 storefront 合约运行主销售。

* **当没有销售开启时**，它会提供开启一个销售：输入 **待售单位数** 和 **每单位价格** （在 `wUSDC`），然后按下 **开启销售**。写操作的先决条件会先显示——代币必须已注册，storefront 必须持有销售库存，且 storefront 本身必须被其所销售的代币列入允许列表——因此尚无法开启的销售会准确说明其所需条件。
* **当销售开启时**，它会显示该报价还剩多少单位，并提供 **关闭此销售**.
* **召回未售单位** 会将未售库存从 storefront 移回给收件人（默认是您）。这是 **不** 一次关闭——销售仍保持启用，且该写操作的后果会明确说明这一点，因此召回不会被误解为撤销。
* **提取收益** 会将 storefront 的收入发送到某个地址（默认是您）。收益独立于销售状态累积，因此无论销售开启还是关闭都可以提取。

### 收益——逐笔交易向持有人支付

![收益选项卡——分配金额字段，并提醒先设置支付币种。](https://4058553919-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)

此选项卡向持有人分配收益支付。

> **分配是一个逐步遍历过程，而不是一次点击。** 在 Rome 上， `distributeYieldWithLimit` 每次支付 **一个持有人** （账户上限），因此一次支付是由多个窗口组成的序列，每个窗口都有其自己的签名。您只需输入一次金额，以支付币种的整数单位表示，一旦遍历开始，该金额即被锁定。该 **首先** 窗口会从您处扣取整笔支付并支付给第一个持有人；之后每个窗口只会移动已在代币合约内的资金。Bloom 会在每个窗口后重新从链上读取游标——持有人集合会随着余额变化而重新排序，而发送过期索引会从零重新开始并再次扣取您的资金。

该选项卡显示进度—— *“正在向第 N 位持有人支付，共 M 位”* ——并在游标回绕时结束。如果资产尚未设置支付币种，选项卡会明确说明；设置支付币种是分配中唯一只能由您选择的字段。

> **受限持有者的份额会保留在合约中。** 被收益黑名单模块排除的地址会被跳过，其按比例分得的份额会保留在代币合约中，而不会支付出去。

过去的支付尚未显示——读取这些记录需要沿分配事件回溯到该资产的创世区块，这需要一个尚未实现的历史游标。该选项卡会在自身内部说明这一点，而不是显示一个 `0`.

### 权限——角色

![权限选项卡——每个角色及其是否已持有，以及授予 / 撤销 / 放弃控件。](https://4058553919-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)

此选项卡列出代币声明的每个角色以及是否已持有，每项都通过一次 `hasRole` 对代币的调用读取。一个角色如果是 **不** 已持有的角色会显示出来，而不是被省略——在权限选项卡中，缺失的行和一个 *“否”* 是两种不同的事实。

列表下方有一个控件用于更改角色：

| 操作         | 作用于                           | 权限                   |
| ---------- | ----------------------------- | -------------------- |
| **授予给账户**  | 您输入的地址                        | `DEFAULT_ADMIN_ROLE` |
| **从账户撤销**  | 您输入的地址                        | `DEFAULT_ADMIN_ROLE` |
| **放弃您自己的** | 您自己（OpenZeppelin 要求确认者必须是调用者） | 您                    |

角色选项来自代币自身，因此控件绝不会提供代币不存在的角色。与每次写操作一样，权限行和后果会在按钮之前显示，因此在您签名前，就已说明这扇门及其单向性。

***

## 从未接触 Bloom 或链的内容

为明确合规所在位置：

| 事项              | 存放位置                                                       |
| --------------- | ---------------------------------------------------------- |
| KYC/AML 文件和 PII | 您自己的系统，配合您自己的供应商和保留策略—— **绝不** 此应用或链                       |
| 您批准某地址准入的决定     | 一条链下记录；存储由您拥有                                              |
| 该决定的链上效果        | 一个布尔值—— `isWhitelisted(address)` ——由 `batchAddToWhitelist` |
| 规则的执行           | 资产合约，在每次转账时                                                |
| 谁可以管理该资产        | 在资产允许列表模块上持有的角色，每次请求都会检查                                   |

如需完整的合规模型，请阅读 [COMPLIANCE.md](https://docs.rome.builders/zh/rome-shang-de-ying-yong/bloom/compliance.md)；如需了解您的持有人使用的双通道（EVM 和 Solana）机制，请阅读 [LANES.md](https://docs.rome.builders/zh/rome-shang-de-ying-yong/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/zh/rome-shang-de-ying-yong/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.
