@dynamic-labs/stellar 4.59.2 → 4.60.0

package/CHANGELOG.md

@@ -1,4 +1,14 @@
 
+## [4.60.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.59.2...v4.60.0) (2026-02-05)
+
+
+### Features
+
+* add prompt to unlock wallet when getting encrypted shares ([#10333](https://github.com/dynamic-labs/dynamic-auth/issues/10333)) ([7009dfa](https://github.com/dynamic-labs/dynamic-auth/commit/7009dfa315538f4f4ad27ff37e7902f10e1cf019))
+* add stellar sendBalance method ([#10310](https://github.com/dynamic-labs/dynamic-auth/issues/10310)) ([c083ea0](https://github.com/dynamic-labs/dynamic-auth/commit/c083ea0a7caa0cb9095d32897acf677c1b661cb4))
+* **webview-controller:** add DelegatedAccessController ([#10348](https://github.com/dynamic-labs/dynamic-auth/issues/10348)) ([57599e4](https://github.com/dynamic-labs/dynamic-auth/commit/57599e4dd1ad6f4b22f98d49d7fae1a724b719ee))
+* **webview-messages:** add DelegatedAccessMessages types ([#10347](https://github.com/dynamic-labs/dynamic-auth/issues/10347)) ([b0a1275](https://github.com/dynamic-labs/dynamic-auth/commit/b0a12759016fa6f8a76753c2394d589acb18ccf1))
+
 ### [4.59.2](https://github.com/dynamic-labs/dynamic-auth/compare/v4.59.1...v4.59.2) (2026-02-03)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/stellar",
-  "version": "4.59.2",
+  "version": "4.60.0",
   "description": "A React SDK for implementing Stellar wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -20,12 +20,14 @@
   "dependencies": {
     "@dynamic-labs/sdk-api-core": "0.0.860",
     "@stellar/stellar-sdk": "14.4.3",
-    "@dynamic-labs/wallet-connector-core": "4.59.2",
-    "@dynamic-labs/assert-package-version": "4.59.2",
-    "@dynamic-labs/logger": "4.59.2",
-    "@dynamic-labs/types": "4.59.2",
-    "@dynamic-labs/utils": "4.59.2",
-    "@dynamic-labs/wallet-book": "4.59.2"
+    "@dynamic-labs/wallet-connector-core": "4.60.0",
+    "@dynamic-labs/assert-package-version": "4.60.0",
+    "@lobstrco/signer-extension-api": "2.0.0",
+    "@stellar/freighter-api": "6.0.1",
+    "@dynamic-labs/logger": "4.60.0",
+    "@dynamic-labs/types": "4.60.0",
+    "@dynamic-labs/utils": "4.60.0",
+    "@dynamic-labs/wallet-book": "4.60.0"
   },
   "peerDependencies": {}
 }

package/src/connectors/FreighterWalletConnector/FreighterProvider.cjs

@@ -0,0 +1,84 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../_virtual/_tslib.cjs');
+var freighterApi = require('@stellar/freighter-api');
+
+/**
+ * Freighter Wallet provider adapter that implements IStellarProvider
+ * using the Freighter API.
+ */
+const createFreighterProvider = () => {
+    let watcher;
+    const eventCallbacks = new Map();
+    let isWatcherStarted = false;
+    const startWatcher = () => {
+        if (isWatcherStarted) {
+            return;
+        }
+        if (!watcher) {
+            watcher = new freighterApi.WatchWalletChanges();
+        }
+        watcher.watch((params) => {
+            const accountChangedCallbacks = eventCallbacks.get('accountChanged');
+            const networkChangedCallbacks = eventCallbacks.get('networkChanged');
+            if (accountChangedCallbacks && params.address !== undefined) {
+                accountChangedCallbacks.forEach((callback) => {
+                    callback(params.address);
+                });
+            }
+            if (networkChangedCallbacks && params.network !== undefined) {
+                networkChangedCallbacks.forEach((callback) => {
+                    callback(params.network);
+                });
+            }
+        });
+        isWatcherStarted = true;
+    };
+    return {
+        close: () => {
+            watcher === null || watcher === void 0 ? void 0 : watcher.stop();
+            eventCallbacks.clear();
+            isWatcherStarted = false;
+        },
+        connect: () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            const response = yield freighterApi.requestAccess();
+            return (_a = response.address) !== null && _a !== void 0 ? _a : '';
+        }),
+        disconnect: () => _tslib.__awaiter(void 0, void 0, void 0, function* () { return undefined; }),
+        getNetwork: () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+            var _b;
+            const response = yield freighterApi.getNetwork();
+            return (_b = response.network) !== null && _b !== void 0 ? _b : 'PUBLIC';
+        }),
+        isUnlocked: () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+            var _c;
+            const response = yield freighterApi.isConnected();
+            return (_c = response.isConnected) !== null && _c !== void 0 ? _c : false;
+        }),
+        on: (event, callback) => {
+            if (!eventCallbacks.has(event)) {
+                eventCallbacks.set(event, new Set());
+            }
+            eventCallbacks.get(event).add(callback);
+            startWatcher();
+        },
+        sign: (transactionXdr, options) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+            var _d;
+            const response = yield freighterApi.signTransaction(transactionXdr, {
+                networkPassphrase: options === null || options === void 0 ? void 0 : options.networkPassphrase,
+            });
+            return (_d = response.signedTxXdr) !== null && _d !== void 0 ? _d : '';
+        }),
+        signMessage: (message) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+            var _e;
+            const response = yield freighterApi.signMessage(message);
+            return String((_e = response.signedMessage) !== null && _e !== void 0 ? _e : '');
+        }),
+    };
+};
+
+exports.createFreighterProvider = createFreighterProvider;

