Creator Fee Sharing

Note: These instructions only apply to coins that have a sharing_config — i.e. coins whose creator vault has been migrated to the Pump Fees program for multi-recipient distribution. For single-creator-recipient coins (no sharing_config), use collect_creator_fee_v2 / collect_coin_creator_fee instead.

The lifecycle is:

create_fee_sharing_config (Pump Fees) — opt the coin into shared distribution. Migrates the bonding curve creator (and AMM pool.coin_creator if graduated) to the new sharing_config PDA.
update_fee_shares_v2 (Pump Fees) — set the final list of shareholders. Sweeps any pending creator fees from both the AMM and the bonding curve via CPI before applying the new shares. Can only be called once per sharing_config (the admin is revoked after).
transfer_creator_fees_to_pump_v2 (Pump AMM) — sweep coin creator fees accrued on the AMM into the bonding curve's creator vault so they can be distributed by the pump program. Permissionless.
distribute_creator_fees_v2 (Pump program) — pay out the bonding curve's creator vault to each shareholder according to their share_bps. Permissionless.

For every token account in the tables below, the third column tells you who is responsible for initialization: whether the caller must initialize it beforehand, whether the instruction will initialize it on the fly, or whether it can be left uninitialized when quote_mint is wrapped SOL (the SOL-paired code path never touches it).

`create_fee_sharing_config` (Pump Fees)

Creates the sharing_config PDA for a coin and CPIs into the Pump program (and the Pump AMM program if the coin has graduated) to point the creator vault at sharing_config. The initial shareholder set is [(creator, 10_000 bps)]. Callable by either the global admin_set_creator_authority or the current coin creator.

Accounts

#	Account	Seeds / derivation	`init_if_needed` / SOL cost
1	`event_authority`	Pump Fees PDA: seeds `[b"__event_authority"]`.	-
2	`program`	Pump Fees program account.	-
3	`payer`	Transaction signer. Must be `global.admin_set_creator_authority` or the coin creator (`bonding_curve.creator` for pre-graduation, `pool.coin_creator` for graduated coins). Pays the rent for `sharing_config`.	-
4	`global`	Pump PDA: seeds `[b"global"]`.	-
5	`mint`	Base token mint.	-
6	`sharing_config`	Pump Fees PDA: seeds `[b"sharing-config", mint]`. Allocates up to `SharingConfig::MAX_SIZE` (1024 bytes). Calling twice is a no-op.	Rent for a 1024-byte account
7	`system_program`	System Program: `11111111111111111111111111111111`.	-
8	`bonding_curve`	Pump PDA: seeds `[b"bonding-curve", mint]`. Mutated by the CPI into `pump::migrate_bonding_curve_creator` (its `creator` field is updated to `sharing_config`).	-
9	`pump_program`	Pump program account.	-
10	`pump_event_authority`	Pump PDA: seeds `[b"__event_authority"]`.	-
11	`pool`	Optional. Pump AMM `Pool` account for the coin. Required if the coin has graduated; omit otherwise.	-
12	`pump_amm_program`	Optional. Pump AMM program account. Required if `pool` is set.	-
13	`pump_amm_event_authority`	Optional. Pump AMM PDA: seeds `[b"__event_authority"]`. Required if `pool` is set.	-

Instruction Data

create_fee_sharing_config takes no instruction data arguments.

`update_fee_shares_v2` (Pump Fees)

Sets the final shareholder list on the sharing_config and revokes further admin updates. Before applying the new shares, this instruction CPIs into the AMM to sweep any AMM-side creator fees into the bonding curve (if the coin has graduated and the AMM-side vault has accrued fees), and CPIs into the Pump program to distribute any currently pending bonding-curve creator fees to the current shareholder list. Callable by the sharing_config.admin.

Accounts

