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

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 } from '@solana/web3.js';
+import { PublicKey, Keypair, Connection, TransactionInstruction } from '@solana/web3.js';
 
 /**
  * Program IDL in camelCase format in order to be used in JS/TS.
@@ -3015,6 +3015,12 @@ interface RegisterStreamerParams {
     streamerId: string;
     streamerKeypair: Keypair;
 }
+interface RegisterStreamerWithSignatureParams {
+    streamerId: string;
+    streamerPublicKey: PublicKey;
+    signature: Uint8Array;
+    timestamp: number;
+}
 interface RegisterStreamerResult {
     txSignature: string;
     streamerRegistrationPda: PublicKey;
@@ -3026,6 +3032,15 @@ interface ClaimFundsParams {
     solAmount: BN;
     tokenAmount: BN;
 }
+interface ClaimFundsWithSignatureParams {
+    streamerId: string;
+    streamerPublicKey: PublicKey;
+    mint: PublicKey;
+    solAmount: BN;
+    tokenAmount: BN;
+    signature: Uint8Array;
+    timestamp: number;
+}
 interface ClaimFundsResult {
     txSignature: string;
 }
@@ -3038,10 +3053,40 @@ declare class StreamerSDK {
     deriveWhitelistEntry(wallet: PublicKey): PublicKey;
     deriveStreamerRegistration(streamerId: string): PublicKey;
     deriveVault(): PublicKey;
-    private getSolanaTimestamp;
-    private createEd25519Instruction;
+    getSolanaTimestamp(): Promise<number>;
+    /**
+     * Build the message that the streamer must sign for register_streamer.
+     * The streamer signs this with their wallet (e.g. Phantom signMessage).
+     *
+     * Format: "register_streamer:{streamer_id}:{wallet}:{timestamp}"
+     */
+    buildRegisterMessage(streamerId: string, streamerWallet: PublicKey, timestamp: number): Uint8Array;
+    /**
+     * 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}"
+     */
+    buildClaimMessage(streamerId: string, streamerWallet: PublicKey, mint: PublicKey, tokenAmount: BN, solAmount: 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.)
+     * instead of exposing a Keypair.
+     *
+     * @param streamerWallet - Public key of the streamer
+     * @param message        - The message bytes (from buildRegisterMessage / buildClaimMessage)
+     * @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;
@@ -3064,4 +3109,4 @@ 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 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, formatSol, formatTokens, parseSol, parseTokens };
+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 };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as anchor from '@coral-xyz/anchor';
 import { BN, Program } from '@coral-xyz/anchor';
-import { PublicKey, Keypair, Connection } from '@solana/web3.js';
+import { PublicKey, Keypair, Connection, TransactionInstruction } from '@solana/web3.js';
 
 /**
  * Program IDL in camelCase format in order to be used in JS/TS.
@@ -3015,6 +3015,12 @@ interface RegisterStreamerParams {
     streamerId: string;
     streamerKeypair: Keypair;
 }
+interface RegisterStreamerWithSignatureParams {
+    streamerId: string;
+    streamerPublicKey: PublicKey;
+    signature: Uint8Array;
+    timestamp: number;
+}
 interface RegisterStreamerResult {
     txSignature: string;
     streamerRegistrationPda: PublicKey;
@@ -3026,6 +3032,15 @@ interface ClaimFundsParams {
     solAmount: BN;
     tokenAmount: BN;
 }
+interface ClaimFundsWithSignatureParams {
+    streamerId: string;
+    streamerPublicKey: PublicKey;
+    mint: PublicKey;
+    solAmount: BN;
+    tokenAmount: BN;
+    signature: Uint8Array;
+    timestamp: number;
+}
 interface ClaimFundsResult {
     txSignature: string;
 }
@@ -3038,10 +3053,40 @@ declare class StreamerSDK {
     deriveWhitelistEntry(wallet: PublicKey): PublicKey;
     deriveStreamerRegistration(streamerId: string): PublicKey;
     deriveVault(): PublicKey;
-    private getSolanaTimestamp;
-    private createEd25519Instruction;
+    getSolanaTimestamp(): Promise<number>;
+    /**
+     * Build the message that the streamer must sign for register_streamer.
+     * The streamer signs this with their wallet (e.g. Phantom signMessage).
+     *
+     * Format: "register_streamer:{streamer_id}:{wallet}:{timestamp}"
+     */
+    buildRegisterMessage(streamerId: string, streamerWallet: PublicKey, timestamp: number): Uint8Array;
+    /**
+     * 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}"
+     */
+    buildClaimMessage(streamerId: string, streamerWallet: PublicKey, mint: PublicKey, tokenAmount: BN, solAmount: 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.)
+     * instead of exposing a Keypair.
+     *
+     * @param streamerWallet - Public key of the streamer
+     * @param message        - The message bytes (from buildRegisterMessage / buildClaimMessage)
+     * @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;
@@ -3064,4 +3109,4 @@ 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 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, formatSol, formatTokens, parseSol, parseTokens };
+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 };

