@paul.lumberwork/bonding-curve-sdk 1.7.2 → 1.8.1

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as anchor from '@coral-xyz/anchor';
 import { BN, Program } from '@coral-xyz/anchor';
-import { PublicKey, Keypair, Connection, TransactionInstruction } from '@solana/web3.js';
+import { PublicKey, Connection, Keypair, TransactionInstruction } from '@solana/web3.js';
 
 /**
  * Program IDL in camelCase format in order to be used in JS/TS.
@@ -1743,8 +1743,137 @@ type KickFunProgram = {
                     "type": {
                         "option": "u128";
                     };
+                },
+                {
+                    "name": "newFeeWithdrawDelay";
+                    "type": {
+                        "option": "i64";
+                    };
                 }
             ];
+        },
+        {
+            "name": "withdrawAccumulatedFees";
+            "docs": [
+                "Withdraw accumulated trading fees (0.5% curve fee) from an incomplete bonding curve.",
+                "Time-locked: only callable after launchpad.fee_withdraw_delay seconds since curve creation.",
+                "Default delay: 7 days. Admin can change delay via update_launchpad.",
+                "Use this when a curve never reaches 100% but has accumulated fees."
+            ];
+            "discriminator": [
+                208,
+                72,
+                35,
+                251,
+                110,
+                63,
+                250,
+                122
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "docs": [
+                        "Admin signer — must be launchpad.authority"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "launchpad";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    108,
+                                    97,
+                                    117,
+                                    110,
+                                    99,
+                                    104,
+                                    112,
+                                    97,
+                                    100
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "tokenLaunch";
+                },
+                {
+                    "name": "bondingCurve";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    98,
+                                    111,
+                                    110,
+                                    100,
+                                    105,
+                                    110,
+                                    103,
+                                    95,
+                                    99,
+                                    117,
+                                    114,
+                                    118,
+                                    101
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "tokenLaunch";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "vault";
+                    "docs": [
+                        "Vault holding SOL collected during trading"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "tokenLaunch";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "treasury";
+                    "docs": [
+                        "Treasury wallet receives the withdrawn fees"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "mint";
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [];
         }
     ];
     "accounts": [
@@ -1828,6 +1957,19 @@ type KickFunProgram = {
                 42
             ];
         },
+        {
+            "name": "feesWithdrawn";
+            "discriminator": [
+                234,
+                15,
+                0,
+                119,
+                148,
+                241,
+                40,
+                21
+            ];
+        },
         {
             "name": "launchCreated";
             "discriminator": [
@@ -1928,6 +2070,21 @@ type KickFunProgram = {
             "code": 6011;
             "name": "curveNotComplete";
             "msg": "Bonding curve is not complete yet";
+        },
+        {
+            "code": 6012;
+            "name": "supplyExceedsMax";
+            "msg": "Total supply exceeds maximum safe calculation limit";
+        },
+        {
+            "code": 6013;
+            "name": "feeWithdrawTooEarly";
+            "msg": "Fee withdrawal not allowed yet: time-lock period has not elapsed";
+        },
+        {
+            "code": 6014;
+            "name": "noFeesToWithdraw";
+            "msg": "No accumulated fees to withdraw";
         }
     ];
     "types": [
@@ -2171,6 +2328,59 @@ type KickFunProgram = {
                 ];
             };
         },
+        {
+            "name": "feesWithdrawn";
+            "docs": [
+                "Event emitted when admin withdraws accumulated fees from an incomplete/dead curve"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "tokenLaunch";
+                        "docs": [
+                            "The token launch public key"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "mint";
+                        "docs": [
+                            "The mint address"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "admin";
+                        "docs": [
+                            "Admin who triggered the withdrawal"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "treasury";
+                        "docs": [
+                            "Treasury wallet that received the fees"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "feesWithdrawn";
+                        "docs": [
+                            "Amount of accumulated fees withdrawn (in lamports)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "timestamp";
+                        "docs": [
+                            "Timestamp"
+                        ];
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
         {
             "name": "launchCreated";
             "docs": [
@@ -2330,6 +2540,14 @@ type KickFunProgram = {
                             "Default k value for bonding curve"
                         ];
                         "type": "u128";
+                    },
+                    {
+                        "name": "feeWithdrawDelay";
+                        "docs": [
+                            "Minimum seconds after curve creation before admin can withdraw accumulated fees",
+                            "Default: 604800 (7 days). Configurable via update_launchpad."
+                        ];
+                        "type": "i64";
                     }
                 ];
             };
@@ -2445,6 +2663,14 @@ type KickFunProgram = {
                         ];
                         "type": "i64";
                     },
+                    {
+                        "name": "feeWithdrawDelay";
+                        "docs": [
+                            "Seconds after creation before admin can withdraw accumulated fees",
+                            "Snapshotted from launchpad.fee_withdraw_delay at creation time — immutable after deploy"
+                        ];
+                        "type": "i64";
+                    },
                     {
                         "name": "bump";
                         "docs": [
@@ -3012,10 +3238,6 @@ declare class KickFunSDK {
     static calculateK(curveSupply: bigint, targetSol: bigint): bigint;
 }
 interface RegisterStreamerParams {
-    streamerId: string;
-    streamerKeypair: Keypair;
-}
-interface RegisterStreamerWithSignatureParams {
     streamerId: string;
     streamerPublicKey: PublicKey;
     signature: Uint8Array;
@@ -3026,18 +3248,12 @@ interface RegisterStreamerResult {
     streamerRegistrationPda: PublicKey;
 }
 interface ClaimFundsParams {
-    streamerId: string;
-    streamerKeypair: Keypair;
-    mint: PublicKey;
-    solAmount: BN;
-    tokenAmount: BN;
-}
-interface ClaimFundsWithSignatureParams {
     streamerId: string;
     streamerPublicKey: PublicKey;
     mint: PublicKey;
     solAmount: BN;
     tokenAmount: BN;
+    nonce: BN;
     signature: Uint8Array;
     timestamp: number;
 }
@@ -3065,9 +3281,9 @@ declare class StreamerSDK {
      * Build the message that the streamer must sign for claim_funds.
      * The streamer signs this with their wallet (e.g. Phantom signMessage).
      *
-     * Format: "claim_funds:{streamer_id}:{wallet}:{mint}:{token_amount}:{sol_amount}:{timestamp}"
+     * Format: "claim_funds:{streamer_id}:{wallet}:{mint}:{token_amount}:{sol_amount}:{nonce}:{timestamp}"
      */
