@pump-fun/pump-sdk 1.27.0-devnet.1 → 1.27.0-devnet.2

package/README.md

@@ -101,3 +101,65 @@ console.log((await sdk.getCreatorVaultBalanceBothPrograms(user)).toString());
 // Collecting creator fees instructions
 const instructions = await sdk.collectCoinCreatorFeeInstructions(user);
 ```
+
+## Fee Sharing
+
+Fee sharing allows token creators to set up fee distribution to multiple shareholders. The `OnlinePumpSdk` provides methods to check distributable fees and distribute them.
+
+```Typescript
+import { OnlinePumpSdk } from "@pump-fun/pump-sdk";
+
+const connection = new Connection(
+    "https://api.devnet.solana.com",
+    "confirmed",
+);
+const onlineSdk = new OnlinePumpSdk(connection);
+const mint = new PublicKey("...");
+```
+
+### Check if Creator Has Migrated to Fee Sharing
+
+Before checking or distributing fees, verify that the coin creator has set up fee sharing:
+
+```Typescript
+const usingSharingConfig = isCreatorUsingSharingConfig({ mint, creator });
+
+if (!usingSharingConfig) {
+    console.log("Creator has not set up fee sharing");
+    return;
+}
+
+// Creator has migrated, proceed with fee distribution
+```
+
+### Get Minimum Distributable Fee
+
+Check whether a coin's fee sharing configuration balance and distributable fees
+
+```Typescript
+const result = await onlineSdk.getMinimumDistributableFee(mint);
+
+console.log("Minimum required:", result.minimumRequired.toString());
+console.log("Distributable fees:", result.distributableFees.toString());
+console.log("Can distribute:", result.canDistribute);
+console.log("Is graduated:", result.isGraduated);
+```
+
+This method handles both graduated (AMM) and non-graduated (bonding curve) tokens. For graduated tokens, it automatically consolidates fees from the AMM vault before calculating.
+
+### Distribute Creator Fees
+
+Build instructions to distribute accumulated creator fees to shareholders:
+
+```Typescript
+const { instructions, isGraduated } = await onlineSdk.buildDistributeCreatorFeesInstructions(mint);
+
+// instructions contains:
+// - For graduated tokens: transferCreatorFeesToPump + distributeCreatorFees
+// - For non-graduated tokens: distributeCreatorFees only
+
+// Add instructions to your transaction
+const tx = new Transaction().add(...instructions);
+```
+
+This method automatically handles graduated tokens by including the `transferCreatorFeesToPump` instruction to consolidate fees from the AMM vault before distributing.

package/dist/esm/index.js

@@ -8965,7 +8965,9 @@ import {
   TOKEN_PROGRAM_ID
 } from "@solana/spl-token";
 import {
-  PublicKey as PublicKey3
+  PublicKey as PublicKey3,
+  TransactionMessage,
+  VersionedTransaction
 } from "@solana/web3.js";
 import BN4 from "bn.js";
 
@@ -9039,6 +9041,7 @@ var OnlinePumpSdk = class {
     this.connection = connection;
     this.pumpProgram = getPumpProgram(connection);
     this.offlinePumpProgram = OFFLINE_PUMP_PROGRAM;
+    this.pumpAmmProgram = getPumpAmmProgram(connection);
     this.pumpAmmSdk = new OnlinePumpAmmSdk(connection);
     this.pumpAmmAdminSdk = new PumpAmmAdminSdk(connection);
   }
@@ -9303,6 +9306,127 @@ var OnlinePumpSdk = class {
       await PUMP_AMM_SDK.syncUserVolumeAccumulator(user)
     ];
   }
+  /**
+   * Gets the minimum distributable fee for a token's fee sharing configuration.
+   *
+   * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+   * For graduated tokens, it automatically consolidates fees from the AMM vault before
+   * calculating the minimum distributable fee.
+   *
+   * @param mint - The mint address of the token
+   * @param simulationSigner - Optional signer address for transaction simulation.
+   *                           Must have a non-zero SOL balance. Defaults to a known funded address.
+   * @returns The minimum distributable fee information including whether distribution is possible
+   */
+  async getMinimumDistributableFee(mint, simulationSigner = new PublicKey3("UqN2p5bAzBqYdHXcgB6WLtuVrdvmy9JSAtgqZb3CMKw")) {
+    const sharingConfigPubkey = feeSharingConfigPda(mint);
+    const poolAddress = canonicalPumpPoolPda(mint);
+    const coinCreatorVaultAuthority = coinCreatorVaultAuthorityPda(sharingConfigPubkey);
+    const ammVaultAta = coinCreatorVaultAtaPda(
+      coinCreatorVaultAuthority,
+      NATIVE_MINT,
+      TOKEN_PROGRAM_ID
+    );
+    const [sharingConfigAccountInfo, poolAccountInfo, ammVaultAtaInfo] = await this.connection.getMultipleAccountsInfo([
+      sharingConfigPubkey,
+      poolAddress,
+      ammVaultAta
+    ]);
+    if (!sharingConfigAccountInfo) {
+      throw new Error(`Sharing config not found for mint: ${mint.toBase58()}`);
+    }
+    const sharingConfig = PUMP_SDK.decodeSharingConfig(sharingConfigAccountInfo);
+    const instructions = [];
+    const isGraduated = poolAccountInfo !== null;
+    if (isGraduated && ammVaultAtaInfo) {
+      const transferCreatorFeesToPumpIx = await this.pumpAmmProgram.methods.transferCreatorFeesToPump().accountsPartial({
+        wsolMint: NATIVE_MINT,
+        tokenProgram: TOKEN_PROGRAM_ID,
+        coinCreator: sharingConfigPubkey
+      }).instruction();
+      instructions.push(transferCreatorFeesToPumpIx);
+    }
+    const getMinFeeIx = await PUMP_SDK.getMinimumDistributableFee({
+      mint,
+      sharingConfig,
+      sharingConfigAddress: sharingConfigPubkey
+    });
+    instructions.push(getMinFeeIx);
+    const { blockhash } = await this.connection.getLatestBlockhash();
+    const tx = new VersionedTransaction(
+      new TransactionMessage({
+        payerKey: simulationSigner,
+        recentBlockhash: blockhash,
+        instructions
+      }).compileToV0Message()
+    );
+    const result = await this.connection.simulateTransaction(tx);
+    let minimumDistributableFee = {
+      minimumRequired: new BN4(0),
+      distributableFees: new BN4(0),
+      canDistribute: false
+    };
+    if (!result.value.err) {
+      const [data, encoding] = result.value.returnData?.data ?? [];
+      if (data) {
+        const buffer = Buffer.from(data, encoding);
+        minimumDistributableFee = PUMP_SDK.decodeMinimumDistributableFee(buffer);
+      }
+    }
+    return {
+      ...minimumDistributableFee,
+      isGraduated
+    };
+  }
+  /**
+   * Gets the instructions to distribute creator fees for a token's fee sharing configuration.
+   *
+   * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+   * For graduated tokens, it automatically includes an instruction to consolidate fees
+   * from the AMM vault before distributing.
+   *
+   * @param mint - The mint address of the token
+   * @returns The instructions to distribute creator fees and whether the token is graduated
+   */
+  async buildDistributeCreatorFeesInstructions(mint) {
+    const sharingConfigPubkey = feeSharingConfigPda(mint);
+    const poolAddress = canonicalPumpPoolPda(mint);
+    const coinCreatorVaultAuthority = coinCreatorVaultAuthorityPda(sharingConfigPubkey);
+    const ammVaultAta = coinCreatorVaultAtaPda(
+      coinCreatorVaultAuthority,
+      NATIVE_MINT,
+      TOKEN_PROGRAM_ID
+    );
+    const [sharingConfigAccountInfo, poolAccountInfo, ammVaultAtaInfo] = await this.connection.getMultipleAccountsInfo([
+      sharingConfigPubkey,
+      poolAddress,
+      ammVaultAta
+    ]);
+    if (!sharingConfigAccountInfo) {
+      throw new Error(`Sharing config not found for mint: ${mint.toBase58()}`);
+    }
+    const sharingConfig = PUMP_SDK.decodeSharingConfig(sharingConfigAccountInfo);
+    const instructions = [];
+    const isGraduated = poolAccountInfo !== null;
+    if (isGraduated && ammVaultAtaInfo) {
+      const transferCreatorFeesToPumpIx = await this.pumpAmmProgram.methods.transferCreatorFeesToPump().accountsPartial({
+        wsolMint: NATIVE_MINT,
+        tokenProgram: TOKEN_PROGRAM_ID,
+        coinCreator: sharingConfigPubkey
+      }).instruction();
+      instructions.push(transferCreatorFeesToPumpIx);
+    }
+    const distributeCreatorFeesIx = await PUMP_SDK.distributeCreatorFees({
+      mint,
+      sharingConfig,
+      sharingConfigAddress: sharingConfigPubkey
+    });
+    instructions.push(distributeCreatorFeesIx);
+    return {
+      instructions,
+      isGraduated
+    };
+  }
 };
 
 // src/idl/pump_amm.json
@@ -18604,7 +18728,7 @@ var PumpSdk = class {
   }
 };
 var PUMP_SDK = new PumpSdk();
-function hasCoinCreatorMigratedToSharingConfig({
+function isCreatorUsingSharingConfig({
   mint,
   creator
 }) {
@@ -18739,7 +18863,7 @@ export {
   getSellSolAmountFromTokenAmount,
   getSolVaultPda,
   getTokenVaultPda,
-  hasCoinCreatorMigratedToSharingConfig,
+  isCreatorUsingSharingConfig,
   newBondingCurve,
   pump_default as pumpIdl,
   pumpPoolAuthorityPda,

package/dist/index.d.mts

@@ -22704,13 +22704,13 @@ declare class PumpSdk {
 }
 declare const PUMP_SDK: PumpSdk;
 /**
- * Checks if a creator has migrated to using a fee sharing configuration.
+ * Checks if a creator has upgraded to using a fee sharing configuration.
  *
  * When a creator sets up fee sharing, the creator address in the BondingCurve or Pool
  * is replaced with the fee sharing config PDA address. This function checks if that
- * migration has occurred.
+ * upgrade has occurred.
  *
- * @param params - Parameters for checking migration status
+ * @param params - Parameters for checking upgrade status
  * @param params.mint - The mint address of the token
  * @param params.creator - The creator address to check
  *                         - For ungraduated coins: use BondingCurve.creator
@@ -22720,18 +22720,18 @@ declare const PUMP_SDK: PumpSdk;
  *
  * @example
  * ```typescript
