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

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as anchor from '@coral-xyz/anchor';
-import { Program } from '@coral-xyz/anchor';
-import { PublicKey, Connection, Keypair } from '@solana/web3.js';
+import { BN, Program } from '@coral-xyz/anchor';
+import { PublicKey, Keypair, Connection, TransactionInstruction } from '@solana/web3.js';
 
 /**
  * Program IDL in camelCase format in order to be used in JS/TS.
@@ -3011,6 +3011,95 @@ declare class KickFunSDK {
     /** Calculate K for a given target SOL and curve supply */
     static calculateK(curveSupply: bigint, targetSol: bigint): bigint;
 }
+interface RegisterStreamerParams {
+    streamerId: string;
+    streamerKeypair: Keypair;
+}
+interface RegisterStreamerWithSignatureParams {
+    streamerId: string;
+    streamerPublicKey: PublicKey;
+    signature: Uint8Array;
+    timestamp: number;
+}
+interface RegisterStreamerResult {
+    txSignature: string;
+    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;
+    signature: Uint8Array;
+    timestamp: number;
+}
+interface ClaimFundsResult {
+    txSignature: string;
+}
+declare class StreamerSDK {
+    program: Program<any>;
+    connection: Connection;
+    wallet: anchor.Wallet;
+    constructor(program: Program<any>, wallet: anchor.Wallet);
+    derivePlatformConfig(): PublicKey;
+    deriveWhitelistEntry(wallet: PublicKey): PublicKey;
+    deriveStreamerRegistration(streamerId: string): PublicKey;
+    deriveVault(): PublicKey;
+    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;
+        verifiedAt: number;
+        registeredBy: PublicKey;
+        createdAt: number;
+    } | null>;
+    isWhitelisted(wallet: PublicKey): Promise<boolean>;
+    getVaultBalance(mint?: PublicKey): Promise<{
+        sol: bigint;
+        tokens: bigint;
+    }>;
+}
 /** Format raw token amount to human-readable */
 declare function formatTokens(raw: bigint): string;
 /** Format lamports to SOL */
@@ -3020,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 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, STREAMER_PROGRAM_ID, 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 { Program } from '@coral-xyz/anchor';
-import { PublicKey, Connection, Keypair } from '@solana/web3.js';
+import { BN, Program } from '@coral-xyz/anchor';
+import { PublicKey, Keypair, Connection, TransactionInstruction } from '@solana/web3.js';
 
 /**
  * Program IDL in camelCase format in order to be used in JS/TS.
@@ -3011,6 +3011,95 @@ declare class KickFunSDK {
     /** Calculate K for a given target SOL and curve supply */
     static calculateK(curveSupply: bigint, targetSol: bigint): bigint;
 }
+interface RegisterStreamerParams {
+    streamerId: string;
+    streamerKeypair: Keypair;
+}
+interface RegisterStreamerWithSignatureParams {
+    streamerId: string;
+    streamerPublicKey: PublicKey;
+    signature: Uint8Array;
+    timestamp: number;
+}
+interface RegisterStreamerResult {
+    txSignature: string;
+    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;
+    signature: Uint8Array;
+    timestamp: number;
+}
+interface ClaimFundsResult {
+    txSignature: string;
+}
+declare class StreamerSDK {
+    program: Program<any>;
+    connection: Connection;
+    wallet: anchor.Wallet;
+    constructor(program: Program<any>, wallet: anchor.Wallet);
+    derivePlatformConfig(): PublicKey;
+    deriveWhitelistEntry(wallet: PublicKey): PublicKey;
+    deriveStreamerRegistration(streamerId: string): PublicKey;
+    deriveVault(): PublicKey;
+    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;
+        verifiedAt: number;
+        registeredBy: PublicKey;
+        createdAt: number;
+    } | null>;
+    isWhitelisted(wallet: PublicKey): Promise<boolean>;
+    getVaultBalance(mint?: PublicKey): Promise<{
+        sol: bigint;
+        tokens: bigint;
+    }>;
+}
 /** Format raw token amount to human-readable */
 declare function formatTokens(raw: bigint): string;
 /** Format lamports to SOL */
@@ -3020,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 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, STREAMER_PROGRAM_ID, 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

@@ -3,6 +3,11 @@
 var anchor = require('@coral-xyz/anchor');
 var web3_js = require('@solana/web3.js');
 var splToken = require('@solana/spl-token');
+var nacl = require('tweetnacl');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var nacl__default = /*#__PURE__*/_interopDefault(nacl);
 
 // src/sdk/index.ts
 var PROGRAM_ID = new web3_js.PublicKey("6o7oTqg2CfvcMCJTLNEJsef7c875zGpTvcnFctNAjudL");
