@stableflow/wallet-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,34 @@
+# @stableflow/wallet-solana
+
+Solana wallet adapter for the StableFlow SDK.
+
+## Installation
+
+```bash
+pnpm add @stableflow/wallet-solana @stableflow/core @stableflow/bridges
+```
+
+**Peer dependencies:**
+
+- `@solana/web3.js` ^1.98.4
+- `@solana/spl-token` ^0.4.14
+- `@layerzerolabs/lz-v2-utilities` ^3.0.151
+- `@layerzerolabs/lz-solana-sdk-v2` ^3.0.154
+- `@layerzerolabs/oft-v2-solana-sdk` ^3.0.168
+- `@coral-xyz/anchor` ^0.29.0
+- `@metaplex-foundation/umi` ^1.5.1 (and related Metaplex packages — see `package.json`)
+
+## When to use
+
+Solana as source or destination chain in `BridgeSFA` flows. Pass the adapter’s `wallet` (`WalletConfig`) into quote and send calls.
+
+## Main exports
+
+```ts
+import SolanaWallet, { SolanaWallet as Named } from '@stableflow/wallet-solana';
+```
+
+## See also
+
+- [Developer Guide](../../DEVELOPER_GUIDE.md)
+- [@stableflow/bridges](../bridges/README.md)

package/dist/index.d.mts

@@ -0,0 +1,81 @@
+import * as _solana_web3_js from '@solana/web3.js';
+import { PublicKey, Connection } from '@solana/web3.js';
+import { Service, SendType } from '@stableflow/core';
+
+declare class SolanaWallet {
+    private publicKey;
+    private signTransaction;
+    private signer;
+    private csl;
+    constructor(options: {
+        publicKey: PublicKey | null;
+        signer: any;
+    });
+    getConnection(): Connection;
+    transferSOL(to: string, amount: string): Promise<string>;
+    transferToken(tokenMint: string, to: string, amount: string): Promise<string>;
+    transfer(data: {
+        originAsset: string;
+        depositAddress: string;
+        amount: string;
+    }): Promise<string>;
+    getSOLBalance(account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<number | "0">;
+    getTokenBalance(tokenMint: string, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<bigint | "0">;
+    getBalance(token: any, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<number | bigint | "0">;
+    balanceOf(token: any, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<number | bigint | "0">;
+    /**
+     * Estimate gas limit for transfer transaction
+     * @param data Transfer data
+     * @returns Gas limit estimate, gas price, and estimated gas cost
+     */
+    estimateTransferGas(data: {
+        fromToken: any;
+        depositAddress: string;
+        amount: string;
+    }): Promise<{
+        gasLimit: bigint;
+        gasPrice: bigint;
+        estimateGas: bigint;
+    }>;
+    getEstimateGas(params: any): Promise<{
+        gasPrice: bigint;
+        usd: string;
+        wei: bigint;
+        amount: string;
+    }>;
+    estimateTransaction(params: any): Promise<{
+        estimateSourceGasLimit: bigint;
+        estimateSourceGas: bigint;
+        estimateSourceGasUsd: string;
+    }>;
+    checkTransactionStatus(signature: string): Promise<boolean>;
+    simulateIx(ix: any): Promise<_solana_web3_js.SimulatedTransactionResponse>;
+    quoteOFT(params: any): Promise<any>;
+    sendTransaction(params: any): Promise<string>;
+    /**
+     * Unified quote method that routes to specific quote methods based on type
+     * @param type Service type from Service
+     * @param params Parameters for the quote
+     */
+    quote(type: Service, params: any): Promise<any>;
+    /**
+     * Unified send method that routes to specific send methods based on type
+     * @param type Send type from SendType enum
+     * @param params Parameters for the send transaction
+     */
+    send(type: SendType, params: any): Promise<string>;
+    quoteOneClickProxy(params: any): Promise<any>;
+    quoteCCTP(params: any): Promise<any>;
+    createAssociatedTokenAddress(params: any): Promise<PublicKey>;
+    quoteFraxZero(params: any): Promise<any>;
+}
+
+export { SolanaWallet, SolanaWallet as default };

package/dist/index.d.ts

@@ -0,0 +1,81 @@
+import * as _solana_web3_js from '@solana/web3.js';
+import { PublicKey, Connection } from '@solana/web3.js';
+import { Service, SendType } from '@stableflow/core';
+
+declare class SolanaWallet {
+    private publicKey;
+    private signTransaction;
+    private signer;
+    private csl;
+    constructor(options: {
+        publicKey: PublicKey | null;
+        signer: any;
+    });
+    getConnection(): Connection;
+    transferSOL(to: string, amount: string): Promise<string>;
+    transferToken(tokenMint: string, to: string, amount: string): Promise<string>;
+    transfer(data: {
+        originAsset: string;
+        depositAddress: string;
+        amount: string;
+    }): Promise<string>;
+    getSOLBalance(account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<number | "0">;
+    getTokenBalance(tokenMint: string, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<bigint | "0">;
+    getBalance(token: any, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<number | bigint | "0">;
+    balanceOf(token: any, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<number | bigint | "0">;
+    /**
+     * Estimate gas limit for transfer transaction
+     * @param data Transfer data
+     * @returns Gas limit estimate, gas price, and estimated gas cost
+     */
+    estimateTransferGas(data: {
+        fromToken: any;
+        depositAddress: string;
+        amount: string;
+    }): Promise<{
+        gasLimit: bigint;
+        gasPrice: bigint;
+        estimateGas: bigint;
+    }>;
+    getEstimateGas(params: any): Promise<{
+        gasPrice: bigint;
+        usd: string;
+        wei: bigint;
+        amount: string;
+    }>;
+    estimateTransaction(params: any): Promise<{
+        estimateSourceGasLimit: bigint;
+        estimateSourceGas: bigint;
+        estimateSourceGasUsd: string;
+    }>;
+    checkTransactionStatus(signature: string): Promise<boolean>;
+    simulateIx(ix: any): Promise<_solana_web3_js.SimulatedTransactionResponse>;
+    quoteOFT(params: any): Promise<any>;
+    sendTransaction(params: any): Promise<string>;
+    /**
+     * Unified quote method that routes to specific quote methods based on type
+     * @param type Service type from Service
+     * @param params Parameters for the quote
+     */
+    quote(type: Service, params: any): Promise<any>;
+    /**
+     * Unified send method that routes to specific send methods based on type
+     * @param type Send type from SendType enum
+     * @param params Parameters for the send transaction
+     */
+    send(type: SendType, params: any): Promise<string>;
+    quoteOneClickProxy(params: any): Promise<any>;
+    quoteCCTP(params: any): Promise<any>;
+    createAssociatedTokenAddress(params: any): Promise<PublicKey>;
+    quoteFraxZero(params: any): Promise<any>;
+}
+
+export { SolanaWallet, SolanaWallet as default };