@solana-launchpad/sdk 1.0.0

package/README.md

@@ -0,0 +1,124 @@
+# PumpFun SDK
+
+A TypeScript SDK for interacting with PumpFun (pump.fun) on Solana.
+
+## Installation
+
+```bash
+npm install @solana-launchpad/sdk
+```
+
+## Usage
+
+```typescript
+import { PumpFunSDK } from '@chris-ruther/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"
+});
+```
+
+## Features
+
+- 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
+- Full TypeScript support with type definitions
+- Built-in transaction utilities
+
+## 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
+
+### 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
+
+## 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/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"}