#	Account	Seeds / derivation	`init_if_needed` / SOL cost
1	`event_authority`	Pump Fees PDA: seeds `[b"__event_authority"]`.	-
2	`program`	Pump Fees program account.	-
3	`authority`	Transaction signer. Must equal `sharing_config.admin`.	-
4	`global`	Pump PDA: seeds `[b"global"]`.	-
5	`mint`	Base token mint.	-
6	`sharing_config`	Pump Fees PDA: seeds `[b"sharing-config", mint]`. Must already exist and have `version != 1` (i.e. created by the V2 deployment).	-
7	`bonding_curve`	Pump PDA: seeds `[b"bonding-curve", mint]`. Used by the CPI into `distribute_creator_fees_v2`.	-
8	`pump_creator_vault`	Pump PDA: seeds `[b"creator-vault", sharing_config]`. Source of the bonding-curve-side creator fees.	-
9	`pump_creator_vault_ata`	Associated token PDA for `(pump_creator_vault, token_program, quote_mint)`. Source of the token transfer for non-native quote mints during the CPI'd distribution.	Expected to be initialized; may be uninitialized when `quote_mint` is wrapped SOL.
10	`system_program`	System Program: `11111111111111111111111111111111`.	-
11	`pump_program`	Pump program account.	-
12	`pump_event_authority`	Pump PDA: seeds `[b"__event_authority"]`.	-
13	`pump_amm_program`	Pump AMM program account.	-
14	`amm_event_authority`	Pump AMM PDA: seeds `[b"__event_authority"]`.	-
15	`quote_mint`	Quote mint for the coin. For SOL-paired coins, pass wrapped SOL: `So11111111111111111111111111111111111111112`.	-
16	`token_program`	Token program for `quote_mint`.	-
17	`associated_token_program`	Associated Token Program: `ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL`.	-
18	`coin_creator_vault_authority`	Pump AMM PDA: seeds `[b"creator_vault", sharing_config]`. Used by the AMM-sweep CPI when the coin has graduated.	-
19	`coin_creator_vault_ata`	Associated token PDA for `(coin_creator_vault_authority, token_program, quote_mint)`. Source of the AMM-sweep CPI.	Expected to be initialized; may be uninitialized when `quote_mint` is wrapped SOL.

Remaining Accounts

The remaining accounts are forwarded to the inner distribute_creator_fees_v2 CPI and follow its shape:

Quote mint	Layout of `remainingAccounts`
Wrapped SOL	`[shareholder_1, …, shareholder_N]`
Non-native (e.g. USDC)	`[shareholder_1, …, shareholder_N, ata_1, …, ata_N]` where `ata_i` is the ATA for `(shareholder_i, token_program, quote_mint)`.

The order must match the current sharing_config.shareholders. For non-native quote mints, missing shareholder ATAs are created on the fly by the CPI'd distribute_creator_fees_v2 (which is invoked with initialize_ata = true from this instruction).

Instruction Data

#	Argument	Type	Description / validation	Optional?
1	`shareholders`	`Vec<Shareholder>`	New list of `{ address, share_bps }`. Must be non-empty, contain at most 10 entries, have no duplicates, every `share_bps > 0`, and `sum(share_bps) == 10_000`. Replaces the current shareholders and sets `admin_revoked = true`, so this instruction can only effectively be used once per `sharing_config`.	No

`transfer_creator_fees_to_pump_v2` (Pump AMM)

Sweeps coin creator fees accrued on the Pump AMM out of the AMM coin creator vault and into the Pump program's creator_vault for the same creator, so they can be paid out via distribute_creator_fees_v2. Permissionless. For wrapped-SOL quotes the instruction unwraps via close-and-recreate to forward lamports directly to pump_creator_vault; for non-native quotes it does a token transfer between ATAs and creates the destination ATA if needed.

Accounts

#	Account	Seeds / derivation	`init_if_needed` / SOL cost
1	`payer`	Transaction signer. Pays the rent for `pump_creator_vault_ata` when it is initialized by the instruction (non-native quote only).	-
2	`quote_mint`	Quote mint for the coin. For SOL-paired coins, pass wrapped SOL: `So11111111111111111111111111111111111111112`.	-
3	`token_program`	Token program for `quote_mint`.	-
4	`system_program`	System Program: `11111111111111111111111111111111`.	-
5	`associated_token_program`	Associated Token Program: `ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL`.	-
6	`coin_creator`	Coin creator account (the `sharing_config` PDA once the coin has been migrated).	-
7	`coin_creator_vault_authority`	Pump AMM PDA: seeds `[b"creator_vault", coin_creator]`. Authority over `coin_creator_vault_ata`. Mutated when its lamports are forwarded for wrapped SOL.	-
8	`coin_creator_vault_ata`	Associated token account for `quote_mint`, owned by `coin_creator_vault_authority`, using `token_program`. Source of the transfer.	Must be initialized.
9	`pump_creator_vault`	Pump PDA: seeds `[b"creator-vault", coin_creator]`. Destination of the lamport transfer for wrapped SOL.	-
10	`pump_creator_vault_ata`	Associated token PDA for `(pump_creator_vault, token_program, quote_mint)`. Destination of the token transfer for non-native quotes.	Expected to be initialized; initialized by the instruction if empty (non-native quote only). For wrapped SOL the account is unused and may be uninitialized.
11	`event_authority`	Pump AMM PDA: seeds `[b"__event_authority"]`.	-
12	`program`	Pump AMM program account.	-