- * import { hasCoinCreatorMigratedToSharingConfig } from "@pump-fun/sdk";
+ * import { isCreatorUsingSharingConfig } from "@pump-fun/sdk";
  *
  * // For an ungraduated coin
  * const bondingCurve = await program.account.bondingCurve.fetch(bondingCurvePda(mint));
- * const hasMigrated = hasCoinCreatorMigratedToSharingConfig({
+ * const hasMigrated = isCreatorUsingSharingConfig({
  *   mint,
  *   creator: bondingCurve.creator
  * });
  *
  * // For a graduated coin
  * const pool = await ammProgram.account.pool.fetch(poolAddress);
- * const hasMigrated = hasCoinCreatorMigratedToSharingConfig({
+ * const hasMigrated = isCreatorUsingSharingConfig({
  *   mint,
  *   creator: pool.coinCreator
  * });
@@ -22743,7 +22743,7 @@ declare const PUMP_SDK: PumpSdk;
  * }
  * ```
  */
-declare function hasCoinCreatorMigratedToSharingConfig({ mint, creator, }: {
+declare function isCreatorUsingSharingConfig({ mint, creator, }: {
     mint: PublicKey;
     creator: PublicKey;
 }): boolean;
@@ -22752,6 +22752,7 @@ declare class OnlinePumpSdk {
     private readonly connection;
     private readonly pumpProgram;
     private readonly offlinePumpProgram;
+    private readonly pumpAmmProgram;
     private readonly pumpAmmSdk;
     private readonly pumpAmmAdminSdk;
     constructor(connection: Connection);
@@ -22783,6 +22784,37 @@ declare class OnlinePumpSdk {
     getCurrentDayTokens(user: PublicKey): Promise<BN>;
     getCurrentDayTokensBothPrograms(user: PublicKey): Promise<BN>;
     syncUserVolumeAccumulatorBothPrograms(user: PublicKey): Promise<TransactionInstruction[]>;
+    /**
+     * Gets the minimum distributable fee for a token's fee sharing configuration.
+     *
+     * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+     * For graduated tokens, it automatically consolidates fees from the AMM vault before
+     * calculating the minimum distributable fee.
+     *
+     * @param mint - The mint address of the token
+     * @param simulationSigner - Optional signer address for transaction simulation.
+     *                           Must have a non-zero SOL balance. Defaults to a known funded address.
+     * @returns The minimum distributable fee information including whether distribution is possible
+     */
+    getMinimumDistributableFee(mint: PublicKey, simulationSigner?: PublicKey): Promise<MinimumDistributableFeeResult>;
+    /**
+     * Gets the instructions to distribute creator fees for a token's fee sharing configuration.
+     *
+     * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+     * For graduated tokens, it automatically includes an instruction to consolidate fees
+     * from the AMM vault before distributing.
+     *
+     * @param mint - The mint address of the token
+     * @returns The instructions to distribute creator fees and whether the token is graduated
+     */
+    buildDistributeCreatorFeesInstructions(mint: PublicKey): Promise<DistributeCreatorFeeResult>;
+}
+interface MinimumDistributableFeeResult extends MinimumDistributableFeeEvent {
+    isGraduated: boolean;
+}
+interface DistributeCreatorFeeResult {
+    instructions: TransactionInstruction[];
+    isGraduated: boolean;
 }
 
 declare function totalUnclaimedTokens(globalVolumeAccumulator: GlobalVolumeAccumulator, userVolumeAccumulator: UserVolumeAccumulator, currentTimestamp?: number): BN;
@@ -22817,4 +22849,4 @@ declare class PoolRequiredForGraduatedError extends Error {
     constructor();
 }
 
-export { AMM_GLOBAL_PDA, AMM_GLOBAL_VOLUME_ACCUMULATOR_PDA, BONDING_CURVE_NEW_SIZE, type BondingCurve, CANONICAL_POOL_INDEX, type DistributeCreatorFeesEvent, DuplicateShareholderError, type FeeConfig, GLOBAL_PDA, GLOBAL_VOLUME_ACCUMULATOR_PDA, type Global, type GlobalVolumeAccumulator, InvalidShareTotalError, MAYHEM_PROGRAM_ID, type MinimumDistributableFeeEvent, NoShareholdersError, OnlinePumpSdk, PUMP_AMM_EVENT_AUTHORITY_PDA, PUMP_AMM_PROGRAM_ID, PUMP_EVENT_AUTHORITY_PDA, PUMP_FEE_CONFIG_PDA, PUMP_FEE_EVENT_AUTHORITY_PDA, PUMP_FEE_PROGRAM_ID, PUMP_PROGRAM_ID, PUMP_SDK, PoolRequiredForGraduatedError, type Pump, type PumpFees, PumpSdk, ShareCalculationOverflowError, type Shareholder, type SharingConfig, TooManyShareholdersError, type UserVolumeAccumulator, type UserVolumeAccumulatorTotalStats, ZeroShareError, ammCreatorVaultPda, bondingCurveMarketCap, bondingCurvePda, canonicalPumpPoolPda, creatorVaultPda, currentDayTokens, feeSharingConfigPda, getBuySolAmountFromTokenAmount, getBuyTokenAmountFromSolAmount, getEventAuthorityPda, getGlobalParamsPda, getMayhemStatePda, getPumpAmmProgram, getPumpFeeProgram, getPumpProgram, getSellSolAmountFromTokenAmount, getSolVaultPda, getTokenVaultPda, hasCoinCreatorMigratedToSharingConfig, newBondingCurve, pump as pumpIdl, pumpPoolAuthorityPda, totalUnclaimedTokens, userVolumeAccumulatorPda };
+export { AMM_GLOBAL_PDA, AMM_GLOBAL_VOLUME_ACCUMULATOR_PDA, BONDING_CURVE_NEW_SIZE, type BondingCurve, CANONICAL_POOL_INDEX, type DistributeCreatorFeeResult, type DistributeCreatorFeesEvent, DuplicateShareholderError, type FeeConfig, GLOBAL_PDA, GLOBAL_VOLUME_ACCUMULATOR_PDA, type Global, type GlobalVolumeAccumulator, InvalidShareTotalError, MAYHEM_PROGRAM_ID, type MinimumDistributableFeeEvent, type MinimumDistributableFeeResult, NoShareholdersError, OnlinePumpSdk, PUMP_AMM_EVENT_AUTHORITY_PDA, PUMP_AMM_PROGRAM_ID, PUMP_EVENT_AUTHORITY_PDA, PUMP_FEE_CONFIG_PDA, PUMP_FEE_EVENT_AUTHORITY_PDA, PUMP_FEE_PROGRAM_ID, PUMP_PROGRAM_ID, PUMP_SDK, PoolRequiredForGraduatedError, type Pump, type PumpFees, PumpSdk, ShareCalculationOverflowError, type Shareholder, type SharingConfig, TooManyShareholdersError, type UserVolumeAccumulator, type UserVolumeAccumulatorTotalStats, ZeroShareError, ammCreatorVaultPda, bondingCurveMarketCap, bondingCurvePda, canonicalPumpPoolPda, creatorVaultPda, currentDayTokens, feeSharingConfigPda, getBuySolAmountFromTokenAmount, getBuyTokenAmountFromSolAmount, getEventAuthorityPda, getGlobalParamsPda, getMayhemStatePda, getPumpAmmProgram, getPumpFeeProgram, getPumpProgram, getSellSolAmountFromTokenAmount, getSolVaultPda, getTokenVaultPda, isCreatorUsingSharingConfig, newBondingCurve, pump as pumpIdl, pumpPoolAuthorityPda, totalUnclaimedTokens, userVolumeAccumulatorPda };

package/dist/index.d.ts

@@ -22704,13 +22704,13 @@ declare class PumpSdk {
 }
 declare const PUMP_SDK: PumpSdk;
 /**
- * Checks if a creator has migrated to using a fee sharing configuration.
+ * Checks if a creator has upgraded to using a fee sharing configuration.
  *
  * When a creator sets up fee sharing, the creator address in the BondingCurve or Pool
  * is replaced with the fee sharing config PDA address. This function checks if that
- * migration has occurred.
+ * upgrade has occurred.
  *
- * @param params - Parameters for checking migration status
+ * @param params - Parameters for checking upgrade status
  * @param params.mint - The mint address of the token
  * @param params.creator - The creator address to check
  *                         - For ungraduated coins: use BondingCurve.creator
@@ -22720,18 +22720,18 @@ declare const PUMP_SDK: PumpSdk;
  *
  * @example
  * ```typescript
- * import { hasCoinCreatorMigratedToSharingConfig } from "@pump-fun/sdk";
+ * import { isCreatorUsingSharingConfig } from "@pump-fun/sdk";
  *
  * // For an ungraduated coin
  * const bondingCurve = await program.account.bondingCurve.fetch(bondingCurvePda(mint));
- * const hasMigrated = hasCoinCreatorMigratedToSharingConfig({
+ * const hasMigrated = isCreatorUsingSharingConfig({
  *   mint,
  *   creator: bondingCurve.creator
  * });
  *
  * // For a graduated coin
  * const pool = await ammProgram.account.pool.fetch(poolAddress);
- * const hasMigrated = hasCoinCreatorMigratedToSharingConfig({
+ * const hasMigrated = isCreatorUsingSharingConfig({
  *   mint,
  *   creator: pool.coinCreator
  * });
@@ -22743,7 +22743,7 @@ declare const PUMP_SDK: PumpSdk;
  * }
  * ```
  */
-declare function hasCoinCreatorMigratedToSharingConfig({ mint, creator, }: {
+declare function isCreatorUsingSharingConfig({ mint, creator, }: {
     mint: PublicKey;
     creator: PublicKey;
 }): boolean;
@@ -22752,6 +22752,7 @@ declare class OnlinePumpSdk {
     private readonly connection;
     private readonly pumpProgram;
     private readonly offlinePumpProgram;
+    private readonly pumpAmmProgram;
     private readonly pumpAmmSdk;
     private readonly pumpAmmAdminSdk;
     constructor(connection: Connection);
@@ -22783,6 +22784,37 @@ declare class OnlinePumpSdk {
     getCurrentDayTokens(user: PublicKey): Promise<BN>;
     getCurrentDayTokensBothPrograms(user: PublicKey): Promise<BN>;
     syncUserVolumeAccumulatorBothPrograms(user: PublicKey): Promise<TransactionInstruction[]>;
+    /**
+     * Gets the minimum distributable fee for a token's fee sharing configuration.
+     *
+     * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+     * For graduated tokens, it automatically consolidates fees from the AMM vault before
+     * calculating the minimum distributable fee.
+     *
+     * @param mint - The mint address of the token
+     * @param simulationSigner - Optional signer address for transaction simulation.
+     *                           Must have a non-zero SOL balance. Defaults to a known funded address.
+     * @returns The minimum distributable fee information including whether distribution is possible
+     */
+    getMinimumDistributableFee(mint: PublicKey, simulationSigner?: PublicKey): Promise<MinimumDistributableFeeResult>;
+    /**
+     * Gets the instructions to distribute creator fees for a token's fee sharing configuration.
+     *
+     * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+     * For graduated tokens, it automatically includes an instruction to consolidate fees
+     * from the AMM vault before distributing.
+     *
+     * @param mint - The mint address of the token
+     * @returns The instructions to distribute creator fees and whether the token is graduated
+     */
+    buildDistributeCreatorFeesInstructions(mint: PublicKey): Promise<DistributeCreatorFeeResult>;
+}
+interface MinimumDistributableFeeResult extends MinimumDistributableFeeEvent {
+    isGraduated: boolean;
+}
+interface DistributeCreatorFeeResult {
+    instructions: TransactionInstruction[];
+    isGraduated: boolean;
 }
 
 declare function totalUnclaimedTokens(globalVolumeAccumulator: GlobalVolumeAccumulator, userVolumeAccumulator: UserVolumeAccumulator, currentTimestamp?: number): BN;
@@ -22817,4 +22849,4 @@ declare class PoolRequiredForGraduatedError extends Error {
     constructor();
 }
 
-export { AMM_GLOBAL_PDA, AMM_GLOBAL_VOLUME_ACCUMULATOR_PDA, BONDING_CURVE_NEW_SIZE, type BondingCurve, CANONICAL_POOL_INDEX, type DistributeCreatorFeesEvent, DuplicateShareholderError, type FeeConfig, GLOBAL_PDA, GLOBAL_VOLUME_ACCUMULATOR_PDA, type Global, type GlobalVolumeAccumulator, InvalidShareTotalError, MAYHEM_PROGRAM_ID, type MinimumDistributableFeeEvent, NoShareholdersError, OnlinePumpSdk, PUMP_AMM_EVENT_AUTHORITY_PDA, PUMP_AMM_PROGRAM_ID, PUMP_EVENT_AUTHORITY_PDA, PUMP_FEE_CONFIG_PDA, PUMP_FEE_EVENT_AUTHORITY_PDA, PUMP_FEE_PROGRAM_ID, PUMP_PROGRAM_ID, PUMP_SDK, PoolRequiredForGraduatedError, type Pump, type PumpFees, PumpSdk, ShareCalculationOverflowError, type Shareholder, type SharingConfig, TooManyShareholdersError, type UserVolumeAccumulator, type UserVolumeAccumulatorTotalStats, ZeroShareError, ammCreatorVaultPda, bondingCurveMarketCap, bondingCurvePda, canonicalPumpPoolPda, creatorVaultPda, currentDayTokens, feeSharingConfigPda, getBuySolAmountFromTokenAmount, getBuyTokenAmountFromSolAmount, getEventAuthorityPda, getGlobalParamsPda, getMayhemStatePda, getPumpAmmProgram, getPumpFeeProgram, getPumpProgram, getSellSolAmountFromTokenAmount, getSolVaultPda, getTokenVaultPda, hasCoinCreatorMigratedToSharingConfig, newBondingCurve, pump as pumpIdl, pumpPoolAuthorityPda, totalUnclaimedTokens, userVolumeAccumulatorPda };
+export { AMM_GLOBAL_PDA, AMM_GLOBAL_VOLUME_ACCUMULATOR_PDA, BONDING_CURVE_NEW_SIZE, type BondingCurve, CANONICAL_POOL_INDEX, type DistributeCreatorFeeResult, type DistributeCreatorFeesEvent, DuplicateShareholderError, type FeeConfig, GLOBAL_PDA, GLOBAL_VOLUME_ACCUMULATOR_PDA, type Global, type GlobalVolumeAccumulator, InvalidShareTotalError, MAYHEM_PROGRAM_ID, type MinimumDistributableFeeEvent, type MinimumDistributableFeeResult, NoShareholdersError, OnlinePumpSdk, PUMP_AMM_EVENT_AUTHORITY_PDA, PUMP_AMM_PROGRAM_ID, PUMP_EVENT_AUTHORITY_PDA, PUMP_FEE_CONFIG_PDA, PUMP_FEE_EVENT_AUTHORITY_PDA, PUMP_FEE_PROGRAM_ID, PUMP_PROGRAM_ID, PUMP_SDK, PoolRequiredForGraduatedError, type Pump, type PumpFees, PumpSdk, ShareCalculationOverflowError, type Shareholder, type SharingConfig, TooManyShareholdersError, type UserVolumeAccumulator, type UserVolumeAccumulatorTotalStats, ZeroShareError, ammCreatorVaultPda, bondingCurveMarketCap, bondingCurvePda, canonicalPumpPoolPda, creatorVaultPda, currentDayTokens, feeSharingConfigPda, getBuySolAmountFromTokenAmount, getBuyTokenAmountFromSolAmount, getEventAuthorityPda, getGlobalParamsPda, getMayhemStatePda, getPumpAmmProgram, getPumpFeeProgram, getPumpProgram, getSellSolAmountFromTokenAmount, getSolVaultPda, getTokenVaultPda, isCreatorUsingSharingConfig, newBondingCurve, pump as pumpIdl, pumpPoolAuthorityPda, totalUnclaimedTokens, userVolumeAccumulatorPda };

package/dist/index.js

@@ -1852,7 +1852,7 @@ __export(index_exports, {
   getSellSolAmountFromTokenAmount: () => getSellSolAmountFromTokenAmount,
   getSolVaultPda: () => getSolVaultPda,
   getTokenVaultPda: () => getTokenVaultPda,
-  hasCoinCreatorMigratedToSharingConfig: () => hasCoinCreatorMigratedToSharingConfig,
+  isCreatorUsingSharingConfig: () => isCreatorUsingSharingConfig,
   newBondingCurve: () => newBondingCurve,
   pumpIdl: () => pump_default,
   pumpPoolAuthorityPda: () => pumpPoolAuthorityPda,
@@ -9078,6 +9078,7 @@ var OnlinePumpSdk = class {
     this.connection = connection;
     this.pumpProgram = getPumpProgram(connection);
     this.offlinePumpProgram = OFFLINE_PUMP_PROGRAM;
+    this.pumpAmmProgram = getPumpAmmProgram(connection);
     this.pumpAmmSdk = new import_pump_swap_sdk.OnlinePumpAmmSdk(connection);
     this.pumpAmmAdminSdk = new import_pump_swap_sdk.PumpAmmAdminSdk(connection);
   }
@@ -9342,6 +9343,127 @@ var OnlinePumpSdk = class {
       await import_pump_swap_sdk.PUMP_AMM_SDK.syncUserVolumeAccumulator(user)
     ];
   }
+  /**
+   * Gets the minimum distributable fee for a token's fee sharing configuration.
+   *
+   * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+   * For graduated tokens, it automatically consolidates fees from the AMM vault before
+   * calculating the minimum distributable fee.
+   *
+   * @param mint - The mint address of the token
+   * @param simulationSigner - Optional signer address for transaction simulation.
+   *                           Must have a non-zero SOL balance. Defaults to a known funded address.
+   * @returns The minimum distributable fee information including whether distribution is possible
+   */
+  async getMinimumDistributableFee(mint, simulationSigner = new import_web33.PublicKey("UqN2p5bAzBqYdHXcgB6WLtuVrdvmy9JSAtgqZb3CMKw")) {
+    const sharingConfigPubkey = feeSharingConfigPda(mint);
+    const poolAddress = canonicalPumpPoolPda(mint);
+    const coinCreatorVaultAuthority = (0, import_pump_swap_sdk.coinCreatorVaultAuthorityPda)(sharingConfigPubkey);
+    const ammVaultAta = (0, import_pump_swap_sdk.coinCreatorVaultAtaPda)(
+      coinCreatorVaultAuthority,
+      import_spl_token.NATIVE_MINT,
+      import_spl_token.TOKEN_PROGRAM_ID
+    );
+    const [sharingConfigAccountInfo, poolAccountInfo, ammVaultAtaInfo] = await this.connection.getMultipleAccountsInfo([
+      sharingConfigPubkey,
+      poolAddress,
+      ammVaultAta
+    ]);
+    if (!sharingConfigAccountInfo) {
+      throw new Error(`Sharing config not found for mint: ${mint.toBase58()}`);
+    }
+    const sharingConfig = PUMP_SDK.decodeSharingConfig(sharingConfigAccountInfo);
+    const instructions = [];
+    const isGraduated = poolAccountInfo !== null;
+    if (isGraduated && ammVaultAtaInfo) {
+      const transferCreatorFeesToPumpIx = await this.pumpAmmProgram.methods.transferCreatorFeesToPump().accountsPartial({
+        wsolMint: import_spl_token.NATIVE_MINT,
+        tokenProgram: import_spl_token.TOKEN_PROGRAM_ID,
+        coinCreator: sharingConfigPubkey
+      }).instruction();
+      instructions.push(transferCreatorFeesToPumpIx);
+    }
+    const getMinFeeIx = await PUMP_SDK.getMinimumDistributableFee({
+      mint,
+      sharingConfig,
+      sharingConfigAddress: sharingConfigPubkey
+    });
+    instructions.push(getMinFeeIx);
+    const { blockhash } = await this.connection.getLatestBlockhash();
+    const tx = new import_web33.VersionedTransaction(
+      new import_web33.TransactionMessage({
+        payerKey: simulationSigner,
+        recentBlockhash: blockhash,
+        instructions
+      }).compileToV0Message()
+    );
+    const result = await this.connection.simulateTransaction(tx);
+    let minimumDistributableFee = {
+      minimumRequired: new import_bn4.default(0),
+      distributableFees: new import_bn4.default(0),
+      canDistribute: false
+    };
+    if (!result.value.err) {
+      const [data, encoding] = result.value.returnData?.data ?? [];
+      if (data) {
+        const buffer = Buffer.from(data, encoding);
+        minimumDistributableFee = PUMP_SDK.decodeMinimumDistributableFee(buffer);
+      }
+    }
+    return {
+      ...minimumDistributableFee,
+      isGraduated
+    };
+  }
+  /**
+   * Gets the instructions to distribute creator fees for a token's fee sharing configuration.
+   *
+   * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+   * For graduated tokens, it automatically includes an instruction to consolidate fees
+   * from the AMM vault before distributing.
+   *
+   * @param mint - The mint address of the token
+   * @returns The instructions to distribute creator fees and whether the token is graduated
+   */
+  async buildDistributeCreatorFeesInstructions(mint) {
+    const sharingConfigPubkey = feeSharingConfigPda(mint);
+    const poolAddress = canonicalPumpPoolPda(mint);
+    const coinCreatorVaultAuthority = (0, import_pump_swap_sdk.coinCreatorVaultAuthorityPda)(sharingConfigPubkey);
+    const ammVaultAta = (0, import_pump_swap_sdk.coinCreatorVaultAtaPda)(
+      coinCreatorVaultAuthority,
+      import_spl_token.NATIVE_MINT,
+      import_spl_token.TOKEN_PROGRAM_ID
+    );
+    const [sharingConfigAccountInfo, poolAccountInfo, ammVaultAtaInfo] = await this.connection.getMultipleAccountsInfo([
+      sharingConfigPubkey,
+      poolAddress,
+      ammVaultAta
+    ]);
+    if (!sharingConfigAccountInfo) {
+      throw new Error(`Sharing config not found for mint: ${mint.toBase58()}`);
+    }
+    const sharingConfig = PUMP_SDK.decodeSharingConfig(sharingConfigAccountInfo);
+    const instructions = [];
+    const isGraduated = poolAccountInfo !== null;
+    if (isGraduated && ammVaultAtaInfo) {
+      const transferCreatorFeesToPumpIx = await this.pumpAmmProgram.methods.transferCreatorFeesToPump().accountsPartial({
+        wsolMint: import_spl_token.NATIVE_MINT,
+        tokenProgram: import_spl_token.TOKEN_PROGRAM_ID,
+        coinCreator: sharingConfigPubkey
+      }).instruction();
+      instructions.push(transferCreatorFeesToPumpIx);
+    }
+    const distributeCreatorFeesIx = await PUMP_SDK.distributeCreatorFees({
+      mint,
+      sharingConfig,
+      sharingConfigAddress: sharingConfigPubkey
+    });
+    instructions.push(distributeCreatorFeesIx);
+    return {
+      instructions,
+      isGraduated
+    };
+  }
 };
 
 // src/idl/pump_amm.json
@@ -18643,7 +18765,7 @@ var PumpSdk = class {
   }
 };
 var PUMP_SDK = new PumpSdk();
-function hasCoinCreatorMigratedToSharingConfig({
+function isCreatorUsingSharingConfig({
   mint,
   creator
 }) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pump-fun/pump-sdk",
-  "version": "1.27.0-devnet.1",
+  "version": "1.27.0-devnet.2",
   "description": "Pump Bonding Curve SDK",
   "keywords": [],
   "homepage": "https://github.com/pump-fun/pump-sdk#readme",

package/src/index.ts

@@ -20,9 +20,9 @@ export {
   BONDING_CURVE_NEW_SIZE,
   PumpSdk,
   PUMP_SDK,
-  hasCoinCreatorMigratedToSharingConfig,
+  isCreatorUsingSharingConfig,
 } from "./sdk";
-export { OnlinePumpSdk } from "./onlineSdk";
+export { OnlinePumpSdk, MinimumDistributableFeeResult, DistributeCreatorFeeResult } from "./onlineSdk";
 export {
   FeeConfig,
   Global,

package/src/onlineSdk.ts

@@ -17,13 +17,18 @@ import {
   PublicKey,
   PublicKeyInitData,
   TransactionInstruction,
+  TransactionMessage,
+  VersionedTransaction,
 } from "@solana/web3.js";
 import { Pump } from "./idl/pump";
+import { PumpAmm } from "./idl/pump_amm";
 import BN from "bn.js";
 
 import {
   bondingCurvePda,
+  canonicalPumpPoolPda,
   creatorVaultPda,
+  feeSharingConfigPda,
   GLOBAL_PDA,
   GLOBAL_VOLUME_ACCUMULATOR_PDA,
   PUMP_FEE_CONFIG_PDA,
@@ -34,11 +39,12 @@ import {
   FeeConfig,
   Global,
   GlobalVolumeAccumulator,
+  MinimumDistributableFeeEvent,
   UserVolumeAccumulator,
   UserVolumeAccumulatorTotalStats,
 } from "./state";
 import { currentDayTokens, totalUnclaimedTokens } from "./tokenIncentives";
-import { getPumpProgram, PUMP_SDK, PUMP_TOKEN_MINT } from "./sdk";
+import { getPumpAmmProgram, getPumpProgram, PUMP_SDK, PUMP_TOKEN_MINT } from "./sdk";
 
 export const OFFLINE_PUMP_PROGRAM = getPumpProgram(null as any as Connection);
 
@@ -46,6 +52,7 @@ export class OnlinePumpSdk {
   private readonly connection: Connection;
   private readonly pumpProgram: Program<Pump>;
   private readonly offlinePumpProgram: Program<Pump>;
+  private readonly pumpAmmProgram: Program<PumpAmm>;
   private readonly pumpAmmSdk: OnlinePumpAmmSdk;
   private readonly pumpAmmAdminSdk: PumpAmmAdminSdk;
 
@@ -54,6 +61,7 @@ export class OnlinePumpSdk {
 
     this.pumpProgram = getPumpProgram(connection);
     this.offlinePumpProgram = OFFLINE_PUMP_PROGRAM;
+    this.pumpAmmProgram = getPumpAmmProgram(connection);
 
     this.pumpAmmSdk = new OnlinePumpAmmSdk(connection);
     this.pumpAmmAdminSdk = new PumpAmmAdminSdk(connection);
@@ -426,4 +434,170 @@ export class OnlinePumpSdk {
       await PUMP_AMM_SDK.syncUserVolumeAccumulator(user),
     ];
   }
+
+  /**
+   * Gets the minimum distributable fee for a token's fee sharing configuration.
+   *
+   * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+   * For graduated tokens, it automatically consolidates fees from the AMM vault before
+   * calculating the minimum distributable fee.
+   *
+   * @param mint - The mint address of the token
+   * @param simulationSigner - Optional signer address for transaction simulation.
+   *                           Must have a non-zero SOL balance. Defaults to a known funded address.
+   * @returns The minimum distributable fee information including whether distribution is possible
+   */
+  async getMinimumDistributableFee(
+    mint: PublicKey,
+    simulationSigner: PublicKey = new PublicKey("UqN2p5bAzBqYdHXcgB6WLtuVrdvmy9JSAtgqZb3CMKw"),
+  ): Promise<MinimumDistributableFeeResult> {
+    const sharingConfigPubkey = feeSharingConfigPda(mint);
+    const poolAddress = canonicalPumpPoolPda(mint);
+    const coinCreatorVaultAuthority = coinCreatorVaultAuthorityPda(sharingConfigPubkey);
+    const ammVaultAta = coinCreatorVaultAtaPda(
+      coinCreatorVaultAuthority,
+      NATIVE_MINT,
+      TOKEN_PROGRAM_ID,
+    );
+
+    const [sharingConfigAccountInfo, poolAccountInfo, ammVaultAtaInfo] =
+      await this.connection.getMultipleAccountsInfo([
+        sharingConfigPubkey,
+        poolAddress,
+        ammVaultAta,
+      ]);
+
+    if (!sharingConfigAccountInfo) {
+      throw new Error(`Sharing config not found for mint: ${mint.toBase58()}`);
+    }
+
+    const sharingConfig = PUMP_SDK.decodeSharingConfig(sharingConfigAccountInfo);
+
+    const instructions: TransactionInstruction[] = [];
+
+    const isGraduated = poolAccountInfo !== null;
+    if (isGraduated && ammVaultAtaInfo) {
+      // Consolidate fees from AMM to bonding curve program for distribution
+      const transferCreatorFeesToPumpIx = await this.pumpAmmProgram.methods
+        .transferCreatorFeesToPump()
+        .accountsPartial({
+          wsolMint: NATIVE_MINT,
+          tokenProgram: TOKEN_PROGRAM_ID,
+          coinCreator: sharingConfigPubkey,
+        })
+        .instruction();
+      instructions.push(transferCreatorFeesToPumpIx);
+    }
+
+    const getMinFeeIx = await PUMP_SDK.getMinimumDistributableFee({
+      mint,
+      sharingConfig,
+      sharingConfigAddress: sharingConfigPubkey,
+    });
+    instructions.push(getMinFeeIx);
+
+    const { blockhash } = await this.connection.getLatestBlockhash();
+
+    const tx = new VersionedTransaction(
+      new TransactionMessage({
+        payerKey: simulationSigner,
+        recentBlockhash: blockhash,
+        instructions,
+      }).compileToV0Message(),
+    );
+
+    const result = await this.connection.simulateTransaction(tx);
+
+    let minimumDistributableFee: MinimumDistributableFeeEvent = {
+      minimumRequired: new BN(0),
+      distributableFees: new BN(0),
+      canDistribute: false,
+    };
+
+    if (!result.value.err) {
+      const [data, encoding] = result.value.returnData?.data ?? [];
+      if (data) {
+        const buffer = Buffer.from(data, encoding as BufferEncoding);
+        minimumDistributableFee = PUMP_SDK.decodeMinimumDistributableFee(buffer);
+      }
+    }
+
+    return {
+      ...minimumDistributableFee,
+      isGraduated,
+    };
+  }
+
+  /**
+   * Gets the instructions to distribute creator fees for a token's fee sharing configuration.
+   *
+   * This method handles both graduated (AMM) and non-graduated (bonding curve) tokens.
+   * For graduated tokens, it automatically includes an instruction to consolidate fees
+   * from the AMM vault before distributing.
+   *
+   * @param mint - The mint address of the token
+   * @returns The instructions to distribute creator fees and whether the token is graduated
+   */
+  async buildDistributeCreatorFeesInstructions(
+    mint: PublicKey,
+  ): Promise<DistributeCreatorFeeResult> {
+    const sharingConfigPubkey = feeSharingConfigPda(mint);
+    const poolAddress = canonicalPumpPoolPda(mint);
+    const coinCreatorVaultAuthority = coinCreatorVaultAuthorityPda(sharingConfigPubkey);
+    const ammVaultAta = coinCreatorVaultAtaPda(
+      coinCreatorVaultAuthority,
+      NATIVE_MINT,
+      TOKEN_PROGRAM_ID,
+    );
+
+    const [sharingConfigAccountInfo, poolAccountInfo, ammVaultAtaInfo] =
+      await this.connection.getMultipleAccountsInfo([
+        sharingConfigPubkey,
+        poolAddress,
+        ammVaultAta,
+      ]);
+
+    if (!sharingConfigAccountInfo) {
+      throw new Error(`Sharing config not found for mint: ${mint.toBase58()}`);
+    }
+
+    const sharingConfig = PUMP_SDK.decodeSharingConfig(sharingConfigAccountInfo);
+
+    const instructions: TransactionInstruction[] = [];
+
+    const isGraduated = poolAccountInfo !== null;
+    if (isGraduated && ammVaultAtaInfo) {
+      // Consolidate fees from AMM to bonding curve program for distribution
+      const transferCreatorFeesToPumpIx = await this.pumpAmmProgram.methods
+        .transferCreatorFeesToPump()
+        .accountsPartial({
+          wsolMint: NATIVE_MINT,
+          tokenProgram: TOKEN_PROGRAM_ID,
+          coinCreator: sharingConfigPubkey,
+        })
+        .instruction();
+      instructions.push(transferCreatorFeesToPumpIx);
+    }
+
+    const distributeCreatorFeesIx = await PUMP_SDK.distributeCreatorFees({
+      mint,
+      sharingConfig,
+      sharingConfigAddress: sharingConfigPubkey,
+    });
+    instructions.push(distributeCreatorFeesIx);
+
+    return {
+      instructions,
+      isGraduated,
+    };
+  }
+}
+
+export interface MinimumDistributableFeeResult extends MinimumDistributableFeeEvent {
+  isGraduated: boolean;
+}
+
+export interface DistributeCreatorFeeResult {
+  instructions: TransactionInstruction[];
+  isGraduated: boolean;
 }

package/src/sdk.ts

@@ -964,13 +964,13 @@ export class PumpSdk {
 export const PUMP_SDK = new PumpSdk();
 
 /**
- * Checks if a creator has migrated to using a fee sharing configuration.
+ * Checks if a creator has upgraded to using a fee sharing configuration.
  *
  * When a creator sets up fee sharing, the creator address in the BondingCurve or Pool
  * is replaced with the fee sharing config PDA address. This function checks if that
- * migration has occurred.
+ * upgrade has occurred.
  *
- * @param params - Parameters for checking migration status
+ * @param params - Parameters for checking upgrade status
  * @param params.mint - The mint address of the token
  * @param params.creator - The creator address to check
  *                         - For ungraduated coins: use BondingCurve.creator
@@ -980,18 +980,18 @@ export const PUMP_SDK = new PumpSdk();
  *
  * @example
  * ```typescript
- * import { hasCoinCreatorMigratedToSharingConfig } from "@pump-fun/sdk";
+ * import { isCreatorUsingSharingConfig } from "@pump-fun/sdk";
  *
  * // For an ungraduated coin
  * const bondingCurve = await program.account.bondingCurve.fetch(bondingCurvePda(mint));
- * const hasMigrated = hasCoinCreatorMigratedToSharingConfig({
+ * const hasMigrated = isCreatorUsingSharingConfig({
  *   mint,
  *   creator: bondingCurve.creator
  * });
  *
  * // For a graduated coin
  * const pool = await ammProgram.account.pool.fetch(poolAddress);
- * const hasMigrated = hasCoinCreatorMigratedToSharingConfig({
+ * const hasMigrated = isCreatorUsingSharingConfig({
  *   mint,
  *   creator: pool.coinCreator
  * });
@@ -1003,7 +1003,7 @@ export const PUMP_SDK = new PumpSdk();
  * }
  * ```
  */
-export function hasCoinCreatorMigratedToSharingConfig({
+export function isCreatorUsingSharingConfig({
   mint,
   creator,
 }: {