package/src/connectors/FreighterWalletConnector/FreighterProvider.d.ts

@@ -0,0 +1,6 @@
+import type { IStellarProvider } from '../../types';
+/**
+ * Freighter Wallet provider adapter that implements IStellarProvider
+ * using the Freighter API.
+ */
+export declare const createFreighterProvider: () => IStellarProvider;

package/src/connectors/FreighterWalletConnector/FreighterProvider.js

@@ -0,0 +1,80 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { requestAccess, getNetwork, isConnected, signTransaction, signMessage, WatchWalletChanges } from '@stellar/freighter-api';
+
+/**
+ * Freighter Wallet provider adapter that implements IStellarProvider
+ * using the Freighter API.
+ */
+const createFreighterProvider = () => {
+    let watcher;
+    const eventCallbacks = new Map();
+    let isWatcherStarted = false;
+    const startWatcher = () => {
+        if (isWatcherStarted) {
+            return;
+        }
+        if (!watcher) {
+            watcher = new WatchWalletChanges();
+        }
+        watcher.watch((params) => {
+            const accountChangedCallbacks = eventCallbacks.get('accountChanged');
+            const networkChangedCallbacks = eventCallbacks.get('networkChanged');
+            if (accountChangedCallbacks && params.address !== undefined) {
+                accountChangedCallbacks.forEach((callback) => {
+                    callback(params.address);
+                });
+            }
+            if (networkChangedCallbacks && params.network !== undefined) {
+                networkChangedCallbacks.forEach((callback) => {
+                    callback(params.network);
+                });
+            }
+        });
+        isWatcherStarted = true;
+    };
+    return {
+        close: () => {
+            watcher === null || watcher === void 0 ? void 0 : watcher.stop();
+            eventCallbacks.clear();
+            isWatcherStarted = false;
+        },
+        connect: () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            const response = yield requestAccess();
+            return (_a = response.address) !== null && _a !== void 0 ? _a : '';
+        }),
+        disconnect: () => __awaiter(void 0, void 0, void 0, function* () { return undefined; }),
+        getNetwork: () => __awaiter(void 0, void 0, void 0, function* () {
+            var _b;
+            const response = yield getNetwork();
+            return (_b = response.network) !== null && _b !== void 0 ? _b : 'PUBLIC';
+        }),
+        isUnlocked: () => __awaiter(void 0, void 0, void 0, function* () {
+            var _c;
+            const response = yield isConnected();
+            return (_c = response.isConnected) !== null && _c !== void 0 ? _c : false;
+        }),
+        on: (event, callback) => {
+            if (!eventCallbacks.has(event)) {
+                eventCallbacks.set(event, new Set());
+            }
+            eventCallbacks.get(event).add(callback);
+            startWatcher();
+        },
+        sign: (transactionXdr, options) => __awaiter(void 0, void 0, void 0, function* () {
+            var _d;
+            const response = yield signTransaction(transactionXdr, {
+                networkPassphrase: options === null || options === void 0 ? void 0 : options.networkPassphrase,
+            });
+            return (_d = response.signedTxXdr) !== null && _d !== void 0 ? _d : '';
+        }),
+        signMessage: (message) => __awaiter(void 0, void 0, void 0, function* () {
+            var _e;
+            const response = yield signMessage(message);
+            return String((_e = response.signedMessage) !== null && _e !== void 0 ? _e : '');
+        }),
+    };
+};
+
+export { createFreighterProvider };