Instruction Data

transfer_creator_fees_to_pump_v2 takes no instruction data arguments.

`distribute_creator_fees_v2` (Pump program)

Pays out the bonding curve creator vault to every shareholder in sharing_config.shareholders proportionally to their share_bps. Permissionless. For wrapped-SOL quotes the instruction transfers lamports directly to each shareholder address (leaving the vault rent-exempt). For non-native quotes it transfers tokens from the vault's ATA to each shareholder's ATA, and — if initialize_ata = true is passed — creates any missing shareholder ATAs along the way (paid for by payer).

Accounts

#	Account	Seeds / derivation	`init_if_needed` / SOL cost
1	`payer`	Transaction signer. Pays the rent for any shareholder ATAs created during this call when `initialize_ata = true`.	-
2	`mint`	Base token mint.	-
3	`bonding_curve`	Pump PDA: seeds `[b"bonding-curve", mint]`. Must have `bonding_curve.creator == sharing_config`.	-
4	`sharing_config`	Pump Fees PDA: seeds `[b"sharing-config", mint]`. Must be `Active`.	-
5	`creator_vault`	Pump PDA: seeds `[b"creator-vault", sharing_config]` (since `bonding_curve.creator == sharing_config`). Source of the distribution.	-
6	`system_program`	System Program: `11111111111111111111111111111111`.	-
7	`event_authority`	Pump PDA: seeds `[b"__event_authority"]`.	-
8	`program`	Pump program account.	-
9	`creator_vault_quote_token_account`	Associated token PDA for `(creator_vault, quote_token_program, quote_mint)`. Source of the token transfer for non-native quotes.	Expected to be initialized; may be uninitialized when `quote_mint` is wrapped SOL.
10	`quote_mint`	Quote mint for the coin. For SOL-paired coins, pass wrapped SOL: `So11111111111111111111111111111111111111112`. Must match the bonding curve's quote mint.	-
11	`quote_token_program`	Token program for `quote_mint`.	-
12	`associated_token_program`	Associated Token Program: `ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL`.	-

Remaining Accounts

Quote mint	Layout of `remainingAccounts`
Wrapped SOL	`[shareholder_1, …, shareholder_N]`
Non-native (e.g. USDC)	`[shareholder_1, …, shareholder_N, ata_1, …, ata_N]` where `ata_i` is the ATA for `(shareholder_i, quote_token_program, quote_mint)`.

The order must match sharing_config.shareholders exactly. For wrapped-SOL coins, each shareholder receives lamports directly and only the wallet pubkeys are required. For non-native quote coins, each ata_i is enforced to be the canonical ATA for that shareholder; if initialize_ata = true is passed, any missing ATAs are created on the fly (rent paid by payer), and if initialize_ata = false the instruction fails on the first uninitialized ATA.

Instruction Data

#	Argument	Type	Description / validation	Optional?
1	`initialize_ata`	`bool`	If `true`, the instruction will create any missing shareholder ATAs (paid by `payer`) before transferring tokens. If `false`, missing ATAs cause the instruction to fail. Ignored for wrapped-SOL coins (no ATAs involved).	No

TS SDK

End-to-end flow: opt the coin into fee sharing, set the final shareholder list, and (after fees have accrued from trading) sweep AMM-side fees into the bonding curve vault and distribute them to the shareholders.

SOL-Paired Coin

For SOL-paired coins, use wrapped SOL as the quoteMint and the SPL token program as quoteTokenProgram.

import { PUMP_SDK, feeSharingConfigPda } from "@pump-fun/pump-sdk";
import { NATIVE_MINT, TOKEN_PROGRAM_ID } from "@solana/spl-token";

