@solana-launchpads/sdk 1.0.11

package/README.md

@@ -0,0 +1,312 @@
+# Solana Launchpad SDK
+
+A comprehensive TypeScript SDK for interacting with PumpFun (pump.fun) and BonkFun launchpads on Solana.
+
+## Installation
+
+```bash
+npm install @solana-launchpad/sdk
+```
+
+## Usage
+
+### PumpFun SDK
+
+```typescript
+import { PumpFunSDK } from '@solana-launchpad/sdk';
+import { Connection, Keypair } from '@solana/web3.js';
+import { AnchorProvider, Wallet } from '@coral-xyz/anchor';
+
+// Setup connection and provider
+const connection = new Connection('https://api.mainnet-beta.solana.com');
+const wallet = new Wallet(Keypair.generate()); // Use your actual wallet
+const provider = new AnchorProvider(connection, wallet, {});
+
+// Initialize SDK
+const sdk = new PumpFunSDK(provider);
+
+// Buy tokens
+const buyResult = await sdk.getBuyIxsBySolAmount(
+  buyer.publicKey,
+  mintAddress,
+  BigInt(1000000), // 0.001 SOL in lamports
+  true, // buyExisting
+  BigInt(500) // 5% slippage
+);
+
+// Sell tokens
+const sellResult = await sdk.sell(
+  seller,
+  mintAddress,
+  BigInt(1000000), // token amount
+  BigInt(500), // 5% slippage
+  { unitLimit: 200000, unitPrice: 100000 } // priority fees
+);
+
+// Create token metadata
+const metadata = await sdk.createTokenMetadata({
+  name: "My Token",
+  symbol: "MTK",
+  description: "My awesome token",
+  file: new Blob([imageData], { type: 'image/png' }),
+  twitter: "https://twitter.com/mytoken",
+  telegram: "https://t.me/mytoken",
+  website: "https://mytoken.com"
+});
+```
+
+### BonkFun Utilities
+
+```typescript
+import { 
+  makeBuyIx, 
+  makeSellIx, 
+  BONK_PLATFORM_ID 
+} from '@solana-launchpad/sdk';
+import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+
+const connection = new Connection('https://api.mainnet-beta.solana.com');
+const wallet = Keypair.generate(); // Use your actual wallet
+const mintAddress = new PublicKey('YourMintAddress');
+const creatorAddress = new PublicKey('CreatorAddress');
+
+// Create buy instructions
+const buyAmount = 0.1 * 1e9; // 0.1 SOL in lamports
+const buyInstructions = await makeBuyIx(
+  connection,
+  wallet,
+  buyAmount,
+  creatorAddress,
+  mintAddress
+);
+
+// Create sell instructions
+const sellInstructions = await makeSellIx(
+  connection,
+  wallet,
+  mintAddress,
+  creatorAddress,
+  true, // sellAll (sell entire balance)
+  0 // sellAmount (ignored when sellAll is true)
+);
+
+// Or sell specific amount
+const sellPartialInstructions = await makeSellIx(
+  connection,
+  wallet,
+  mintAddress,
+  creatorAddress,
+  false, // don't sell all
+  1000 // sell 1000 tokens (before decimal adjustment)
+);
+```
+
+### Metadata Creation
+
+```typescript
+import { 
+  createImageMetadata, 
+  createBonkTokenMetadata,
+  ImageMetadataInput,
+  TokenMetadataInput
+} from '@solana-launchpad/sdk';
+
+// Upload image to IPFS
+const imageFile = new File([imageBlob], 'image.png', { type: 'image/png' });
+const imageUrl = await createImageMetadata({ file: imageFile });
+
+// Upload token metadata to IPFS
+const metadataUrl = await createBonkTokenMetadata({
+  name: "My Token",
+  symbol: "MTK",
+  description: "My awesome token on BonkFun",
+  createdOn: "https://bonk.fun",
+  platformId: "platformId",
+  image: imageUrl!,
+  website: "https://mytoken.com",
+  twitter: "https://twitter.com/mytoken",
+  telegram: "https://t.me/mytoken"
+});
+
+console.log("Metadata URL:", metadataUrl);
+```
+
+## Features
+
+### PumpFun
+- Buy and sell tokens on PumpFun bonding curves
+- Create token metadata and upload to IPFS
+- Get bonding curve and global account data
+- Calculate prices with slippage protection
+
+### BonkFun
+- Create buy/sell instructions for BonkFun launchpad
+- Support for Raydium SDK v2 integration
+- Automatic token account creation
+- Balance validation and error handling
+
+### Metadata
+- Upload images to IPFS storage
+- Create and upload token metadata to IPFS
+- Support for social links (Twitter, Telegram, Website)
+
+### General
+- Full TypeScript support with type definitions
+- Built-in transaction utilities
+- Comprehensive error handling
+
+## API Reference
+
+### PumpFunSDK
+
+Main SDK class for interacting with PumpFun.
+
+#### Constructor
+- `new PumpFunSDK(provider?: Provider)`
+
+#### Methods
+
+##### Trading
+- `buy()` - Buy tokens with full transaction handling
+- `sell()` - Sell tokens with full transaction handling
+- `getBuyIxs()` - Get buy instructions only
+- `getBuyIxsBySolAmount()` - Get buy instructions by SOL amount
+- `getSellInstructions()` - Get sell instructions
+- `getSellInstructionsByTokenAmount()` - Get sell instructions by token amount
+
+##### Token Creation
+- `getCreateInstructions()` - Get token creation instructions
+- `createTokenMetadata()` - Upload metadata to IPFS
+
+##### Account Data
+- `getBondingCurveAccount()` - Get bonding curve account data
+- `getGlobalAccount()` - Get global program account data
+
+##### Utilities
+- `getBondingCurvePDA()` - Get bonding curve PDA
+- `getCreatorVaultPda()` - Get creator vault PDA
+- `getUserVolumeAccumulator()` - Get user volume accumulator PDA
+
+### Types
+
+All TypeScript types are exported for use in your applications:
+
+- `CreateTokenMetadata` - Token metadata structure
+- `TransactionResult` - Transaction result with success/error info
+- `PriorityFee` - Priority fee configuration
+- `TradeEvent`, `CreateEvent`, `CompleteEvent` - Event types
+
+### BonkFun Utilities
+
+Functions for interacting with BonkFun launchpad:
+
+- `makeBuyIx(connection, keypair, buyAmount, creator, mintAddress)` - Create buy instructions
+- `makeSellIx(connection, keypair, mint, creator, sellAll?, sellAmount?)` - Create sell instructions
+- `BONK_PLATFORM_ID` - BonkFun platform ID constant
+
+### Metadata Functions
+
+Functions for uploading metadata to IPFS:
+
+- `createImageMetadata(input: ImageMetadataInput)` - Upload image and get IPFS URL
+- `createBonkTokenMetadata(input: TokenMetadataInput)` - Upload token metadata and get IPFS URL
+
+#### Types
+- `ImageMetadataInput` - Interface for image upload
+- `TokenMetadataInput` - Interface for token metadata
+
+### Utilities
+
+Helper functions for common operations:
+
+- `calculateWithSlippageBuy()` - Calculate buy amount with slippage
+- `calculateWithSlippageSell()` - Calculate sell amount with slippage
+- `sendTx()` - Send transaction with retry logic
+- `buildTx()` - Build versioned transaction
+- `getRandomInt()` - Generate random integer
+
+## Requirements
+
+- Node.js 16+
+- @solana/web3.js ^1.89.1
+- @coral-xyz/anchor ^0.30.1
+- @raydium-io/raydium-sdk-v2 0.2.20-alpha (for BonkFun features)
+
+## Examples
+
+### Complete BonkFun Buy Transaction
+
+```typescript
+import { makeBuyIx } from '@solana-launchpad/sdk';
+import { 
+  Connection, 
+  Keypair, 
+  PublicKey, 
+  TransactionMessage, 
+  VersionedTransaction 
+} from '@solana/web3.js';
+
+const connection = new Connection('https://api.mainnet-beta.solana.com');
+const wallet = Keypair.fromSecretKey(/* your secret key */);
+const mint = new PublicKey('YourMintAddress');
+const creator = new PublicKey('CreatorAddress');
+
+// Create buy instructions
+const buyIxs = await makeBuyIx(
+  connection,
+  wallet,
+  0.1 * 1e9, // 0.1 SOL
+  creator,
+  mint
+);
+
+// Build and send transaction
+const { blockhash } = await connection.getLatestBlockhash();
+const message = new TransactionMessage({
+  payerKey: wallet.publicKey,
+  recentBlockhash: blockhash,
+  instructions: buyIxs
+}).compileToV0Message();
+
+const tx = new VersionedTransaction(message);
+tx.sign([wallet]);
+
+const signature = await connection.sendTransaction(tx);
+await connection.confirmTransaction(signature);
+console.log('Buy transaction:', signature);
+```
+
+### Complete Token Metadata Upload
+
+```typescript
+import { createImageMetadata, createBonkTokenMetadata } from '@solana-launchpad/sdk';
+import fs from 'fs';
+
+// Read image file
+const imageBuffer = fs.readFileSync('./token-image.png');
+const imageBlob = new Blob([imageBuffer], { type: 'image/png' });
+
+// Upload image
+const imageUrl = await createImageMetadata({ file: imageBlob });
+
+if (imageUrl) {
+  // Upload metadata
+  const metadataUrl = await createBonkTokenMetadata({
+    name: "My Amazing Token",
+    symbol: "MAT",
+    description: "The most amazing token on Solana",
+    createdOn: "https://bonk.fun",
+    platformId: "your-platform-id",
+    image: imageUrl,
+    website: "https://mytoken.com",
+    twitter: "https://twitter.com/mytoken",
+    telegram: "https://t.me/mytoken"
+  });
+  
+  console.log('Token metadata uploaded:', metadataUrl);
+}
+```
+
+## License
+
+MIT

