pump-kit 0.0.1

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

@@ -0,0 +1,20 @@
+/**
+ * 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';
+import { type Fees, type FeesArgs } from '.';
+export type FeeTier = {
+    marketCapLamportsThreshold: bigint;
+    fees: Fees;
+};
+export type FeeTierArgs = {
+    marketCapLamportsThreshold: number | bigint;
+    fees: FeesArgs;
+};
+export declare function getFeeTierEncoder(): FixedSizeEncoder<FeeTierArgs>;
+export declare function getFeeTierDecoder(): FixedSizeDecoder<FeeTier>;
+export declare function getFeeTierCodec(): FixedSizeCodec<FeeTierArgs, FeeTier>;

package/dist/types/pumpsdk/generated/types/fees.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 Fees = {
+    lpFeeBps: bigint;
+    protocolFeeBps: bigint;
+    creatorFeeBps: bigint;
+};
+export type FeesArgs = {
+    lpFeeBps: number | bigint;
+    protocolFeeBps: number | bigint;
+    creatorFeeBps: number | bigint;
+};
+export declare function getFeesEncoder(): FixedSizeEncoder<FeesArgs>;
+export declare function getFeesDecoder(): FixedSizeDecoder<Fees>;
+export declare function getFeesCodec(): FixedSizeCodec<FeesArgs, Fees>;

package/dist/types/pumpsdk/generated/types/index.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
+ */
+export * from './adminSetCreatorEvent';
+export * from './adminSetIdlAuthorityEvent';
+export * from './adminUpdateTokenIncentivesEvent';
+export * from './claimTokenIncentivesEvent';
+export * from './closeUserVolumeAccumulatorEvent';
+export * from './collectCreatorFeeEvent';
+export * from './completeEvent';
+export * from './completePumpAmmMigrationEvent';
+export * from './createEvent';
+export * from './extendAccountEvent';
+export * from './fees';
+export * from './feeTier';
+export * from './initUserVolumeAccumulatorEvent';
+export * from './optionBool';
+export * from './setCreatorEvent';
+export * from './setMetaplexCreatorEvent';
+export * from './setParamsEvent';
+export * from './syncUserVolumeAccumulatorEvent';
+export * from './tradeEvent';
+export * from './updateGlobalAuthorityEvent';

package/dist/types/pumpsdk/generated/types/initUserVolumeAccumulatorEvent.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 InitUserVolumeAccumulatorEvent = {
+    payer: Address;
+    user: Address;
+    timestamp: bigint;
+};
+export type InitUserVolumeAccumulatorEventArgs = {
+    payer: Address;
+    user: Address;
+    timestamp: number | bigint;
+};
+export declare function getInitUserVolumeAccumulatorEventEncoder(): FixedSizeEncoder<InitUserVolumeAccumulatorEventArgs>;
+export declare function getInitUserVolumeAccumulatorEventDecoder(): FixedSizeDecoder<InitUserVolumeAccumulatorEvent>;
+export declare function getInitUserVolumeAccumulatorEventCodec(): FixedSizeCodec<InitUserVolumeAccumulatorEventArgs, InitUserVolumeAccumulatorEvent>;

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