// 1. Opt the coin into shared distribution. After this CPI, `bonding_curve.creator`
//    (and `pool.coin_creator` if graduated) point at `sharing_config`, and the
//    default shareholder list is `[(creator, 10_000 bps)]`.
const createSharingConfigIx = await PUMP_SDK.createFeeSharingConfig({
  creator,
  mint,
  pool, // canonical Pump AMM pool, or `null` if the coin hasn't graduated
});

// 2. Set the final shareholder list. Sweeps any pending bonding-curve creator fees
//    to the *current* shareholders before applying the new list, then revokes
//    further admin updates on this sharing_config.
const updateFeeSharesIx = await PUMP_SDK.updateFeeSharesV2({
  authority: creator, // = sharing_config.admin (bonding_curve.creator at this point)
  mint,
  currentShareholders: [creator], // matches what was set by `createFeeSharingConfig`
  newShareholders: [
    { address: wallet1, shareBps: 5000 }, // 50%
    { address: wallet2, shareBps: 3000 }, // 30%
    { address: wallet3, shareBps: 2000 }, // 20%
  ],
  quoteMint: NATIVE_MINT,
  quoteTokenProgram: TOKEN_PROGRAM_ID,
});

// --- Trades occur over time and creator fees accumulate in the bonding curve
//     creator vault and, for graduated coins, in the AMM coin creator vault. ---

// 3. (Graduated coins only.) Sweep AMM-side creator fees into the bonding curve
//    creator vault so they can be distributed alongside the bonding-curve fees.
const transferIx = await PUMP_SDK.transferCreatorFeesToPumpV2({
  payer: user,
  mint,
  quoteMint: NATIVE_MINT,
  quoteTokenProgram: TOKEN_PROGRAM_ID,
});

// 4. Distribute the accumulated bonding-curve creator fees to the shareholders.
const sharingConfigAddress = feeSharingConfigPda(mint);
const sharingConfigAccountInfo = await connection.getAccountInfo(
  sharingConfigAddress,
);
const sharingConfig = PUMP_SDK.decodeSharingConfig(sharingConfigAccountInfo!);

const distributeIx = await PUMP_SDK.distributeCreatorFeesV2({
  mint,
  sharingConfig,
  sharingConfigAddress,
  quoteMint: NATIVE_MINT,
  payer: user,
  shouldInitializeAta: true, // create missing recipient ATAs (non-WSOL only)
  quoteTokenProgram: TOKEN_PROGRAM_ID,
});

USDC-Paired Coin

For USDC-paired coins, pass the USDC mint as quoteMint and the USDC token program as quoteTokenProgram. Setting shouldInitializeAta: true on the distribute call ensures any missing shareholder USDC ATAs are created on the fly (rent paid by payer).

import { PUMP_SDK, feeSharingConfigPda } from "@pump-fun/pump-sdk";
import { TOKEN_PROGRAM_ID } from "@solana/spl-token";
import { PublicKey } from "@solana/web3.js";

const quoteMint = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
const quoteTokenProgram = TOKEN_PROGRAM_ID;

// 1. Opt the coin into shared distribution.
const createSharingConfigIx = await PUMP_SDK.createFeeSharingConfig({
  creator,
  mint,
  pool, // canonical Pump AMM pool, or `null` if the coin hasn't graduated
});

// 2. Set the final shareholder list. For non-WSOL quotes, the inner CPI distributes
//    pending fees as USDC, so the current shareholder ATAs must already exist (the
//    initial shareholder is just `creator`, whose ATA will be auto-created here).
const updateFeeSharesIx = await PUMP_SDK.updateFeeSharesV2({
  authority: creator,
  mint,
  currentShareholders: [creator],
  newShareholders: [
    { address: wallet1, shareBps: 5000 },
    { address: wallet2, shareBps: 3000 },
    { address: wallet3, shareBps: 2000 },
  ],
  quoteMint,
  quoteTokenProgram,
});

// --- Trades occur over time and creator fees accumulate in the bonding curve
//     creator vault and, for graduated coins, in the AMM coin creator vault. ---

// 3. (Graduated coins only.) Sweep AMM-side creator fees into the bonding curve
//    creator vault. For non-WSOL quotes this transfers tokens via ATAs and creates
//    the destination `pump_creator_vault_ata` on the fly if it doesn't exist yet
//    (rent paid by `payer`).
const transferIx = await PUMP_SDK.transferCreatorFeesToPumpV2({
  payer: user,
  mint,
  quoteMint,
  quoteTokenProgram,
});