-    buildClaimMessage(streamerId: string, streamerWallet: PublicKey, mint: PublicKey, tokenAmount: BN, solAmount: BN, timestamp: number): Uint8Array;
+    buildClaimMessage(streamerId: string, streamerWallet: PublicKey, mint: PublicKey, tokenAmount: BN, solAmount: BN, nonce: BN, timestamp: number): Uint8Array;
     /**
      * Create an Ed25519 instruction from an externally-signed signature.
      * Use this when the streamer signs via browser wallet (Phantom, Solflare, etc.)
@@ -3078,21 +3294,16 @@ declare class StreamerSDK {
      * @param signature      - The Ed25519 signature from wallet.signMessage(message)
      */
     createEd25519Instruction(streamerWallet: PublicKey, message: Uint8Array, signature: Uint8Array): TransactionInstruction;
-    /**
-     * Sign a message using a Keypair directly (server-side / test usage).
-     * Returns the Ed25519 signature bytes.
-     */
-    static signMessage(message: Uint8Array, keypair: Keypair): Uint8Array;
     registerStreamer(params: RegisterStreamerParams): Promise<RegisterStreamerResult>;
     claimFunds(params: ClaimFundsParams): Promise<ClaimFundsResult>;
-    registerStreamerWithSignature(params: RegisterStreamerWithSignatureParams): Promise<RegisterStreamerResult>;
-    claimFundsWithSignature(params: ClaimFundsWithSignatureParams): Promise<ClaimFundsResult>;
     getStreamerRegistration(streamerId: string): Promise<{
         streamerId: string;
         wallet: PublicKey;
         verifiedAt: number;
         registeredBy: PublicKey;
         createdAt: number;
+        claimNonce: number;
+        lastClaimAt: number;
     } | null>;
     isWhitelisted(wallet: PublicKey): Promise<boolean>;
     getVaultBalance(mint?: PublicKey): Promise<{
@@ -3109,4 +3320,14 @@ declare function parseSol(sol: number): bigint;
 /** Parse tokens to raw */
 declare function parseTokens(tokens: number): bigint;
 
-export { ADMIN_WALLET, type AdminWithdrawEvent, type BondingCurveState, CURVE_PERCENT, type ClaimFundsParams, type ClaimFundsResult, type ClaimFundsWithSignatureParams, type CurveCompleteEvent, type EstimateBuyResult, type EstimateSellResult, type EventCallback, FEE_BPS, K_SCALE, type KickFunEvent, type KickFunProgram, KickFunSDK, LAMPORTS, LP_PERCENT, type LaunchAddresses, type LaunchCreatedEvent, METADATA_PROGRAM_ID, PROGRAM_ID, type RegisterStreamerParams, type RegisterStreamerResult, type RegisterStreamerWithSignatureParams, STREAMER_PROGRAM_ID, StreamerSDK, TOKEN_DECIMALS, TREASURY_PERCENT, type TokenLaunchConfig, type TokenLaunchState, type TokensPurchasedEvent, type TokensSoldEvent, type TradeResult, formatSol, formatTokens, parseSol, parseTokens };
+/**
+ * Create a StreamerSDK instance with the bundled IDL.
+ * Dev only needs to provide connection + wallet — no IDL setup required.
+ *
+ * @example
+ * const streamerSdk = createStreamerSDK(connection, wallet);
+ * const reg = await streamerSdk.getStreamerRegistration("94926228");
+ */
+declare function createStreamerSDK(connection: Connection, wallet: anchor.Wallet): StreamerSDK;
+
+export { ADMIN_WALLET, type AdminWithdrawEvent, type BondingCurveState, CURVE_PERCENT, type ClaimFundsParams, type ClaimFundsResult, type CurveCompleteEvent, type EstimateBuyResult, type EstimateSellResult, type EventCallback, FEE_BPS, K_SCALE, type KickFunEvent, type KickFunProgram, KickFunSDK, LAMPORTS, LP_PERCENT, type LaunchAddresses, type LaunchCreatedEvent, METADATA_PROGRAM_ID, PROGRAM_ID, type RegisterStreamerParams, type RegisterStreamerResult, STREAMER_PROGRAM_ID, StreamerSDK, TOKEN_DECIMALS, TREASURY_PERCENT, type TokenLaunchConfig, type TokenLaunchState, type TokensPurchasedEvent, type TokensSoldEvent, type TradeResult, createStreamerSDK, formatSol, formatTokens, parseSol, parseTokens };