@@ -0,0 +1,13 @@
+/**
+ * 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 OptionBool = readonly [boolean];
+export type OptionBoolArgs = OptionBool;
+export declare function getOptionBoolEncoder(): FixedSizeEncoder<OptionBoolArgs>;
+export declare function getOptionBoolDecoder(): FixedSizeDecoder<OptionBool>;
+export declare function getOptionBoolCodec(): FixedSizeCodec<OptionBoolArgs, OptionBool>;

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

@@ -0,0 +1,23 @@
+/**
+ * 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 SetCreatorEvent = {
+    timestamp: bigint;
+    mint: Address;
+    bondingCurve: Address;
+    creator: Address;
+};
+export type SetCreatorEventArgs = {
+    timestamp: number | bigint;
+    mint: Address;
+    bondingCurve: Address;
+    creator: Address;
+};
+export declare function getSetCreatorEventEncoder(): FixedSizeEncoder<SetCreatorEventArgs>;
+export declare function getSetCreatorEventDecoder(): FixedSizeDecoder<SetCreatorEvent>;
+export declare function getSetCreatorEventCodec(): FixedSizeCodec<SetCreatorEventArgs, SetCreatorEvent>;

package/dist/types/pumpsdk/generated/types/setMetaplexCreatorEvent.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 SetMetaplexCreatorEvent = {
+    timestamp: bigint;
+    mint: Address;
+    bondingCurve: Address;
+    metadata: Address;
+    creator: Address;
+};
+export type SetMetaplexCreatorEventArgs = {
+    timestamp: number | bigint;
+    mint: Address;
+    bondingCurve: Address;
+    metadata: Address;
+    creator: Address;
+};
+export declare function getSetMetaplexCreatorEventEncoder(): FixedSizeEncoder<SetMetaplexCreatorEventArgs>;
+export declare function getSetMetaplexCreatorEventDecoder(): FixedSizeDecoder<SetMetaplexCreatorEvent>;
+export declare function getSetMetaplexCreatorEventCodec(): FixedSizeCodec<SetMetaplexCreatorEventArgs, SetMetaplexCreatorEvent>;

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

@@ -0,0 +1,43 @@
+/**
+ * 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 SetParamsEvent = {
+    initialVirtualTokenReserves: bigint;
+    initialVirtualSolReserves: bigint;
+    initialRealTokenReserves: bigint;
+    finalRealSolReserves: bigint;
+    tokenTotalSupply: bigint;
+    feeBasisPoints: bigint;
+    withdrawAuthority: Address;
+    enableMigrate: boolean;
+    poolMigrationFee: bigint;
+    creatorFeeBasisPoints: bigint;
+    feeRecipients: Array<Address>;
+    timestamp: bigint;
+    setCreatorAuthority: Address;
+    adminSetCreatorAuthority: Address;
+};
+export type SetParamsEventArgs = {
+    initialVirtualTokenReserves: number | bigint;
+    initialVirtualSolReserves: number | bigint;
+    initialRealTokenReserves: number | bigint;
+    finalRealSolReserves: number | bigint;
+    tokenTotalSupply: number | bigint;
+    feeBasisPoints: number | bigint;
+    withdrawAuthority: Address;
+    enableMigrate: boolean;
+    poolMigrationFee: number | bigint;
+    creatorFeeBasisPoints: number | bigint;
+    feeRecipients: Array<Address>;
+    timestamp: number | bigint;
+    setCreatorAuthority: Address;
+    adminSetCreatorAuthority: Address;
+};
+export declare function getSetParamsEventEncoder(): FixedSizeEncoder<SetParamsEventArgs>;
+export declare function getSetParamsEventDecoder(): FixedSizeDecoder<SetParamsEvent>;
+export declare function getSetParamsEventCodec(): FixedSizeCodec<SetParamsEventArgs, SetParamsEvent>;

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

@@ -0,0 +1,23 @@
+/**
+ * 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 SyncUserVolumeAccumulatorEvent = {
+    user: Address;
+    totalClaimedTokensBefore: bigint;
+    totalClaimedTokensAfter: bigint;
+    timestamp: bigint;
+};
+export type SyncUserVolumeAccumulatorEventArgs = {
+    user: Address;
+    totalClaimedTokensBefore: number | bigint;
+    totalClaimedTokensAfter: number | bigint;
+    timestamp: number | bigint;
+};
+export declare function getSyncUserVolumeAccumulatorEventEncoder(): FixedSizeEncoder<SyncUserVolumeAccumulatorEventArgs>;
+export declare function getSyncUserVolumeAccumulatorEventDecoder(): FixedSizeDecoder<SyncUserVolumeAccumulatorEvent>;
+export declare function getSyncUserVolumeAccumulatorEventCodec(): FixedSizeCodec<SyncUserVolumeAccumulatorEventArgs, SyncUserVolumeAccumulatorEvent>;

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

@@ -0,0 +1,60 @@
+/**
+ * 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';
+/** ix_name: "buy" | "sell" | "buy_exact_sol_in" */
+export type TradeEvent = {
+    mint: Address;
+    solAmount: bigint;
+    tokenAmount: bigint;
+    isBuy: boolean;
+    user: Address;
+    timestamp: bigint;
+    virtualSolReserves: bigint;
+    virtualTokenReserves: bigint;
+    realSolReserves: bigint;
+    realTokenReserves: bigint;
+    feeRecipient: Address;
+    feeBasisPoints: bigint;
+    fee: bigint;
+    creator: Address;
+    creatorFeeBasisPoints: bigint;
+    creatorFee: bigint;
+    trackVolume: boolean;
+    totalUnclaimedTokens: bigint;
+    totalClaimedTokens: bigint;
+    currentSolVolume: bigint;
+    lastUpdateTimestamp: bigint;
+    ixName: string;
+};
+export type TradeEventArgs = {
+    mint: Address;
+    solAmount: number | bigint;
+    tokenAmount: number | bigint;
+    isBuy: boolean;
+    user: Address;
+    timestamp: number | bigint;
+    virtualSolReserves: number | bigint;
+    virtualTokenReserves: number | bigint;
+    realSolReserves: number | bigint;
+    realTokenReserves: number | bigint;
+    feeRecipient: Address;
+    feeBasisPoints: number | bigint;
+    fee: number | bigint;
+    creator: Address;
+    creatorFeeBasisPoints: number | bigint;
+    creatorFee: number | bigint;
+    trackVolume: boolean;
+    totalUnclaimedTokens: number | bigint;
+    totalClaimedTokens: number | bigint;
+    currentSolVolume: number | bigint;
+    lastUpdateTimestamp: number | bigint;
+    ixName: string;
+};
+export declare function getTradeEventEncoder(): Encoder<TradeEventArgs>;
+export declare function getTradeEventDecoder(): Decoder<TradeEvent>;
+export declare function getTradeEventCodec(): Codec<TradeEventArgs, TradeEvent>;

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

