@pump-fun/pump-sdk 1.17.2 → 1.17.4

package/README.md

@@ -1 +1,103 @@
 # Pump SDK
+
+Official Pump program SDK
+
+```Typescript
+const connection = new Connection(
+    "https://api.devnet.solana.com",
+    "confirmed",
+);
+const sdk = new PumpSdk(connection);
+```
+
+## Coin creation
+
+```Typescript
+const mint = PublicKey.unique();
+const creator = PublicKey.unique();
+const user = PublicKey.unique();
+
+const instruction = await sdk.createInstruction({
+    mint,
+    name: "name",
+    symbol: "symbol",
+    uri: "uri",
+    creator,
+    user,
+});
+
+// or creating and buying instructions in the same tx
+
+const global = await sdk.fetchGlobal();
+const solAmount = new BN(0.1 * 10 ** 9); // 0.1 SOL
+
+const instructions = await sdk.createAndBuyInstructions({
+    global,
+    mint,
+    name: "name",
+    symbol: "symbol",
+    uri: "uri",
+    creator,
+    user,
+    solAmount,
+    amount: getBuyTokenAmountFromSolAmount(global, null, solAmount),
+});
+```
+
+## Buying coins
+
+```Typescript
+const mint = PublicKey.unique();
+const user = PublicKey.unique();
+
+const global = await sdk.fetchGlobal();
+const { bondingCurveAccountInfo, bondingCurve, associatedUserAccountInfo } =
+    await sdk.fetchBuyState(mint, user);
+const solAmount = new BN(0.1 * 10 ** 9); // 0.1 SOL
+
+const instructions = await sdk.buyInstructions({
+    global,
+    bondingCurveAccountInfo,
+    bondingCurve,
+    associatedUserAccountInfo,
+    mint,
+    user,
+    solAmount,
+    amount: getBuyTokenAmountFromSolAmount(global, bondingCurve, solAmount),
+    slippage: 1,
+});
+```
+
+## Selling coins
+
+```Typescript
+const mint = PublicKey.unique();
+const user = PublicKey.unique();
+
+const global = await sdk.fetchGlobal();
+const { bondingCurveAccountInfo, bondingCurve } = await sdk.fetchSellState(mint, user);
+const amount = new BN(15_828);
+
+const instructions = await sdk.sellInstructions({
+    global,
+    bondingCurveAccountInfo,
+    bondingCurve,
+    mint,
+    user,
+    amount,
+    solAmount: getSellSolAmountFromTokenAmount(global, bondingCurve, amount),
+    slippage: 1,
+});
+```
+
+## Creator fees
+
+```Typescript
+const user = PublicKey.unique();
+
+// Getting total accumulated creator fees for both Pump and PumpSwap programs
+console.log((await sdk.getCreatorVaultBalanceBothPrograms(user)).toString());
+
+// Collecting creator fees instructions
+const instructions = await sdk.collectCoinCreatorFeeInstructions(user);
+```

package/dist/esm/index.js

@@ -5054,6 +5054,11 @@ var PumpSdk = class {
     }
     return new BN3(accountInfo.lamports - rentExemptionLamports);
   }
