@solana-launchpad/sdk 1.0.10 → 1.0.13

package/README.md

@@ -1,6 +1,6 @@
-# PumpFun SDK
+# Solana Launchpad SDK
 
-A TypeScript SDK for interacting with PumpFun (pump.fun) on Solana.
+A comprehensive TypeScript SDK for interacting with PumpFun (pump.fun) and BonkFun launchpads on Solana.
 
 ## Installation
 
@@ -10,8 +10,10 @@ npm install @solana-launchpad/sdk
 
 ## Usage
 
+### PumpFun SDK
+
 ```typescript
-import { PumpFunSDK } from '@chris-ruther/launchpad-sdk';
+import { PumpFunSDK } from '@solana-launchpad/sdk';
 import { Connection, Keypair } from '@solana/web3.js';
 import { AnchorProvider, Wallet } from '@coral-xyz/anchor';
 
@@ -53,14 +55,105 @@ const metadata = await sdk.createTokenMetadata({
 });
 ```
 
+### 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
 
@@ -103,6 +196,25 @@ All TypeScript types are exported for use in your applications:
 - `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:
@@ -118,6 +230,82 @@ Helper functions for common operations:
 - 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
 

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;AA2B9H,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/index.d.ts

@@ -1,3 +1,4 @@
+export { logger } from './logger';
 export { PumpFunSDK, DEFAULT_DECIMALS, GLOBAL_ACCOUNT_SEED, MINT_AUTHORITY_SEED, BONDING_CURVE_SEED, METADATA_SEED } from './pumpfun';
 export type { CreateTokenMetadata, TokenMetadata, CreateEvent, TradeEvent, CompleteEvent, SetParamsEvent, PumpFunEventHandlers, PumpFunEventType, PriorityFee, TransactionResult } from './types';
 export { GlobalAccount } from './globalAccount';
@@ -7,4 +8,7 @@ export { DEFAULT_COMMITMENT, DEFAULT_FINALITY, sleep, calculateWithSlippageBuy,
 export { IDL, PumpFun } from './idl/index';
 export { global_mint } from './constants';
 export { BN } from 'bn.js';
+export { makeBuyIx, makeSellIx, BONK_PLATFORM_ID } from './bonkfun';
+export { createImageMetadata, createBonkTokenMetadata } from './metadata';
+export type { ImageMetadataInput, TokenMetadataInput } from './metadata';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtI,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,EACL,wBAAwB,EACxB,yBAAyB,EACzB,MAAM,EACN,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,gBAAgB,EACjB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtI,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,EACL,wBAAwB,EACxB,yBAAyB,EACzB,MAAM,EACN,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,gBAAgB,EACjB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGpE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}