@@ -0,0 +1,23 @@
+/**
+ * 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 UpdateGlobalAuthorityEvent = {
+    global: Address;
+    authority: Address;
+    newAuthority: Address;
+    timestamp: bigint;
+};
+export type UpdateGlobalAuthorityEventArgs = {
+    global: Address;
+    authority: Address;
+    newAuthority: Address;
+    timestamp: number | bigint;
+};
+export declare function getUpdateGlobalAuthorityEventEncoder(): FixedSizeEncoder<UpdateGlobalAuthorityEventArgs>;
+export declare function getUpdateGlobalAuthorityEventDecoder(): FixedSizeDecoder<UpdateGlobalAuthorityEvent>;
+export declare function getUpdateGlobalAuthorityEventCodec(): FixedSizeCodec<UpdateGlobalAuthorityEventArgs, UpdateGlobalAuthorityEvent>;

package/dist/types/recipes/buy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Buy recipe - purchase tokens from the bonding curve with slippage protection.
+ */
+import type { Address, Instruction, TransactionSigner } from "@solana/kit";
+import { buy as buildBuyInstruction } from "../clients/pump";
+type RpcClient = Parameters<typeof buildBuyInstruction>[0]["rpc"];
+type CommitmentLevel = Parameters<typeof buildBuyInstruction>[0]["commitment"];
+export interface BuyWithSlippageParams {
+    user: TransactionSigner;
+    mint: Address | string;
+    /** Token amount to buy (raw bigint). */
+    tokenAmount: bigint;
+    /** Estimated SOL cost in SOL units. */
+    estimatedSolCostSol: number;
+    /** Slippage tolerance in basis points (default: 50 = 0.5%) */
+    slippageBps?: number;
+    /** Fee recipient address */
+    feeRecipient?: Address | string;
+    /** Optional override to skip fetching the bonding curve account */
+    bondingCurveCreator?: Address | string;
+    /** Whether to track user volume (default true) */
+    trackVolume?: boolean;
+    /** RPC client used to fetch Pump accounts */
+    rpc: RpcClient;
+    /** Optional commitment override */
+    commitment?: CommitmentLevel;
+}
+/**
+ * Build a buy instruction with automatic slippage calculation.
+ * Takes an estimated SOL cost and adds slippage to create the max SOL cost.
+ */
+export declare function buyWithSlippage(params: BuyWithSlippageParams): Promise<Instruction>;
+/**
+ * Simple buy wrapper that takes max SOL cost directly.
+ */
+export interface SimpleBuyParams {
+    user: TransactionSigner;
+    mint: Address | string;
+    tokenAmount: bigint;
+    /** Maximum SOL budget expressed in SOL units. */
+    maxSolCostSol?: number;
+    /** Optional lamport-denominated SOL budget. Takes precedence when provided. */
+    maxSolCostLamports?: bigint;
+    feeRecipient?: Address | string;
+    trackVolume?: boolean;
+    bondingCurveCreator?: Address | string;
+    rpc: RpcClient;
+    commitment?: CommitmentLevel;
+}
+export declare function buySimple(params: SimpleBuyParams): Promise<Instruction>;
+export {};