package/src/connectors/FreighterWalletConnector/FreighterWalletConnector.cjs

@@ -0,0 +1,45 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../_virtual/_tslib.cjs');
+var freighterApi = require('@stellar/freighter-api');
+var StellarWalletConnector = require('../StellarWalletConnector/StellarWalletConnector.cjs');
+var FreighterProvider = require('./FreighterProvider.cjs');
+
+/**
+ * Freighter Wallet connector for Stellar blockchain.
+ * Implements Stellar wallet functionality using the Freighter browser extension.
+ */
+class FreighterWalletConnector extends StellarWalletConnector.StellarWalletConnector {
+    constructor(opts) {
+        super('Freighter', opts);
+        this.name = 'Freighter';
+        this.overrideKey = 'freighter';
+    }
+    getProvider() {
+        if (!this.isInstalledOnBrowser()) {
+            return undefined;
+        }
+        if (!this.provider) {
+            this.provider = FreighterProvider.createFreighterProvider();
+        }
+        return this.provider;
+    }
+    isInstalledOnBrowser() {
+        return FreighterWalletConnector.isInstalled;
+    }
+    static isConnected() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const response = yield freighterApi.isConnected();
+            const connected = (_a = response === null || response === void 0 ? void 0 : response.isConnected) !== null && _a !== void 0 ? _a : false;
+            FreighterWalletConnector.isInstalled = connected;
+            return connected;
+        });
+    }
+}
+FreighterWalletConnector.isInstalled = false;
+
+exports.FreighterWalletConnector = FreighterWalletConnector;

package/src/connectors/FreighterWalletConnector/FreighterWalletConnector.d.ts

@@ -0,0 +1,16 @@
+import type { IStellarProvider, StellarWalletConnectorProps } from '../../types';
+import { StellarWalletConnector } from '../StellarWalletConnector';
+/**
+ * Freighter Wallet connector for Stellar blockchain.
+ * Implements Stellar wallet functionality using the Freighter browser extension.
+ */
+export declare class FreighterWalletConnector extends StellarWalletConnector {
+    name: string;
+    overrideKey: string;
+    private provider;
+    static isInstalled: boolean;
+    constructor(opts: StellarWalletConnectorProps);
+    getProvider(): IStellarProvider | undefined;
+    isInstalledOnBrowser(): boolean;
+    static isConnected(): Promise<boolean>;
+}

package/src/connectors/FreighterWalletConnector/FreighterWalletConnector.js

@@ -0,0 +1,41 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { isConnected } from '@stellar/freighter-api';
+import { StellarWalletConnector } from '../StellarWalletConnector/StellarWalletConnector.js';
+import { createFreighterProvider } from './FreighterProvider.js';
+
+/**
+ * Freighter Wallet connector for Stellar blockchain.
+ * Implements Stellar wallet functionality using the Freighter browser extension.
+ */
+class FreighterWalletConnector extends StellarWalletConnector {
+    constructor(opts) {
+        super('Freighter', opts);
+        this.name = 'Freighter';
+        this.overrideKey = 'freighter';
+    }
+    getProvider() {
+        if (!this.isInstalledOnBrowser()) {
+            return undefined;
+        }
+        if (!this.provider) {
+            this.provider = createFreighterProvider();
+        }
+        return this.provider;
+    }
+    isInstalledOnBrowser() {
+        return FreighterWalletConnector.isInstalled;
+    }
+    static isConnected() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const response = yield isConnected();
+            const connected = (_a = response === null || response === void 0 ? void 0 : response.isConnected) !== null && _a !== void 0 ? _a : false;
+            FreighterWalletConnector.isInstalled = connected;
+            return connected;
+        });
+    }
+}
+FreighterWalletConnector.isInstalled = false;
+
+export { FreighterWalletConnector };

