Genesis ボンディングカーブのクリエイター手数料

クリエイター手数料はGenesis ボンディングカーブのオプションのスワップごとの手数料で、毎回の購入と売却で設定されたウォレットに蓄積されます。

Summary

クリエイター手数料は、Genesis ボンディングカーブのオプションのスワップごとの手数料で、毎回の購入と売却のSOL側に適用されます。手数料はすぐには転送されず、バケットアカウント（creatorFeeAccrued）に蓄積されます。2つのパーミッションレスインストラクションで回収します。

• 設定 — カーブ作成時に launch オブジェクトに creatorFeeWallet を設定する。省略するとデフォルトでローンチウォレットになる
• 蓄積 — creatorFeeAccrued はスワップごとに増加する。手数料はスワップごとに転送されない
• アクティブカーブ中の請求 — claimBondingCurveCreatorFeeV2 でカーブがライブ中に蓄積した手数料を回収する
• グラデュエーション後の請求 — claimRaydiumCreatorFeeV2 でカーブがグラデュエーションした後にRaydium CPMMプールから手数料を回収する

スワップ価格設定とプロトコルスワップ手数料とのクリエイター手数料の相互作用については、動作理論 — 手数料構造を参照してください。

クイックスタート

ジャンプ: ローンチ時の設定 · ウォレットへのリダイレクト · [エージェントPDA](#エージェントローンチ自動pda ルーティング) · ファーストバイとの組み合わせ · 蓄積確認 · カーブ中の請求 · グラデュエーション後の請求

1. createAndRegisterLaunch を呼び出すときに launch オブジェクトに creatorFeeWallet を設定する
2. ローンチ後、bucket.creatorFeeAccrued を監視して蓄積手数料を追跡する
3. claimBondingCurveCreatorFeeV2 を呼び出してカーブがアクティブな間に手数料を回収する
4. グラデュエーション後、claimRaydiumCreatorFeeV2 を呼び出してRaydium LP手数料を回収する

前提条件

• @metaplex-foundation/genesis SDKインストール済み
• キーペアIDで設定されたUmiインスタンス — Metaplex APIを通じたボンディングカーブのローンチを参照
• トランザクション手数料のための入金済みSolanaウォレット

ローンチ時のクリエイター手数料の設定

クリエイター手数料は createAndRegisterLaunch（または createLaunch）に渡す launch オブジェクトで設定します。creatorFeeWallet フィールドはオプションです — 省略した場合、デフォルトでローンチウォレットがすべての手数料を受け取ります。完全なローンチフローについてはMetaplex APIを通じたボンディングカーブのローンチを参照してください。

クリエイター手数料を特定のウォレットにリダイレクトする

creatorFeeWallet を設定して、蓄積された手数料をローンチウォレット以外の任意のウォレットアドレスに向けます。

1import { createAndRegisterLaunch } from '@metaplex-foundation/genesis/api';
2
3const result = await createAndRegisterLaunch(umi, {}, {
4  wallet: umi.identity.publicKey,
5  launchType: 'bondingCurve',
6  token: {
7    name: 'My Token',
8    symbol: 'MTK',
9    image: 'https://gateway.irys.xyz/your-image-id',
10  },
11  launch: {
12    creatorFeeWallet: 'FeeRecipientWalletAddress...',
13  },
14});

エージェントローンチ — 自動PDAルーティング

MetaplexエージェントのためにローンチするSolana場合、クリエイター手数料は creatorFeeWallet を手動設定せずにエージェントのPDAに自動的にルーティングされます。Coreエグゼキュートラッピングと setToken 関連付けを含む完全なエージェントローンチフローについては、エージェントトークンの作成を参照してください。

クリエイター手数料とファーストバイの組み合わせ

クリエイター手数料ウォレットとファーストバイを一緒に設定できます。ファーストバイは常に手数料無料です — その初回購入にはプロトコル手数料もクリエイター手数料もかかりません。その後のすべてのスワップは通常のクリエイター手数料を支払います。

launch: {
  creatorFeeWallet: 'FeeRecipientWalletAddress...',
  firstBuyAmount: 0.5, // 0.5 SOL、最初の購入者に手数料無料
},

蓄積したクリエイター手数料の確認

BondingCurveBucketV2 アカウントの creatorFeeAccrued フィールドは、最後の請求以降に蓄積した合計SOLを追跡します。fetchBondingCurveBucketV2 を使用して読み取ります：

1import {
2  findBondingCurveBucketV2Pda,
3  fetchBondingCurveBucketV2,
4} from '@metaplex-foundation/genesis';
5import { isSome, publicKey } from '@metaplex-foundation/umi';
6
7const genesisAccount = publicKey('YOUR_GENESIS_ACCOUNT_PUBKEY');
8const baseMint = publicKey('TOKEN_MINT_PUBKEY');
9
10const [bucketPda] = findBondingCurveBucketV2Pda(umi, {
11  genesisAccount,
12  bucketIndex: 0,
13});
14
15const bucket = await fetchBondingCurveBucketV2(umi, bucketPda);
16console.log('Creator fees accrued (lamports):', bucket.creatorFeeAccrued);
17console.log('Creator fees claimed to date (lamports):', bucket.creatorFeeClaimed);
18
19// バケット拡張機能から設定されたクリエイター手数料ウォレットを読み取る
20const creatorFeeExt = bucket.extensions.creatorFee;
21const creatorFeeWallet = isSome(creatorFeeExt) ? creatorFeeExt.value.wallet : null;
22console.log('Creator fee wallet:', creatorFeeWallet?.toString() ?? 'none configured');

アクティブなカーブ中のクリエイター手数料の請求

claimBondingCurveCreatorFeeV2 は、蓄積したすべてのクリエイター手数料をバケットから設定されたクリエイター手数料ウォレットに転送します。カーブがアクティブな間はいつでも呼び出せます。

1import { claimBondingCurveCreatorFeeV2 } from '@metaplex-foundation/genesis';
2import { isSome } from '@metaplex-foundation/umi';
3
4// 請求前にバケット拡張機能からクリエイター手数料ウォレットを読み取る。
5const creatorFeeExt = bucket.extensions.creatorFee;
6if (!isSome(creatorFeeExt)) throw new Error('No creator fee configured on this bucket');
7const creatorFeeWallet = creatorFeeExt.value.wallet;
8
9const result = await claimBondingCurveCreatorFeeV2(umi, {
10  genesisAccount,
11  bucket: bucketPda,
12  baseMint,
13  creatorFeeWallet,
14}).sendAndConfirm(umi);
15
16console.log('Creator fees claimed:', result.signature);

グラデュエーション後のクリエイター手数料の請求

ボンディングカーブがグラデュエーションした後、流動性はRaydium CPMMプールに移行し、クリエイター手数料はLPの取引活動から引き続き蓄積されます。RaydiumCpmmBucketV2 アカウントは、BondingCurveBucketV2 と同様の creatorFeeAccrued と creatorFeeClaimed フィールドを公開します。グラデュエーション後の手数料は claimRaydiumCreatorFeeV2 で回収します。

1import { claimRaydiumCreatorFeeV2 } from '@metaplex-foundation/genesis';
2
3const result = await claimRaydiumCreatorFeeV2(umi, {
4  genesisAccount,
5  // ... Raydiumプールアカウント
6}).sendAndConfirm(umi);

Notes

• クリエイター手数料は各スワップでバケット（creatorFeeAccrued）に蓄積されますが、すぐには転送されません — 受け取るには明示的に請求インストラクションを呼び出す必要があります。creatorFeeClaimed は累計の請求済み合計を追跡します
• 両方の請求インストラクションはパーミッションレスです。どのウォレットでもトリガーできますが、SOLは常に設定されたクリエイター手数料ウォレットに送られ、呼び出し元には送られません
• creatorFeeWallet は設定されていない場合デフォルトでローンチウォレットになります。カーブ作成後は変更できません
• ファーストバイの仕組みは、指定された初回購入のみすべての手数料（プロトコルとクリエイター）を免除します。その後のすべてのスワップは通常のクリエイター手数料を支払います
• クリエイター手数料は方向（購入または売却）に関わらずすべてのスワップのSOL側に適用されます。プロトコルスワップ手数料とは複合しません
• 現在の手数料率についてはGenesis プロトコル手数料ページを参照してください
• バケット状態の読み取り、見積もりの計算、取引の実行についてはボンディングカーブスワップ統合を参照してください

FAQ

creatorFeeWallet が設定されていない場合、デフォルトのクリエイター手数料ウォレットは何ですか？

デフォルトのクリエイター手数料ウォレットはローンチウォレット — createLaunch 呼び出しに署名したウォレットです。launch オブジェクトに creatorFeeWallet を明示的に設定して、手数料を他のアドレスにリダイレクトします。

クリエイター手数料はスワップごとに転送されますか？

いいえ。クリエイター手数料は各スワップでバケット（creatorFeeAccrued）に蓄積されますが、すぐには転送されません。アクティブなカーブ中は claimBondingCurveCreatorFeeV2 で、グラデュエーション後は claimRaydiumCreatorFeeV2 で請求します。

誰でも claimBondingCurveCreatorFeeV2 を呼び出せますか？

はい。claimBondingCurveCreatorFeeV2 と claimRaydiumCreatorFeeV2 はどちらもパーミッションレスです — どのウォレットでも請求をトリガーできますが、SOLは常に設定されたクリエイター手数料ウォレットに送られ、呼び出し元には送られません。

ファーストバイはクリエイター手数料を支払いますか？

いいえ。ファーストバイが設定されている場合、プロトコルスワップ手数料とクリエイター手数料の両方が、その1回の初回購入に対して免除されます。その後のすべてのスワップは通常のクリエイター手数料を支払います。

蓄積したクリエイター手数料を確認するにはどうすればよいですか？

fetchBondingCurveBucketV2 を使用してバケットアカウントから creatorFeeAccrued フィールドを読み取ります。蓄積したクリエイター手数料の確認を参照してください。

ローンチ後にクリエイター手数料ウォレットを変更できますか？

いいえ。クリエイター手数料ウォレットはカーブ作成時に設定され、カーブがライブになった後は変更できません。