+  async getCreatorVaultBalanceBothPrograms(creator) {
+    const balance = await this.getCreatorVaultBalance(creator);
+    const ammBalance = await this.pumpAmmSdk.getCoinCreatorVaultBalance(creator);
+    return balance.add(ammBalance);
+  }
   async adminUpdateTokenIncentives(startTime, endTime, dayNumber, tokenSupplyPerDay, secondsInADay = new BN3(86400), mint = PUMP_TOKEN_MINT, tokenProgram = TOKEN_2022_PROGRAM_ID) {
     const { authority } = await this.fetchGlobal();
     return await this.offlinePumpProgram.methods.adminUpdateTokenIncentives(

package/dist/index.d.mts

@@ -9186,6 +9186,7 @@ declare class PumpSdk {
     collectCoinCreatorFeeInstructions(coinCreator: PublicKey): Promise<TransactionInstruction[]>;
     adminSetCoinCreatorInstructions(newCoinCreator: PublicKey, mint: PublicKey): Promise<TransactionInstruction[]>;
     getCreatorVaultBalance(creator: PublicKey): Promise<BN>;
+    getCreatorVaultBalanceBothPrograms(creator: PublicKey): Promise<BN>;
     adminUpdateTokenIncentives(startTime: BN, endTime: BN, dayNumber: BN, tokenSupplyPerDay: BN, secondsInADay?: BN, mint?: PublicKey, tokenProgram?: PublicKey): Promise<TransactionInstruction>;
     adminUpdateTokenIncentivesBothPrograms(startTime: BN, endTime: BN, dayNumber: BN, tokenSupplyPerDay: BN, secondsInADay?: BN, mint?: PublicKey, tokenProgram?: PublicKey): Promise<TransactionInstruction[]>;
     claimTokenIncentives(user: PublicKey, payer: PublicKey): Promise<TransactionInstruction[]>;

package/dist/index.d.ts

@@ -9186,6 +9186,7 @@ declare class PumpSdk {
     collectCoinCreatorFeeInstructions(coinCreator: PublicKey): Promise<TransactionInstruction[]>;
     adminSetCoinCreatorInstructions(newCoinCreator: PublicKey, mint: PublicKey): Promise<TransactionInstruction[]>;
     getCreatorVaultBalance(creator: PublicKey): Promise<BN>;
+    getCreatorVaultBalanceBothPrograms(creator: PublicKey): Promise<BN>;
     adminUpdateTokenIncentives(startTime: BN, endTime: BN, dayNumber: BN, tokenSupplyPerDay: BN, secondsInADay?: BN, mint?: PublicKey, tokenProgram?: PublicKey): Promise<TransactionInstruction>;
     adminUpdateTokenIncentivesBothPrograms(startTime: BN, endTime: BN, dayNumber: BN, tokenSupplyPerDay: BN, secondsInADay?: BN, mint?: PublicKey, tokenProgram?: PublicKey): Promise<TransactionInstruction[]>;
     claimTokenIncentives(user: PublicKey, payer: PublicKey): Promise<TransactionInstruction[]>;

package/dist/index.js

@@ -5104,6 +5104,11 @@ var PumpSdk = class {
     }
     return new import_bn3.default(accountInfo.lamports - rentExemptionLamports);
   }
+  async getCreatorVaultBalanceBothPrograms(creator) {
+    const balance = await this.getCreatorVaultBalance(creator);
+    const ammBalance = await this.pumpAmmSdk.getCoinCreatorVaultBalance(creator);
+    return balance.add(ammBalance);
+  }
   async adminUpdateTokenIncentives(startTime, endTime, dayNumber, tokenSupplyPerDay, secondsInADay = new import_bn3.default(86400), mint = PUMP_TOKEN_MINT, tokenProgram = import_spl_token.TOKEN_2022_PROGRAM_ID) {
     const { authority } = await this.fetchGlobal();
     return await this.offlinePumpProgram.methods.adminUpdateTokenIncentives(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pump-fun/pump-sdk",
-  "version": "1.17.2",
+  "version": "1.17.4",
   "description": "Pump Bonding Curve SDK",
   "keywords": [],
   "homepage": "https://github.com/pump-fun/pump-sdk#readme",

package/src/sdk.ts

@@ -532,6 +532,13 @@ export class PumpSdk {
     return new BN(accountInfo.lamports - rentExemptionLamports);
   }
 
+  async getCreatorVaultBalanceBothPrograms(creator: PublicKey): Promise<BN> {
+    const balance = await this.getCreatorVaultBalance(creator);
+    const ammBalance =
+      await this.pumpAmmSdk.getCoinCreatorVaultBalance(creator);
+    return balance.add(ammBalance);
+  }
+
   async adminUpdateTokenIncentives(
     startTime: BN,
     endTime: BN,