x402agent/skills/pumpfun-fees

PumpFun 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.