@stableflow/utils-solana 0.0.0-experimental-5a8afd7389-20260703

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StableFlow AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# @stableflow/utils-solana
+
+Solana utilities for the StableFlow SDK: RPC fallback connections and associated-token-account helpers.
+
+## Installation
+
+```bash
+pnpm add @stableflow/utils-solana @stableflow/core
+```
+
+**Peer dependencies** (install in your app):
+
+- `@solana/spl-token` ^0.4.14
+- `@solana/web3.js` ^1.98.4
+
+This package is primarily used by `@stableflow/wallet-solana` and some cross-chain wallet paths. Application code rarely imports it directly.
+
+## Main exports
+
+| Export | Description |
+|--------|-------------|
+| `createSolanaFallbackConnection` | `Connection` proxy with automatic RPC failover |
+| `getAvailableSolanaRpcUrl` | Health-check and return a working RPC URL |
+| `getDestinationAssociatedTokenAddress` | Resolve or detect need to create recipient ATA |
+
+See `dist/index.d.ts` after `pnpm build`.
+
+## See also
+
+- [Developer Guide](../../DEVELOPER_GUIDE.md)
+- [@stableflow/wallet-solana](../wallet-solana/README.md)

package/dist/index.d.mts

@@ -0,0 +1,12 @@
+import { Connection } from '@solana/web3.js';
+
+declare const createSolanaFallbackConnection: (rpcUrls: string[]) => Connection;
+declare const getAvailableSolanaRpcUrl: (options?: {
+    isQuerySignature?: boolean;
+}) => Promise<string>;
+declare const getDestinationAssociatedTokenAddress: (params: any) => Promise<{
+    needCreateTokenAccount: boolean;
+    associatedTokenAddress: string;
+}>;
+
+export { createSolanaFallbackConnection, getAvailableSolanaRpcUrl, getDestinationAssociatedTokenAddress };

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { Connection } from '@solana/web3.js';
+
+declare const createSolanaFallbackConnection: (rpcUrls: string[]) => Connection;
+declare const getAvailableSolanaRpcUrl: (options?: {
+    isQuerySignature?: boolean;
+}) => Promise<string>;
+declare const getDestinationAssociatedTokenAddress: (params: any) => Promise<{
+    needCreateTokenAccount: boolean;
+    associatedTokenAddress: string;
+}>;
+
+export { createSolanaFallbackConnection, getAvailableSolanaRpcUrl, getDestinationAssociatedTokenAddress };

package/dist/index.js