package/src/connectors/FreighterWalletConnector/index.d.ts

@@ -0,0 +1,2 @@
+export { FreighterWalletConnector } from './FreighterWalletConnector';
+export { createFreighterProvider } from './FreighterProvider';

package/src/connectors/LobstrWalletConnector/LobstrWalletConnector.cjs

@@ -0,0 +1,95 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../_virtual/_tslib.cjs');
+var signerExtensionApi = require('@lobstrco/signer-extension-api');
+var StellarWalletConnector = require('../StellarWalletConnector/StellarWalletConnector.cjs');
+var StellarWallet = require('../../wallet/StellarWallet.cjs');
+require('@stellar/stellar-sdk');
+var getNetworkFromAddress = require('../../utils/getNetworkFromAddress.cjs');
+
+/**
+ * Lobstr Wallet provider adapter that implements IStellarProvider
+ * using the Lobstr signer extension API.
+ */
+const createLobstrProvider = () => ({
+    // Lobstr SDK doesn't have a close method
+    close: () => undefined,
+    connect: () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        const publicKey = yield signerExtensionApi.getPublicKey();
+        return publicKey;
+    }),
+    // Lobstr SDK doesn't have a disconnect method
+    disconnect: () => _tslib.__awaiter(void 0, void 0, void 0, function* () { return undefined; }),
+    // Lobstr uses mainnet by default
+    getNetwork: () => _tslib.__awaiter(void 0, void 0, void 0, function* () { return 'PUBLIC'; }),
+    isUnlocked: () => _tslib.__awaiter(void 0, void 0, void 0, function* () { return signerExtensionApi.isConnected(); }),
+    // Lobstr SDK doesn't support event subscriptions
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    on: (event, callback) => undefined,
+    sign: (transactionXdr) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        const signedXdr = yield signerExtensionApi.signTransaction(transactionXdr);
+        return signedXdr;
+    }),
+    signMessage: (message) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const response = yield signerExtensionApi.signMessage(message);
+        return (_a = response === null || response === void 0 ? void 0 : response.signedMessage) !== null && _a !== void 0 ? _a : '';
+    }),
+});
+class LobstrWalletConnector extends StellarWalletConnector.StellarWalletConnector {
+    constructor(opts) {
+        super('Lobstr', opts);
+        this.name = 'Lobstr';
+        this.ChainWallet = StellarWallet.StellarWallet;
+        this.connectedChain = 'STELLAR';
+        this.supportedChains = ['STELLAR'];
+        this.provider = createLobstrProvider();
+    }
+    static isConnected() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            const connected = yield signerExtensionApi.isConnected();
+            LobstrWalletConnector.isInstalled = connected;
+            return connected;
+        });
+    }
+    getProvider() {
+        if (!this.isInstalledOnBrowser()) {
+            return undefined;
+        }
+        if (!this.provider) {
+            this.provider = createLobstrProvider();
+        }
+        return this.provider;
+    }
+    getNetwork() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            const address = yield this.getAddress();
+            if (!address) {
+                return undefined;
+            }
+            if (!this.stellarNetworks.length) {
+                return undefined;
+            }
+            const network = yield getNetworkFromAddress.getNetworkFromAddress(address, this.stellarNetworks[0]);
+            return network;
+        });
+    }
+    isInstalledOnBrowser() {
+        return LobstrWalletConnector.isInstalled;
+    }
+    /**
+     * Lobstr uses its own SDK method to fetch the public key
+     * instead of the provider's connect method.
+     */
+    fetchPublicAddress() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return signerExtensionApi.getPublicKey();
+        });
+    }
+}
+LobstrWalletConnector.isInstalled = false;
+
+exports.LobstrWalletConnector = LobstrWalletConnector;

package/src/connectors/LobstrWalletConnector/LobstrWalletConnector.d.ts