package/dist/types/recipes/mintFirstBuy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Mint + First Buy recipe - create a new token and make the initial purchase in one transaction.
+ */
+import type { TransactionSigner, Instruction, Address } from "@solana/kit";
+import { buy as buildBuyInstruction } from "../clients/pump";
+export interface MintWithFirstBuyParams {
+    /** User's wallet/signer (will be the creator) */
+    user: TransactionSigner;
+    /** Pre-generated mint keypair/signer */
+    mint: TransactionSigner;
+    /** Mint authority address (usually same as user) */
+    mintAuthority: Address | string;
+    /** Token name */
+    name: string;
+    /** Token symbol */
+    symbol: string;
+    /** Metadata URI (JSON) */
+    uri: string;
+    /** Amount of tokens to buy in the first purchase */
+    firstBuyTokenAmount: bigint;
+    /** Estimated SOL cost for the first buy */
+    estimatedFirstBuyCost: bigint;
+    /** Slippage tolerance in basis points (default: 50 = 0.5%) */
+    slippageBps?: number;
+    /** Fee recipient address */
+    feeRecipient?: Address | string;
+    /** Optional override to skip fetching the bonding curve account */
+    bondingCurveCreator?: Address | string;
+    /** Whether to track user volume for the initial buy (default true) */
+    trackVolume?: boolean;
+    /** RPC client used to fetch Pump accounts */
+    rpc: Parameters<typeof buildBuyInstruction>[0]["rpc"];
+    /** Optional commitment */
+    commitment?: Parameters<typeof buildBuyInstruction>[0]["commitment"];
+}
+/**
+ * Build instructions for minting a new token and making the first purchase.
+ * Returns both create and buy instructions to be included in a single transaction.
+ */
+export declare function mintWithFirstBuy(params: MintWithFirstBuyParams): Promise<{
+    createInstruction: Instruction;
+    buyInstruction: Instruction;
+}>;
+/**
+ * Validate mint creation parameters.
+ */
+export declare function validateMintParams(params: {
+    name: string;
+    symbol: string;
+    uri: string;
+}): void;

package/dist/types/recipes/provideLiquidity.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Provide Liquidity recipe - add liquidity to a Pump AMM pool.
+ */
+import type { TransactionSigner, Instruction } from "@solana/kit";
+export interface ProvideLiquidityParams {
+    /** User's wallet/signer */
+    user: TransactionSigner;
+    /** Base token mint address */
+    baseMint: string;
+    /** Quote token mint address (e.g., SOL, USDC) */
+    quoteMint: string;
+    /** Amount of base tokens to deposit */
+    baseIn: bigint;
+    /** Amount of quote tokens to deposit */
+    quoteIn: bigint;
+    /** Expected LP tokens to receive */
+    estimatedLpOut: bigint;
+    /** Slippage tolerance in basis points (default: 50 = 0.5%) */
+    slippageBps?: number;
+    /** Pool index (for multi-pool support, default: 0) */
+    poolIndex?: number;
+}
+/**
+ * Build a provide liquidity instruction with slippage protection.
+ *
+ * TODO: This needs to be implemented once the AMM client is complete.
+ * The AMM client needs deposit/withdraw instruction builders similar to the pump client.
+ */
+export declare function provideLiquidity(params: ProvideLiquidityParams): Promise<Instruction>;
+/**
+ * Calculate optimal deposit amounts for balanced liquidity provision.
+ * This helps prevent losing value to impermanent loss or price impact.
+ */
+export declare function calculateOptimalDeposit(params: {
+    baseReserve: bigint;
+    quoteReserve: bigint;
+    desiredBase: bigint;
+    desiredQuote: bigint;
+}): {
+    optimalBase: bigint;
+    optimalQuote: bigint;
+};

