> 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/ja/romenoapuri/bloom/issuing.md).

# 発行中

Bloomでは、 **許可制の実世界資産を** Romeチェーン上の通常のSolidityコントラクトとして発行し、資産ごとのコンソールから管理できます。その資産にはEVMウォレットとSolanaウォレットの両方からアクセスできますが、 **発行はEVMのみです** — Solanaウォレットは資産を保有するだけで、作成はしません。このガイドでは、発行者コンソール、作成ウィザード、コンソールのサインインゲート、および6つの管理タブを扱います。

> **Bloomに書類や個人データを渡す必要はありませんし、投資家も同様です。** Bloomは *結果* コンプライアンス判断の結果を記録し、チェーンにはアドレスごとに1つの真偽値が記録されます。KYC/AMLのプロセス — ベンダー、ファイル、保存期間 — は完全にあなた自身のシステム内に留まります。完全なモデルは [COMPLIANCE.md](https://docs.rome.builders/ja/romenoapuri/bloom/compliance.md)にあります。このガイドではそれを言い換えるのではなく、そこへ案内します。

***

## できること

資産の管理者として、以下のすべてをコンソールから実行できます — そしてこれらはすべて実際のオンチェーン取引であり、 [証拠](https://docs.rome.builders/ja/romenoapuri/bloom/evidence.md) ページにリンクされています:

* **資産を発行する** — ウィザードがそれを3つのコントラクトとしてデプロイします（以下）。
* **申請を審査する** — それぞれを承認または拒否します（拒否には申請者に対して説明される理由が付きます）、そして承認済みアドレスを許可リストに追加します。
* **許可リストを管理する** — 1つのアドレスを追加し、 **アドレスのバッチを1回のトランザクションで追加し** (`batchAddToWhitelist`）、またはアドレスを削除します。トークンはすべての送信でそのリストを強制します。
* **資産を制限する** — 転送を許可リストに制限します（これにより供給は確定します）、またはその制限を解除します。
* **供給を管理する** — 合計を読み取り、役割を持っている場合はミントまたはバーンします。
* **販売を実行する** — 販売を開始し（単位数と価格）、終了し、売れ残り在庫を回収し、売上を引き出します。
* **利回りを設定して分配する** — 支払い通貨を設定し、その後で分配を実行します。分配は保有者を1件ずつ処理します。除外された保有者はスキップされます。
* **役割を管理する** — アドレスに役割を付与する、取り消す、または自分の役割を放棄します。

それぞれについて、チェーンが何を強制するのかを含め、該当するタブで以下に詳述します。

***

## 発行者コンソール

![/issuer にある発行者コンソール。現在のデプロイで認識されている資産と、その販売状態を一覧表示します。](https://3990464069-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ウォレットは発行できません。これはチェーンが第2の独立したガードとして強制する、製品上の境界です。
* 表には各資産の **名前とシンボル**、ライフサイクルの **段階**、および **販売** 状態（ *開く* バッジまたは *Closed*).

2つの列 — **保有者** および **審査** — はダッシュで表示されます。保有者数には許可リストの列挙が必要で、審査キューは資産ごとにサインインするオフチェーンのストアです。ダッシュは *尋ねていない* ところで `0` アプリがまだ読んでいない事実を主張してしまう、という意味です。

押す **資産を発行する** ウィザードを開くか、行を選択してその資産のコンソールを開きます。

***

## 資産の作成: ウィザード

![/create の作成ウィザード: 資産フィールドと、トランザクションが着地するたびに点灯する6枚のカード。](https://3990464069-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` 4つの項目を収集してから、あなたの資産をデプロイします。

| 項目       | ルール         |
| -------- | ----------- |
| **名前**   | 必須。         |
| **シンボル** | 必須。         |
| **供給量**  | 0より大きい整数。   |
| **小数桁**  | 0から18までの整数。 |

押す **開始**。項目が無効な場合、ウィザードは無効化されたボタンの後ろに隠れるのではなく、どれがなぜ無効なのかを知らせます。下書きが有効になると、あなたのウォレットに各ステップを順に署名するよう求められます。

### なぜ段階的にデプロイするのか

> **トークンは3つのコントラクトとして複数のトランザクションにまたがってデプロイされます — 1回ではありません。** Arcの1トランザクション `createToken` には **77個のアカウントロック**が必要で、Romeでは1件のトランザクションの上限が **62ロック**です。そこでウィザードは各部分をそれぞれ独立したトランザクションでデプロイし、その後に `ArcTokenFactoryV2.registerToken`を通じてファクトリーステータスを取得します。これは、オプションの最適化ではなく、Romeの制約が可視化されたものです — そしてガードはArcの上流のセキュリティモデル（canonical proxy、whitelisted implementation、呼び出し元がトークンのadminロールを保持していること、登録は1回限り）をそのまま厳密に保持します。 [COMPLIANCE.md](https://docs.rome.builders/ja/romenoapuri/bloom/compliance.md#what-rome-adds-and-what-registertoken-preserves).

### 6枚のカード

ウィザードは6枚のカードを表示し、デプロイの進行に追従します。カードは **待機中** を **署名中…** を **完了** （または **失敗**に変わります。

| # | カード          | 何をするか                                                       |
| - | ------------ | ----------------------------------------------------------- |
| 1 | **実装**       | このチェーン向けの共有資産実装です — 解決済みで、署名は不要です。（最初のステップが実行される前に完了しています。） |
| 2 | **資産**       | あなたの資産をデプロイし、その名前、シンボル、供給量、小数桁を1ステップで設定します。                 |
| 3 | **誰が保有できるか** | この資産専用の許可モジュールをデプロイし、あなたをその管理者にします。                         |
| 4 | **送金時に適用**   | 資産をそのモジュールに向け、すべての送信が資産自身によってチェックされるようにします。                 |
| 5 | **利回りルール**   | 誰に支払うかを決めるモジュールをデプロイしてリンクします。                               |
| 6 | **登録**       | 資産を登録します — これが販売を開き、後でアップグレードできるようにします。                     |

6枚のカードは8つの基礎デプロイ手順を折りたたんでいるため、1回の **開始** で **8回の署名**になります。ボタンの下の注記には *「あなたのウォレットは各ステップの署名を求めます。途中で止めても、そこで中断したところから再開できます — 失われるものはありません。」* 登録が最後のステップであるため、途中停止が安全です。資産は各段階で実際にデプロイされ、最後に登録されます。

実行が完了すると、ウィザードは *「発行されました。あなたの資産は次の場所で有効です: …」* を読み取り、 `/token/[address]`.

> **`初期化` の資産コンソールへのリンクを表示します。** すべての役割があなたに付与されます。 **権限** タブには、すべての権限の保持者が可視化されます。（`UPGRADER_ROLE` が *ではなく* ファクトリーに自動的に付与されます — ファクトリー経由のアップグレードを行いたい場合は、明示的に付与してください。）

***

## 資産ごとのコンソールとサインインゲート

![コンソールのサインインゲート: ウォレットでメッセージに署名してください — パスワードはありません。](https://3990464069-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 — この資産を管理していることを証明してください」*&#x3068;あり、認可する唯一の操作 — この資産の申請キューの閲覧 — と、資産アドレス、チェーンID、タイムスタンプを記載します。
2. アプリはその署名済み文言を `GET /api/applications`.
3. 上記の **サーバー** に送信し、そこで検証します: 署名からあなたのアドレスを復元し、その文言がこのチェーン向けで、なお新しいものであることを確認し（セッションではなく2分間だけ認可します）、 **トークン自身の許可リストモジュール** をチェーンから読み取り、あなたのアドレスが、許可リストの書き込みに実際に必要な役割をそのモジュール上で持っているかを確認します。 `MANAGER_ROLE` そのモジュール上で。
4. その役割を持っていれば、キューが返され、コンソールが表示されます。持っていなければ、サーバーは `403` と理由付きで拒否します。

![この資産を管理していないウォレットは退けられる、という引用付きの拒否を示すゲート。](https://3990464069-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は、なぜウォレットが拒否されたのかという文を一切書きません。ウォレット内で署名を拒否した場合、それはあなたの *「いいえ」*&#x3067;あって、資産のものではなく、拒否として報告されることもありません。

> **このゲートは「誰のコンソールか」を示すものであり、「何が秘密か」ではありません。** 供給量、販売状態、許可リストの名簿、そして役割はすべて公開チェーンの読み取りであり、どのエクスプローラでも確認できます。署名で得られるのは **申請キュー** — 他人の申告 — と、そもそもコンソールを表示してもらう権利です。

### コンソールのヘッダー

サインインすると、ヘッダーに資産名と **段階** が表示されます — それが持つ、最も重要な情報です:

| 段階       | 意味                                                                       |
| -------- | ------------------------------------------------------------------------ |
| **下書き**  | まだ許可モジュールがリンクされていないため、これを誰が保有できるかは制限されていません。                             |
| **開く**   | 転送は開放されたままで、供給量もまだ変えられます。資産を制限すると供給量は確定し、その状態は元に戻せません。                   |
| **制限済み** | 許可リストに載っているアドレスだけがこれを保有できます。 **その供給量は確定しています** — これ以上ミントもバーンもできません。永続的に。 |

タブの上部には4つの数値が要約表示されます — **保有者 · 審査中 · 販売済み · 支払済み利回り**。2つはチェーンとストアから読み取られます（*審査* サインイン後に; *販売済み* ストアフロントから）； *保有者* は利回りプレビューの保有者数を待ち、 *支払済み利回り* は後で来る支払い履歴カーソルを待ちます。各待機中のセルはダッシュを表示し、必要なものを説明します。 `0` チェーンに誰も尋ねていない事実を主張するような

***

## 6つのタブ

コンソールには次の順で6つのタブがあります: **申請 · 保有可能者 · 供給 · 販売 · 利回り · 権限。**

これらのタブにおけるすべての書き込みは、書き込みの **明示的な前提条件** と **結果** *を* ボタンの前に描画し、実行中の段階名も表示する、共通の制御を使います（*「ウォレットを待機中…」*, *「チェーン上に着地中…」*）。何が先にチェックできたかを教えるために、何かをリバートさせるべきではありません。

### 申請 — 審査キュー

![申請タブ — 審査キュー。承認または拒否する保留中の申請と、コンプライアンスの接点があります。](https://3990464069-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)

このタブには、資産の保有を申請した人が一覧表示されます。各行には、申請者のアドレス、管轄、保有者タイプ、 **確認** 列（*合格* あなたのプロバイダが結果を記録していれば、そうでなければ *申告済み*）、および **ステータス** (*審査*, *承認済み*, *拒否*）。行を展開すると、その事実と2つの操作が表示されます: **承認 — 保有可** および **拒否**。拒否には理由が必要で、それが申請者への回答になります。

> **承認は2つの別々の行為であり、このタブはそれらを厳密に扱います。** 押すと **承認** *記録されます* あなたの判断が申請ストアに記録されます。アドレスをチェーン上の資産の許可リストに載せるのは **2回目の署名** — `batchAddToWhitelist` — そして着地するまで行にはそう表示されます。記録された判断とチェーンが食い違うとき、このタブはその差分を示し、それを埋める書き込みを提示します: **承認** で承認済みアドレスを許可リストに追加するか、（まだ掲載されている拒否済みアドレスの場合は）それを削除する操作です。許可リストへの書き込みが着地するまでは、そのアドレスは資産を保有できません。

このタブに常設されている注記 — **コンプライアンスの接点** — は、あなた自身のプロセスがどこに組み込まれるかを示します:

> *「ここでは書類は求められず、保持もされません — チェックはあなた自身のものです。プロバイダを `申請` インターフェースの背後に接続するか、すでに下した判断を取り込んでください。Bloomは結果を記録し、チェーンはそのアドレスに対して1つの yes か no を記録します。」*

それが、自社ホストの発行者が置き換えるインターフェースです: 申請ストアの実装を自前の永続的なものに差し替えても、呼び出し元は変わりません。Bloomは何のチェックも行わず、文書も保持しません。

### 保有できるのは誰か — 転送ゲート

![保有可能者タブ — 許可リストの数と転送制限の操作を示し、その一方通行の結果も表示します。](https://3990464069-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://3990464069-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://3990464069-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)

このタブは、ストアフロントコントラクトを通じて一次販売を実行します。

* **販売がまだ開始されていないとき**は、開始するよう提案します: **販売する単位数** および **1単位あたりの価格** (in `wUSDC`を入力し、次に **販売を開始**を押します。書き込みの前提条件が先に表示されます — トークンが登録済みであること、ストアフロントが販売在庫を保持していること、そしてストアフロント自身が販売先のトークンで許可リストに載っていること — そのため、まだ開始できない販売は必要なものを正確に示します。
* **販売が開始されているとき**、提供分の残り単位数が表示され、 **この販売を終了する**.
* **売れ残り単位を回収する** は、売れ残り在庫をストアフロントから受取先へ戻します（既定ではあなた）。これは **ではなく** 終了ではありません — 販売は有効なままであり、そのことは書き込みの結果でも示されます。したがって、回収を巻き戻しと誤解することはありません。
* **売上を引き出す** は、ストアフロントの売上をあるアドレスへ送ります（既定ではあなた）。売上は販売状態とは独立して蓄積されるため、販売が開いていても閉じていても引き出せます。

### 利回り — 保有者へ、トランザクションごとに1人ずつ支払う

![利回りタブ — 分配額の入力欄と、まず支払い通貨を設定するよう促す注意書き。](https://3990464069-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` が **1回のトランザクションで保有者1人に支払います** （アカウント上限）ので、支払いはウィンドウの連なりになります。各ウィンドウはそれぞれ独自の署名です。支払い額は1回だけ、支払い通貨の単位で入力し、歩みが始まるとロックされます。 **まず** ウィンドウは全額の支払いをあなたから引き出して最初の保有者に支払い、以降の各ウィンドウはトークンコントラクト内にすでにある資金だけを動かします。Bloomは各ウィンドウの後にチェーンからカーソルを再読み取りします — 保有者集合は残高の変化で順序が入れ替わり、古いインデックスを送ると0から再開してあなたのお金を2度引き出してしまうからです。

このタブは進行状況を表示します — *「N人中M人目の保有者に支払い中」* — そしてカーソルが一周すると完了します。資産に支払い通貨が設定されていない場合、このタブがそう伝えます。支払い通貨の設定は、分配においてあなたにしか選べない唯一の項目です。

> **制限された保有者の取り分はコントラクト内に残ります。** 利回りブラックリストモジュールで除外されたアドレスはスキップされ、その按分は支払いとして送られるのではなく、トークンコントラクト内に残ります。

過去の支払いはまだ表示されません — それらを読むには、分配イベントを資産の最初のブロックまでたどる必要があり、そのためにはまだ来ていない履歴カーソルが必要です。このタブはそれを自分の内部で示し、 `0`.

### 権限 — 役割

![権限タブ — すべての役割と、それが保持されているかどうか、および付与 / 取り消し / 放棄の操作。](https://3990464069-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      | あなた自身のシステム。あなた自身のベンダーと保存期間で — **決して** このアプリでもチェーンでもない             |
| アドレスを承認するというあなたの判断 | オフチェーンの記録; ストアの所有者はあなたです                                          |
| その判断のオンチェーン上の結果    | 1つの真偽値 — `isWhitelisted(address)` — を書き込むのは `batchAddToWhitelist` |
| ルールの強制             | 資産コントラクト。すべての送信で                                                  |
| 誰が資産を管理できるか        | 資産の許可リストモジュールで保持されている役割。各リクエストで確認されます                             |

コンプライアンスモデル全体については [COMPLIANCE.md](https://docs.rome.builders/ja/romenoapuri/bloom/compliance.md)をお読みください。保有者が使う2系統（EVMとSolana）の仕組みについては [LANES.md](https://docs.rome.builders/ja/romenoapuri/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/ja/romenoapuri/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.