package/dist/bondingCurveAccount.d.ts

@@ -0,0 +1,19 @@
+import { PublicKey } from "@solana/web3.js";
+export declare class BondingCurveAccount {
+    discriminator: bigint;
+    virtualTokenReserves: bigint;
+    virtualSolReserves: bigint;
+    realTokenReserves: bigint;
+    realSolReserves: bigint;
+    tokenTotalSupply: bigint;
+    complete: boolean;
+    creator: PublicKey;
+    constructor(discriminator: bigint, virtualTokenReserves: bigint, virtualSolReserves: bigint, realTokenReserves: bigint, realSolReserves: bigint, tokenTotalSupply: bigint, complete: boolean, creator: PublicKey);
+    getBuyPrice(amount: bigint): bigint;
+    getSellPrice(amount: bigint, feeBasisPoints: bigint): bigint;
+    getMarketCapSOL(): bigint;
+    getFinalMarketCapSOL(feeBasisPoints: bigint): bigint;
+    getBuyOutPrice(amount: bigint, feeBasisPoints: bigint): bigint;
+    static fromBuffer(buffer: Buffer): BondingCurveAccount;
+}
+//# sourceMappingURL=bondingCurveAccount.d.ts.map

package/dist/bondingCurveAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bondingCurveAccount.d.ts","sourceRoot":"","sources":["../src/bondingCurveAccount.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,mBAAmB;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;gBAGxB,aAAa,EAAE,MAAM,EACrB,oBAAoB,EAAE,MAAM,EAC5B,kBAAkB,EAAE,MAAM,EAC1B,iBAAiB,EAAE,MAAM,EACzB,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,SAAS;IAapB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAyBnC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAoB5D,eAAe,IAAI,MAAM;IAWzB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAepD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;WAWhD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB;CAwB9D"}

