pump-kit 0.2.4 → 0.2.5

package/dist/types/pumpsdk/generated/programs/pump.d.ts

@@ -6,14 +6,15 @@
  * @see https://github.com/codama-idl/codama
  */
 import { type Address, type ReadonlyUint8Array } from '@solana/kit';
-import { type ParsedAdminSetCreatorInstruction, type ParsedAdminSetIdlAuthorityInstruction, type ParsedAdminUpdateTokenIncentivesInstruction, type ParsedBuyExactSolInInstruction, type ParsedBuyInstruction, type ParsedClaimTokenIncentivesInstruction, type ParsedCloseUserVolumeAccumulatorInstruction, type ParsedCollectCreatorFeeInstruction, type ParsedCreateInstruction, type ParsedExtendAccountInstruction, type ParsedInitializeInstruction, type ParsedInitUserVolumeAccumulatorInstruction, type ParsedMigrateInstruction, type ParsedSellInstruction, type ParsedSetCreatorInstruction, type ParsedSetMetaplexCreatorInstruction, type ParsedSetParamsInstruction, type ParsedSyncUserVolumeAccumulatorInstruction, type ParsedUpdateGlobalAuthorityInstruction } from '../instructions';
+import { type ParsedAdminSetCreatorInstruction, type ParsedAdminSetIdlAuthorityInstruction, type ParsedAdminUpdateTokenIncentivesInstruction, type ParsedBuyExactSolInInstruction, type ParsedBuyInstruction, type ParsedClaimCashbackInstruction, type ParsedClaimTokenIncentivesInstruction, type ParsedCloseUserVolumeAccumulatorInstruction, type ParsedCollectCreatorFeeInstruction, type ParsedCreateInstruction, type ParsedCreateV2Instruction, type ParsedDistributeCreatorFeesInstruction, type ParsedExtendAccountInstruction, type ParsedGetMinimumDistributableFeeInstruction, type ParsedInitializeInstruction, type ParsedInitUserVolumeAccumulatorInstruction, type ParsedMigrateBondingCurveCreatorInstruction, type ParsedMigrateInstruction, type ParsedSellInstruction, type ParsedSetCreatorInstruction, type ParsedSetMayhemVirtualParamsInstruction, type ParsedSetMetaplexCreatorInstruction, type ParsedSetParamsInstruction, type ParsedSetReservedFeeRecipientsInstruction, type ParsedSyncUserVolumeAccumulatorInstruction, type ParsedToggleCashbackEnabledInstruction, type ParsedToggleCreateV2Instruction, type ParsedToggleMayhemModeInstruction, type ParsedUpdateGlobalAuthorityInstruction } from '../instructions';
 export declare const PUMP_PROGRAM_ADDRESS: Address<"6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P">;
 export declare enum PumpAccount {
     BondingCurve = 0,
     FeeConfig = 1,
     Global = 2,
     GlobalVolumeAccumulator = 3,
-    UserVolumeAccumulator = 4
+    SharingConfig = 4,
+    UserVolumeAccumulator = 5
 }
 export declare function identifyPumpAccount(account: {
     data: ReadonlyUint8Array;
@@ -24,20 +25,30 @@ export declare enum PumpInstruction {
     AdminUpdateTokenIncentives = 2,
     Buy = 3,
     BuyExactSolIn = 4,
-    ClaimTokenIncentives = 5,
-    CloseUserVolumeAccumulator = 6,
-    CollectCreatorFee = 7,
-    Create = 8,
-    ExtendAccount = 9,
-    InitUserVolumeAccumulator = 10,
-    Initialize = 11,
-    Migrate = 12,
-    Sell = 13,
-    SetCreator = 14,
-    SetMetaplexCreator = 15,
-    SetParams = 16,
-    SyncUserVolumeAccumulator = 17,
-    UpdateGlobalAuthority = 18
+    ClaimCashback = 5,
+    ClaimTokenIncentives = 6,
+    CloseUserVolumeAccumulator = 7,
+    CollectCreatorFee = 8,
+    Create = 9,
+    CreateV2 = 10,
+    DistributeCreatorFees = 11,
+    ExtendAccount = 12,
+    GetMinimumDistributableFee = 13,
+    InitUserVolumeAccumulator = 14,
+    Initialize = 15,
+    Migrate = 16,
+    MigrateBondingCurveCreator = 17,
+    Sell = 18,
+    SetCreator = 19,
+    SetMayhemVirtualParams = 20,
+    SetMetaplexCreator = 21,
+    SetParams = 22,
+    SetReservedFeeRecipients = 23,
+    SyncUserVolumeAccumulator = 24,
+    ToggleCashbackEnabled = 25,
+    ToggleCreateV2 = 26,
+    ToggleMayhemMode = 27,
+    UpdateGlobalAuthority = 28
 }
 export declare function identifyPumpInstruction(instruction: {
     data: ReadonlyUint8Array;
@@ -53,6 +64,8 @@ export type ParsedPumpInstruction<TProgram extends string = '6EF8rrecthR5Dkzon8N
 } & ParsedBuyInstruction<TProgram>) | ({
     instructionType: PumpInstruction.BuyExactSolIn;
 } & ParsedBuyExactSolInInstruction<TProgram>) | ({
+    instructionType: PumpInstruction.ClaimCashback;
+} & ParsedClaimCashbackInstruction<TProgram>) | ({
     instructionType: PumpInstruction.ClaimTokenIncentives;
 } & ParsedClaimTokenIncentivesInstruction<TProgram>) | ({
     instructionType: PumpInstruction.CloseUserVolumeAccumulator;
@@ -61,23 +74,41 @@ export type ParsedPumpInstruction<TProgram extends string = '6EF8rrecthR5Dkzon8N
 } & ParsedCollectCreatorFeeInstruction<TProgram>) | ({
     instructionType: PumpInstruction.Create;
 } & ParsedCreateInstruction<TProgram>) | ({
+    instructionType: PumpInstruction.CreateV2;
+} & ParsedCreateV2Instruction<TProgram>) | ({
+    instructionType: PumpInstruction.DistributeCreatorFees;
+} & ParsedDistributeCreatorFeesInstruction<TProgram>) | ({
     instructionType: PumpInstruction.ExtendAccount;
 } & ParsedExtendAccountInstruction<TProgram>) | ({
+    instructionType: PumpInstruction.GetMinimumDistributableFee;
+} & ParsedGetMinimumDistributableFeeInstruction<TProgram>) | ({
     instructionType: PumpInstruction.InitUserVolumeAccumulator;
 } & ParsedInitUserVolumeAccumulatorInstruction<TProgram>) | ({
     instructionType: PumpInstruction.Initialize;
 } & ParsedInitializeInstruction<TProgram>) | ({
     instructionType: PumpInstruction.Migrate;
 } & ParsedMigrateInstruction<TProgram>) | ({
+    instructionType: PumpInstruction.MigrateBondingCurveCreator;
+} & ParsedMigrateBondingCurveCreatorInstruction<TProgram>) | ({
     instructionType: PumpInstruction.Sell;
 } & ParsedSellInstruction<TProgram>) | ({
     instructionType: PumpInstruction.SetCreator;
 } & ParsedSetCreatorInstruction<TProgram>) | ({
+    instructionType: PumpInstruction.SetMayhemVirtualParams;
+} & ParsedSetMayhemVirtualParamsInstruction<TProgram>) | ({
     instructionType: PumpInstruction.SetMetaplexCreator;
 } & ParsedSetMetaplexCreatorInstruction<TProgram>) | ({
     instructionType: PumpInstruction.SetParams;
 } & ParsedSetParamsInstruction<TProgram>) | ({
+    instructionType: PumpInstruction.SetReservedFeeRecipients;
+} & ParsedSetReservedFeeRecipientsInstruction<TProgram>) | ({
     instructionType: PumpInstruction.SyncUserVolumeAccumulator;
 } & ParsedSyncUserVolumeAccumulatorInstruction<TProgram>) | ({
+    instructionType: PumpInstruction.ToggleCashbackEnabled;
+} & ParsedToggleCashbackEnabledInstruction<TProgram>) | ({
+    instructionType: PumpInstruction.ToggleCreateV2;
+} & ParsedToggleCreateV2Instruction<TProgram>) | ({
+    instructionType: PumpInstruction.ToggleMayhemMode;
+} & ParsedToggleMayhemModeInstruction<TProgram>) | ({
     instructionType: PumpInstruction.UpdateGlobalAuthority;
 } & ParsedUpdateGlobalAuthorityInstruction<TProgram>);

package/dist/types/pumpsdk/generated/types/claimCashbackEvent.d.ts

@@ -0,0 +1,25 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export type ClaimCashbackEvent = {
+    user: Address;
+    amount: bigint;
+    timestamp: bigint;
+    totalClaimed: bigint;
+    totalCashbackEarned: bigint;
+};
+export type ClaimCashbackEventArgs = {
+    user: Address;
+    amount: number | bigint;
+    timestamp: number | bigint;
+    totalClaimed: number | bigint;
+    totalCashbackEarned: number | bigint;
+};
+export declare function getClaimCashbackEventEncoder(): FixedSizeEncoder<ClaimCashbackEventArgs>;
+export declare function getClaimCashbackEventDecoder(): FixedSizeDecoder<ClaimCashbackEvent>;
+export declare function getClaimCashbackEventCodec(): FixedSizeCodec<ClaimCashbackEventArgs, ClaimCashbackEvent>;

package/dist/types/pumpsdk/generated/types/configStatus.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export declare enum ConfigStatus {
+    Paused = 0,
+    Active = 1
+}
+export type ConfigStatusArgs = ConfigStatus;
+export declare function getConfigStatusEncoder(): FixedSizeEncoder<ConfigStatusArgs>;
+export declare function getConfigStatusDecoder(): FixedSizeDecoder<ConfigStatus>;
+export declare function getConfigStatusCodec(): FixedSizeCodec<ConfigStatusArgs, ConfigStatus>;

package/dist/types/pumpsdk/generated/types/createEvent.d.ts

@@ -19,6 +19,9 @@ export type CreateEvent = {
     virtualSolReserves: bigint;
     realTokenReserves: bigint;
     tokenTotalSupply: bigint;
+    tokenProgram: Address;
+    isMayhemMode: boolean;
+    isCashbackEnabled: boolean;
 };
 export type CreateEventArgs = {
     name: string;
@@ -33,6 +36,9 @@ export type CreateEventArgs = {
     virtualSolReserves: number | bigint;
     realTokenReserves: number | bigint;
     tokenTotalSupply: number | bigint;
+    tokenProgram: Address;
+    isMayhemMode: boolean;
+    isCashbackEnabled: boolean;
 };
 export declare function getCreateEventEncoder(): Encoder<CreateEventArgs>;
 export declare function getCreateEventDecoder(): Decoder<CreateEvent>;

package/dist/types/pumpsdk/generated/types/distributeCreatorFeesEvent.d.ts

@@ -0,0 +1,30 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type Codec, type Decoder, type Encoder } from '@solana/kit';
+import { type Shareholder, type ShareholderArgs } from '.';
+export type DistributeCreatorFeesEvent = {
+    timestamp: bigint;
+    mint: Address;
+    bondingCurve: Address;
+    sharingConfig: Address;
+    admin: Address;
+    shareholders: Array<Shareholder>;
+    distributed: bigint;
+};
+export type DistributeCreatorFeesEventArgs = {
+    timestamp: number | bigint;
+    mint: Address;
+    bondingCurve: Address;
+    sharingConfig: Address;
+    admin: Address;
+    shareholders: Array<ShareholderArgs>;
+    distributed: number | bigint;
+};
+export declare function getDistributeCreatorFeesEventEncoder(): Encoder<DistributeCreatorFeesEventArgs>;
+export declare function getDistributeCreatorFeesEventDecoder(): Decoder<DistributeCreatorFeesEvent>;
+export declare function getDistributeCreatorFeesEventCodec(): Codec<DistributeCreatorFeesEventArgs, DistributeCreatorFeesEvent>;

package/dist/types/pumpsdk/generated/types/index.d.ts

@@ -8,20 +8,28 @@
 export * from './adminSetCreatorEvent';
 export * from './adminSetIdlAuthorityEvent';
 export * from './adminUpdateTokenIncentivesEvent';
+export * from './claimCashbackEvent';
 export * from './claimTokenIncentivesEvent';
 export * from './closeUserVolumeAccumulatorEvent';
 export * from './collectCreatorFeeEvent';
 export * from './completeEvent';
 export * from './completePumpAmmMigrationEvent';
+export * from './configStatus';
 export * from './createEvent';
+export * from './distributeCreatorFeesEvent';
 export * from './extendAccountEvent';
 export * from './fees';
 export * from './feeTier';
 export * from './initUserVolumeAccumulatorEvent';
+export * from './migrateBondingCurveCreatorEvent';
+export * from './minimumDistributableFeeEvent';
 export * from './optionBool';
+export * from './reservedFeeRecipientsEvent';
 export * from './setCreatorEvent';
 export * from './setMetaplexCreatorEvent';
 export * from './setParamsEvent';
+export * from './shareholder';
 export * from './syncUserVolumeAccumulatorEvent';
 export * from './tradeEvent';
 export * from './updateGlobalAuthorityEvent';
+export * from './updateMayhemVirtualParamsEvent';

package/dist/types/pumpsdk/generated/types/migrateBondingCurveCreatorEvent.d.ts

@@ -0,0 +1,27 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export type MigrateBondingCurveCreatorEvent = {
+    timestamp: bigint;
+    mint: Address;
+    bondingCurve: Address;
+    sharingConfig: Address;
+    oldCreator: Address;
+    newCreator: Address;
+};
+export type MigrateBondingCurveCreatorEventArgs = {
+    timestamp: number | bigint;
+    mint: Address;
+    bondingCurve: Address;
+    sharingConfig: Address;
+    oldCreator: Address;
+    newCreator: Address;
+};
+export declare function getMigrateBondingCurveCreatorEventEncoder(): FixedSizeEncoder<MigrateBondingCurveCreatorEventArgs>;
+export declare function getMigrateBondingCurveCreatorEventDecoder(): FixedSizeDecoder<MigrateBondingCurveCreatorEvent>;
+export declare function getMigrateBondingCurveCreatorEventCodec(): FixedSizeCodec<MigrateBondingCurveCreatorEventArgs, MigrateBondingCurveCreatorEvent>;

package/dist/types/pumpsdk/generated/types/minimumDistributableFeeEvent.d.ts

@@ -0,0 +1,21 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export type MinimumDistributableFeeEvent = {
+    minimumRequired: bigint;
+    distributableFees: bigint;
+    canDistribute: boolean;
+};
+export type MinimumDistributableFeeEventArgs = {
+    minimumRequired: number | bigint;
+    distributableFees: number | bigint;
+    canDistribute: boolean;
+};
+export declare function getMinimumDistributableFeeEventEncoder(): FixedSizeEncoder<MinimumDistributableFeeEventArgs>;
+export declare function getMinimumDistributableFeeEventDecoder(): FixedSizeDecoder<MinimumDistributableFeeEvent>;
+export declare function getMinimumDistributableFeeEventCodec(): FixedSizeCodec<MinimumDistributableFeeEventArgs, MinimumDistributableFeeEvent>;

package/dist/types/pumpsdk/generated/types/reservedFeeRecipientsEvent.d.ts

@@ -0,0 +1,21 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export type ReservedFeeRecipientsEvent = {
+    timestamp: bigint;
+    reservedFeeRecipient: Address;
+    reservedFeeRecipients: Array<Address>;
+};
+export type ReservedFeeRecipientsEventArgs = {
+    timestamp: number | bigint;
+    reservedFeeRecipient: Address;
+    reservedFeeRecipients: Array<Address>;
+};
+export declare function getReservedFeeRecipientsEventEncoder(): FixedSizeEncoder<ReservedFeeRecipientsEventArgs>;
+export declare function getReservedFeeRecipientsEventDecoder(): FixedSizeDecoder<ReservedFeeRecipientsEvent>;
+export declare function getReservedFeeRecipientsEventCodec(): FixedSizeCodec<ReservedFeeRecipientsEventArgs, ReservedFeeRecipientsEvent>;

package/dist/types/pumpsdk/generated/types/shareholder.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export type Shareholder = {
+    address: Address;
+    shareBps: number;
+};
+export type ShareholderArgs = Shareholder;
+export declare function getShareholderEncoder(): FixedSizeEncoder<ShareholderArgs>;
+export declare function getShareholderDecoder(): FixedSizeDecoder<Shareholder>;
+export declare function getShareholderCodec(): FixedSizeCodec<ShareholderArgs, Shareholder>;

package/dist/types/pumpsdk/generated/types/tradeEvent.d.ts

@@ -30,6 +30,9 @@ export type TradeEvent = {
     currentSolVolume: bigint;
     lastUpdateTimestamp: bigint;
     ixName: string;
+    mayhemMode: boolean;
+    cashbackFeeBasisPoints: bigint;
+    cashback: bigint;
 };
 export type TradeEventArgs = {
     mint: Address;
@@ -54,6 +57,9 @@ export type TradeEventArgs = {
     currentSolVolume: number | bigint;
     lastUpdateTimestamp: number | bigint;
     ixName: string;
+    mayhemMode: boolean;
+    cashbackFeeBasisPoints: number | bigint;
+    cashback: number | bigint;
 };
 export declare function getTradeEventEncoder(): Encoder<TradeEventArgs>;
 export declare function getTradeEventDecoder(): Decoder<TradeEvent>;

package/dist/types/pumpsdk/generated/types/updateMayhemVirtualParamsEvent.d.ts

@@ -0,0 +1,31 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export type UpdateMayhemVirtualParamsEvent = {
+    timestamp: bigint;
+    mint: Address;
+    virtualTokenReserves: bigint;
+    virtualSolReserves: bigint;
+    newVirtualTokenReserves: bigint;
+    newVirtualSolReserves: bigint;
+    realTokenReserves: bigint;
+    realSolReserves: bigint;
+};
+export type UpdateMayhemVirtualParamsEventArgs = {
+    timestamp: number | bigint;
+    mint: Address;
+    virtualTokenReserves: number | bigint;
+    virtualSolReserves: number | bigint;
+    newVirtualTokenReserves: number | bigint;
+    newVirtualSolReserves: number | bigint;
+    realTokenReserves: number | bigint;
+    realSolReserves: number | bigint;
+};
+export declare function getUpdateMayhemVirtualParamsEventEncoder(): FixedSizeEncoder<UpdateMayhemVirtualParamsEventArgs>;
+export declare function getUpdateMayhemVirtualParamsEventDecoder(): FixedSizeDecoder<UpdateMayhemVirtualParamsEvent>;
+export declare function getUpdateMayhemVirtualParamsEventCodec(): FixedSizeCodec<UpdateMayhemVirtualParamsEventArgs, UpdateMayhemVirtualParamsEvent>;

package/llms.txt

@@ -0,0 +1,24 @@
+# pump-kit
+> TypeScript SDK for Pump.fun built on Solana Kit 6.
+
+Canonical docs: `README.md`
+Testing guide: `TESTING.md`
+WSOL guide: `WRAPPING.md`
+Machine-readable action registry: `metadata/actions-registry.json`
+
+Entry points:
+- `pump-kit` (full API)
+- `pump-kit/simple` (minimal API)
+
+Agent integration notes:
+- Pass slippage in basis points (`slippageBps`), not percent.
+- For swap helpers, use either explicit lamport limits or estimate+`slippageBps` mode; do not mix modes.
+- JSON transports should encode bigint values as decimal strings and cast with `BigInt(...)` before calling SDK functions.
+- Provide `bondingCurveCreator`/`poolCreator` when known to avoid extra RPC lookups.
+
+High-value actions:
+- `curveBuy`, `curveSell`
+- `ammBuy`, `ammSell`
+- `addLiquidity`, `removeLiquidity`
+- `mintWithFirstBuy`, `createAndBuy`
+- `buildTransaction`, `sendAndConfirmTransaction`, `simulateTransaction`