// 4. Distribute the accumulated USDC creator fees to the shareholders.
const sharingConfigAddress = feeSharingConfigPda(mint);
const sharingConfigAccountInfo = await connection.getAccountInfo(
  sharingConfigAddress,
);
const sharingConfig = PUMP_SDK.decodeSharingConfig(sharingConfigAccountInfo!);

const distributeIx = await PUMP_SDK.distributeCreatorFeesV2({
  mint,
  sharingConfig,
  sharingConfigAddress,
  quoteMint,
  payer: user,
  shouldInitializeAta: true, // create missing shareholder USDC ATAs as needed
  quoteTokenProgram,
});

Rust SDK

Sweep AMM-side creator fees into the bonding curve vault, then distribute them to the shareholders. quote_mint can be wrapped SOL or USDC, pass the matching token program as quote_token_program.

use pump_rust_client::accounts::decode_sharing_config;
use pump_rust_client::accounts::pump_amm::decode_pool;
use pump_rust_client::constants::NATIVE_MINT;
use pump_rust_client::{constants, pda, PumpSdk};
use solana_sdk::compute_budget::ComputeBudgetInstruction;
use solana_sdk::pubkey::Pubkey;

let sdk = PumpSdk::new();

// For SOL-paired coins:
let quote_mint = NATIVE_MINT;
let quote_token_program = constants::SPL_TOKEN_PROGRAM_ID;
// For USDC-paired coins, set `quote_mint` to the USDC mint instead
// (token program remains `SPL_TOKEN_PROGRAM_ID`).

let pool_creator = pda::pump::pool_authority(&mint).0;
let pool_address = pda::pump_amm::pool(0, &pool_creator, &mint, &quote_mint).0;
let pool = decode_pool(&rpc.get_account(&pool_address).await?.data)?;

// 1. (Graduated coins only.) Sweep AMM-side creator fees into the bonding
//    curve creator vault.
let transfer_ix = sdk.transfer_creator_fees_to_pump_v2_instruction(
    payer,
    pool.coin_creator,
    quote_mint,
    quote_token_program,
);

// 2. Distribute the bonding curve creator vault to the shareholders.
let sharing_config = decode_sharing_config(
    &rpc.get_account(&pda::pump::sharing_config(&mint).0).await?.data,
)?;
let shareholders: Vec<Pubkey> = sharing_config
    .shareholders
    .iter()
    .map(|s| s.address)
    .collect();

let bc = client.fetch_bonding_curve(&mint).await?;

let mut ixs = vec![
    ComputeBudgetInstruction::set_compute_unit_limit(400_000),
    transfer_ix,
];
ixs.extend(sdk.distribute_creator_fees_v2_instructions(
    payer,
    mint,
    bc.creator,
    quote_mint,
    quote_token_program,
    false,
    true,
    &shareholders,
));

Navigation Menu

Uh oh!

Creator Fee Sharing

`create_fee_sharing_config` (Pump Fees)

Accounts

Instruction Data

`update_fee_shares_v2` (Pump Fees)

Accounts

Remaining Accounts

Instruction Data

`transfer_creator_fees_to_pump_v2` (Pump AMM)

Accounts

Instruction Data

`distribute_creator_fees_v2` (Pump program)

Accounts

Remaining Accounts

Instruction Data

TS SDK

SOL-Paired Coin

USDC-Paired Coin

Rust SDK

Uh oh!

FilesExpand file tree

CREATOR_FEE_SHARING.md

Latest commit

History

CREATOR_FEE_SHARING.md

File metadata and controls

Creator Fee Sharing

create_fee_sharing_config (Pump Fees)

Accounts

Instruction Data

update_fee_shares_v2 (Pump Fees)

Accounts

Remaining Accounts

Instruction Data

transfer_creator_fees_to_pump_v2 (Pump AMM)

Accounts

Instruction Data

distribute_creator_fees_v2 (Pump program)

Accounts

Remaining Accounts

Instruction Data

TS SDK

SOL-Paired Coin

USDC-Paired Coin

Rust SDK

`create_fee_sharing_config` (Pump Fees)

`update_fee_shares_v2` (Pump Fees)

`transfer_creator_fees_to_pump_v2` (Pump AMM)

`distribute_creator_fees_v2` (Pump program)