@@ -0,0 +1,164 @@
+'use strict';
+
+var splToken = require('@solana/spl-token');
+var web3_js = require('@solana/web3.js');
+var core = require('@stableflow/core');
+
+// src/index.ts
+var SOLANA_RPC_TIMEOUT_MS = 5e3;
+var withTimeout = async (promise, timeoutMs) => {
+  return await Promise.race([
+    promise,
+    new Promise((_, reject) => {
+      setTimeout(() => reject(new Error(`Solana RPC timeout after ${timeoutMs}ms`)), timeoutMs);
+    })
+  ]);
+};
+var isRpcUnavailableError = (error) => {
+  const message = error?.message?.toLowerCase?.() || "";
+  return message.includes("fetch") || message.includes("timeout") || message.includes("failed to fetch") || message.includes("503") || message.includes("429") || message.includes("403") || message.includes("401") || message.includes("network");
+};
+var createSolanaFallbackConnection = (rpcUrls) => {
+  if (!rpcUrls?.length) {
+    throw new Error("No Solana RPC URLs configured");
+  }
+  const cs = new core.Csl(core.OpenAPI.DEBUG);
+  const csl = cs.log;
+  const connections = rpcUrls.map((rpcUrl) => new web3_js.Connection(rpcUrl, {
+    commitment: "confirmed"
+  }));
+  let activeIndex = 0;
+  let active = connections[activeIndex];
+  return new Proxy(connections[0], {
+    get(_, prop, receiver) {
+      const activeValue = Reflect.get(active, prop, receiver);
+      if (typeof activeValue !== "function") {
+        return activeValue;
+      }
+      return (...args) => {
+        const callAtIndex = (index) => {
+          const targetConnection = connections[index];
+          const method = targetConnection[prop];
+          if (typeof method !== "function") {
+            return method;
+          }
+          return method.apply(targetConnection, args);
+        };
+        const tryWithFallback = async () => {
+          let index = activeIndex;
+          let attempts = 0;
+          let lastError = null;
+          while (attempts < connections.length) {
+            try {
+              const result = await callAtIndex(index);
+              activeIndex = index;
+              active = connections[activeIndex];
+              return result;
+            } catch (error) {
+              lastError = error;
+              if (!isRpcUnavailableError(error)) {
+                throw error;
+              }
+              const nextIndex = (index + 1) % connections.length;
+              csl(
+                "solana rpc fallback",
+                "yellow-400",
+                "rpc unavailable, switching endpoint (%d -> %d): %o",
+                index,
+                nextIndex,
+                error
+              );
+              index = nextIndex;
+              attempts += 1;
+            }
+          }
+          throw lastError;
+        };
+        return tryWithFallback();
+      };
+    }
+  });
+};
+var probeRpcHealth = async (rpcUrl) => {
+  const response = await withTimeout(fetch(rpcUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      id: 1,
+      method: "getLatestBlockhash",
+      params: [{ commitment: "confirmed" }]
+    })
+  }), SOLANA_RPC_TIMEOUT_MS);
+  if (!response.ok) {
+    throw new Error(`Solana RPC unavailable: ${rpcUrl}, status=${response.status}`);
+  }
+  const body = await response.json();
+  if (body?.error) {
+    throw new Error(
+      `Solana RPC error: ${rpcUrl}, code=${body.error.code}, message=${body.error.message || "unknown"}`
+    );
+  }
+  if (!body?.result) {
+    throw new Error(`Solana RPC invalid response: ${rpcUrl}`);
+  }
+};
+var getAvailableSolanaRpcUrl = async (options) => {
+  const cs = new core.Csl(core.OpenAPI.DEBUG);
+  const csl = cs.log;
+  const rpcUrls = core.getChainRpcUrl("sol").rpcUrls;
+  if (!rpcUrls?.length) {
+    throw new Error("No Solana RPC URLs configured");
+  }
+  const formatRpcUrl = (rpcUrl) => {
+    return rpcUrl;
+  };
+  for (const rpcUrl of rpcUrls) {
+    try {
+      await probeRpcHealth(rpcUrl);
+      return formatRpcUrl(rpcUrl);
+    } catch (error) {
+      csl("solana rpc health", "yellow-400", "rpc health check failed: %o", error);
+    }
+  }
+  return formatRpcUrl(rpcUrls[0]);
+};
+var getDestinationAssociatedTokenAddress = async (params) => {
+  const {
+    recipient,
+    toToken
+  } = params;
+  const cs = new core.Csl(core.OpenAPI.DEBUG);
+  const csl = cs.log;
+  const result = {
+    needCreateTokenAccount: false,
+    associatedTokenAddress: ""
+  };
+  if (toToken.chainType !== "sol") {
+    return result;
+  }
+  try {
+    const connection = createSolanaFallbackConnection(core.getChainRpcUrl("sol").rpcUrls);
+    const wallet = new web3_js.PublicKey(recipient);
+    const TOKEN_MINT = new web3_js.PublicKey(toToken.contractAddress);
+    const ata = splToken.getAssociatedTokenAddressSync(TOKEN_MINT, wallet);
+    const accountInfo = await connection.getAccountInfo(ata);
+    csl("getDestinationAssociatedTokenAddress", "purple-400", "accountInfo: %o", accountInfo);
+    if (!accountInfo) {
+      result.needCreateTokenAccount = true;
+      return result;
+    }
+    result.associatedTokenAddress = ata.toBase58();
+  } catch (error) {
+    csl("getDestinationAssociatedTokenAddress", "red-500", "getDestinationAssociatedTokenAddress failed: %o", error);
+  }
+  return result;
+};
+
+exports.createSolanaFallbackConnection = createSolanaFallbackConnection;
+exports.getAvailableSolanaRpcUrl = getAvailableSolanaRpcUrl;
+exports.getDestinationAssociatedTokenAddress = getDestinationAssociatedTokenAddress;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["Csl","OpenAPI","Connection","getChainRpcUrl","PublicKey","getAssociatedTokenAddressSync"],"mappings":"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","file":"index.js","sourcesContent":["import { getAssociatedTokenAddressSync } from \"@solana/spl-token\";\nimport { Connection, PublicKey } from \"@solana/web3.js\";\nimport { Csl, OpenAPI, getChainRpcUrl } from '@stableflow/core';\n\nconst SOLANA_RPC_TIMEOUT_MS = 5000;\n\nconst withTimeout = async <T>(promise: Promise<T>, timeoutMs: number) => {\n  return await Promise.race([\n    promise,\n    new Promise<T>((_, reject) => {\n      setTimeout(() => reject(new Error(`Solana RPC timeout after ${timeoutMs}ms`)), timeoutMs);\n    }),\n  ]);\n};\n\nconst isRpcUnavailableError = (error: unknown) => {\n  const message = (error as Error)?.message?.toLowerCase?.() || \"\";\n  return (\n    message.includes(\"fetch\") ||\n    message.includes(\"timeout\") ||\n    message.includes(\"failed to fetch\") ||\n    message.includes(\"503\") ||\n    message.includes(\"429\") ||\n    message.includes(\"403\") ||\n    message.includes(\"401\") ||\n    message.includes(\"network\")\n  );\n};\n\nexport const createSolanaFallbackConnection = (rpcUrls: string[]) => {\n  if (!rpcUrls?.length) {\n    throw new Error(\"No Solana RPC URLs configured\");\n  }\n\n  const cs = new Csl(OpenAPI.DEBUG);\n  const csl = cs.log;\n  const connections = rpcUrls.map((rpcUrl) => new Connection(rpcUrl, {\n    commitment: \"confirmed\",\n  }));\n  let activeIndex = 0;\n  let active: Connection = connections[activeIndex];\n\n  return new Proxy(connections[0], {\n    get(_, prop, receiver) {\n      const activeValue = Reflect.get(active, prop, receiver);\n      if (typeof activeValue !== \"function\") {\n        return activeValue;\n      }\n\n      return (...args: unknown[]) => {\n        const callAtIndex = (index: number) => {\n          const targetConnection = connections[index];\n          const method = (targetConnection as any)[prop];\n          if (typeof method !== \"function\") {\n            return method;\n          }\n          return method.apply(targetConnection, args);\n        };\n\n        const tryWithFallback = async () => {\n          let index = activeIndex;\n          let attempts = 0;\n          let lastError: unknown = null;\n\n          while (attempts < connections.length) {\n            try {\n              const result = await callAtIndex(index);\n              activeIndex = index;\n              active = connections[activeIndex];\n              return result;\n            } catch (error) {\n              lastError = error;\n              if (!isRpcUnavailableError(error)) {\n                throw error;\n              }\n\n              const nextIndex = (index + 1) % connections.length;\n              csl(\n                \"solana rpc fallback\",\n                \"yellow-400\",\n                \"rpc unavailable, switching endpoint (%d -> %d): %o\",\n                index,\n                nextIndex,\n                error\n              );\n              index = nextIndex;\n              attempts += 1;\n            }\n          }\n\n          throw lastError;\n        };\n\n        return tryWithFallback();\n      };\n    },\n  }) as Connection;\n};\n\nconst probeRpcHealth = async (rpcUrl: string) => {\n  const response = await withTimeout(fetch(rpcUrl, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({\n      jsonrpc: \"2.0\",\n      id: 1,\n      method: \"getLatestBlockhash\",\n      params: [{ commitment: \"confirmed\" }],\n    }),\n  }), SOLANA_RPC_TIMEOUT_MS);\n\n  if (!response.ok) {\n    throw new Error(`Solana RPC unavailable: ${rpcUrl}, status=${response.status}`);\n  }\n\n  const body = await response.json() as {\n    result?: unknown;\n    error?: { code?: number; message?: string; data?: unknown; };\n  };\n\n  if (body?.error) {\n    throw new Error(\n      `Solana RPC error: ${rpcUrl}, code=${body.error.code}, message=${body.error.message || \"unknown\"}`\n    );\n  }\n\n  if (!body?.result) {\n    throw new Error(`Solana RPC invalid response: ${rpcUrl}`);\n  }\n};\n\nexport const getAvailableSolanaRpcUrl = async (options?: { isQuerySignature?: boolean; }) => {\n  const { } = options || {};\n\n  const cs = new Csl(OpenAPI.DEBUG);\n  const csl = cs.log;\n\n  const rpcUrls = getChainRpcUrl(\"sol\").rpcUrls;\n  if (!rpcUrls?.length) {\n    throw new Error(\"No Solana RPC URLs configured\");\n  }\n\n  const formatRpcUrl = (rpcUrl: string) => {\n    return rpcUrl;\n  };\n\n  for (const rpcUrl of rpcUrls) {\n    try {\n      await probeRpcHealth(rpcUrl);\n      return formatRpcUrl(rpcUrl);\n    } catch (error) {\n      csl(\"solana rpc health\", \"yellow-400\", \"rpc health check failed: %o\", error);\n    }\n  }\n\n  return formatRpcUrl(rpcUrls[0]);\n};\n\nexport const getDestinationAssociatedTokenAddress = async (params: any) => {\n  const {\n    recipient,\n    toToken,\n  } = params;\n\n  const cs = new Csl(OpenAPI.DEBUG);\n  const csl = cs.log;\n\n  const result = {\n    needCreateTokenAccount: false,\n    associatedTokenAddress: \"\",\n  };\n\n  if (toToken.chainType !== \"sol\") {\n    return result;\n  }\n\n  try {\n    const connection = createSolanaFallbackConnection(getChainRpcUrl(\"sol\").rpcUrls);\n    const wallet = new PublicKey(recipient);\n    const TOKEN_MINT = new PublicKey(toToken.contractAddress);\n\n    const ata = getAssociatedTokenAddressSync(TOKEN_MINT, wallet);\n\n    const accountInfo = await connection.getAccountInfo(ata);\n\n    csl(\"getDestinationAssociatedTokenAddress\", \"purple-400\", \"accountInfo: %o\", accountInfo);\n\n    if (!accountInfo) {\n      result.needCreateTokenAccount = true;\n      return result;\n    }\n\n    result.associatedTokenAddress = ata.toBase58();\n  } catch (error) {\n    csl(\"getDestinationAssociatedTokenAddress\", \"red-500\", \"getDestinationAssociatedTokenAddress failed: %o\", error);\n  }\n\n  return result;\n};\n"]}