@@ -135,6 +140,22 @@ var KickFunSDK = class {
     preInstructions.push(
       web3_js.ComputeBudgetProgram.setComputeUnitLimit({ units: computeUnits })
     );
+    preInstructions.push(
+      splToken.createAssociatedTokenAccountIdempotentInstruction(
+        this.wallet.publicKey,
+        streamerTokenAccount,
+        streamerVaultPda,
+        mint
+      )
+    );
+    preInstructions.push(
+      splToken.createAssociatedTokenAccountIdempotentInstruction(
+        this.wallet.publicKey,
+        adminTokenAccount,
+        ADMIN_WALLET,
+        mint
+      )
+    );
     const tx = await this.program.methods.buyTokens(solLamports).accountsPartial({
       contributor: this.wallet.publicKey,
       launchpad: this.launchpadPda,
@@ -618,6 +639,252 @@ var KickFunSDK = class {
     return numerator / denominator;
   }
 };
+var StreamerSDK = class _StreamerSDK {
+  constructor(program, wallet) {
+    this.program = program;
+    this.connection = program.provider.connection;
+    this.wallet = wallet;
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // PDA Derivation Helpers
+  // ═══════════════════════════════════════════════════════════════════════════
+  derivePlatformConfig() {
+    const [pda] = web3_js.PublicKey.findProgramAddressSync(
+      [Buffer.from("platform_config")],
+      this.program.programId
+    );
+    return pda;
+  }
+  deriveWhitelistEntry(wallet) {
+    const [pda] = web3_js.PublicKey.findProgramAddressSync(
+      [Buffer.from("whitelist"), wallet.toBuffer()],
+      this.program.programId
+    );
+    return pda;
+  }
+  deriveStreamerRegistration(streamerId) {
+    const [pda] = web3_js.PublicKey.findProgramAddressSync(
+      [Buffer.from("streamer"), Buffer.from(streamerId)],
+      this.program.programId
+    );
+    return pda;
+  }
+  deriveVault() {
+    const [pda] = web3_js.PublicKey.findProgramAddressSync(
+      [Buffer.from("vault")],
+      this.program.programId
+    );
+    return pda;
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Helpers
+  // ═══════════════════════════════════════════════════════════════════════════
+  async getSolanaTimestamp() {
+    const slot = await this.connection.getSlot();
+    const blockTime = await this.connection.getBlockTime(slot);
+    if (!blockTime) throw new Error("Failed to get block time");
+    return blockTime;
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // 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: 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 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(
+      streamerId,
+      streamerKeypair.publicKey,
+      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
+  // ═══════════════════════════════════════════════════════════════════════════
+  async claimFunds(params) {
+    const { streamerId, streamerKeypair, mint, solAmount, tokenAmount } = params;
+    const timestamp = await this.getSolanaTimestamp();
+    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();
+    const programTokenAccount = splToken.getAssociatedTokenAddressSync(
+      mint,
+      vaultPda,
+      true
+    );
+    const streamerTokenAccount = splToken.getAssociatedTokenAddressSync(
+      mint,
+      streamerKeypair.publicKey,
+      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: streamerKeypair.publicKey,
+      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 };
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // 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) {
+    const pda = this.deriveStreamerRegistration(streamerId);
+    try {
+      const account = await this.program.account.streamerRegistration.fetch(pda);
+      return {
+        streamerId: account.streamerId,
+        wallet: account.wallet,
+        verifiedAt: account.verifiedAt.toNumber(),
+        registeredBy: account.registeredBy,
+        createdAt: account.createdAt.toNumber()
+      };
+    } catch {
+      return null;
+    }
+  }
+  async isWhitelisted(wallet) {
+    const pda = this.deriveWhitelistEntry(wallet);
+    try {
+      const account = await this.program.account.whitelistEntry.fetch(pda);
+      return account.active;
+    } catch {
+      return false;
+    }
+  }
+  async getVaultBalance(mint) {
+    const vaultPda = this.deriveVault();
+    const sol = BigInt(await this.connection.getBalance(vaultPda));
+    let tokens = 0n;
+    if (mint) {
+      const ata = splToken.getAssociatedTokenAddressSync(mint, vaultPda, true);
+      try {
+        const account = await splToken.getAccount(this.connection, ata);
+        tokens = account.amount;
+      } catch {
+      }
+    }
+    return { sol, tokens };
+  }
+};
 function formatTokens(raw) {
   const tokens = Number(raw) / 10 ** TOKEN_DECIMALS;
   return tokens.toLocaleString(void 0, { maximumFractionDigits: 2 });
@@ -643,6 +910,7 @@ exports.LP_PERCENT = LP_PERCENT;
 exports.METADATA_PROGRAM_ID = METADATA_PROGRAM_ID;
 exports.PROGRAM_ID = PROGRAM_ID;
 exports.STREAMER_PROGRAM_ID = STREAMER_PROGRAM_ID;
+exports.StreamerSDK = StreamerSDK;
 exports.TOKEN_DECIMALS = TOKEN_DECIMALS;
 exports.TREASURY_PERCENT = TREASURY_PERCENT;
 exports.formatSol = formatSol;