# LaunchLab と CPMM の手数料リファレンス

このページでは、手数料がエンドツーエンドでどのように機能するかを示します。ボンディングカーブから移行を経て CPMM プールまで、資金がどこに流れ、誰が何を受け取るのかを正確に確認できます。

### 手数料のライフサイクル

LaunchLab を通じてローンチされたトークンには、2つの取引フェーズがあります。各フェーズには、それぞれ独自の手数料構造があります。

#### フェーズ1: ボンディングカーブ

ボンディングカーブ上のすべての取引には、4つの独立した手数料が適用されます。

```
総手数料 = プロトコル手数料 + プラットフォーム手数料 + クリエイター手数料 + 紹介手数料
```

| 手数料         | 設定者                                       | レート例   | 受取先              |
| ----------- | ----------------------------------------- | ------ | ---------------- |
| プロトコル手数料    | Raydium（グローバル設定 `tradeFeeRate`)           | 0.25%  | Raydium          |
| プラットフォーム手数料 | プラットフォーム開発者（`feeRate` プラットフォーム設定上）        | 1%     | プラットフォームの請求ウォレット |
| クリエイター手数料   | プラットフォーム開発者（`creatorFeeRate` プラットフォーム設定上） | 0.5%   | トークン作成者のvault    |
| 紹介手数料       | トランザクションごと（`shareFeeRate`)                | 0–0.5% | 紹介者ウォレット         |

これらの手数料は **加算式です**。プラットフォームが1%のプラットフォーム手数料と0.5%のクリエイター手数料を設定し、プロトコル手数料が0.25%の場合、各取引の総手数料は少なくとも1.75%（加えて紹介手数料）になります。

**請求方法:**

| 対象       | SDKメソッド                                                         |
| -------- | --------------------------------------------------------------- |
| プラットフォーム | `claimVaultPlatformFee()` または `claimMultipleVaultPlatformFee()` |
| クリエイター   | `claimCreatorFee()` または `claimMultipleCreatorFee()`             |

手数料はvaultに蓄積され、手動で請求する必要があります。紹介手数料は、各取引で紹介者に直接送金されます。

#### 移行

ボンディングカーブが卒業ターゲットに達すると:

1. 流動性は CPMM プールに移行します（プール作成手数料 0.15 SOL）。
2. LP トークンは次の比率に従って配布されます `migrateCpLockNftScale`:
   * `burnScale` → 永久にバーンされます（これらから手数料を請求する者はいません）
   * `creatorScale` → Burn & Earn を通じてロックされ、クリエイターは Fee Key NFT を受け取ります
   * `platformScale` → Burn & Earn によりロックされ、プラットフォームは Fee Key NFT を受け取ります
3. CPMM プールは、で指定された手数料設定を使用します `cpConfigId` プラットフォームの config 上で。

#### フェーズ 2: CPMM プール

移行後、各スワップは最大 2 つの手数料を発生させ、どちらもスワップ入力から差し引かれます:

```
取引手数料    = スワップ入力 × trade_fee_rate (例: 0.25%)
creator fee  = スワップ入力 × creator_fee_rate (例: 0.05%)
```

その後、取引手数料は次のように分配されます:

| 区分       | シェア        | 受取先                                              |
| -------- | ---------- | ------------------------------------------------ |
| LP シェア   | 取引手数料の 84% | プールの vault（すべての LP 保有者と Fee Key NFT 保有者に利益があります） |
| プロトコル    | 取引手数料の 12% | Raydium                                          |
| Treasury | 取引手数料の 4%  | Raydium                                          |

creator fee は 100% プール作成者に送られます。これは **取引手数料から差し引かれる** ものではなく、その上乗せで発生する追加 शुल्कです。

Fee Key NFT 保有者は LP シェアから収益を得ます。請求額は、NFT が表すロックされた LP トークンに比例します。

**請求方法:**

| 対象       | 何                | SDKメソッド               |
| -------- | ---------------- | --------------------- |
| クリエイター   | CPMM creator fee | `collectCreatorFee()` |
| クリエイター   | LP fee share     | `harvestLockLp()`     |
| プラットフォーム | LP fee share     | `harvestLockLp()`     |

***

### 作成者の手数料の積み上がり方

移行後、作成者は以下から収益を得ることができます **3 つのソースを同時に**:

| ソース                        | メカニズム                        | 請求                    |
| -------------------------- | ---------------------------- | --------------------- |
| Bonding curve creator fee  | 移行前の vault                   | `claimCreatorFee()`   |
| CPMM creator fee           | あたりのスワップで `creator_fee_rate` | `collectCreatorFee()` |
| LP fee share (Fee Key NFT) | ロックされた流動性からの LP 取引手数料のシェア    | `harvestLockLp()`     |

これらは互いに置き換わるものではありません。3 つすべてを有効にしてローンチした作成者は、3 つすべてを個別に請求する必要があります。