package/dist/index.js

@@ -639,7 +639,7 @@ var KickFunSDK = class {
     return numerator / denominator;
   }
 };
-var StreamerSDK = class {
+var StreamerSDK = class _StreamerSDK {
   constructor(program, wallet) {
     this.program = program;
     this.connection = program.provider.connection;
@@ -685,25 +685,61 @@ var StreamerSDK = class {
     if (!blockTime) throw new Error("Failed to get block time");
     return blockTime;
   }
-  createEd25519Instruction(keypair, message) {
-    const signature = nacl__default.default.sign.detached(message, keypair.secretKey);
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Ed25519 Signing Utilities (for browser wallets / external signers)
+  // ═══════════════════════════════════════════════════════════════════════════
+  /**
+   * Build the message that the streamer must sign for register_streamer.
+   * The streamer signs this with their wallet (e.g. Phantom signMessage).
+   *
+   * Format: "register_streamer:{streamer_id}:{wallet}:{timestamp}"
+   */
+  buildRegisterMessage(streamerId, streamerWallet, timestamp) {
+    const msg = `register_streamer:${streamerId}:${streamerWallet.toBase58()}:${timestamp}`;
+    return Buffer.from(msg, "utf-8");
+  }
+  /**
+   * 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}"
+   */
+  buildClaimMessage(streamerId, streamerWallet, mint, tokenAmount, solAmount, timestamp) {
+    const msg = `claim_funds:${streamerId}:${streamerWallet.toBase58()}:${mint.toBase58()}:${tokenAmount.toString()}:${solAmount.toString()}:${timestamp}`;
+    return Buffer.from(msg, "utf-8");
+  }
+  /**
+   * Create an Ed25519 instruction from an externally-signed signature.
+   * Use this when the streamer signs via browser wallet (Phantom, Solflare, etc.)
+   * instead of exposing a Keypair.
+   *
+   * @param streamerWallet - Public key of the streamer
+   * @param message        - The message bytes (from buildRegisterMessage / buildClaimMessage)
+   * @param signature      - The Ed25519 signature from wallet.signMessage(message)
+   */
+  createEd25519Instruction(streamerWallet, message, signature) {
     return web3_js.Ed25519Program.createInstructionWithPublicKey({
-      publicKey: keypair.publicKey.toBytes(),
+      publicKey: streamerWallet.toBytes(),
       message,
       signature
     });
   }
+  /**
+   * Sign a message using a Keypair directly (server-side / test usage).
+   * Returns the Ed25519 signature bytes.
+   */
+  static signMessage(message, keypair) {
+    return nacl__default.default.sign.detached(message, keypair.secretKey);
+  }
   // ═══════════════════════════════════════════════════════════════════════════
   // Register Streamer
   // ═══════════════════════════════════════════════════════════════════════════
   async registerStreamer(params) {
     const { streamerId, streamerKeypair } = params;
     const timestamp = await this.getSolanaTimestamp();
-    const message = `register_streamer:${streamerId}:${streamerKeypair.publicKey.toBase58()}:${timestamp}`;
-    const ed25519Ix = this.createEd25519Instruction(
-      streamerKeypair,
-      Buffer.from(message, "utf-8")
-    );
+    const msgBytes = this.buildRegisterMessage(streamerId, streamerKeypair.publicKey, timestamp);
+    const sig = _StreamerSDK.signMessage(msgBytes, streamerKeypair);
+    const ed25519Ix = this.createEd25519Instruction(streamerKeypair.publicKey, msgBytes, sig);
     const whitelistPda = this.deriveWhitelistEntry(this.wallet.publicKey);
     const streamerRegPda = this.deriveStreamerRegistration(streamerId);
     const registerIx = await this.program.methods.registerStreamer(
@@ -727,11 +763,9 @@ var StreamerSDK = class {
   async claimFunds(params) {
     const { streamerId, streamerKeypair, mint, solAmount, tokenAmount } = params;
     const timestamp = await this.getSolanaTimestamp();
-    const message = `claim_funds:${streamerId}:${streamerKeypair.publicKey.toBase58()}:${mint.toBase58()}:${tokenAmount.toString()}:${solAmount.toString()}:${timestamp}`;
-    const ed25519Ix = this.createEd25519Instruction(
-      streamerKeypair,
-      Buffer.from(message, "utf-8")
-    );
+    const msgBytes = this.buildClaimMessage(streamerId, streamerKeypair.publicKey, mint, tokenAmount, solAmount, timestamp);
+    const sig = _StreamerSDK.signMessage(msgBytes, streamerKeypair);
+    const ed25519Ix = this.createEd25519Instruction(streamerKeypair.publicKey, msgBytes, sig);
     const whitelistPda = this.deriveWhitelistEntry(this.wallet.publicKey);
     const streamerRegPda = this.deriveStreamerRegistration(streamerId);
     const vaultPda = this.deriveVault();
@@ -762,6 +796,54 @@ var StreamerSDK = class {
     return { txSignature };
   }
   // ═══════════════════════════════════════════════════════════════════════════
+  // Register Streamer (browser wallet — signature from Phantom/Solflare)
+  // ═══════════════════════════════════════════════════════════════════════════
+  async registerStreamerWithSignature(params) {
+    const { streamerId, streamerPublicKey, signature, timestamp } = params;
+    const msgBytes = this.buildRegisterMessage(streamerId, streamerPublicKey, timestamp);
+    const ed25519Ix = this.createEd25519Instruction(streamerPublicKey, msgBytes, signature);
+    const whitelistPda = this.deriveWhitelistEntry(this.wallet.publicKey);
+    const streamerRegPda = this.deriveStreamerRegistration(streamerId);
+    const registerIx = await this.program.methods.registerStreamer(streamerId, streamerPublicKey, new anchor.BN(timestamp)).accounts({
+      caller: this.wallet.publicKey,
+      whitelistEntry: whitelistPda,
+      streamerRegistration: streamerRegPda,
+      instructionsSysvar: web3_js.SYSVAR_INSTRUCTIONS_PUBKEY
+    }).instruction();
+    const tx = new web3_js.Transaction().add(ed25519Ix).add(registerIx);
+    const provider = this.program.provider;
+    const txSignature = await provider.sendAndConfirm(tx);
+    return { txSignature, streamerRegistrationPda: streamerRegPda };
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Claim Funds (browser wallet — signature from Phantom/Solflare)
+  // ═══════════════════════════════════════════════════════════════════════════
+  async claimFundsWithSignature(params) {
+    const { streamerId, streamerPublicKey, mint, solAmount, tokenAmount, signature, timestamp } = params;
+    const msgBytes = this.buildClaimMessage(streamerId, streamerPublicKey, mint, tokenAmount, solAmount, timestamp);
+    const ed25519Ix = this.createEd25519Instruction(streamerPublicKey, msgBytes, signature);
+    const whitelistPda = this.deriveWhitelistEntry(this.wallet.publicKey);
+    const streamerRegPda = this.deriveStreamerRegistration(streamerId);
+    const vaultPda = this.deriveVault();
+    const programTokenAccount = splToken.getAssociatedTokenAddressSync(mint, vaultPda, true);
+    const streamerTokenAccount = splToken.getAssociatedTokenAddressSync(mint, streamerPublicKey, false);
+    const claimIx = await this.program.methods.claimFunds(streamerId, solAmount, tokenAmount, new anchor.BN(timestamp)).accounts({
+      caller: this.wallet.publicKey,
+      whitelistEntry: whitelistPda,
+      streamerRegistration: streamerRegPda,
+      streamerWallet: streamerPublicKey,
+      vault: vaultPda,
+      mint,
+      programTokenAccount,
+      streamerTokenAccount,
+      instructionsSysvar: web3_js.SYSVAR_INSTRUCTIONS_PUBKEY
+    }).instruction();
+    const tx = new web3_js.Transaction().add(ed25519Ix).add(claimIx);
+    const provider = this.program.provider;
+    const txSignature = await provider.sendAndConfirm(tx);
+    return { txSignature };
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
   // Read State
   // ═══════════════════════════════════════════════════════════════════════════
   async getStreamerRegistration(streamerId) {