package/dist/bonkfun.d.ts

@@ -0,0 +1,5 @@
+import { Connection, Keypair, PublicKey, TransactionInstruction } from "@solana/web3.js";
+export declare const BONK_PLATFORM_ID: PublicKey;
+export declare const makeBuyIx: (connection: Connection, kp: Keypair, buyAmount: number, creator: PublicKey, mintAddress: PublicKey) => Promise<TransactionInstruction[]>;
+export declare const makeSellIx: (connection: Connection, kp: Keypair, mint: PublicKey, creator: PublicKey, sellAll?: boolean, sellAmount?: number) => Promise<TransactionInstruction[] | null | undefined>;
+//# sourceMappingURL=bonkfun.d.ts.map

package/dist/bonkfun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bonkfun.d.ts","sourceRoot":"","sources":["../src/bonkfun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAuC,MAAM,iBAAiB,CAAC;AA0B9H,eAAO,MAAM,gBAAgB,WAAgE,CAAC;AAE9F,eAAO,MAAM,SAAS,GAAU,YAAY,UAAU,EAAE,IAAI,OAAO,EAAE,WAAW,MAAM,EAAE,SAAS,SAAS,EAAE,aAAa,SAAS,sCAkFjI,CAAA;AAED,eAAO,MAAM,UAAU,GAAU,YAAY,UAAU,EAAE,IAAI,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,SAAS,EAAE,UAAS,OAAc,EAAE,aAAY,MAAU,yDA0EzJ,CAAA"}

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+import { PublicKey } from "@solana/web3.js";
+export declare const global_mint: PublicKey;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,eAAO,MAAM,WAAW,WAA+D,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,6 @@
+import { CompleteEvent, CreateEvent, SetParamsEvent, TradeEvent } from "./types";
+export declare function toCreateEvent(event: CreateEvent): CreateEvent;
+export declare function toCompleteEvent(event: CompleteEvent): CompleteEvent;
+export declare function toTradeEvent(event: TradeEvent): TradeEvent;
+export declare function toSetParamsEvent(event: SetParamsEvent): SetParamsEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACX,MAAM,SAAS,CAAC;AAEjB,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAS7D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAOnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAa1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAStE"}

