@pump-fun/pump-sdk 1.31.0 → 1.32.0

package/README.md

@@ -2,6 +2,34 @@
 
 Official Pump program SDK
 
+# Updates
+
+## One-Time Creator Reward Distribution Policy
+
+This update only affects fee-sharing configuration. Trading instructions are unchanged and do not require an upgrade.
+
+
+**TLDR:** After the first configuration, reward distribution is locked and cannot be changed.
+
+What changed:
+- Reward distribution can be configured **only once**.
+- You can configure it using either `updateFeeShares` or `updateSharingConfigWithSocialRecipients`.
+- After it is configured, it is **locked** and cannot be changed again.
+
+What did **not** change:
+- Buy and sell instructions are unchanged.
+
+Migration/compatibility notes:
+- Reward distributions created before this policy are treated as final (locked).
+- `RevokeFeeSharingAuthority` and `TransferFeeSharingAuthority` are no longer supported.
+- If you are unsure whether a reward distribution is still editable, call `isSharingConfigEditable`.
+
+```Typescript
+import { isSharingConfigEditable } from "@pump-fun/pump-sdk";
+```
+
+# Usage
+
 ```Typescript
 const connection = new Connection(
     "https://api.devnet.solana.com",
@@ -106,6 +134,8 @@ const instructions = await sdk.collectCoinCreatorFeeInstructions(user);
 
 Fee sharing allows token creators to set up fee distribution to multiple shareholders. The `OnlinePumpSdk` provides methods to check distributable fees and distribute them.
 
+> **Important:** Reward split can be setup once and once only by calling either `updateFeeShares` or `updateSharingConfigWithSocialRecipients`. Double-check final recipients and `shareBps` before submitting.
+
 ```Typescript
 import { OnlinePumpSdk } from "@pump-fun/pump-sdk";
 
@@ -202,6 +232,10 @@ Method selection:
 - `updateSharingConfigWithSocialRecipients`: use when sharing config already exists.
 - `createSharingConfigWithSocialRecipients`: use for first-time setup (creates config, then updates shares).
 
+Important:
+- Social fee PDA creation is a one-time initialization per `(userId, platform)` and can be reused across coins once created.
+- Reward split can be setup once and once only by calling either `updateFeeShares` or `updateSharingConfigWithSocialRecipients`. Double-check final recipients and `shareBps` before submitting.
+
 ✅ Checklist
 
 - [ ] The GitHub user must be able to log in to claim fees. **GitHub organizations are not supported** for social fee recipients; adding an organization account can result in fees being permanently lost.