@@ -0,0 +1,22 @@
+import { Chain } from '@dynamic-labs/wallet-connector-core';
+import { StellarWalletConnector } from '../StellarWalletConnector';
+import { StellarWallet } from '../../wallet';
+import type { IStellarProvider, StellarWalletConnectorProps } from '../../types';
+export declare class LobstrWalletConnector extends StellarWalletConnector {
+    name: string;
+    ChainWallet: typeof StellarWallet;
+    connectedChain: Chain;
+    supportedChains: Chain[];
+    private provider;
+    static isInstalled: boolean;
+    constructor(opts: StellarWalletConnectorProps);
+    static isConnected(): Promise<boolean>;
+    getProvider(): IStellarProvider | undefined;
+    getNetwork(): Promise<string | undefined>;
+    isInstalledOnBrowser(): boolean;
+    /**
+     * Lobstr uses its own SDK method to fetch the public key
+     * instead of the provider's connect method.
+     */
+    protected fetchPublicAddress(): Promise<string>;
+}

package/src/connectors/LobstrWalletConnector/LobstrWalletConnector.js

@@ -0,0 +1,91 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { getPublicKey, isConnected, signTransaction, signMessage } from '@lobstrco/signer-extension-api';
+import { StellarWalletConnector } from '../StellarWalletConnector/StellarWalletConnector.js';
+import { StellarWallet } from '../../wallet/StellarWallet.js';
+import '@stellar/stellar-sdk';
+import { getNetworkFromAddress } from '../../utils/getNetworkFromAddress.js';
+
+/**
+ * Lobstr Wallet provider adapter that implements IStellarProvider
+ * using the Lobstr signer extension API.
+ */
+const createLobstrProvider = () => ({
+    // Lobstr SDK doesn't have a close method
+    close: () => undefined,
+    connect: () => __awaiter(void 0, void 0, void 0, function* () {
+        const publicKey = yield getPublicKey();
+        return publicKey;
+    }),
+    // Lobstr SDK doesn't have a disconnect method
+    disconnect: () => __awaiter(void 0, void 0, void 0, function* () { return undefined; }),
+    // Lobstr uses mainnet by default
+    getNetwork: () => __awaiter(void 0, void 0, void 0, function* () { return 'PUBLIC'; }),
+    isUnlocked: () => __awaiter(void 0, void 0, void 0, function* () { return isConnected(); }),
+    // Lobstr SDK doesn't support event subscriptions
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    on: (event, callback) => undefined,
+    sign: (transactionXdr) => __awaiter(void 0, void 0, void 0, function* () {
+        const signedXdr = yield signTransaction(transactionXdr);
+        return signedXdr;
+    }),
+    signMessage: (message) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const response = yield signMessage(message);
+        return (_a = response === null || response === void 0 ? void 0 : response.signedMessage) !== null && _a !== void 0 ? _a : '';
+    }),
+});
+class LobstrWalletConnector extends StellarWalletConnector {
+    constructor(opts) {
+        super('Lobstr', opts);
+        this.name = 'Lobstr';
+        this.ChainWallet = StellarWallet;
+        this.connectedChain = 'STELLAR';
+        this.supportedChains = ['STELLAR'];
+        this.provider = createLobstrProvider();
+    }
+    static isConnected() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const connected = yield isConnected();
+            LobstrWalletConnector.isInstalled = connected;
+            return connected;
+        });
+    }
+    getProvider() {
+        if (!this.isInstalledOnBrowser()) {
+            return undefined;
+        }
+        if (!this.provider) {
+            this.provider = createLobstrProvider();
+        }
+        return this.provider;
+    }
+    getNetwork() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const address = yield this.getAddress();
+            if (!address) {
+                return undefined;
+            }
+            if (!this.stellarNetworks.length) {
+                return undefined;
+            }
+            const network = yield getNetworkFromAddress(address, this.stellarNetworks[0]);
+            return network;
+        });
+    }
+    isInstalledOnBrowser() {
+        return LobstrWalletConnector.isInstalled;
+    }
+    /**
+     * Lobstr uses its own SDK method to fetch the public key
+     * instead of the provider's connect method.
+     */
+    fetchPublicAddress() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return getPublicKey();
+        });
+    }
+}
+LobstrWalletConnector.isInstalled = false;
+
+export { LobstrWalletConnector };

package/src/connectors/LobstrWalletConnector/index.d.ts

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