pumpfun-fees

Quick Pump.fun fee shortcut for creator fee sharing setup, shareholder BPS splits, claim/distribution flows, fee-tier checks, token incentives, and automated fee monitoring.

SKILL.md

GitHub

Pump.fun Fee Sharing

Set up, manage, and claim creator fee sharing on Pump.fun tokens. Supports up to 10 shareholders with configurable basis point splits.

Prerequisites

  • Token creator wallet
  • HELIUS_RPC_URL configured
  • Token must be active (bonding curve or graduated)

Fee Sharing Setup

1. Create Fee Sharing Config

import { PUMP_SDK } from "@nirholas/pump-sdk";

const createConfigIx = await PUMP_SDK.createFeeSharingConfig({
  creator: wallet.publicKey,
  mint: tokenMint,
  pool: null, // null for pre-graduation tokens
});

2. Set Shareholders

Shares must total exactly 10,000 BPS (100%). Maximum 10 shareholders.

const updateIx = await PUMP_SDK.updateFeeShares({
  authority: wallet.publicKey,
  mint: tokenMint,
  currentShareholders: [wallet.publicKey],
  newShareholders: [
    { address: wallet.publicKey, shareBps: 7000 },           // 70%
    { address: new PublicKey("Partner..."), shareBps: 2000 }, // 20%
    { address: new PublicKey("Dev..."), shareBps: 1000 },     // 10%
  ],
});

3. Claim Accumulated Fees

const sdk = new OnlinePumpSdk(connection);
const claimResult = await sdk.distributeCreatorFees({
  mint: tokenMint,
  creator: wallet.publicKey,
});

Fee Tier Reference

Fees are tiered by market cap:

Market Cap (SOL) Protocol Fee Creator Fee
< 100 Higher Lower
100-1000 Standard Standard
> 1000 Lower Higher

Error Handling

Error Cause Fix
NoShareholdersError Empty array Provide ≥1 shareholder
TooManyShareholdersError >10 shareholders Reduce to ≤10
ZeroShareError Share ≤ 0 Set positive values
InvalidShareTotalError Sum ≠ 10,000 Ensure total = 10,000 BPS
DuplicateShareholderError Same address twice Remove duplicates

Token Incentives

Track unclaimed $PUMP reward tokens:

import { totalUnclaimedTokens, currentDayTokens } from "@nirholas/pump-sdk";

const unclaimed = totalUnclaimedTokens(userVolumeAccumulator, globalVolumeAccumulator);
const todayTokens = currentDayTokens(globalVolumeAccumulator);

Agent Integration

The fee-claimer agent role uses this skill to automatically monitor and claim accumulated creator fees across all managed tokens.