@pump-fun/pump-sdk 1.29.0 → 1.30.0

package/README.md

@@ -163,3 +163,48 @@ 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.
+
+## GitHub Recipient and Social Fee PDA Requirements
+
+If you are adding a **GitHub recipient** as a fee recipient in sharing config, make sure to initialize the social fee pda before adding it as a recipient. Use one of these methods:
+
+```ts
+import {
+  Platform,
+  PUMP_SDK,
+} from "@pump-fun/pump-sdk";
+
+// 1) Update an existing sharing config
+await PUMP_SDK.updateSharingConfigWithSocialRecipients({
+  authority,
+  mint,
+  currentShareholders,
+  newShareholders: [
+    { address: authority, shareBps: 7000 },
+    { userId: "1234567", platform: Platform.GitHub, shareBps: 3000 },
+  ],
+});
+
+// 2) Create sharing config + set social recipients in one flow
+//    - Use pool for graduated coins or null for ungraduated
+await PUMP_SDK.createSharingConfigWithSocialRecipients({
+  creator,
+  mint,
+  pool,
+  newShareholders: [
+    { address: creator, shareBps: 7000 },
+    { userId: "1234567", platform: Platform.GitHub, shareBps: 3000 },
+  ],
+});
+```
+
+Method selection:
+- `updateSharingConfigWithSocialRecipients`: use when sharing config already exists.
+- `createSharingConfigWithSocialRecipients`: use for first-time setup (creates config, then updates shares).
+
+✅ Checklist
+
+- [ ] The GitHub user must be able to log in to claim fees. **GitHub organizations are not supported** for social fee recipients; adding an organization account can result in fees being permanently lost.
+- [ ] Only `Platform.GitHub` is supported. Any attempt to use a different platform value can result in the coin being banned or **fees lost**.
+- [ ] Fees in a GitHub vault can only be claimed by the linked GitHub user, and only through Pump.fun (web or mobile). You are responsible for directing users to claim there; we do not support any claim flow outside our apps.
+- [ ] You have initialized the social fee recipient pda by using one of the above helper or `createSocialFeePda`

package/dist/esm/index.js

@@ -19910,6 +19910,35 @@ var OnlinePumpSdk = class {
   }
 };
 