package/dist/index.mjs

@@ -0,0 +1,160 @@
+import { getAssociatedTokenAddressSync } from '@solana/spl-token';
+import { Connection, PublicKey } from '@solana/web3.js';
+import { Csl, OpenAPI, getChainRpcUrl } from '@stableflow/core';
+
+// src/index.ts
+var SOLANA_RPC_TIMEOUT_MS = 5e3;
+var withTimeout = async (promise, timeoutMs) => {
+  return await Promise.race([
+    promise,
+    new Promise((_, reject) => {
+      setTimeout(() => reject(new Error(`Solana RPC timeout after ${timeoutMs}ms`)), timeoutMs);
+    })
+  ]);
+};
+var isRpcUnavailableError = (error) => {
+  const message = error?.message?.toLowerCase?.() || "";
+  return message.includes("fetch") || message.includes("timeout") || message.includes("failed to fetch") || message.includes("503") || message.includes("429") || message.includes("403") || message.includes("401") || message.includes("network");
+};
+var createSolanaFallbackConnection = (rpcUrls) => {
+  if (!rpcUrls?.length) {
+    throw new Error("No Solana RPC URLs configured");
+  }
+  const cs = new Csl(OpenAPI.DEBUG);
+  const csl = cs.log;
+  const connections = rpcUrls.map((rpcUrl) => new Connection(rpcUrl, {
+    commitment: "confirmed"
+  }));
+  let activeIndex = 0;
+  let active = connections[activeIndex];
+  return new Proxy(connections[0], {
+    get(_, prop, receiver) {
+      const activeValue = Reflect.get(active, prop, receiver);
+      if (typeof activeValue !== "function") {
+        return activeValue;
+      }
+      return (...args) => {
+        const callAtIndex = (index) => {
+          const targetConnection = connections[index];
+          const method = targetConnection[prop];
+          if (typeof method !== "function") {
+            return method;
+          }
+          return method.apply(targetConnection, args);
+        };
+        const tryWithFallback = async () => {
+          let index = activeIndex;
+          let attempts = 0;
+          let lastError = null;
+          while (attempts < connections.length) {
+            try {
+              const result = await callAtIndex(index);
+              activeIndex = index;
+              active = connections[activeIndex];
+              return result;
+            } catch (error) {
+              lastError = error;
+              if (!isRpcUnavailableError(error)) {
+                throw error;
+              }
+              const nextIndex = (index + 1) % connections.length;
+              csl(
+                "solana rpc fallback",
+                "yellow-400",
+                "rpc unavailable, switching endpoint (%d -> %d): %o",
+                index,
+                nextIndex,
+                error
+              );
+              index = nextIndex;
+              attempts += 1;
+            }
+          }
+          throw lastError;
+        };
+        return tryWithFallback();
+      };
+    }
+  });
+};
+var probeRpcHealth = async (rpcUrl) => {
+  const response = await withTimeout(fetch(rpcUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      id: 1,
+      method: "getLatestBlockhash",
+      params: [{ commitment: "confirmed" }]
+    })
+  }), SOLANA_RPC_TIMEOUT_MS);
+  if (!response.ok) {
+    throw new Error(`Solana RPC unavailable: ${rpcUrl}, status=${response.status}`);
+  }
+  const body = await response.json();
+  if (body?.error) {
+    throw new Error(
+      `Solana RPC error: ${rpcUrl}, code=${body.error.code}, message=${body.error.message || "unknown"}`
+    );
+  }
+  if (!body?.result) {
+    throw new Error(`Solana RPC invalid response: ${rpcUrl}`);
+  }
+};
+var getAvailableSolanaRpcUrl = async (options) => {
+  const cs = new Csl(OpenAPI.DEBUG);
+  const csl = cs.log;
+  const rpcUrls = getChainRpcUrl("sol").rpcUrls;
+  if (!rpcUrls?.length) {
+    throw new Error("No Solana RPC URLs configured");
+  }
+  const formatRpcUrl = (rpcUrl) => {
+    return rpcUrl;
+  };
+  for (const rpcUrl of rpcUrls) {
+    try {
+      await probeRpcHealth(rpcUrl);
+      return formatRpcUrl(rpcUrl);
+    } catch (error) {
+      csl("solana rpc health", "yellow-400", "rpc health check failed: %o", error);
+    }
+  }
+  return formatRpcUrl(rpcUrls[0]);
+};
+var getDestinationAssociatedTokenAddress = async (params) => {
+  const {
+    recipient,
+    toToken
+  } = params;
+  const cs = new Csl(OpenAPI.DEBUG);
+  const csl = cs.log;
+  const result = {
+    needCreateTokenAccount: false,
+    associatedTokenAddress: ""
+  };
+  if (toToken.chainType !== "sol") {
+    return result;
+  }
+  try {
+    const connection = createSolanaFallbackConnection(getChainRpcUrl("sol").rpcUrls);
+    const wallet = new PublicKey(recipient);
+    const TOKEN_MINT = new PublicKey(toToken.contractAddress);
+    const ata = getAssociatedTokenAddressSync(TOKEN_MINT, wallet);
+    const accountInfo = await connection.getAccountInfo(ata);
+    csl("getDestinationAssociatedTokenAddress", "purple-400", "accountInfo: %o", accountInfo);
+    if (!accountInfo) {
+      result.needCreateTokenAccount = true;
+      return result;
+    }
+    result.associatedTokenAddress = ata.toBase58();
+  } catch (error) {
+    csl("getDestinationAssociatedTokenAddress", "red-500", "getDestinationAssociatedTokenAddress failed: %o", error);
+  }
+  return result;
+};
+
+export { createSolanaFallbackConnection, getAvailableSolanaRpcUrl, getDestinationAssociatedTokenAddress };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { getAssociatedTokenAddressSync } from \"@solana/spl-token\";\nimport { Connection, PublicKey } from \"@solana/web3.js\";\nimport { Csl, OpenAPI, getChainRpcUrl } from '@stableflow/core';\n\nconst SOLANA_RPC_TIMEOUT_MS = 5000;\n\nconst withTimeout = async <T>(promise: Promise<T>, timeoutMs: number) => {\n  return await Promise.race([\n    promise,\n    new Promise<T>((_, reject) => {\n      setTimeout(() => reject(new Error(`Solana RPC timeout after ${timeoutMs}ms`)), timeoutMs);\n    }),\n  ]);\n};\n\nconst isRpcUnavailableError = (error: unknown) => {\n  const message = (error as Error)?.message?.toLowerCase?.() || \"\";\n  return (\n    message.includes(\"fetch\") ||\n    message.includes(\"timeout\") ||\n    message.includes(\"failed to fetch\") ||\n    message.includes(\"503\") ||\n    message.includes(\"429\") ||\n    message.includes(\"403\") ||\n    message.includes(\"401\") ||\n    message.includes(\"network\")\n  );\n};\n\nexport const createSolanaFallbackConnection = (rpcUrls: string[]) => {\n  if (!rpcUrls?.length) {\n    throw new Error(\"No Solana RPC URLs configured\");\n  }\n\n  const cs = new Csl(OpenAPI.DEBUG);\n  const csl = cs.log;\n  const connections = rpcUrls.map((rpcUrl) => new Connection(rpcUrl, {\n    commitment: \"confirmed\",\n  }));\n  let activeIndex = 0;\n  let active: Connection = connections[activeIndex];\n\n  return new Proxy(connections[0], {\n    get(_, prop, receiver) {\n      const activeValue = Reflect.get(active, prop, receiver);\n      if (typeof activeValue !== \"function\") {\n        return activeValue;\n      }\n\n      return (...args: unknown[]) => {\n        const callAtIndex = (index: number) => {\n          const targetConnection = connections[index];\n          const method = (targetConnection as any)[prop];\n          if (typeof method !== \"function\") {\n            return method;\n          }\n          return method.apply(targetConnection, args);\n        };\n\n        const tryWithFallback = async () => {\n          let index = activeIndex;\n          let attempts = 0;\n          let lastError: unknown = null;\n\n          while (attempts < connections.length) {\n            try {\n              const result = await callAtIndex(index);\n              activeIndex = index;\n              active = connections[activeIndex];\n              return result;\n            } catch (error) {\n              lastError = error;\n              if (!isRpcUnavailableError(error)) {\n                throw error;\n              }\n\n              const nextIndex = (index + 1) % connections.length;\n              csl(\n                \"solana rpc fallback\",\n                \"yellow-400\",\n                \"rpc unavailable, switching endpoint (%d -> %d): %o\",\n                index,\n                nextIndex,\n                error\n              );\n              index = nextIndex;\n              attempts += 1;\n            }\n          }\n\n          throw lastError;\n        };\n\n        return tryWithFallback();\n      };\n    },\n  }) as Connection;\n};\n\nconst probeRpcHealth = async (rpcUrl: string) => {\n  const response = await withTimeout(fetch(rpcUrl, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({\n      jsonrpc: \"2.0\",\n      id: 1,\n      method: \"getLatestBlockhash\",\n      params: [{ commitment: \"confirmed\" }],\n    }),\n  }), SOLANA_RPC_TIMEOUT_MS);\n\n  if (!response.ok) {\n    throw new Error(`Solana RPC unavailable: ${rpcUrl}, status=${response.status}`);\n  }\n\n  const body = await response.json() as {\n    result?: unknown;\n    error?: { code?: number; message?: string; data?: unknown; };\n  };\n\n  if (body?.error) {\n    throw new Error(\n      `Solana RPC error: ${rpcUrl}, code=${body.error.code}, message=${body.error.message || \"unknown\"}`\n    );\n  }\n\n  if (!body?.result) {\n    throw new Error(`Solana RPC invalid response: ${rpcUrl}`);\n  }\n};\n\nexport const getAvailableSolanaRpcUrl = async (options?: { isQuerySignature?: boolean; }) => {\n  const { } = options || {};\n\n  const cs = new Csl(OpenAPI.DEBUG);\n  const csl = cs.log;\n\n  const rpcUrls = getChainRpcUrl(\"sol\").rpcUrls;\n  if (!rpcUrls?.length) {\n    throw new Error(\"No Solana RPC URLs configured\");\n  }\n\n  const formatRpcUrl = (rpcUrl: string) => {\n    return rpcUrl;\n  };\n\n  for (const rpcUrl of rpcUrls) {\n    try {\n      await probeRpcHealth(rpcUrl);\n      return formatRpcUrl(rpcUrl);\n    } catch (error) {\n      csl(\"solana rpc health\", \"yellow-400\", \"rpc health check failed: %o\", error);\n    }\n  }\n\n  return formatRpcUrl(rpcUrls[0]);\n};\n\nexport const getDestinationAssociatedTokenAddress = async (params: any) => {\n  const {\n    recipient,\n    toToken,\n  } = params;\n\n  const cs = new Csl(OpenAPI.DEBUG);\n  const csl = cs.log;\n\n  const result = {\n    needCreateTokenAccount: false,\n    associatedTokenAddress: \"\",\n  };\n\n  if (toToken.chainType !== \"sol\") {\n    return result;\n  }\n\n  try {\n    const connection = createSolanaFallbackConnection(getChainRpcUrl(\"sol\").rpcUrls);\n    const wallet = new PublicKey(recipient);\n    const TOKEN_MINT = new PublicKey(toToken.contractAddress);\n\n    const ata = getAssociatedTokenAddressSync(TOKEN_MINT, wallet);\n\n    const accountInfo = await connection.getAccountInfo(ata);\n\n    csl(\"getDestinationAssociatedTokenAddress\", \"purple-400\", \"accountInfo: %o\", accountInfo);\n\n    if (!accountInfo) {\n      result.needCreateTokenAccount = true;\n      return result;\n    }\n\n    result.associatedTokenAddress = ata.toBase58();\n  } catch (error) {\n    csl(\"getDestinationAssociatedTokenAddress\", \"red-500\", \"getDestinationAssociatedTokenAddress failed: %o\", error);\n  }\n\n  return result;\n};\n"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@stableflow/utils-solana",
+  "version": "0.0.0-experimental-5a8afd7389-20260703",
+  "description": "Solana utilities for StableFlow SDK (RPC fallback, ATA helpers)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stableflow-ai/stableflow-sdk.git",
+    "directory": "packages/utils-solana"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@stableflow/core": "0.0.0-experimental-5a8afd7389-20260703"
+  },
+  "peerDependencies": {
+    "@solana/spl-token": "^0.4.14",
+    "@solana/web3.js": "^1.98.4"
+  },
+  "devDependencies": {
+    "@solana/spl-token": "^0.4.14",
+    "@solana/web3.js": "^1.98.4",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist"
+  }
+}