Merge pull request #304 from streamflow-finance/dujo/feat/expose-solana-tx-builders

Fix: expose solana tx builders

Author: dperdic-streamflow

lerna.json

@@ -1,6 +1,6 @@
 {
   "packages": ["packages/*"],
-  "version": "8.7.0-alpha.0",
+  "version": "8.7.0",
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "command": {
     "run": {

packages/common/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamflow/common",
-  "version": "8.7.0-alpha.0",
+  "version": "8.7.0",
   "description": "Common utilities and types used by streamflow packages.",
   "homepage": "https://github.com/streamflow-finance/js-sdk/",
   "type": "module",

packages/distributor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamflow/distributor",
-  "version": "8.7.0-alpha.0",
+  "version": "8.7.0",
   "description": "JavaScript SDK to interact with Streamflow Airdrop protocol.",
   "homepage": "https://github.com/streamflow-finance/js-sdk/",
   "main": "./dist/cjs/index.cjs",

packages/eslint-config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamflow/eslint-config",
-  "version": "8.7.0-alpha.0",
+  "version": "8.7.0",
   "description": "ESLint configuration for Streamflow protocol.",
   "homepage": "https://github.com/streamflow-finance/js-sdk/",
   "engines": {

packages/launchpad/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamflow/launchpad",
-  "version": "8.7.0-alpha.0",
+  "version": "8.7.0",
   "description": "JavaScript SDK to interact with Streamflow Launchpad protocol.",
   "homepage": "https://github.com/streamflow-finance/js-sdk/",
   "main": "./dist/cjs/index.cjs",

packages/staking/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamflow/staking",
-  "version": "8.7.0-alpha.0",
+  "version": "8.7.0",
   "description": "JavaScript SDK to interact with Streamflow Staking protocol.",
   "homepage": "https://github.com/streamflow-finance/js-sdk/",
   "main": "./dist/cjs/index.cjs",

packages/stream/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamflow/stream",
-  "version": "8.7.0-alpha.0",
+  "version": "8.7.0",
   "description": "JavaScript SDK to interact with Streamflow protocol.",
   "homepage": "https://github.com/streamflow-finance/js-sdk/",
   "main": "./dist/cjs/index.cjs",

packages/stream/solana/StreamClient.ts

@@ -221,6 +221,10 @@ export class SolanaStreamClient extends BaseStreamClient {
   /**
    * Builds transaction instructions for creating a new stream/vesting contract without creating a transaction.
    * All fees are paid by sender (escrow metadata account rent, escrow token account rent, recipient's associated token account rent, Streamflow's service fee).
+   *
+   * For native SOL (isNative: true), SOL wrapping instructions are automatically included in the correct order
+   * (before stream creation) to ensure the WSOL account exists when the stream creation instruction executes.
+   *
    * @param {ICreateStreamData} data - Stream parameters including recipient, token, amount, schedule, and permissions
    * @param {Omit<ICreateStreamSolanaExt, "sender"> & { senderPublicKey: PublicKey }} extParams - Transaction configuration including sender public key, native token handling, and custom instructions
    * @returns Transaction instructions and metadata ID
@@ -250,6 +254,16 @@ export class SolanaStreamClient extends BaseStreamClient {
       tokenProgramId ? new PublicKey(tokenProgramId) : undefined,
     );
 
+    // CRITICAL: SOL wrapping must happen BEFORE stream creation instructions
+    // This ensures the WSOL account exists and has sufficient balance when stream creation executes
+    if (isNative) {
+      const totalFee = await this.getTotalFee({
+        address: partnerPublicKey.toString(),
+      });
+      const totalAmount = calculateTotalAmountToDeposit(amount, totalFee);
+      ixs.push(...(await prepareWrappedAccount(this.connection, tempSender.publicKey!, totalAmount)));
+    }
+
     const {
       ixs: createIxs,
       metadata,
@@ -261,14 +275,6 @@ export class SolanaStreamClient extends BaseStreamClient {
 
     ixs.push(...createIxs);
 
-    if (isNative) {
-      const totalFee = await this.getTotalFee({
-        address: partnerPublicKey.toString(),
-      });
-      const totalAmount = calculateTotalAmountToDeposit(amount, totalFee);
-      ixs.push(...(await prepareWrappedAccount(this.connection, tempSender.publicKey!, totalAmount)));
-    }
-
     await this.applyCustomAfterInstructions(ixs, customInstructions, metadataPubKey);
 
     return {
@@ -281,6 +287,10 @@ export class SolanaStreamClient extends BaseStreamClient {
   /**
    * Builds a transaction for creating a new stream/vesting contract without signing or executing it.
    * All fees are paid by sender (escrow metadata account rent, escrow token account rent, recipient's associated token account rent, Streamflow's service fee).
+   *
+   * For native SOL (isNative: true), SOL wrapping instructions are automatically included in the correct order
+   * (before stream creation) to ensure the WSOL account exists when the stream creation instruction executes.
+   *
    * @param {ICreateStreamData} data - Stream parameters including recipient, token, amount, schedule, and permissions
    * @param {Omit<ICreateStreamSolanaExt, "sender"> & { senderPublicKey: PublicKey }} extParams - Transaction configuration including sender public key, native token handling, and custom instructions
    * @returns Transaction and metadata information
@@ -841,6 +851,25 @@ export class SolanaStreamClient extends BaseStreamClient {
   /**
    * Builds multiple transactions for creating stream/vesting contracts without signing or executing them.
    * All fees are paid by sender (escrow metadata account rent, escrow token account rent, recipient's associated token account rent, Streamflow's service fee).
+   *
+   * IMPORTANT: When using native SOL (isNative: true), you MUST execute the prepareTx FIRST and wait for confirmation
+   * before executing the stream creation transactions. Otherwise, stream creation will fail with "InvalidAccountData".
+   *
+   * @example
+   * ```typescript
+   * const result = await streamClient.buildCreateMultipleTransactions(data, { isNative: true, senderPublicKey });
+   *
+   * // CRITICAL: Execute prepareTx first if it exists
+   * if (result.prepareTx) {
+   *   await connection.sendAndConfirmTransaction(result.prepareTx, [signer]);
+   * }
+   *
+   * // Only then execute stream creation transactions
+   * for (const item of result.transactions) {
+   *   await connection.sendAndConfirmTransaction(item.tx, [signer]);
+   * }
+   * ```
+   *
    * @param {ICreateMultipleStreamData} data - Stream base parameters and array of recipients with individual amounts and settings
    * @param {Omit<ICreateStreamSolanaExt, "sender"> & { senderPublicKey: PublicKey }} extParams - Transaction configuration including sender public key, native token handling, and custom instructions
    * @returns Multiple transaction information