@pump-fun/pump-sdk 1.27.0 → 1.28.0-devnet.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pump-fun/pump-sdk",
-  "version": "1.27.0",
+  "version": "1.28.0-devnet.1",
   "description": "Pump Bonding Curve SDK",
   "keywords": [],
   "homepage": "https://github.com/pump-fun/pump-sdk#readme",
@@ -35,7 +35,9 @@
     "build": "tsup --clean --dts",
     "dev": "tsup --watch",
     "clean": "rm -rf dist",
-    "test": "jest"
+    "test": "jest",
+    "lint": "eslint --cache --quiet \"${@:-.}\"",
+    "lint:fix": "eslint --cache --fix --quiet \"${@:-.}\""
   },
   "dependencies": {
     "@coral-xyz/anchor": "^0.31.1",
@@ -57,7 +59,20 @@
     "ts-jest": "^29.3.2",
     "ts-node": "^10.9.2",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "@eslint/js": "^9.14.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-config-flat-gitignore": "^2.1.0",
+    "eslint-plugin-atomic-design-hierarchy": "^1.0.11",
+    "eslint-plugin-eslint-comments": "^3.2.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jest": "^28.11.0",
+    "eslint-plugin-jsdoc": "^50.6.11",
+    "eslint-plugin-no-barrel-files": "^1.2.2",
+    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-unicorn": "^54.0.0",
+    "globals": "^15.12.0",
+    "typescript-eslint": "^8.29.1"
   },
   "publishConfig": {
     "access": "public"

package/src/bondingCurve.ts

@@ -1,7 +1,8 @@
-import BN from "bn.js";
 import { PublicKey } from "@solana/web3.js";
-import { BondingCurve, FeeConfig, Global } from "./state";
+import BN from "bn.js";
+
 import { computeFeesBps, getFee } from "./fees";
+import { BondingCurve, FeeConfig, Global } from "./state";
 
 export function newBondingCurve(global: Global): BondingCurve {
   return {

package/src/errors.ts

@@ -10,7 +10,10 @@ export class NoShareholdersError extends Error {
 }
 
 export class TooManyShareholdersError extends Error {
-  constructor(public count: number, public max: number) {
+  constructor(
+    public count: number,
+    public max: number,
+  ) {
     super(`Too many shareholders. Maximum allowed is ${max}, got ${count}`);
     this.name = "TooManyShareholdersError";
   }
@@ -32,7 +35,9 @@ export class ShareCalculationOverflowError extends Error {
 
 export class InvalidShareTotalError extends Error {
   constructor(public total: number) {
-    super(`Invalid share total. Must equal 10,000 basis points (100%). Got ${total}`);
+    super(
+      `Invalid share total. Must equal 10,000 basis points (100%). Got ${total}`,
+    );
     this.name = "InvalidShareTotalError";
   }
 }
@@ -46,7 +51,9 @@ export class DuplicateShareholderError extends Error {
 
 export class PoolRequiredForGraduatedError extends Error {
   constructor() {
-    super("Pool parameter is required for graduated coins (bondingCurve.complete = true)");
+    super(
+      "Pool parameter is required for graduated coins (bondingCurve.complete = true)",
+    );
     this.name = "PoolRequiredForGraduatedError";
   }
-}
+}

package/src/fees.ts

@@ -1,9 +1,10 @@
-import BN from "bn.js";
 import { PublicKey } from "@solana/web3.js";
-import { FeeConfig, Global, Fees, BondingCurve, FeeTier } from "./state";
+import BN from "bn.js";
+
 import { bondingCurveMarketCap } from "./bondingCurve";
+import { FeeConfig, Global, Fees, BondingCurve, FeeTier } from "./state";
 
-export const ONE_BILLION_SUPPLY = new BN(1_000_000_000_000000);
+export const ONE_BILLION_SUPPLY = new BN(1_000_000_000_000_000);
 
 export interface CalculatedFeesBps {
   protocolFeeBps: BN;
@@ -25,7 +26,8 @@ export function getFee({
   amount: BN;
   isNewBondingCurve: boolean;
 }) {
-  const { virtualSolReserves, virtualTokenReserves, isMayhemMode } = bondingCurve;
+  const { virtualSolReserves, virtualTokenReserves, isMayhemMode } =
+    bondingCurve;
   const { protocolFeeBps, creatorFeeBps } = computeFeesBps({
     global,
     feeConfig,
@@ -104,12 +106,17 @@ function ceilDiv(a: BN, b: BN): BN {
   return a.add(b.subn(1)).div(b);
 }
 
-export function getFeeRecipient(global: Global, mayhemMode: boolean): PublicKey {
+export function getFeeRecipient(
+  global: Global,
+  mayhemMode: boolean,
+): PublicKey {
   if (mayhemMode) {
-    const feeRecipients = [global.reservedFeeRecipient, ...global.reservedFeeRecipients];
-    return feeRecipients[Math.floor(Math.random() * feeRecipients.length)];
-  } else {
-    const feeRecipients = [global.feeRecipient, ...global.feeRecipients,];
+    const feeRecipients = [
+      global.reservedFeeRecipient,
+      ...global.reservedFeeRecipients,
+    ];
     return feeRecipients[Math.floor(Math.random() * feeRecipients.length)];
   }
+  const feeRecipients = [global.feeRecipient, ...global.feeRecipients];
+  return feeRecipients[Math.floor(Math.random() * feeRecipients.length)];
 }

package/src/idl/pump.json

@@ -1185,6 +1185,103 @@
         }
       ]
     },
+    {
+      "name": "claim_cashback",
+      "discriminator": [
+        37,
+        58,
+        35,
+        126,
+        190,
+        53,
+        228,
+        197
+      ],
+      "accounts": [
+        {
+          "name": "user",
+          "writable": true
+        },
+        {
+          "name": "user_volume_accumulator",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  117,
+                  115,
+                  101,
+                  114,
+                  95,
+                  118,
+                  111,
+                  108,
+                  117,
+                  109,
+                  101,
+                  95,
+                  97,
+                  99,
+                  99,
+                  117,
+                  109,
+                  117,
+                  108,
+                  97,
+                  116,
+                  111,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "user"
+              }
+            ]
+          }
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        },
+        {
+          "name": "event_authority",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  95,
+                  95,
+                  101,
+                  118,
+                  101,
+                  110,
+                  116,
+                  95,
+                  97,
+                  117,
+                  116,
+                  104,
+                  111,
+                  114,
+                  105,
+                  116,
+                  121
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "program",
+          "address": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P"
+        }
+      ],
+      "args": []
+    },
     {
       "name": "claim_token_incentives",
       "discriminator": [
@@ -2378,6 +2475,14 @@
         {
           "name": "is_mayhem_mode",
           "type": "bool"
+        },
+        {
+          "name": "is_cashback_enabled",
+          "type": {
+            "defined": {
+              "name": "OptionBool"
+            }
+          }
         }
       ]
     },
@@ -3578,7 +3683,10 @@
     {
       "name": "sell",
       "docs": [
-        "Sells tokens into a bonding curve."
+        "Sells tokens into a bonding curve.",
+        "For cashback coins, optionally pass user_volume_accumulator as remaining_accounts[0].",
+        "If provided and valid, creator_fee goes to user_volume_accumulator.",
+        "Otherwise, falls back to transferring creator_fee to creator_vault."
       ],
       "discriminator": [
         51,
@@ -4806,6 +4914,86 @@
       ],
       "args": []
     },
+    {
+      "name": "toggle_cashback_enabled",
+      "discriminator": [
+        115,
+        103,
+        224,
+        255,
+        189,
+        89,
+        86,
+        195
+      ],
+      "accounts": [
+        {
+          "name": "global",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority",
+          "writable": true,
+          "signer": true,
+          "relations": [
+            "global"
+          ]
+        },
+        {
+          "name": "event_authority",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  95,
+                  95,
+                  101,
+                  118,
+                  101,
+                  110,
+                  116,
+                  95,
+                  97,
+                  117,
+                  116,
+                  104,
+                  111,
+                  114,
+                  105,
+                  116,
+                  121
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "program"
+        }
+      ],
+      "args": [
+        {
+          "name": "enabled",
+          "type": "bool"
+        }
+      ]
+    },
     {
       "name": "toggle_create_v2",
       "discriminator": [
@@ -5164,6 +5352,19 @@
         222
       ]
     },
+    {
+      "name": "ClaimCashbackEvent",
+      "discriminator": [
+        226,
+        214,
+        246,
+        33,
+        7,
+        242,
+        147,
+        229
+      ]
+    },
     {
       "name": "ClaimTokenIncentivesEvent",
       "discriminator": [
@@ -5677,6 +5878,11 @@
       "code": 6055,
       "name": "InvalidShareBps",
       "msg": "Share bps must be greater than 0"
+    },
+    {
+      "code": 6056,
+      "name": "CashbackNotEnabled",
+      "msg": "Cashback is not enabled"
     }
   ],
   "types": [
@@ -5796,6 +6002,38 @@
           {
             "name": "is_mayhem_mode",
             "type": "bool"
+          },
+          {
+            "name": "is_cashback_coin",
+            "type": "bool"
+          }
+        ]
+      }
+    },
+    {
+      "name": "ClaimCashbackEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "user",
+            "type": "pubkey"
+          },
+          {
+            "name": "amount",
+            "type": "u64"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          },
+          {
+            "name": "total_claimed",
+            "type": "u64"
+          },
+          {
+            "name": "total_cashback_earned",
+            "type": "u64"
           }
         ]
       }
@@ -6022,6 +6260,10 @@
           {
             "name": "is_mayhem_mode",
             "type": "bool"
+          },
+          {
+            "name": "is_cashback_enabled",
+            "type": "bool"
           }
         ]
       }
@@ -6270,6 +6512,10 @@
                 7
               ]
             }
+          },
+          {
+            "name": "is_cashback_enabled",
+            "type": "bool"
           }
         ]
       }
@@ -6728,6 +6974,14 @@
           {
             "name": "mayhem_mode",
             "type": "bool"
+          },
+          {
+            "name": "cashback_fee_basis_points",
+            "type": "u64"
+          },
+          {
+            "name": "cashback",
+            "type": "u64"
           }
         ]
       }
@@ -6828,6 +7082,14 @@
           {
             "name": "has_total_claimed_tokens",
             "type": "bool"
+          },
+          {
+            "name": "cashback_earned",
+            "type": "u64"
+          },
+          {
+            "name": "total_cashback_claimed",
+            "type": "u64"
           }
         ]
       }