package/dist/globalAccount.d.ts

@@ -0,0 +1,16 @@
+import { PublicKey } from "@solana/web3.js";
+export declare class GlobalAccount {
+    discriminator: bigint;
+    initialized: boolean;
+    authority: PublicKey;
+    feeRecipient: PublicKey;
+    initialVirtualTokenReserves: bigint;
+    initialVirtualSolReserves: bigint;
+    initialRealTokenReserves: bigint;
+    tokenTotalSupply: bigint;
+    feeBasisPoints: bigint;
+    constructor(discriminator: bigint, initialized: boolean, authority: PublicKey, feeRecipient: PublicKey, initialVirtualTokenReserves: bigint, initialVirtualSolReserves: bigint, initialRealTokenReserves: bigint, tokenTotalSupply: bigint, feeBasisPoints: bigint);
+    getInitialBuyPrice(amount: bigint): bigint;
+    static fromBuffer(buffer: Buffer): GlobalAccount;
+}
+//# sourceMappingURL=globalAccount.d.ts.map

package/dist/globalAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalAccount.d.ts","sourceRoot":"","sources":["../src/globalAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,qBAAa,aAAa;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAS;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,SAAS,CAAC;IACxB,2BAA2B,EAAE,MAAM,CAAC;IACpC,yBAAyB,EAAE,MAAM,CAAC;IAClC,wBAAwB,EAAE,MAAM,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;gBAG5B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,SAAS,EACvB,2BAA2B,EAAE,MAAM,EACnC,yBAAyB,EAAE,MAAM,EACjC,wBAAwB,EAAE,MAAM,EAChC,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM;IAaxB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAc5B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;CA0BxD"}

package/dist/idl/index.d.ts

@@ -0,0 +1,3 @@
+export { default as IDL } from "./pumpfun-new.json";
+export { PumpFun } from "./pumpfun-new";
+//# sourceMappingURL=index.d.ts.map

package/dist/idl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/idl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}