package/dist/types/recipes/removeLiquidity.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Remove Liquidity recipe - withdraw liquidity from a Pump AMM pool.
+ */
+import type { TransactionSigner, Instruction } from "@solana/kit";
+export interface RemoveLiquidityParams {
+    /** User's wallet/signer */
+    user: TransactionSigner;
+    /** Base token mint address */
+    baseMint: string;
+    /** Quote token mint address */
+    quoteMint: string;
+    /** Amount of LP tokens to burn */
+    lpAmount: bigint;
+    /** Expected base tokens to receive */
+    estimatedBaseOut: bigint;
+    /** Expected quote tokens to receive */
+    estimatedQuoteOut: bigint;
+    /** Slippage tolerance in basis points (default: 50 = 0.5%) */
+    slippageBps?: number;
+    /** Pool index (for multi-pool support, default: 0) */
+    poolIndex?: number;
+}
+/**
+ * Build a remove liquidity instruction with slippage protection.
+ *
+ * TODO: This needs to be implemented once the AMM client is complete.
+ */
+export declare function removeLiquidity(params: RemoveLiquidityParams): Promise<Instruction>;
+/**
+ * Calculate expected withdrawal amounts based on LP share.
+ */
+export declare function calculateWithdrawal(params: {
+    lpAmount: bigint;
+    totalLpSupply: bigint;
+    baseReserve: bigint;
+    quoteReserve: bigint;
+}): {
+    baseOut: bigint;
+    quoteOut: bigint;
+};

package/dist/types/recipes/sell.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Sell recipe - sell tokens back to the bonding curve with slippage protection.
+ */
+import type { Address, Instruction, TransactionSigner } from "@solana/kit";
+import { sell as buildSellInstruction } from "../clients/pump";
+type RpcClient = Parameters<typeof buildSellInstruction>[0]["rpc"];
+type CommitmentLevel = Parameters<typeof buildSellInstruction>[0]["commitment"];
+export interface SellWithSlippageParams {
+    user: TransactionSigner;
+    mint: Address | string;
+    /** Amount of tokens to sell (human-readable). */
+    tokenAmount: number;
+    /** Estimated SOL output in SOL units. */
+    estimatedSolOutSol: number;
+    slippageBps?: number;
+    feeRecipient?: Address | string;
+    bondingCurveCreator?: Address | string;
+    rpc: RpcClient;
+    commitment?: CommitmentLevel;
+}
+export declare function sellWithSlippage(params: SellWithSlippageParams): Promise<Instruction>;
+export interface SimpleSellParams {
+    user: TransactionSigner;
+    mint: Address | string;
+    /** Human-readable token amount to sell (defaults to 6 decimals). */
+    tokenAmount?: number;
+    /** Raw token amount expressed in the mint's base units. */
+    tokenAmountRaw?: bigint;
+    /** Minimum SOL output expressed in SOL units. */
+    minSolOutputSol?: number;
+    /** Optional lamport-denominated minimum SOL output. */
+    minSolOutputLamports?: bigint;
+    feeRecipient?: Address | string;
+    bondingCurveCreator?: Address | string;
+    rpc: RpcClient;
+    commitment?: CommitmentLevel;
+}
+export declare function sellSimple(params: SimpleSellParams): Promise<Instruction>;
+export {};

package/dist/types/simple.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The absolute simplest API for Pump.fun
+ * Everything you need, nothing you don't.
+ */
+import "./config/polyfills";
+export { buy, sell, quickBuy, quickSell } from "./swap";
+export type { BuyParams, SellParams } from "./swap";
+export { mintWithFirstBuy, validateMintParams } from "./recipes/mintFirstBuy";
+export type { MintWithFirstBuyParams } from "./recipes/mintFirstBuy";
+export type { TransactionSigner, Instruction, Address } from "@solana/kit";

