x402agent/SolanaOS / skills/pump-fee-sharing
pump-fee-sharing
VerifiedConfigure and distribute creator fees to multiple shareholders using the PumpFees program with BPS-based share allocation, admin management, and cross-program fee consolidation for graduated tokens.
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
BothProgramsmethods when aggregating across Pump + PumpAMM - Check
isGraduatedto determine if AMM fee consolidation is needed - Check
adminRevokedbefore attempting to update shareholders
Common Pitfalls
- Shares must total exactly 10,000 BPS (100%) — not 100, not 1,000,000
- Graduated tokens require the
poolparameter for config creation - Two separate creator vaults exist with different PDA seeds (hyphen vs underscore)
updateFeeShareswill fail on-chain ifadminRevoked === true- Basis points use integer arithmetic — fractional bps are not possible
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |