@dynamic-labs/stellar 4.57.2 → 4.58.0

package/CHANGELOG.md

@@ -1,4 +1,18 @@
 
+## [4.58.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.57.2...v4.58.0) (2026-01-28)
+
+
+### Features
+
+* add password setup flow for WaaS wallets ([#10308](https://github.com/dynamic-labs/dynamic-auth/issues/10308)) ([aad892d](https://github.com/dynamic-labs/dynamic-auth/commit/aad892d0359df589753b141c1099a03c72b799d9))
+* add useRefreshAuth ([#10280](https://github.com/dynamic-labs/dynamic-auth/issues/10280)) ([bff850a](https://github.com/dynamic-labs/dynamic-auth/commit/bff850afc4167d47d3a38c5e9845d35b754ea573))
+* **waas:** add unlockWallet and getWalletRecoveryState methods ([#10286](https://github.com/dynamic-labs/dynamic-auth/issues/10286)) ([4c2f26b](https://github.com/dynamic-labs/dynamic-auth/commit/4c2f26b1cd6483406288513d73be66554cd3c66a))
+
+### Bug Fixes
+
+* ensure refresh user not update the jwt ([#10278](https://github.com/dynamic-labs/dynamic-auth/issues/10278)) ([c8cdbe6](https://github.com/dynamic-labs/dynamic-auth/commit/c8cdbe6e10636b39985f299a219fa362c25b4cd0))
+* use isVersionedTransaction for reliable Solana transaction type detection ([#10319](https://github.com/dynamic-labs/dynamic-auth/issues/10319)) ([472aa15](https://github.com/dynamic-labs/dynamic-auth/commit/472aa15a94cfe541b22b96c5c63483e6a5971781))
+
 ### [4.57.2](https://github.com/dynamic-labs/dynamic-auth/compare/v4.57.1...v4.57.2) (2026-01-23)
 
 ### [4.57.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.57.0...v4.57.1) (2026-01-22)

package/_virtual/_tslib.cjs

@@ -0,0 +1,36 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+exports.__awaiter = __awaiter;

package/_virtual/_tslib.js

@@ -0,0 +1,32 @@
+'use client'
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+export { __awaiter };

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.57.2";
+var version = "4.58.0";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.57.2";
+var version = "4.58.0";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/stellar",
-  "version": "4.57.2",
+  "version": "4.58.0",
   "description": "A React SDK for implementing Stellar wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,7 +18,10 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/assert-package-version": "4.57.2"
+    "@stellar/stellar-sdk": "14.4.3",
+    "@dynamic-labs/wallet-connector-core": "4.58.0",
+    "@dynamic-labs/assert-package-version": "4.58.0",
+    "@dynamic-labs/types": "4.58.0"
   },
   "peerDependencies": {}
 }

package/src/consts/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Required features for Stellar wallets to function properly.
+ * These are the minimum capabilities a wallet must support.
+ */
+export declare const REQUIRED_FEATURES: readonly ["getPublicKey", "signTransaction"];
+/**
+ * Stellar network passphrase for mainnet
+ */
+export declare const STELLAR_PUBLIC_NETWORK_PASSPHRASE = "Public Global Stellar Network ; September 2015";
+/**
+ * Stellar network passphrase for testnet
+ */
+export declare const STELLAR_TESTNET_NETWORK_PASSPHRASE = "Test SDF Network ; September 2015";
+/**
+ * Stellar network passphrase for futurenet
+ */
+export declare const STELLAR_FUTURENET_NETWORK_PASSPHRASE = "Test SDF Future Network ; October 2022";

package/src/index.cjs

@@ -5,10 +5,16 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var assertPackageVersion = require('@dynamic-labs/assert-package-version');
 var _package = require('../package.cjs');
+var StellarWallet = require('./wallet/StellarWallet.cjs');
+var getNetworkFromAddress = require('./utils/getNetworkFromAddress.cjs');
 
 assertPackageVersion.assertPackageVersion('@dynamic-labs/stellar', _package.version);
-// Wallet connector factory
-// eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unused-vars
-const StellarWalletConnectors = (props) => [];
+// Wallet connector factory (to be implemented by specific wallet connectors)
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const StellarWalletConnectors = (_props) => [
+// Specific wallet connectors will be added here by implementers
+];
 
+exports.StellarWallet = StellarWallet.StellarWallet;
+exports.getNetworkFromAddress = getNetworkFromAddress.getNetworkFromAddress;
 exports.StellarWalletConnectors = StellarWalletConnectors;

package/src/index.d.ts

@@ -1 +1,3 @@
-export declare const StellarWalletConnectors: (props: any) => never[];
+export { StellarWallet } from './wallet';
+export { getNetworkFromAddress } from './utils';
+export declare const StellarWalletConnectors: (_props?: unknown) => never[];

package/src/index.js

@@ -1,10 +1,14 @@
 'use client'
 import { assertPackageVersion } from '@dynamic-labs/assert-package-version';
 import { version } from '../package.js';
+export { StellarWallet } from './wallet/StellarWallet.js';
+export { getNetworkFromAddress } from './utils/getNetworkFromAddress.js';
 
 assertPackageVersion('@dynamic-labs/stellar', version);
-// Wallet connector factory
-// eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unused-vars
-const StellarWalletConnectors = (props) => [];
+// Wallet connector factory (to be implemented by specific wallet connectors)
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const StellarWalletConnectors = (_props) => [
+// Specific wallet connectors will be added here by implementers
+];
 
 export { StellarWalletConnectors };

package/src/types.d.ts

@@ -0,0 +1,124 @@
+import type { Transaction } from '@stellar/stellar-sdk';
+import type { GenericNetwork } from '@dynamic-labs/types';
+import type { ProviderCondition } from '@dynamic-labs/wallet-connector-core';
+/**
+ * Interface for Stellar wallet providers.
+ *
+ * This interface is designed to work with Stellar wallets that implement
+ * common wallet APIs. Major Stellar wallets include:
+ * Freighter, Albedo, xBull, Lobstr, and Rabet.
+ *
+ * ## Core Features
+ * - **Connection Management**: Connect, disconnect, and account retrieval
+ * - **Network Support**: Network information and switching capabilities
+ * - **Transaction Signing**: Support for transaction and message signing
+ *
+ * @example
+ * ```typescript
+ * // Connect to wallet
+ * const publicKey = await provider.connect();
+ *
+ * // Sign a transaction
+ * const signedXdr = await provider.sign(transactionXdr, options);
+ *
+ * // Sign a message
+ * const signature = await provider.signMessage("Hello Stellar");
+ * ```
+ */
+export type IStellarProvider = {
+    /** Close the wallet connection */
+    close(): void;
+    /** Connect to the wallet and get the public key */
+    connect(): Promise<string>;
+    /** Disconnect from the wallet */
+    disconnect(): Promise<void>;
+    /** Get the current network */
+    getNetwork(): Promise<string>;
+    /** Check if the wallet is unlocked */
+    isUnlocked(): Promise<boolean>;
+    /** Subscribe to wallet events */
+    on(event: StellarProviderEvent, callback: StellarEventCallback): void;
+    /** Sign a Stellar transaction XDR */
+    sign(transactionXdr: string, options?: StellarSignTransactionOptions): Promise<string>;
+    /** Sign an arbitrary message */
+    signMessage(message: string): Promise<string>;
+};
+/**
+ * Stellar provider event types
+ */
+export type StellarProviderEvent = 'accountChanged' | 'networkChanged';
+/**
+ * Stellar event callback type
+ */
+export type StellarEventCallback = (data: unknown) => void;
+/**
+ * Options for signing a Stellar transaction
+ */
+export type StellarSignTransactionOptions = {
+    /** Account public key (for multi-account wallets) */
+    accountToSign?: string;
+    /** Network to use ('PUBLIC' or 'TESTNET' or custom passphrase) */
+    network?: string;
+    /** Network passphrase */
+    networkPassphrase?: string;
+};
+/**
+ * Result from wallet connection
+ */
+export type StellarConnectionResult = {
+    publicKey: string;
+};
+/**
+ * Props for sending XLM or token balance
+ */
+export type StellarSendBalanceProps = {
+    /** Amount to send (in XLM for native transfers) */
+    amount: string;
+    /** Optional asset information for non-XLM transfers */
+    asset?: {
+        /** Asset code */
+        code: string;
+        /** Asset issuer */
+        issuer: string;
+    };
+    /** Optional memo */
+    memo?: {
+        type: 'hash' | 'id' | 'return' | 'text';
+        value: string;
+    };
+    /** Recipient address (Stellar public key) */
+    toAddress: string;
+};
+/**
+ * Stellar wallet connector constructor properties
+ */
+export type StellarWalletConnectorProps = {
+    /** Wallet metadata */
+    metadata?: unknown;
+    /** Stellar networks */
+    stellarNetworks?: GenericNetwork[];
+    /** Wallet book schema */
+    walletBook: unknown;
+};
+/**
+ * Extension locators for identifying Stellar wallet browser extensions.
+ * These flags are typically set on the injected provider object to identify
+ * which wallet extension is present.
+ */
+export type ExtensionLocator = 'isAlbedo' | 'isFreighter' | 'isLobstr' | 'isRabet' | 'isXBull';
+/**
+ * Type for Stellar provider condition used in provider lookup.
+ */
+export type StellarProviderCondition = ProviderCondition<ExtensionLocator>;
+/**
+ * Stellar network names
+ */
+export type StellarNetworkName = 'FUTURENET' | 'PUBLIC' | 'TESTNET';
+/**
+ * Stellar method names for provider interactions
+ */
+export type StellarMethodName = 'close' | 'connect' | 'disconnect' | 'getNetwork' | 'isUnlocked' | 'on' | 'sign' | 'signMessage';
+/**
+ * Stellar transaction type from the SDK
+ */
+export type StellarTransaction = Transaction;

package/src/utils/getNetworkFromAddress.cjs

@@ -0,0 +1,66 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../_virtual/_tslib.cjs');
+var stellarSdk = require('@stellar/stellar-sdk');
+
+const HORIZON_MAINNET_URL = 'https://horizon.stellar.org';
+const HORIZON_TESTNET_URL = 'https://horizon-testnet.stellar.org';
+const getNetworkIdFromPassphrase = (passphrase) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    const encoder = new TextEncoder();
+    const data = encoder.encode(passphrase);
+    const hashBuffer = yield crypto.subtle.digest('SHA-256', data);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
+});
+/**
+ * Checks if a Stellar account exists on a given Horizon server.
+ *
+ * @param address - The Stellar public key to check
+ * @param server - The Horizon Server instance to query
+ * @returns true if the account exists, false otherwise
+ * @throws Re-throws non-404 errors (network errors, bad request, etc.)
+ */
+const accountExistsOnNetwork = (address, server) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    try {
+        yield server.loadAccount(address);
+        return true;
+    }
+    catch (error) {
+        // Account not found (404) - expected for unfunded accounts
+        if (((_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.status) === 404) {
+            return false;
+        }
+        throw error;
+    }
+});
+/**
+ * Detects which Stellar network an address belongs to by checking
+ * if the account exists on mainnet or testnet.
+ *
+ * @param address - The Stellar public key to check
+ * @returns The network chainId (which is sha256 hash of the network passphrase)
+ */
+const getNetworkFromAddress = (address, defaultNetwork) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    const mainnetServer = new stellarSdk.Horizon.Server(HORIZON_MAINNET_URL);
+    const testnetServer = new stellarSdk.Horizon.Server(HORIZON_TESTNET_URL);
+    // Check testnet
+    const existsOnTestnet = yield accountExistsOnNetwork(address, testnetServer);
+    if (existsOnTestnet) {
+        return getNetworkIdFromPassphrase(stellarSdk.Networks.TESTNET);
+    }
+    // Check mainnet first since it's the most common
+    const existsOnMainnet = yield accountExistsOnNetwork(address, mainnetServer);
+    if (existsOnMainnet) {
+        return getNetworkIdFromPassphrase(stellarSdk.Networks.PUBLIC);
+    }
+    // Account doesn't exist on either network (unfunded account)
+    // Default to mainnet
+    return defaultNetwork.chainId.toString();
+});
+
+exports.getNetworkFromAddress = getNetworkFromAddress;
+exports.getNetworkIdFromPassphrase = getNetworkIdFromPassphrase;

package/src/utils/getNetworkFromAddress.d.ts

@@ -0,0 +1,10 @@
+import { GenericNetwork } from '@dynamic-labs/types';
+export declare const getNetworkIdFromPassphrase: (passphrase: string) => Promise<string>;
+/**
+ * Detects which Stellar network an address belongs to by checking
+ * if the account exists on mainnet or testnet.
+ *
+ * @param address - The Stellar public key to check
+ * @returns The network chainId (which is sha256 hash of the network passphrase)
+ */
+export declare const getNetworkFromAddress: (address: string, defaultNetwork: GenericNetwork) => Promise<string | undefined>;

package/src/utils/getNetworkFromAddress.js

@@ -0,0 +1,61 @@
+'use client'
+import { __awaiter } from '../../_virtual/_tslib.js';
+import { Horizon, Networks } from '@stellar/stellar-sdk';
+
+const HORIZON_MAINNET_URL = 'https://horizon.stellar.org';
+const HORIZON_TESTNET_URL = 'https://horizon-testnet.stellar.org';
+const getNetworkIdFromPassphrase = (passphrase) => __awaiter(void 0, void 0, void 0, function* () {
+    const encoder = new TextEncoder();
+    const data = encoder.encode(passphrase);
+    const hashBuffer = yield crypto.subtle.digest('SHA-256', data);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
+});
+/**
+ * Checks if a Stellar account exists on a given Horizon server.
+ *
+ * @param address - The Stellar public key to check
+ * @param server - The Horizon Server instance to query
+ * @returns true if the account exists, false otherwise
+ * @throws Re-throws non-404 errors (network errors, bad request, etc.)
+ */
+const accountExistsOnNetwork = (address, server) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    try {
+        yield server.loadAccount(address);
+        return true;
+    }
+    catch (error) {
+        // Account not found (404) - expected for unfunded accounts
+        if (((_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.status) === 404) {
+            return false;
+        }
+        throw error;
+    }
+});
+/**
+ * Detects which Stellar network an address belongs to by checking
+ * if the account exists on mainnet or testnet.
+ *
+ * @param address - The Stellar public key to check
+ * @returns The network chainId (which is sha256 hash of the network passphrase)
+ */
+const getNetworkFromAddress = (address, defaultNetwork) => __awaiter(void 0, void 0, void 0, function* () {
+    const mainnetServer = new Horizon.Server(HORIZON_MAINNET_URL);
+    const testnetServer = new Horizon.Server(HORIZON_TESTNET_URL);
+    // Check testnet
+    const existsOnTestnet = yield accountExistsOnNetwork(address, testnetServer);
+    if (existsOnTestnet) {
+        return getNetworkIdFromPassphrase(Networks.TESTNET);
+    }
+    // Check mainnet first since it's the most common
+    const existsOnMainnet = yield accountExistsOnNetwork(address, mainnetServer);
+    if (existsOnMainnet) {
+        return getNetworkIdFromPassphrase(Networks.PUBLIC);
+    }
+    // Account doesn't exist on either network (unfunded account)
+    // Default to mainnet
+    return defaultNetwork.chainId.toString();
+});
+
+export { getNetworkFromAddress, getNetworkIdFromPassphrase };

package/src/utils/index.d.ts

@@ -0,0 +1 @@
+export { getNetworkFromAddress } from './getNetworkFromAddress';

package/src/wallet/StellarWallet.cjs

@@ -0,0 +1,91 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../_virtual/_tslib.cjs');
+var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
+
+/**
+ * Stellar wallet implementation that provides chain-specific functionality
+ * for interacting with the Stellar blockchain.
+ *
+ * This class extends the base Wallet class and provides Stellar-specific
+ * methods for transactions, signing, and network operations.
+ */
+class StellarWallet extends walletConnectorCore.Wallet {
+    /**
+     * Get balance of the wallet.
+     * @returns Balance of the wallet in XLM
+     */
+    getBalance() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            yield this._connector.connect();
+            // Balance fetching will be implemented when full SDK support is added
+            return '0';
+        });
+    }
+    /**
+     * Sends balance to another address.
+     * @param amount - Amount to send (in XLM for native transfers)
+     * @param toAddress - Recipient address
+     * @returns Transaction hash
+     */
+    sendBalance(_a) {
+        return _tslib.__awaiter(this, arguments, void 0, function* ({ amount, toAddress, }) {
+            yield this._connector.connect();
+            // Transaction sending will be implemented when full SDK support is added
+            throw new Error(`sendBalance not yet implemented. Amount: ${amount}, To: ${toAddress}`);
+        });
+    }
+    /**
+     * Signs a Stellar transaction XDR.
+     *
+     * @param transactionXdr - The transaction XDR to sign
+     * @returns The signed transaction XDR
+     */
+    signTransaction(transactionXdr) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            yield this._connector.connect();
+            return this._connector.signTransaction(transactionXdr);
+        });
+    }
+    /**
+     * Signs a message.
+     *
+     * @param message - The message to sign
+     * @returns The signature
+     */
+    signMessage(message) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            yield this._connector.connect();
+            const result = yield this._connector.signMessage(message);
+            if (!result) {
+                throw new Error('Failed to sign message');
+            }
+            return result;
+        });
+    }
+    /**
+     * Returns the wallet's current network.
+     *
+     * @returns The current network or undefined if not available
+     */
+    getNetworkInfo() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return this._connector.getNetwork();
+        });
+    }
+    /**
+     * Retrieves the Horizon Server instance for interacting with the Stellar network.
+     *
+     * @returns A promise that resolves to the Horizon.Server instance
+     */
+    getHorizonServer() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return this._connector.getHorizonServer();
+        });
+    }
+}
+
+exports.StellarWallet = StellarWallet;

package/src/wallet/StellarWallet.d.ts

@@ -0,0 +1,63 @@
+import { Horizon } from '@stellar/stellar-sdk';
+import { Wallet, WalletConnectorBase } from '@dynamic-labs/wallet-connector-core';
+/**
+ * Stellar wallet connector interface for type safety.
+ * This will be properly typed when StellarWalletConnector is added.
+ */
+type StellarWalletConnectorType = WalletConnectorBase<typeof StellarWallet> & {
+    signTransaction(transactionXdr: string): Promise<string>;
+    signMessage(message: string): Promise<string | undefined>;
+    getNetwork(): Promise<string | undefined>;
+    getHorizonServer(): Promise<Horizon.Server>;
+};
+/**
+ * Stellar wallet implementation that provides chain-specific functionality
+ * for interacting with the Stellar blockchain.
+ *
+ * This class extends the base Wallet class and provides Stellar-specific
+ * methods for transactions, signing, and network operations.
+ */
+export declare class StellarWallet extends Wallet<StellarWalletConnectorType> {
+    /**
+     * Get balance of the wallet.
+     * @returns Balance of the wallet in XLM
+     */
+    getBalance(): Promise<string>;
+    /**
+     * Sends balance to another address.
+     * @param amount - Amount to send (in XLM for native transfers)
+     * @param toAddress - Recipient address
+     * @returns Transaction hash
+     */
+    sendBalance({ amount, toAddress, }: {
+        amount: string;
+        toAddress: string;
+    }): Promise<string>;
+    /**
+     * Signs a Stellar transaction XDR.
+     *
+     * @param transactionXdr - The transaction XDR to sign
+     * @returns The signed transaction XDR
+     */
+    signTransaction(transactionXdr: string): Promise<string>;
+    /**
+     * Signs a message.
+     *
+     * @param message - The message to sign
+     * @returns The signature
+     */
+    signMessage(message: string): Promise<string | undefined>;
+    /**
+     * Returns the wallet's current network.
+     *
+     * @returns The current network or undefined if not available
+     */
+    getNetworkInfo(): Promise<string | undefined>;
+    /**
+     * Retrieves the Horizon Server instance for interacting with the Stellar network.
+     *
+     * @returns A promise that resolves to the Horizon.Server instance
+     */
+    getHorizonServer(): Promise<Horizon.Server>;
+}
+export {};