package/dist/types/swap.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Ultra-simple swap API - the cleanest way to trade on Pump.fun.
+ * Users now provide input-side amounts (SOL for buys, tokens for sells) plus optional slippage.
+ */
+import type { Address, Instruction, TransactionSigner } from "@solana/kit";
+import type { RpcClient } from "./config/connection";
+import { type FeeStructure, type BondingCurveState } from "./ammsdk/bondingCurveMath";
+export type CommitmentLevel = "processed" | "confirmed" | "finalized";
+type WithRpcOptions = {
+    rpc: RpcClient;
+    commitment?: CommitmentLevel;
+};
+export type BuyParams = WithRpcOptions & {
+    user: TransactionSigner;
+    mint: Address | string;
+    /** SOL budget (before slippage), expressed in SOL. */
+    solAmount: number;
+    /** Optional slippage tolerance applied to the SOL budget (default 0.5%). */
+    slippageBps?: number;
+    feeRecipient?: Address | string;
+    bondingCurveCreator?: Address | string;
+    trackVolume?: boolean;
+    curveStateOverride?: BondingCurveState;
+    feeStructureOverride?: FeeStructure;
+};
+export type SellParams = WithRpcOptions & {
+    user: TransactionSigner;
+    mint: Address | string;
+    /** Human-readable token amount to sell. */
+    tokenAmount?: number;
+    /** Use a percentage of the wallet balance instead of fixed token amount. */
+    useWalletPercentage?: boolean;
+    /** Percentage of the wallet balance to sell (0-100]. */
+    walletPercentage?: number;
+    /** Token decimals (defaults to 6). */
+    tokenDecimals?: number;
+    slippageBps?: number;
+    feeRecipient?: Address | string;
+    bondingCurveCreator?: Address | string;
+    curveStateOverride?: BondingCurveState;
+    feeStructureOverride?: FeeStructure;
+};
+export declare function buy(params: BuyParams): Promise<Instruction>;
+export declare function sell(params: SellParams): Promise<Instruction>;
+type QuickBuyOptions = Omit<BuyParams, "user" | "mint" | "solAmount">;
+type QuickSellOptions = Omit<SellParams, "user" | "mint" | "tokenAmount">;
+export declare function quickBuy(user: TransactionSigner, mint: Address | string, solAmount: number, options?: QuickBuyOptions): Promise<Instruction>;
+export declare function quickSell(user: TransactionSigner, mint: Address | string, tokenAmount: number, options?: QuickSellOptions): Promise<Instruction>;
+export {};

package/dist/types/utils/amounts.d.ts

@@ -0,0 +1,4 @@
+export declare function solToLamports(sol: number): bigint;
+export declare function lamportsToSol(lamports: bigint): number;
+export declare function tokensToRaw(amount: number, decimals: number): bigint;
+export declare function rawToTokens(raw: bigint, decimals: number): number;

package/dist/types/utils/ata.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Helper to create Associated Token Account instructions
+ */
+import type { Address, Instruction, TransactionSigner } from "@solana/kit";
+export interface CreateAtaParams {
+    payer: TransactionSigner | Address | string;
+    owner: TransactionSigner | Address | string;
+    mint: Address | string;
+    tokenProgram?: Address | string;
+    associatedTokenProgram?: Address | string;
+}
+/**
+ * Build an instruction to create an Associated Token Account if it doesn't exist.
+ */
+export declare function buildCreateAtaInstruction(params: CreateAtaParams): Instruction;

package/dist/types/utils/slippage.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Slippage calculation utilities.
+ * All calculations use basis points (bps) where 100 bps = 1%.
+ */
+export declare const DEFAULT_SLIPPAGE_BPS = 50;
+/**
+ * Add slippage to an amount (for max input scenarios).
+ * @param x Base amount
+ * @param bps Slippage in basis points (default: 50 = 0.5%)
+ * @returns Amount increased by slippage
+ */
+export declare const addSlippage: (x: bigint, bps?: number) => bigint;
+/**
+ * Subtract slippage from an amount (for min output scenarios).
+ * @param x Base amount
+ * @param bps Slippage in basis points (default: 50 = 0.5%)
+ * @returns Amount decreased by slippage
+ */
+export declare const subSlippage: (x: bigint, bps?: number) => bigint;
+/**
+ * Validate slippage basis points.
+ * @param bps Basis points to validate
+ * @throws Error if bps is negative or > 10000 (100%)
+ */
+export declare function validateSlippage(bps: number): void;
+/**
+ * Convert percentage to basis points.
+ * @param percent Percentage (0-100)
+ * @returns Basis points (0-10000)
+ */
+export declare function percentToBps(percent: number): number;
+/**
+ * Convert basis points to percentage.
+ * @param bps Basis points (0-10000)
+ * @returns Percentage (0-100)
+ */
+export declare function bpsToPercent(bps: number): number;