x402agent/pump-fee-sharing

Fee Sharing — Multi-Party Creator Fee Distribution

Configure and manage creator fee sharing — allowing token creators to distribute accumulated trading fees to multiple shareholders using the PumpFees program with BPS-based share allocation.

Architecture

    Token Creator
         │
         ▼
    ┌─────────────────────┐
    │  SharingConfig PDA  │
    │  (PumpFees program) │
    │  shareholders:       │
    │    [{ addr, bps }]   │
    └─────────────────────┘
         │ distribute
    ┌────┴────┬────┬────┐
    │  40%    │ 30%│ 20%│ 10%
    ▼         ▼    ▼    ▼
   User1   User2 User3 User4

Workflow

1. Create Fee Sharing Config

const ix = PUMP_SDK.createFeeSharingConfig({
    creator, mint, pool, payer,
    shareholders: [
        { address: userA, shareBps: 5000 },  // 50%
        { address: userB, shareBps: 3000 },  // 30%
        { address: userC, shareBps: 2000 },  // 20%
    ]
});

2. Update Shareholders

const ix = PUMP_SDK.updateFeeShares({
    creator, mint,
    shareholders: [
        { address: userA, shareBps: 4000 },
        { address: userD, shareBps: 3000 },
        { address: userB, shareBps: 3000 },
    ]
});

3. Distribute Fees

const { instructions, isGraduated } = await onlineSdk.buildDistributeCreatorFeesInstructions(mint);
// For graduated: transferCreatorFeesToPump + distributeCreatorFees
// For non-graduated: distributeCreatorFees only

Validation Rules

| Rule | Error Class | |------|------------| | At least 1 shareholder | NoShareholdersError | | Maximum 10 shareholders | TooManyShareholdersError | | No zero-share entries | ZeroShareError | | Shares sum to 10,000 BPS | InvalidShareTotalError | | No duplicate addresses | DuplicateShareholderError | | Graduated tokens need pool | PoolRequiredForGraduatedError |

Cross-Program Fee Consolidation

Trading fees ──► AMM Creator Vault (PumpAMM)
                        │
                transferCreatorFeesToPump
                        │
                        ▼
                Pump Creator Vault (Pump)
                        │
                distributeCreatorFees
                        │
                        ▼
                Shareholders (proportional)

Patterns to Follow

• Validate shareholder arrays before sending: max 10, sum = 10,000 BPS, no duplicates, no zero shares
• Use BothPrograms methods when aggregating across Pump + PumpAMM
• Check isGraduated to determine if AMM fee consolidation is needed
• Check adminRevoked before attempting to update shareholders

Common Pitfalls

• Shares must total exactly 10,000 BPS (100%) — not 100, not 1,000,000
• Graduated tokens require the pool parameter for config creation
• Two separate creator vaults exist with different PDA seeds (hyphen vs underscore)
• updateFeeShares will fail on-chain if adminRevoked === true
• Basis points use integer arithmetic — fractional bps are not possible