+// src/state.ts
+var Platform = /* @__PURE__ */ ((Platform3) => {
+  Platform3[Platform3["Pump"] = 0] = "Pump";
+  Platform3[Platform3["X"] = 1] = "X";
+  Platform3[Platform3["GitHub"] = 2] = "GitHub";
+  return Platform3;
+})(Platform || {});
+var SUPPORTED_SOCIAL_PLATFORMS = [2 /* GitHub */];
+var stringToPlatform = (value) => {
+  const normalized = value.trim().toUpperCase();
+  const entry = Object.entries(Platform).find(
+    ([key, val]) => typeof val === "number" && key.toUpperCase() === normalized
+  );
+  if (entry) {
+    return entry[1];
+  }
+  const validNames = Object.entries(Platform).filter(([, val]) => typeof val === "number").map(([key]) => key.toUpperCase()).join(", ");
+  throw new Error(
+    `Unknown platform "${value}". Expected one of: ${validNames}`
+  );
+};
+var platformToString = (platform) => {
+  const name = Platform[platform];
+  if (name !== void 0) {
+    return name;
+  }
+  throw new Error(`Unknown platform value: ${platform}`);
+};
+
 // src/sdk.ts
 function getPumpProgram(connection) {
   return new Program(
@@ -20455,9 +20484,9 @@ var PumpSdk = class {
    * Creates a fee sharing configuration for a token.
    *
    * @param params - Parameters for creating a fee sharing configuration
-   * @param params.creator - The creator of the token
+   * @param params.creator - The creator of the token. Must sign the transaction.
    * @param params.mint - The mint address of the token
-   * @param params.pool - The pool address of the token (null for ungraduated coins)
+   * @param params.pool - The pool address of the token. Must be provided for graduated coins; use `null` for ungraduated coins.
    */
   async createFeeSharingConfig({
     creator,
@@ -20608,6 +20637,154 @@ var PumpSdk = class {
       user
     }).instruction();
   }
+  /**
+  * Creates a social fee PDA that can accumulate fees for a social media user.
+  *
+  * @param params.payer - Any signer account that pays for the transaction.
+  * @param params.userId - Must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+  * The target must be a real user account with a login. E.g: Organizations are not supported.
+  * @param params.platform - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss.
+  * In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+  */
+  async createSocialFeePda({
+    payer,
+    userId,
+    platform
+  }) {
+    if (!SUPPORTED_SOCIAL_PLATFORMS.includes(platform)) {
+      const supportedPlatformNames = SUPPORTED_SOCIAL_PLATFORMS.map(
+        (supportedPlatform) => platformToString(supportedPlatform)
+      ).join(", ");
+      throw new Error(
+        `Unsupported platform "${platform}" for userId "${userId}". Supported platforms: ${supportedPlatformNames}.`
+      );
+    }
+    return await this.offlinePumpFeeProgram.methods.createSocialFeePda(userId, platform).accountsPartial({
+      payer,
+      socialFeePda: socialFeePda(userId, platform)
+    }).instruction();
+  }
+  normalizeSocialShareholders({
+    newShareholders
+  }) {
+    const socialRecipientsToCreate = /* @__PURE__ */ new Map();
+    const normalizedShareholders = newShareholders.map(
+      (shareholder) => {
+        if (shareholder.address) {
+          return {
+            address: shareholder.address,
+            shareBps: shareholder.shareBps
+          };
+        }
+        if (typeof shareholder.userId === "string" && typeof shareholder.platform === "number") {
+          if (!SUPPORTED_SOCIAL_PLATFORMS.includes(shareholder.platform)) {
+            const supportedPlatformNames = SUPPORTED_SOCIAL_PLATFORMS.map(
+              (platform) => platformToString(platform)
+            ).join(", ");
+            throw new Error(
+              `Unsupported platform "${shareholder.platform}" for userId "${shareholder.userId}". Supported platforms: ${supportedPlatformNames}.`
+            );
+          }
+          const recipientPda = socialFeePda(shareholder.userId, shareholder.platform);
+          socialRecipientsToCreate.set(recipientPda.toBase58(), {
+            userId: shareholder.userId,
+            platform: shareholder.platform
+          });
+          return {
+            address: recipientPda,
+            shareBps: shareholder.shareBps
+          };
+        }
+        throw new Error(
+          "Each new shareholder must provide either an address or both userId and platform."
+        );
+      }
+    );
+    return {
+      normalizedShareholders,
+      socialRecipientsToCreate
+    };
+  }
+  /**
+   * Wrapper around `updateSharingConfig` that resolves social recipients and
+   * initializes any missing social recipient PDAs before updating fee shares.
+   *
+   * Requirements:
+   * - `authority` must sign the transaction.
+   *
+   * Warning:
+   * - sharing config must exist for that mint
+   * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+   *   The target must be a real user account with a login. E.g: Organizations are not supported.
+   * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+   */
+  async updateSharingConfigWithSocialRecipients({
+    authority,
+    mint,
+    currentShareholders,
+    newShareholders
+  }) {
+    const instructions = [];
+    const { normalizedShareholders, socialRecipientsToCreate } = this.normalizeSocialShareholders({ newShareholders });
+    for (const recipient of socialRecipientsToCreate.values()) {
+      instructions.push(
+        await this.createSocialFeePda({
+          payer: authority,
+          userId: recipient.userId,
+          platform: recipient.platform
+        })
+      );
+    }
+    instructions.push(
+      await this.updateFeeShares({
+        authority,
+        mint,
+        currentShareholders,
+        newShareholders: normalizedShareholders
+      })
+    );
+    return instructions;
+  }
+  /**
+   * Wrapper around `createFeeSharingConfig` that resolves social recipients and
+   * initializes any missing social recipient PDAs before updating fee shares.
+   *
+   * Requirements:
+   * - `creator` must sign the transaction.
+   * - `pool` must be provided for graduated coins; use `null` for ungraduated coins.
+   *
+   * Warning:
+   * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+   *   The target must be a real user account with a login. E.g: Organizations are not supported.
+   * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+   */
+  async createSharingConfigWithSocialRecipients({
+    creator,
+    mint,
+    pool,
+    newShareholders
+  }) {
+    const instructions = [];
+    instructions.push(
+      await this.createFeeSharingConfig({
+        creator,
+        mint,
+        pool
+      })
+    );
+    instructions.push(
+      ...await this.updateSharingConfigWithSocialRecipients({
+        authority: creator,
+        mint,
+        currentShareholders: [creator],
+        newShareholders
+      })
+    );
+    return instructions;
+  }
+  claimSocialFeePda() {
+    throw new Error("This function can only be called by pump and is not supported");
+  }
 };
 var PUMP_SDK = new PumpSdk();
 function isCreatorUsingSharingConfig({
@@ -20704,6 +20881,13 @@ var ammCreatorVaultPda = (creator) => {
     PUMP_AMM_PROGRAM_ID
   )[0];
 };
+var socialFeePda = (userId, platform) => {
+  return pumpFeePda([
+    import_buffer.Buffer.from("social-fee-pda"),
+    import_buffer.Buffer.from(userId),
+    import_buffer.Buffer.from([platform])
+  ]);
+};
 export {
   AMM_GLOBAL_PDA,
   AMM_GLOBAL_VOLUME_ACCUMULATOR_PDA,
@@ -20724,8 +20908,10 @@ export {
   PUMP_FEE_PROGRAM_ID,
   PUMP_PROGRAM_ID,
   PUMP_SDK,
+  Platform,
   PoolRequiredForGraduatedError,
   PumpSdk,
+  SUPPORTED_SOCIAL_PLATFORMS,
   ShareCalculationOverflowError,
   TooManyShareholdersError,
   ZeroShareError,
@@ -20750,8 +20936,11 @@ export {
   getTokenVaultPda,
   isCreatorUsingSharingConfig,
   newBondingCurve,
+  platformToString,
   pump_default as pumpIdl,
   pumpPoolAuthorityPda,
+  socialFeePda,
+  stringToPlatform,
   totalUnclaimedTokens,
   userVolumeAccumulatorPda
 };

package/dist/index.d.mts

@@ -16814,6 +16814,17 @@ interface PumpFees {
     ];
 }
 
+/**
+ * Platform identifiers for social handle mappings.
+ */
+declare enum Platform {
+    Pump = 0,
+    X = 1,
+    GitHub = 2
+}
+declare const SUPPORTED_SOCIAL_PLATFORMS: Platform[];
+declare const stringToPlatform: (value: string) => Platform;
+declare const platformToString: (platform: Platform) => string;
 interface Global {
     initialized: boolean;
     authority: PublicKey;
@@ -16956,6 +16967,7 @@ declare const getSolVaultPda: () => PublicKey;
 declare const getTokenVaultPda: (mintPubkey: PublicKey) => PublicKey;
 declare const feeSharingConfigPda: (mint: PublicKey) => PublicKey;
 declare const ammCreatorVaultPda: (creator: PublicKey) => PublicKey;
+declare const socialFeePda: (userId: string, platform: number) => PublicKey;
 
 /**
  * Program IDL in camelCase format in order to be used in JS/TS.
@@ -22728,9 +22740,9 @@ declare class PumpSdk {
      * Creates a fee sharing configuration for a token.
      *
      * @param params - Parameters for creating a fee sharing configuration
-     * @param params.creator - The creator of the token
+     * @param params.creator - The creator of the token. Must sign the transaction.
      * @param params.mint - The mint address of the token
-     * @param params.pool - The pool address of the token (null for ungraduated coins)
+     * @param params.pool - The pool address of the token. Must be provided for graduated coins; use `null` for ungraduated coins.
      */
     createFeeSharingConfig({ creator, mint, pool, }: {
         creator: PublicKey;
@@ -22792,6 +22804,83 @@ declare class PumpSdk {
     claimCashbackInstruction({ user, }: {
         user: PublicKey;
     }): Promise<TransactionInstruction>;
+    /**
+    * Creates a social fee PDA that can accumulate fees for a social media user.
+    *
+    * @param params.payer - Any signer account that pays for the transaction.
+    * @param params.userId - Must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+    * The target must be a real user account with a login. E.g: Organizations are not supported.
+    * @param params.platform - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss.
+    * In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+    */
+    createSocialFeePda({ payer, userId, platform, }: {
+        payer: PublicKey;
+        userId: string;
+        platform: Platform;
+    }): Promise<TransactionInstruction>;
+    normalizeSocialShareholders({ newShareholders, }: {
+        newShareholders: Array<{
+            shareBps: number;
+            address?: PublicKey;
+            userId?: string;
+            platform?: Platform;
+        }>;
+    }): {
+        normalizedShareholders: Shareholder[];
+        socialRecipientsToCreate: Map<string, {
+            userId: string;
+            platform: Platform;
+        }>;
+    };
+    /**
+     * Wrapper around `updateSharingConfig` that resolves social recipients and
+     * initializes any missing social recipient PDAs before updating fee shares.
+     *
+     * Requirements:
+     * - `authority` must sign the transaction.
+     *
+     * Warning:
+     * - sharing config must exist for that mint
+     * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+     *   The target must be a real user account with a login. E.g: Organizations are not supported.
+     * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+     */
+    updateSharingConfigWithSocialRecipients({ authority, mint, currentShareholders, newShareholders, }: {
+        authority: PublicKey;
+        mint: PublicKey;
+        currentShareholders: PublicKey[];
+        newShareholders: Array<{
+            shareBps: number;
+            address?: PublicKey;
+            userId?: string;
+            platform?: Platform;
+        }>;
+    }): Promise<TransactionInstruction[]>;
+    /**
+     * Wrapper around `createFeeSharingConfig` that resolves social recipients and
+     * initializes any missing social recipient PDAs before updating fee shares.
+     *
+     * Requirements:
+     * - `creator` must sign the transaction.
+     * - `pool` must be provided for graduated coins; use `null` for ungraduated coins.
+     *
+     * Warning:
+     * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+     *   The target must be a real user account with a login. E.g: Organizations are not supported.
+     * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+     */
+    createSharingConfigWithSocialRecipients({ creator, mint, pool, newShareholders, }: {
+        creator: PublicKey;
+        mint: PublicKey;
+        pool: PublicKey | null;
+        newShareholders: Array<{
+            shareBps: number;
+            address?: PublicKey;
+            userId?: string;
+            platform?: Platform;
+        }>;
+    }): Promise<TransactionInstruction[]>;
+    claimSocialFeePda(): void;
 }
 declare const PUMP_SDK: PumpSdk;
 /**
@@ -22938,4 +23027,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 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, bondingCurveV2Pda, canonicalPumpPoolPda, creatorVaultPda, currentDayTokens, feeSharingConfigPda, getBuySolAmountFromTokenAmount, getBuyTokenAmountFromSolAmount, getEventAuthorityPda, getGlobalParamsPda, getMayhemStatePda, getPumpAmmProgram, getPumpFeeProgram, getPumpProgram, getSellSolAmountFromTokenAmount, getSolVaultPda, getTokenVaultPda, isCreatorUsingSharingConfig, 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, Platform, PoolRequiredForGraduatedError, type Pump, type PumpFees, PumpSdk, SUPPORTED_SOCIAL_PLATFORMS, ShareCalculationOverflowError, type Shareholder, type SharingConfig, TooManyShareholdersError, type UserVolumeAccumulator, type UserVolumeAccumulatorTotalStats, ZeroShareError, ammCreatorVaultPda, bondingCurveMarketCap, bondingCurvePda, bondingCurveV2Pda, canonicalPumpPoolPda, creatorVaultPda, currentDayTokens, feeSharingConfigPda, getBuySolAmountFromTokenAmount, getBuyTokenAmountFromSolAmount, getEventAuthorityPda, getGlobalParamsPda, getMayhemStatePda, getPumpAmmProgram, getPumpFeeProgram, getPumpProgram, getSellSolAmountFromTokenAmount, getSolVaultPda, getTokenVaultPda, isCreatorUsingSharingConfig, newBondingCurve, platformToString, pump as pumpIdl, pumpPoolAuthorityPda, socialFeePda, stringToPlatform, totalUnclaimedTokens, userVolumeAccumulatorPda };

package/dist/index.d.ts

@@ -16814,6 +16814,17 @@ interface PumpFees {
     ];
 }
 
+/**
+ * Platform identifiers for social handle mappings.
+ */
+declare enum Platform {
+    Pump = 0,
+    X = 1,
+    GitHub = 2
+}
+declare const SUPPORTED_SOCIAL_PLATFORMS: Platform[];
+declare const stringToPlatform: (value: string) => Platform;
+declare const platformToString: (platform: Platform) => string;
 interface Global {
     initialized: boolean;
     authority: PublicKey;
@@ -16956,6 +16967,7 @@ declare const getSolVaultPda: () => PublicKey;
 declare const getTokenVaultPda: (mintPubkey: PublicKey) => PublicKey;
 declare const feeSharingConfigPda: (mint: PublicKey) => PublicKey;
 declare const ammCreatorVaultPda: (creator: PublicKey) => PublicKey;
+declare const socialFeePda: (userId: string, platform: number) => PublicKey;
 
 /**
  * Program IDL in camelCase format in order to be used in JS/TS.
@@ -22728,9 +22740,9 @@ declare class PumpSdk {
      * Creates a fee sharing configuration for a token.
      *
      * @param params - Parameters for creating a fee sharing configuration
-     * @param params.creator - The creator of the token
+     * @param params.creator - The creator of the token. Must sign the transaction.
      * @param params.mint - The mint address of the token
-     * @param params.pool - The pool address of the token (null for ungraduated coins)
+     * @param params.pool - The pool address of the token. Must be provided for graduated coins; use `null` for ungraduated coins.
      */
     createFeeSharingConfig({ creator, mint, pool, }: {
         creator: PublicKey;
@@ -22792,6 +22804,83 @@ declare class PumpSdk {
     claimCashbackInstruction({ user, }: {
         user: PublicKey;
     }): Promise<TransactionInstruction>;
+    /**
+    * Creates a social fee PDA that can accumulate fees for a social media user.
+    *
+    * @param params.payer - Any signer account that pays for the transaction.
+    * @param params.userId - Must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+    * The target must be a real user account with a login. E.g: Organizations are not supported.
+    * @param params.platform - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss.
+    * In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+    */
+    createSocialFeePda({ payer, userId, platform, }: {
+        payer: PublicKey;
+        userId: string;
+        platform: Platform;
+    }): Promise<TransactionInstruction>;
+    normalizeSocialShareholders({ newShareholders, }: {
+        newShareholders: Array<{
+            shareBps: number;
+            address?: PublicKey;
+            userId?: string;
+            platform?: Platform;
+        }>;
+    }): {
+        normalizedShareholders: Shareholder[];
+        socialRecipientsToCreate: Map<string, {
+            userId: string;
+            platform: Platform;
+        }>;
+    };
+    /**
+     * Wrapper around `updateSharingConfig` that resolves social recipients and
+     * initializes any missing social recipient PDAs before updating fee shares.
+     *
+     * Requirements:
+     * - `authority` must sign the transaction.
+     *
+     * Warning:
+     * - sharing config must exist for that mint
+     * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+     *   The target must be a real user account with a login. E.g: Organizations are not supported.
+     * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+     */
+    updateSharingConfigWithSocialRecipients({ authority, mint, currentShareholders, newShareholders, }: {
+        authority: PublicKey;
+        mint: PublicKey;
+        currentShareholders: PublicKey[];
+        newShareholders: Array<{
+            shareBps: number;
+            address?: PublicKey;
+            userId?: string;
+            platform?: Platform;
+        }>;
+    }): Promise<TransactionInstruction[]>;
+    /**
+     * Wrapper around `createFeeSharingConfig` that resolves social recipients and
+     * initializes any missing social recipient PDAs before updating fee shares.
+     *
+     * Requirements:
+     * - `creator` must sign the transaction.
+     * - `pool` must be provided for graduated coins; use `null` for ungraduated coins.
+     *
+     * Warning:
+     * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+     *   The target must be a real user account with a login. E.g: Organizations are not supported.
+     * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+     */
+    createSharingConfigWithSocialRecipients({ creator, mint, pool, newShareholders, }: {
+        creator: PublicKey;
+        mint: PublicKey;
+        pool: PublicKey | null;
+        newShareholders: Array<{
+            shareBps: number;
+            address?: PublicKey;
+            userId?: string;
+            platform?: Platform;
+        }>;
+    }): Promise<TransactionInstruction[]>;
+    claimSocialFeePda(): void;
 }
 declare const PUMP_SDK: PumpSdk;
 /**
@@ -22938,4 +23027,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 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, bondingCurveV2Pda, canonicalPumpPoolPda, creatorVaultPda, currentDayTokens, feeSharingConfigPda, getBuySolAmountFromTokenAmount, getBuyTokenAmountFromSolAmount, getEventAuthorityPda, getGlobalParamsPda, getMayhemStatePda, getPumpAmmProgram, getPumpFeeProgram, getPumpProgram, getSellSolAmountFromTokenAmount, getSolVaultPda, getTokenVaultPda, isCreatorUsingSharingConfig, 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, Platform, PoolRequiredForGraduatedError, type Pump, type PumpFees, PumpSdk, SUPPORTED_SOCIAL_PLATFORMS, ShareCalculationOverflowError, type Shareholder, type SharingConfig, TooManyShareholdersError, type UserVolumeAccumulator, type UserVolumeAccumulatorTotalStats, ZeroShareError, ammCreatorVaultPda, bondingCurveMarketCap, bondingCurvePda, bondingCurveV2Pda, canonicalPumpPoolPda, creatorVaultPda, currentDayTokens, feeSharingConfigPda, getBuySolAmountFromTokenAmount, getBuyTokenAmountFromSolAmount, getEventAuthorityPda, getGlobalParamsPda, getMayhemStatePda, getPumpAmmProgram, getPumpFeeProgram, getPumpProgram, getSellSolAmountFromTokenAmount, getSolVaultPda, getTokenVaultPda, isCreatorUsingSharingConfig, newBondingCurve, platformToString, pump as pumpIdl, pumpPoolAuthorityPda, socialFeePda, stringToPlatform, totalUnclaimedTokens, userVolumeAccumulatorPda };

package/dist/index.js

@@ -1829,8 +1829,10 @@ __export(index_exports, {
   PUMP_FEE_PROGRAM_ID: () => PUMP_FEE_PROGRAM_ID,
   PUMP_PROGRAM_ID: () => PUMP_PROGRAM_ID,
   PUMP_SDK: () => PUMP_SDK,
+  Platform: () => Platform,
   PoolRequiredForGraduatedError: () => PoolRequiredForGraduatedError,
   PumpSdk: () => PumpSdk,
+  SUPPORTED_SOCIAL_PLATFORMS: () => SUPPORTED_SOCIAL_PLATFORMS,
   ShareCalculationOverflowError: () => ShareCalculationOverflowError,
   TooManyShareholdersError: () => TooManyShareholdersError,
   ZeroShareError: () => ZeroShareError,
@@ -1855,8 +1857,11 @@ __export(index_exports, {
   getTokenVaultPda: () => getTokenVaultPda,
   isCreatorUsingSharingConfig: () => isCreatorUsingSharingConfig,
   newBondingCurve: () => newBondingCurve,
+  platformToString: () => platformToString,
   pumpIdl: () => pump_default,
   pumpPoolAuthorityPda: () => pumpPoolAuthorityPda,
+  socialFeePda: () => socialFeePda,
+  stringToPlatform: () => stringToPlatform,
   totalUnclaimedTokens: () => totalUnclaimedTokens,
   userVolumeAccumulatorPda: () => userVolumeAccumulatorPda
 });
@@ -19936,6 +19941,35 @@ var OnlinePumpSdk = class {
   }
 };
 
+// src/state.ts
+var Platform = /* @__PURE__ */ ((Platform3) => {
+  Platform3[Platform3["Pump"] = 0] = "Pump";
+  Platform3[Platform3["X"] = 1] = "X";
+  Platform3[Platform3["GitHub"] = 2] = "GitHub";
+  return Platform3;
+})(Platform || {});
+var SUPPORTED_SOCIAL_PLATFORMS = [2 /* GitHub */];
+var stringToPlatform = (value) => {
+  const normalized = value.trim().toUpperCase();
+  const entry = Object.entries(Platform).find(
+    ([key, val]) => typeof val === "number" && key.toUpperCase() === normalized
+  );
+  if (entry) {
+    return entry[1];
+  }
+  const validNames = Object.entries(Platform).filter(([, val]) => typeof val === "number").map(([key]) => key.toUpperCase()).join(", ");
+  throw new Error(
+    `Unknown platform "${value}". Expected one of: ${validNames}`
+  );
+};
+var platformToString = (platform) => {
+  const name = Platform[platform];
+  if (name !== void 0) {
+    return name;
+  }
+  throw new Error(`Unknown platform value: ${platform}`);
+};
+
 // src/sdk.ts
 function getPumpProgram(connection) {
   return new import_anchor.Program(
@@ -20481,9 +20515,9 @@ var PumpSdk = class {
    * Creates a fee sharing configuration for a token.
    *
    * @param params - Parameters for creating a fee sharing configuration
-   * @param params.creator - The creator of the token
+   * @param params.creator - The creator of the token. Must sign the transaction.
    * @param params.mint - The mint address of the token
-   * @param params.pool - The pool address of the token (null for ungraduated coins)
+   * @param params.pool - The pool address of the token. Must be provided for graduated coins; use `null` for ungraduated coins.
    */
   async createFeeSharingConfig({
     creator,
@@ -20634,6 +20668,154 @@ var PumpSdk = class {
       user
     }).instruction();
   }
+  /**
+  * Creates a social fee PDA that can accumulate fees for a social media user.
+  *
+  * @param params.payer - Any signer account that pays for the transaction.
+  * @param params.userId - Must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+  * The target must be a real user account with a login. E.g: Organizations are not supported.
+  * @param params.platform - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss.
+  * In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+  */
+  async createSocialFeePda({
+    payer,
+    userId,
+    platform
+  }) {
+    if (!SUPPORTED_SOCIAL_PLATFORMS.includes(platform)) {
+      const supportedPlatformNames = SUPPORTED_SOCIAL_PLATFORMS.map(
+        (supportedPlatform) => platformToString(supportedPlatform)
+      ).join(", ");
+      throw new Error(
+        `Unsupported platform "${platform}" for userId "${userId}". Supported platforms: ${supportedPlatformNames}.`
+      );
+    }
+    return await this.offlinePumpFeeProgram.methods.createSocialFeePda(userId, platform).accountsPartial({
+      payer,
+      socialFeePda: socialFeePda(userId, platform)
+    }).instruction();
+  }
+  normalizeSocialShareholders({
+    newShareholders
+  }) {
+    const socialRecipientsToCreate = /* @__PURE__ */ new Map();
+    const normalizedShareholders = newShareholders.map(
+      (shareholder) => {
+        if (shareholder.address) {
+          return {
+            address: shareholder.address,
+            shareBps: shareholder.shareBps
+          };
+        }
+        if (typeof shareholder.userId === "string" && typeof shareholder.platform === "number") {
+          if (!SUPPORTED_SOCIAL_PLATFORMS.includes(shareholder.platform)) {
+            const supportedPlatformNames = SUPPORTED_SOCIAL_PLATFORMS.map(
+              (platform) => platformToString(platform)
+            ).join(", ");
+            throw new Error(
+              `Unsupported platform "${shareholder.platform}" for userId "${shareholder.userId}". Supported platforms: ${supportedPlatformNames}.`
+            );
+          }
+          const recipientPda = socialFeePda(shareholder.userId, shareholder.platform);
+          socialRecipientsToCreate.set(recipientPda.toBase58(), {
+            userId: shareholder.userId,
+            platform: shareholder.platform
+          });
+          return {
+            address: recipientPda,
+            shareBps: shareholder.shareBps
+          };
+        }
+        throw new Error(
+          "Each new shareholder must provide either an address or both userId and platform."
+        );
+      }
+    );
+    return {
+      normalizedShareholders,
+      socialRecipientsToCreate
+    };
+  }
+  /**
+   * Wrapper around `updateSharingConfig` that resolves social recipients and
+   * initializes any missing social recipient PDAs before updating fee shares.
+   *
+   * Requirements:
+   * - `authority` must sign the transaction.
+   *
+   * Warning:
+   * - sharing config must exist for that mint
+   * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+   *   The target must be a real user account with a login. E.g: Organizations are not supported.
+   * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+   */
+  async updateSharingConfigWithSocialRecipients({
+    authority,
+    mint,
+    currentShareholders,
+    newShareholders
+  }) {
+    const instructions = [];
+    const { normalizedShareholders, socialRecipientsToCreate } = this.normalizeSocialShareholders({ newShareholders });
+    for (const recipient of socialRecipientsToCreate.values()) {
+      instructions.push(
+        await this.createSocialFeePda({
+          payer: authority,
+          userId: recipient.userId,
+          platform: recipient.platform
+        })
+      );
+    }
+    instructions.push(
+      await this.updateFeeShares({
+        authority,
+        mint,
+        currentShareholders,
+        newShareholders: normalizedShareholders
+      })
+    );
+    return instructions;
+  }
+  /**
+   * Wrapper around `createFeeSharingConfig` that resolves social recipients and
+   * initializes any missing social recipient PDAs before updating fee shares.
+   *
+   * Requirements:
+   * - `creator` must sign the transaction.
+   * - `pool` must be provided for graduated coins; use `null` for ungraduated coins.
+   *
+   * Warning:
+   * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+   *   The target must be a real user account with a login. E.g: Organizations are not supported.
+   * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+   */
+  async createSharingConfigWithSocialRecipients({
+    creator,
+    mint,
+    pool,
+    newShareholders
+  }) {
+    const instructions = [];
+    instructions.push(
+      await this.createFeeSharingConfig({
+        creator,
+        mint,
+        pool
+      })
+    );
+    instructions.push(
+      ...await this.updateSharingConfigWithSocialRecipients({
+        authority: creator,
+        mint,
+        currentShareholders: [creator],
+        newShareholders
+      })
+    );
+    return instructions;
+  }
+  claimSocialFeePda() {
+    throw new Error("This function can only be called by pump and is not supported");
+  }
 };
 var PUMP_SDK = new PumpSdk();
 function isCreatorUsingSharingConfig({
@@ -20730,6 +20912,13 @@ var ammCreatorVaultPda = (creator) => {
     PUMP_AMM_PROGRAM_ID
   )[0];
 };
+var socialFeePda = (userId, platform) => {
+  return (0, import_pump_swap_sdk3.pumpFeePda)([
+    import_buffer.Buffer.from("social-fee-pda"),
+    import_buffer.Buffer.from(userId),
+    import_buffer.Buffer.from([platform])
+  ]);
+};
 /*! Bundled license information:
 
 ieee754/index.js:

package/package.json

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

package/src/index.ts

@@ -38,6 +38,10 @@ export {
   SharingConfig,
   DistributeCreatorFeesEvent,
   MinimumDistributableFeeEvent,
+  Platform,
+  SUPPORTED_SOCIAL_PLATFORMS,
+  platformToString,
+  stringToPlatform
 } from "./state";
 export { totalUnclaimedTokens, currentDayTokens } from "./tokenIncentives";
 export * from "./errors";

package/src/pda.ts

@@ -128,3 +128,11 @@ export const ammCreatorVaultPda = (creator: PublicKey): PublicKey => {
     PUMP_AMM_PROGRAM_ID,
   )[0];
 };
+
+export const socialFeePda = (userId: string, platform: number): PublicKey => {
+  return pumpFeePda([
+    Buffer.from("social-fee-pda"),
+    Buffer.from(userId),
+    Buffer.from([platform]),
+  ]);
+};

package/src/sdk.ts

@@ -46,6 +46,7 @@ import {
   feeSharingConfigPda,
   userVolumeAccumulatorPda,
   bondingCurveV2Pda,
+  socialFeePda,
 } from "./pda";
 import {
   BondingCurve,
@@ -57,6 +58,9 @@ import {
   SharingConfig,
   DistributeCreatorFeesEvent,
   MinimumDistributableFeeEvent,
+  Platform,
+  SUPPORTED_SOCIAL_PLATFORMS,
+  platformToString,
 } from "./state";
 
 export function getPumpProgram(connection: Connection): Program<Pump> {
@@ -824,9 +828,9 @@ export class PumpSdk {
    * Creates a fee sharing configuration for a token.
    *
    * @param params - Parameters for creating a fee sharing configuration
-   * @param params.creator - The creator of the token
+   * @param params.creator - The creator of the token. Must sign the transaction.
    * @param params.mint - The mint address of the token
-   * @param params.pool - The pool address of the token (null for ungraduated coins)
+   * @param params.pool - The pool address of the token. Must be provided for graduated coins; use `null` for ungraduated coins.
    */
   async createFeeSharingConfig({
     creator,
@@ -1029,8 +1033,218 @@ export class PumpSdk {
       })
       .instruction();
   }
+
+  /**
+  * Creates a social fee PDA that can accumulate fees for a social media user.
+  *
+  * @param params.payer - Any signer account that pays for the transaction.
+  * @param params.userId - Must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+  * The target must be a real user account with a login. E.g: Organizations are not supported.
+  * @param params.platform - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss.
+  * In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+  */
+  async createSocialFeePda({
+    payer,
+    userId,
+    platform,
+  }: {
+    payer: PublicKey;
+    userId: string;
+    platform: Platform;
+  }): Promise<TransactionInstruction> {
+    if (!SUPPORTED_SOCIAL_PLATFORMS.includes(platform)) {
+      const supportedPlatformNames = SUPPORTED_SOCIAL_PLATFORMS.map((supportedPlatform) =>
+        platformToString(supportedPlatform),
+      ).join(", ");
+      throw new Error(
+        `Unsupported platform "${platform}" for userId "${userId}". Supported platforms: ${supportedPlatformNames}.`,
+      );
+    }
+
+    return await this.offlinePumpFeeProgram.methods
+      .createSocialFeePda(userId, platform)
+      .accountsPartial({
+        payer,
+        socialFeePda: socialFeePda(userId, platform),
+      })
+      .instruction();
+  }
+
+  normalizeSocialShareholders({
+    newShareholders,
+  }: {
+    newShareholders: Array<{
+      shareBps: number;
+      address?: PublicKey;
+      userId?: string;
+      platform?: Platform;
+    }>;
+  }): {
+    normalizedShareholders: Shareholder[];
+    socialRecipientsToCreate: Map<string, { userId: string; platform: Platform }>;
+  } {
+    const socialRecipientsToCreate = new Map<
+      string,
+      { userId: string; platform: Platform }
+    >();
+    const normalizedShareholders: Shareholder[] = newShareholders.map(
+      (shareholder) => {
+        if (shareholder.address) {
+          return {
+            address: shareholder.address,
+            shareBps: shareholder.shareBps,
+          };
+        }
+
+        if (
+          typeof shareholder.userId === "string" &&
+          typeof shareholder.platform === "number"
+        ) {
+          if (!SUPPORTED_SOCIAL_PLATFORMS.includes(shareholder.platform)) {
+            const supportedPlatformNames = SUPPORTED_SOCIAL_PLATFORMS.map((platform) =>
+              platformToString(platform),
+            ).join(", ");
+            throw new Error(
+              `Unsupported platform "${shareholder.platform}" for userId "${shareholder.userId}". Supported platforms: ${supportedPlatformNames}.`,
+            );
+          }
+
+          const recipientPda = socialFeePda(shareholder.userId, shareholder.platform);
+          socialRecipientsToCreate.set(recipientPda.toBase58(), {
+            userId: shareholder.userId,
+            platform: shareholder.platform,
+          });
+
+          return {
+            address: recipientPda,
+            shareBps: shareholder.shareBps,
+          };
+        }
+
+        throw new Error(
+          "Each new shareholder must provide either an address or both userId and platform.",
+        );
+      },
+    );
+
+    return {
+      normalizedShareholders,
+      socialRecipientsToCreate,
+    };
+  }
+
+  /**
+   * Wrapper around `updateSharingConfig` that resolves social recipients and
+   * initializes any missing social recipient PDAs before updating fee shares.
+   *
+   * Requirements:
+   * - `authority` must sign the transaction.
+   *
+   * Warning:
+   * - sharing config must exist for that mint
+   * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+   *   The target must be a real user account with a login. E.g: Organizations are not supported.
+   * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+   */
+  async updateSharingConfigWithSocialRecipients({
+    authority,
+    mint,
+    currentShareholders,
+    newShareholders,
+  }: {
+    authority: PublicKey;
+    mint: PublicKey;
+    currentShareholders: PublicKey[];
+    newShareholders: Array<{
+      shareBps: number;
+      address?: PublicKey;
+      userId?: string;
+      platform?: Platform;
+    }>;
+  }): Promise<TransactionInstruction[]> {
+    const instructions: TransactionInstruction[] = [];
+    const { normalizedShareholders, socialRecipientsToCreate } =
+      this.normalizeSocialShareholders({ newShareholders });
+
+    for (const recipient of socialRecipientsToCreate.values()) {
+      instructions.push(
+        await this.createSocialFeePda({
+          payer: authority,
+          userId: recipient.userId,
+          platform: recipient.platform,
+        }),
+      );
+    }
+
+    instructions.push(
+      await this.updateFeeShares({
+        authority,
+        mint,
+        currentShareholders,
+        newShareholders: normalizedShareholders,
+      }),
+    );
+
+    return instructions;
+  }
+
+  /**
+   * Wrapper around `createFeeSharingConfig` that resolves social recipients and
+   * initializes any missing social recipient PDAs before updating fee shares.
+   *
+   * Requirements:
+   * - `creator` must sign the transaction.
+   * - `pool` must be provided for graduated coins; use `null` for ungraduated coins.
+   *
+   * Warning:
+   * - `userId` must be the GitHub user id returned by `https://api.github.com/users/<github-username>`.
+   *   The target must be a real user account with a login. E.g: Organizations are not supported.
+   * - Only `github` is supported at the moment, any attempt to use other platforms will result in fee loss. In doubt check `SUPPORTED_SOCIAL_PLATFORMS`
+   */
+  async createSharingConfigWithSocialRecipients({
+    creator,
+    mint,
+    pool,
+    newShareholders,
+  }: {
+    creator: PublicKey;
+    mint: PublicKey;
+    pool: PublicKey | null;
+    newShareholders: Array<{
+      shareBps: number;
+      address?: PublicKey;
+      userId?: string;
+      platform?: Platform;
+    }>;
+  }): Promise<TransactionInstruction[]> {
+    const instructions: TransactionInstruction[] = [];
+
+    instructions.push(
+      await this.createFeeSharingConfig({
+        creator,
+        mint,
+        pool,
+      }),
+    );
+
+    instructions.push(
+      ...(await this.updateSharingConfigWithSocialRecipients({
+        authority: creator,
+        mint,
+        currentShareholders: [creator],
+        newShareholders,
+      })),
+    );
+
+    return instructions;
+  }
+
+  claimSocialFeePda() {
+    throw new Error("This function can only be called by pump and is not supported");
+  }
 }
 
+
 export const PUMP_SDK = new PumpSdk();
 
 /**

package/src/state.ts

@@ -1,6 +1,42 @@
 import { PublicKey } from "@solana/web3.js";
 import BN from "bn.js";
 
+/**
+ * Platform identifiers for social handle mappings.
+ */
+export enum Platform {
+  Pump = 0,
+  X = 1,
+  GitHub = 2,
+}
+
+export const SUPPORTED_SOCIAL_PLATFORMS = [Platform.GitHub];
+
+export const stringToPlatform = (value: string): Platform => {
+  const normalized = value.trim().toUpperCase();
+  const entry = Object.entries(Platform).find(
+    ([key, val]) => typeof val === "number" && key.toUpperCase() === normalized,
+  );
+  if (entry) {
+    return entry[1] as Platform;
+  }
+  const validNames = Object.entries(Platform)
+    .filter(([, val]) => typeof val === "number")
+    .map(([key]) => key.toUpperCase())
+    .join(", ");
+  throw new Error(
+    `Unknown platform "${value}". Expected one of: ${validNames}`,
+  );
+};
+
+export const platformToString = (platform: Platform): string => {
+  const name = Platform[platform];
+  if (name !== undefined) {
+    return name;
+  }
+  throw new Error(`Unknown platform value: ${platform}`);
+};
+
 export interface Global {
   // unused
   initialized: boolean;