package/src/wallet/StellarWallet.js

@@ -0,0 +1,87 @@
+'use client'
+import { __awaiter } from '../../_virtual/_tslib.js';
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+
+/**
+ * Stellar wallet implementation that provides chain-specific functionality
+ * for interacting with the Stellar blockchain.
+ *
+ * This class extends the base Wallet class and provides Stellar-specific
+ * methods for transactions, signing, and network operations.
+ */
+class StellarWallet extends Wallet {
+    /**
+     * Get balance of the wallet.
+     * @returns Balance of the wallet in XLM
+     */
+    getBalance() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this._connector.connect();
+            // Balance fetching will be implemented when full SDK support is added
+            return '0';
+        });
+    }
+    /**
+     * Sends balance to another address.
+     * @param amount - Amount to send (in XLM for native transfers)
+     * @param toAddress - Recipient address
+     * @returns Transaction hash
+     */
+    sendBalance(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ amount, toAddress, }) {
+            yield this._connector.connect();
+            // Transaction sending will be implemented when full SDK support is added
+            throw new Error(`sendBalance not yet implemented. Amount: ${amount}, To: ${toAddress}`);
+        });
+    }
+    /**
+     * Signs a Stellar transaction XDR.
+     *
+     * @param transactionXdr - The transaction XDR to sign
+     * @returns The signed transaction XDR
+     */
+    signTransaction(transactionXdr) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this._connector.connect();
+            return this._connector.signTransaction(transactionXdr);
+        });
+    }
+    /**
+     * Signs a message.
+     *
+     * @param message - The message to sign
+     * @returns The signature
+     */
+    signMessage(message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this._connector.connect();
+            const result = yield this._connector.signMessage(message);
+            if (!result) {
+                throw new Error('Failed to sign message');
+            }
+            return result;
+        });
+    }
+    /**
+     * Returns the wallet's current network.
+     *
+     * @returns The current network or undefined if not available
+     */
+    getNetworkInfo() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._connector.getNetwork();
+        });
+    }
+    /**
+     * Retrieves the Horizon Server instance for interacting with the Stellar network.
+     *
+     * @returns A promise that resolves to the Horizon.Server instance
+     */
+    getHorizonServer() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._connector.getHorizonServer();
+        });
+    }
+}
+
+export { StellarWallet };

package/src/wallet/index.d.ts

@@ -0,0 +1 @@
+export { StellarWallet } from './StellarWallet';

package/src/wallet/isStellarWallet/isStellarWallet.d.ts

@@ -0,0 +1,3 @@
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+import { StellarWallet } from '../StellarWallet';
+export declare const isStellarWallet: (wallet: Wallet) => wallet is StellarWallet;