CPMM クリエイター手数料の設定方法

Creator fees により、LaunchLab プラットフォームは、トークン作成者にその CPMM プール上のスワップ取引量の一部を報酬として付与できます。各スワップの一定割合が、LP が獲得する取引手数料とは別に、作成者向けに確保されます。

Creator fees は、LaunchLab migration を通じて作成されたプールで利用できます。

creator fees の仕組み

この creator_fee_rate は AmmConfig で定義され、creator fees が有効化されているプール内のすべてのスワップに適用されます。これは取引手数料に上乗せされる追加手数料であり、その一部を切り出すものではありません。

次の条件のスワップでは trade_fee_rate: 2500 （0.25%）および creator_fee_rate: 500 (0.05%):

trade_fee   = input × 0.25%   → LP、protocol、fund に分配
creator_fee = input × 0.05%   → プール作成者向けに蓄積
                                 ─────
合計手数料                      = スワップ input の 0.30%

Creator fees は、プール state 上のプール vault に creator_fees_token_0 および creator_fees_token_1 として蓄積されます。作成者は、次を呼び出すことでこれらを回収します collect_creator_fee。これには、次として署名する必要があります pool_creator アドレス。

Quote-only モード

デフォルトでは、LaunchLab は creatorFeeOn を OnlyTokenB に設定します（quote token、通常は SOL）。これは、スワップ方向に関係なく、creator fee が常に quote token 建てになることを意味します。

3 つのモード:

モード	動作
BothToken	creator fee は input token から徴収されます。手数料は両方のトークンで蓄積されます。
OnlyToken0	creator fee は常に token 0 です。token 0 が input の場合、手数料は input から差し引かれます。token 1 が input の場合、手数料は output から差し引かれます。
OnlyToken1	creator fee は常に token 1 です（LaunchLab のデフォルト）。上記と同じロジックが、逆の形で適用されます。

この OnlyToken1 モード（デフォルト）では、ユーザーが SOL → Token をスワップする場合:

• creator fee は SOL input（quote token）から差し引かれます

ユーザーが Token → SOL をスワップする場合:

• creator fee は SOL output（やはり quote token）から差し引かれます

これにより、作成者は常に単一の流動性の高いトークンで手数料を受け取ることが保証されます。

トークンを作成する際に、これを次経由で設定します createLaunchpad:

creatorFeeOn: CpmmCreatorFeeOn.OnlyTokenB // デフォルト

creator fees の回収

この pool_creator アドレスは、蓄積された手数料をいつでも回収できます。SDK は、 collectMultiCreatorFees を提供しており、すべてのプールにまたがって一括回収できます:

const { execute, transactions } = await raydium.cpmm.collectMultiCreatorFees({
  poolInfoList: poolInfos,
  programId: CREATE_CPMM_POOL_PROGRAM,
  txVersion: TxVersion.V0,
})

完全な例: collectAllCreatorFee.ts

このスクリプトは、あなたのウォレットが該当するすべてのプールについて API を照会し、 pool_creatorを基準に、未回収手数料があるプールを絞り込み、それらをバッチトランザクションで回収します。

creator fee rate の設定

この creator_fee_rate は AmmConfigの一部であり、プールごとの設定ではありません。プラットフォームの cpConfigId によって、migrated pools に適用される config（したがって creator fee rate）が決まります。

利用可能な config とその creator fee rate を確認するには、「How to Set CPMM Fees」を参照してください。

プール作成者とは誰ですか？

この pool_creator アドレスは、LaunchLab migration 中のプール作成時に設定されます。LaunchLab プールでは、通常これはトークン作成者、つまり次を呼び出したウォレットです createLaunchpad. この設定は、プラットフォーム config 上の updatePlatformCpCreator を介してプラットフォームが構成できます。

完全な例: updatePlatform.ts