{% hint style="info" %}
**CPMM creator fee は別ルートに振り分けることができます。** プラットフォームは `updatePlatformCpCreator` を呼び出して、creator fees をプラットフォーム管理のウォレット（または PDA）に転送し、その後は自由に再配分できます。プラットフォーム収益として一部を保持したり、独自条件で作成者と分配したり、他のプログラムの資金に充てたりできます。
{% endhint %}

#### 実例

次の条件の CPMM プール `trade_fee_rate: 2500` (0.25%), `creator_fee_rate: 500` (0.05%)、および `creatorScale: 100%`.

1,000,000トークンの **1,000,000トークン** スワップ:

| 手数料               | 金額            | 受取先                               |
| ----------------- | ------------- | --------------------------------- |
| 取引手数料 (0.25%)     | 2,500トークン     | 内訳: LP 2,100 / プロトコル 300 / 財庫 100 |
| クリエイター手数料 (0.05%) | 500トークン       | プール作成者                            |
| **総手数料**          | **3,000トークン** |                                   |
| スワップへ             | 997,000トークン   | 定積の計算                             |

作成者の収益は **2,600トークン**: LP手数料から2,100（Fee Key NFT経由）+ CPMMのクリエイター手数料から500。

***

### 設定リファレンス

#### グローバル設定（LaunchLab — Raydium によって設定）

| フィールド             | 制御対象                              |
| ----------------- | --------------------------------- |
| `tradeFeeRate`    | ボンディングカーブ取引に対する Raydium のプロトコル手数料 |
| `maxShareFeeRate` | 許可される最大の紹介手数料率                    |

グローバル設定は、クォートトークンとカーブタイプに基づいて次の方法で導出されます `getPdaLaunchpadConfigId()`. 開発者はこれを変更できません。

#### プラットフォーム設定（LaunchLab — プラットフォーム開発者によって設定）

| フィールド                   | 制御対象                                  | 次を通じて設定                                                    |
| ----------------------- | ------------------------------------- | ---------------------------------------------------------- |
| `feeRate`               | プラットフォームのボンディングカーブ取引手数料               | `createPlatformConfig()` または `updateFeeRate`               |
| `creatorFeeRate`        | 作成者のボンディングカーブ取引手数料                    | `createPlatformConfig()`                                   |
| `migrateCpLockNftScale` | 移行時の LP 分割（burn / creator / platform） | `createPlatformConfig()` または `updateMigrateCpLockNftScale` |
| `cpConfigId`            | 移行済みプールで使用される CPMM AmmConfig          | `createPlatformConfig()` または `updateCpConfigId`            |
| `platformCpCreator`     | 移行済みの CPMM プールでプール作成者アドレスを上書きします      | `updatePlatformCpCreator()`                                |

#### AmmConfig（CPMM — Raydium によって設定）

| フィールド               | 制御対象                                  |
| ------------------- | ------------------------------------- |
| `trade_fee_rate`    | スワップ入力から差し引かれる手数料（例: 2500 = 0.25%）    |
| `protocol_fee_rate` | 取引手数料に対するプロトコルの取り分（例: 120000 = 12%）   |
| `fund_fee_rate`     | 取引手数料に対する財庫の取り分（例: 40000 = 4%）        |
| `creator_fee_rate`  | プール作成者向けのスワップごとの追加手数料（例: 500 = 0.05%） |
| `create_pool_fee`   | lamports における一度限りのプール作成コスト            |

すべてのレートフィールドは 1,000,000 を分母として使用します。プラットフォーム開発者は、どの AmmConfig を使用するかを以下で選択します `cpConfigId` が、カスタム設定は作成できません。必要な場合は Raydium にお問い合わせください。

***

### よくある誤解

1. 作成者手数料は 3 種類あります。ボンディングカーブの作成者手数料、CPMM の作成者手数料、そして Fee Key NFT を通じた LP 手数料の分配です。上記のライフサイクルのセクションを参照してください。
2. **CPMM の作成者手数料は取引手数料の一部として差し引かれます。** いいえ。これは取引手数料に加えて発生する追加手数料です。どちらも スワップ の入力から個別に差し引かれます。
3. **Fee Key NFT = CPMM creator fee.** いいえ。Fee Key NFT は、ロックされた流動性から発生する LP 取引手数料の請求権を与えます。CPMM の作成者手数料は、以下を通じて徴収されるスワップごとの別個の शुल्कです `collectCreatorFee()`。これらは異なる収益源です。
4. **すべての CPMM プールには作成者手数料があります。** いいえ。作成者手数料は、権限付き経路（LaunchLab migration）で作成されたプールにのみ存在します。以下で作成された標準の CPMM プール `createPool()` では、プログラム レベルで作成者手数料が無効になっています。
5. **LP トークンを Burn すると、流動性を失うことになります。** Burn された LP トークンは流動性をプールに永久に残しますが、そのトークンが生み出す手数料を請求できる人はいません。Burn & Earn の Fee Key NFT は異なります。流動性はロックされており（Burn されていません）、NFT 保有者が手数料の増分を請求します。