@dynamic-labs/stellar 4.60.0 → 4.61.0

package/CHANGELOG.md

@@ -1,4 +1,34 @@
 
+## [4.61.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.60.1...v4.61.0) (2026-02-10)
+
+
+### Features
+
+* add unlockWallet and getWalletRecoveryState to WaaS ([#10407](https://github.com/dynamic-labs/dynamic-auth/issues/10407)) ([e0d1a28](https://github.com/dynamic-labs/dynamic-auth/commit/e0d1a2830f36eee6c6e84737011e8cf59966122d))
+* add useWalletPassword hook for waas wallet password management ([#10399](https://github.com/dynamic-labs/dynamic-auth/issues/10399)) ([508835f](https://github.com/dynamic-labs/dynamic-auth/commit/508835fb0f4f17b7353a4378f4c254e02f0a46ff))
+* add WaaS unlock and recovery UI to mobile demo ([#10408](https://github.com/dynamic-labs/dynamic-auth/issues/10408)) ([94cdb88](https://github.com/dynamic-labs/dynamic-auth/commit/94cdb882fca3c34d157b42d5208f56812008c43b))
+
+
+### Bug Fixes
+
+* bump axios to fix high vulnerability ([#10406](https://github.com/dynamic-labs/dynamic-auth/issues/10406)) ([303e2dc](https://github.com/dynamic-labs/dynamic-auth/commit/303e2dcf1e7e8ecad4caf2d74e805ee427c1d00e))
+* patch node-forge CVE-2025-12816 in global-wallet ([#10401](https://github.com/dynamic-labs/dynamic-auth/issues/10401)) ([46e6eb2](https://github.com/dynamic-labs/dynamic-auth/commit/46e6eb28a0add0052299eaa4ac2dcbe8b1faa98c))
+
+### [4.60.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.60.0...v4.60.1) (2026-02-09)
+
+
+### Features
+
+* add WAAS password handlers to DynamicContextProvider settings ([#10360](https://github.com/dynamic-labs/dynamic-auth/issues/10360)) ([5fc3fa7](https://github.com/dynamic-labs/dynamic-auth/commit/5fc3fa7148c53b64d36672be2d1ae629cb9cdaf8))
+* improve password handling and UI for wallet protection ([#10386](https://github.com/dynamic-labs/dynamic-auth/issues/10386)) ([d27936e](https://github.com/dynamic-labs/dynamic-auth/commit/d27936e5bea37facceefccc0f2507d25a775ad33))
+* pass authToken to wallet recovery operations ([#10379](https://github.com/dynamic-labs/dynamic-auth/issues/10379)) ([294efc7](https://github.com/dynamic-labs/dynamic-auth/commit/294efc7ab5816f63b7e5cc49a150cf9d34d300af))
+
+
+### Bug Fixes
+
+* override fast-xml-parser to 5.3.4 for CVE-2026-25128 ([#10381](https://github.com/dynamic-labs/dynamic-auth/issues/10381)) ([7fb4c22](https://github.com/dynamic-labs/dynamic-auth/commit/7fb4c221252b84bf38bbdab0b37b8f9a981ebe1a))
+* unlock wallet view error handling and password error UI ([#10388](https://github.com/dynamic-labs/dynamic-auth/issues/10388)) ([5ffc8e1](https://github.com/dynamic-labs/dynamic-auth/commit/5ffc8e1e6dd0d7f32bb94c37ce3674be949f010b))
+
 ## [4.60.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.59.2...v4.60.0) (2026-02-05)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/stellar",
-  "version": "4.60.0",
+  "version": "4.61.0",
   "description": "A React SDK for implementing Stellar wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,16 +18,16 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.0.860",
+    "@dynamic-labs/sdk-api-core": "0.0.864",
     "@stellar/stellar-sdk": "14.4.3",
-    "@dynamic-labs/wallet-connector-core": "4.60.0",
-    "@dynamic-labs/assert-package-version": "4.60.0",
+    "@dynamic-labs/wallet-connector-core": "4.61.0",
+    "@dynamic-labs/assert-package-version": "4.61.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"
+    "@dynamic-labs/logger": "4.61.0",
+    "@dynamic-labs/types": "4.61.0",
+    "@dynamic-labs/utils": "4.61.0",
+    "@dynamic-labs/wallet-book": "4.61.0"
   },
   "peerDependencies": {}
 }

package/src/connectors/LobstrWalletConnector/LobstrWalletConnector.cjs

@@ -9,6 +9,7 @@ var StellarWalletConnector = require('../StellarWalletConnector/StellarWalletCon
 var StellarWallet = require('../../wallet/StellarWallet.cjs');
 require('@stellar/stellar-sdk');
 var getNetworkFromAddress = require('../../utils/getNetworkFromAddress.cjs');
+require('@dynamic-labs/utils');
 
 /**
  * Lobstr Wallet provider adapter that implements IStellarProvider

package/src/connectors/LobstrWalletConnector/LobstrWalletConnector.js

@@ -5,6 +5,7 @@ import { StellarWalletConnector } from '../StellarWalletConnector/StellarWalletC
 import { StellarWallet } from '../../wallet/StellarWallet.js';
 import '@stellar/stellar-sdk';
 import { getNetworkFromAddress } from '../../utils/getNetworkFromAddress.js';
+import '@dynamic-labs/utils';
 
 /**
  * Lobstr Wallet provider adapter that implements IStellarProvider

package/src/connectors/StellarWalletConnector/StellarWalletConnector.cjs

@@ -10,6 +10,7 @@ var utils = require('@dynamic-labs/utils');
 var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
 var StellarWallet = require('../../wallet/StellarWallet.cjs');
 var getNetworkFromAddress = require('../../utils/getNetworkFromAddress.cjs');
+var StellarUiTransaction = require('../../utils/StellarUiTransaction/StellarUiTransaction.cjs');
 var StellarLocalStorageCache = require('../../StellarLocalStorageCache.cjs');
 
 const HORIZON_MAINNET_URL = 'https://horizon.stellar.org';
@@ -422,6 +423,36 @@ class StellarWalletConnector extends walletConnectorCore.WalletConnectorBase {
             yield this.cache.clearConnectedAcccounts();
         });
     }
+    /**
+     * Function used to create transactions in the SDK interface
+     *
+     * @param from - The sender's address (Stellar public key)
+     * @returns A new StellarUiTransaction instance
+     */
+    createUiTransaction(from) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            yield this.validateActiveWallet(from);
+            const horizonServer = yield this.getHorizonServer();
+            const networkPassphrase = yield this.getNetworkPassphrase();
+            if (!horizonServer) {
+                throw new utils.DynamicError('No Horizon server available');
+            }
+            return new StellarUiTransaction.StellarUiTransaction({
+                from,
+                horizonServer,
+                networkPassphrase,
+                onSubmit: (transaction) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                    if (!transaction) {
+                        throw new utils.DynamicError('Transaction must be provided');
+                    }
+                    const signedXdr = yield this.signTransaction(transaction.toXDR());
+                    const signedTransaction = stellarSdk.TransactionBuilder.fromXDR(signedXdr, networkPassphrase);
+                    const result = yield horizonServer.submitTransaction(signedTransaction);
+                    return result.hash;
+                }),
+            });
+        });
+    }
 }
 
 exports.StellarWalletConnector = StellarWalletConnector;

package/src/connectors/StellarWalletConnector/StellarWalletConnector.d.ts

@@ -1,6 +1,6 @@
 import { Horizon } from '@stellar/stellar-sdk';
 import { Logger } from '@dynamic-labs/logger';
-import type { GenericNetwork } from '@dynamic-labs/types';
+import type { GenericNetwork, IUITransaction } from '@dynamic-labs/types';
 import { type Chain, WalletConnectorBase } from '@dynamic-labs/wallet-connector-core';
 import { WalletAdditionalAddress } from '@dynamic-labs/sdk-api-core';
 import type { IStellarProvider, StellarWalletConnectorProps } from '../../types';
@@ -109,4 +109,11 @@ export declare abstract class StellarWalletConnector extends WalletConnectorBase
      * Ends the session and clears connected accounts.
      */
     endSession(): Promise<void>;
+    /**
+     * Function used to create transactions in the SDK interface
+     *
+     * @param from - The sender's address (Stellar public key)
+     * @returns A new StellarUiTransaction instance
+     */
+    createUiTransaction(from: string): Promise<IUITransaction>;
 }

package/src/connectors/StellarWalletConnector/StellarWalletConnector.js

@@ -1,11 +1,12 @@
 'use client'
 import { __awaiter } from '../../../_virtual/_tslib.js';
-import { Horizon, Networks } from '@stellar/stellar-sdk';
+import { Horizon, Networks, TransactionBuilder } from '@stellar/stellar-sdk';
 import { Logger } from '@dynamic-labs/logger';
 import { DynamicError } from '@dynamic-labs/utils';
 import { WalletConnectorBase } from '@dynamic-labs/wallet-connector-core';
 import { StellarWallet } from '../../wallet/StellarWallet.js';
 import { getNetworkFromAddress } from '../../utils/getNetworkFromAddress.js';
+import { StellarUiTransaction } from '../../utils/StellarUiTransaction/StellarUiTransaction.js';
 import { StellarLocalStorageCache } from '../../StellarLocalStorageCache.js';
 
 const HORIZON_MAINNET_URL = 'https://horizon.stellar.org';
@@ -418,6 +419,36 @@ class StellarWalletConnector extends WalletConnectorBase {
             yield this.cache.clearConnectedAcccounts();
         });
     }
+    /**
+     * Function used to create transactions in the SDK interface
+     *
+     * @param from - The sender's address (Stellar public key)
+     * @returns A new StellarUiTransaction instance
+     */
+    createUiTransaction(from) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.validateActiveWallet(from);
+            const horizonServer = yield this.getHorizonServer();
+            const networkPassphrase = yield this.getNetworkPassphrase();
+            if (!horizonServer) {
+                throw new DynamicError('No Horizon server available');
+            }
+            return new StellarUiTransaction({
+                from,
+                horizonServer,
+                networkPassphrase,
+                onSubmit: (transaction) => __awaiter(this, void 0, void 0, function* () {
+                    if (!transaction) {
+                        throw new DynamicError('Transaction must be provided');
+                    }
+                    const signedXdr = yield this.signTransaction(transaction.toXDR());
+                    const signedTransaction = TransactionBuilder.fromXDR(signedXdr, networkPassphrase);
+                    const result = yield horizonServer.submitTransaction(signedTransaction);
+                    return result.hash;
+                }),
+            });
+        });
+    }
 }
 
 export { StellarWalletConnector };

package/src/consts/index.cjs

@@ -0,0 +1,15 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Required features for Stellar wallets to function properly.
+ * These are the minimum capabilities a wallet must support.
+ */
+/**
+ * Number of stroops per XLM (1 XLM = 10,000,000 stroops)
+ */
+const STROOPS_PER_XLM = 1e7;
+
+exports.STROOPS_PER_XLM = STROOPS_PER_XLM;

package/src/consts/index.d.ts

@@ -15,3 +15,7 @@ export declare const STELLAR_TESTNET_NETWORK_PASSPHRASE = "Test SDF Network ; Se
  * Stellar network passphrase for futurenet
  */
 export declare const STELLAR_FUTURENET_NETWORK_PASSPHRASE = "Test SDF Future Network ; October 2022";
+/**
+ * Number of stroops per XLM (1 XLM = 10,000,000 stroops)
+ */
+export declare const STROOPS_PER_XLM = 10000000;

package/src/consts/index.js

@@ -0,0 +1,11 @@
+'use client'
+/**
+ * Required features for Stellar wallets to function properly.
+ * These are the minimum capabilities a wallet must support.
+ */
+/**
+ * Number of stroops per XLM (1 XLM = 10,000,000 stroops)
+ */
+const STROOPS_PER_XLM = 1e7;
+
+export { STROOPS_PER_XLM };

package/src/index.cjs

@@ -12,6 +12,8 @@ var StellarWalletConnector = require('./connectors/StellarWalletConnector/Stella
 var StellarLocalStorageCache = require('./StellarLocalStorageCache.cjs');
 require('@stellar/stellar-sdk');
 var getNetworkFromAddress = require('./utils/getNetworkFromAddress.cjs');
+require('../_virtual/_tslib.cjs');
+require('@dynamic-labs/utils');
 
 assertPackageVersion.assertPackageVersion('@dynamic-labs/stellar', _package.version);
 // Wallet connector factory (to be implemented by specific wallet connectors)

package/src/index.js

@@ -8,6 +8,8 @@ export { StellarWalletConnector } from './connectors/StellarWalletConnector/Stel
 export { StellarLocalStorageCache } from './StellarLocalStorageCache.js';
 import '@stellar/stellar-sdk';
 export { getNetworkFromAddress } from './utils/getNetworkFromAddress.js';
+import '../_virtual/_tslib.js';
+import '@dynamic-labs/utils';
 
 assertPackageVersion('@dynamic-labs/stellar', version);
 // Wallet connector factory (to be implemented by specific wallet connectors)

package/src/types.d.ts

@@ -77,7 +77,7 @@ export type StellarSendBalanceProps = {
     toAddress: string;
     /** Optional token information for non-XLM transfers */
     token?: {
-        /** Token address in format "CODE:ISSUER" (e.g., "USDC:GXXXXXXX...") */
+        /** Token address in format "CODE:ISSUER" or "CODE-ISSUER" (e.g., "USDC:GXXXXXXX..." or "USDC-GXXXXXXX...") */
         address: string;
         /** Token decimals (optional, Stellar uses 7 decimals by default) */
         decimals?: number;

package/src/utils/StellarUiTransaction/StellarUiTransaction.cjs

@@ -0,0 +1,208 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../_virtual/_tslib.cjs');
+var stellarSdk = require('@stellar/stellar-sdk');
+var utils = require('@dynamic-labs/utils');
+var index = require('../../consts/index.cjs');
+var buildPaymentTransaction = require('../buildPaymentTransaction.cjs');
+var createPaymentAsset = require('../createPaymentAsset.cjs');
+var getAccountBalance = require('../getAccountBalance.cjs');
+
+/**
+ * Stellar UI Transaction class for managing Stellar transactions in the UI.
+ *
+ * This class implements the IUITransaction interface and provides Stellar-specific
+ * functionality for creating, formatting, and submitting transactions.
+ */
+class StellarUiTransaction {
+    constructor({ onSubmit, from, horizonServer, networkPassphrase, }) {
+        this.chain = 'STELLAR';
+        this.data = undefined;
+        this.fee = { gas: undefined };
+        /**
+         * Formats a non-native token value back to a string
+         *
+         * @param value - The value as bigint
+         * @param decimals - The number of decimals for the token
+         * @returns The formatted amount as string
+         */
+        this.formatNonNativeToken = (value, decimals) => (Number(value) / Number(Math.pow(10, decimals))).toString();
+        this.from = from;
+        this.onSubmit = onSubmit;
+        this.horizonServer = horizonServer;
+        this.networkPassphrase = networkPassphrase;
+    }
+    /**
+     * Fetches the gas fee for the transaction.
+     *
+     * Stellar uses a fixed base fee per operation. The minimum fee is 100 stroops
+     * (0.00001 XLM) per operation. We'll use this as our default estimate.
+     *
+     * @returns The gas fee for the transaction
+     */
+    fetchFee() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (this.fee.gas)
+                return;
+            const transaction = yield this.createTransactionSafe();
+            if (!transaction) {
+                throw new Error('Could not create a valid Stellar transaction, check your address and value');
+            }
+            // Stellar has a fixed base fee per operation (100 stroops = 0.00001 XLM)
+            // Payment transactions have 1 operation, so the base fee is 100 stroops
+            this.fee.gas = BigInt(100);
+        });
+    }
+    isGasSponsored() {
+        return false;
+    }
+    /**
+     * Parses a string amount into bigint stroops (XLM smallest unit, 1e7)
+     *
+     * @param input - The amount as a string (e.g., "1.5")
+     * @returns The amount in stroops as bigint
+     */
+    parse(input) {
+        const floatValue = parseFloat(input);
+        const stroops = Math.round(floatValue * index.STROOPS_PER_XLM);
+        return BigInt(stroops);
+    }
+    /**
+     * Parses a non-native token amount with custom decimals
+     *
+     * @param input - The amount as a string
+     * @param decimals - The number of decimals for the token
+     * @returns The amount as bigint
+     */
+    parseNonNativeToken(input, decimals) {
+        return BigInt(Math.floor(Number(input) * Math.pow(10, decimals)));
+    }
+    /**
+     * Formats a bigint value (in stroops) to a human-readable XLM string
+     *
+     * @param value - The value in stroops
+     * @param options - Formatting options including precision
+     * @returns The formatted amount as string
+     */
+    format(value, { precision } = {}) {
+        const xlmValue = Number(value) / index.STROOPS_PER_XLM;
+        const decimalString = xlmValue.toLocaleString('fullwide', {
+            maximumFractionDigits: 20,
+            minimumFractionDigits: 0,
+            useGrouping: false,
+        });
+        return utils.formatNumberText(decimalString, { precision });
+    }
+    /**
+     * Submits the transaction by creating it and calling onSubmit
+     *
+     * @returns The transaction hash from onSubmit
+     */
+    submit() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            const transaction = (yield this.createTransaction());
+            return this.onSubmit(transaction);
+        });
+    }
+    /**
+     * Gets the balance of the sender's account in stroops
+     *
+     * @returns The balance as bigint in stroops
+     */
+    getBalance() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const account = yield this.horizonServer.loadAccount(this.from);
+                const balanceString = getAccountBalance.getAccountBalance(account);
+                // Balance comes back as a string with decimals (e.g., "100.5000000")
+                // We need to convert it to stroops
+                const xlmAmount = parseFloat(balanceString);
+                const stroops = Math.floor(xlmAmount * index.STROOPS_PER_XLM);
+                return BigInt(stroops);
+            }
+            catch (_a) {
+                return BigInt(0);
+            }
+        });
+    }
+    /**
+     * Validates that an address is a valid Stellar address format
+     *
+     * Stellar addresses are 56-character base32-encoded strings starting with 'G'
+     *
+     * @param address - The address to validate
+     * @returns true if the address format is valid
+     */
+    validateAddressFormat(address) {
+        if (address === 'dyn_send_transaction.multiple_recipients') {
+            return true;
+        }
+        // Use Stellar SDK's built-in validation
+        return stellarSdk.StrKey.isValidEd25519PublicKey(address);
+    }
+    /**
+     * Creates a transaction for sending XLM or tokens
+     *
+     * @returns The transaction or undefined if invalid
+     */
+    createTransaction() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { value, to, nonNativeAddress, nonNativeValue } = this;
+            if (!to) {
+                throw new Error('Destination is required');
+            }
+            if (!value && !nonNativeValue) {
+                return undefined;
+            }
+            // Load the source account
+            const sourceAccount = yield this.horizonServer.loadAccount(this.from);
+            // Determine the asset to send
+            let asset;
+            let amount;
+            if (nonNativeAddress && nonNativeValue !== undefined) {
+                // Transfer non-native token
+                // nonNativeAddress format: "CODE:ISSUER" or "CODE-ISSUER" (e.g., "USDC:GXXXXXXX..." or "USDC-GXXXXXXX...")
+                const [code, issuer] = nonNativeAddress.split(/[:-]/);
+                asset = createPaymentAsset.createPaymentAsset({ code, issuer });
+                amount = this.formatNonNativeToken(nonNativeValue, (_a = this.nonNativeDecimal) !== null && _a !== void 0 ? _a : 7);
+            }
+            else if (value) {
+                // Transfer native XLM
+                asset = stellarSdk.Asset.native();
+                amount = (Number(value) / index.STROOPS_PER_XLM).toString();
+            }
+            else {
+                return undefined;
+            }
+            // Build the transaction
+            return buildPaymentTransaction.buildPaymentTransaction({
+                amount,
+                asset,
+                networkPassphrase: this.networkPassphrase,
+                sourceAccount,
+                toAddress: to,
+            });
+        });
+    }
+    /**
+     * Safely creates a transaction, returning undefined on error
+     *
+     * @returns The transaction or undefined if creation fails
+     */
+    createTransactionSafe() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield this.createTransaction();
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+}
+
+exports.StellarUiTransaction = StellarUiTransaction;

package/src/utils/StellarUiTransaction/StellarUiTransaction.d.ts

@@ -0,0 +1,112 @@
+import type { Horizon, Transaction } from '@stellar/stellar-sdk';
+import { IUITransaction, IUITransactionFormatOptions } from '@dynamic-labs/types';
+type StellarUiTransactionProps = {
+    /** Stellar public key of the sender */
+    from: string;
+    /** The Horizon server instance, needed to fetch account info and estimate fees */
+    horizonServer: Horizon.Server;
+    /** Network passphrase (PUBLIC, TESTNET, or FUTURENET) */
+    networkPassphrase: string;
+    /** The function to call when the transaction is submitted */
+    onSubmit: (transaction?: Transaction) => Promise<any>;
+};
+/**
+ * Stellar UI Transaction class for managing Stellar transactions in the UI.
+ *
+ * This class implements the IUITransaction interface and provides Stellar-specific
+ * functionality for creating, formatting, and submitting transactions.
+ */
+export declare class StellarUiTransaction implements IUITransaction {
+    to: string | undefined;
+    from: string;
+    value: bigint | undefined;
+    chain: string;
+    receipt: string | undefined;
+    data: undefined;
+    fee: {
+        gas: bigint | undefined;
+    };
+    nonNativeAddress?: string;
+    nonNativeDecimal?: number;
+    nonNativeValue?: bigint;
+    nativePrice?: number;
+    private onSubmit;
+    private horizonServer;
+    private networkPassphrase;
+    constructor({ onSubmit, from, horizonServer, networkPassphrase, }: StellarUiTransactionProps);
+    /**
+     * Fetches the gas fee for the transaction.
+     *
+     * Stellar uses a fixed base fee per operation. The minimum fee is 100 stroops
+     * (0.00001 XLM) per operation. We'll use this as our default estimate.
+     *
+     * @returns The gas fee for the transaction
+     */
+    fetchFee(): Promise<void>;
+    isGasSponsored(): boolean;
+    /**
+     * Parses a string amount into bigint stroops (XLM smallest unit, 1e7)
+     *
+     * @param input - The amount as a string (e.g., "1.5")
+     * @returns The amount in stroops as bigint
+     */
+    parse(input: string): bigint;
+    /**
+     * Parses a non-native token amount with custom decimals
+     *
+     * @param input - The amount as a string
+     * @param decimals - The number of decimals for the token
+     * @returns The amount as bigint
+     */
+    parseNonNativeToken(input: string, decimals: number): bigint;
+    /**
+     * Formats a non-native token value back to a string
+     *
+     * @param value - The value as bigint
+     * @param decimals - The number of decimals for the token
+     * @returns The formatted amount as string
+     */
+    formatNonNativeToken: (value: bigint, decimals: number) => string;
+    /**
+     * Formats a bigint value (in stroops) to a human-readable XLM string
+     *
+     * @param value - The value in stroops
+     * @param options - Formatting options including precision
+     * @returns The formatted amount as string
+     */
+    format(value: bigint, { precision }?: IUITransactionFormatOptions): string;
+    /**
+     * Submits the transaction by creating it and calling onSubmit
+     *
+     * @returns The transaction hash from onSubmit
+     */
+    submit(): Promise<any>;
+    /**
+     * Gets the balance of the sender's account in stroops
+     *
+     * @returns The balance as bigint in stroops
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Validates that an address is a valid Stellar address format
+     *
+     * Stellar addresses are 56-character base32-encoded strings starting with 'G'
+     *
+     * @param address - The address to validate
+     * @returns true if the address format is valid
+     */
+    validateAddressFormat(address: string): boolean;
+    /**
+     * Creates a transaction for sending XLM or tokens
+     *
+     * @returns The transaction or undefined if invalid
+     */
+    private createTransaction;
+    /**
+     * Safely creates a transaction, returning undefined on error
+     *
+     * @returns The transaction or undefined if creation fails
+     */
+    private createTransactionSafe;
+}
+export {};

package/src/utils/StellarUiTransaction/StellarUiTransaction.js

@@ -0,0 +1,204 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { StrKey, Asset } from '@stellar/stellar-sdk';
+import { formatNumberText } from '@dynamic-labs/utils';
+import { STROOPS_PER_XLM } from '../../consts/index.js';
+import { buildPaymentTransaction } from '../buildPaymentTransaction.js';
+import { createPaymentAsset } from '../createPaymentAsset.js';
+import { getAccountBalance } from '../getAccountBalance.js';
+
+/**
+ * Stellar UI Transaction class for managing Stellar transactions in the UI.
+ *
+ * This class implements the IUITransaction interface and provides Stellar-specific
+ * functionality for creating, formatting, and submitting transactions.
+ */
+class StellarUiTransaction {
+    constructor({ onSubmit, from, horizonServer, networkPassphrase, }) {
+        this.chain = 'STELLAR';
+        this.data = undefined;
+        this.fee = { gas: undefined };
+        /**
+         * Formats a non-native token value back to a string
+         *
+         * @param value - The value as bigint
+         * @param decimals - The number of decimals for the token
+         * @returns The formatted amount as string
+         */
+        this.formatNonNativeToken = (value, decimals) => (Number(value) / Number(Math.pow(10, decimals))).toString();
+        this.from = from;
+        this.onSubmit = onSubmit;
+        this.horizonServer = horizonServer;
+        this.networkPassphrase = networkPassphrase;
+    }
+    /**
+     * Fetches the gas fee for the transaction.
+     *
+     * Stellar uses a fixed base fee per operation. The minimum fee is 100 stroops
+     * (0.00001 XLM) per operation. We'll use this as our default estimate.
+     *
+     * @returns The gas fee for the transaction
+     */
+    fetchFee() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.fee.gas)
+                return;
+            const transaction = yield this.createTransactionSafe();
+            if (!transaction) {
+                throw new Error('Could not create a valid Stellar transaction, check your address and value');
+            }
+            // Stellar has a fixed base fee per operation (100 stroops = 0.00001 XLM)
+            // Payment transactions have 1 operation, so the base fee is 100 stroops
+            this.fee.gas = BigInt(100);
+        });
+    }
+    isGasSponsored() {
+        return false;
+    }
+    /**
+     * Parses a string amount into bigint stroops (XLM smallest unit, 1e7)
+     *
+     * @param input - The amount as a string (e.g., "1.5")
+     * @returns The amount in stroops as bigint
+     */
+    parse(input) {
+        const floatValue = parseFloat(input);
+        const stroops = Math.round(floatValue * STROOPS_PER_XLM);
+        return BigInt(stroops);
+    }
+    /**
+     * Parses a non-native token amount with custom decimals
+     *
+     * @param input - The amount as a string
+     * @param decimals - The number of decimals for the token
+     * @returns The amount as bigint
+     */
+    parseNonNativeToken(input, decimals) {
+        return BigInt(Math.floor(Number(input) * Math.pow(10, decimals)));
+    }
+    /**
+     * Formats a bigint value (in stroops) to a human-readable XLM string
+     *
+     * @param value - The value in stroops
+     * @param options - Formatting options including precision
+     * @returns The formatted amount as string
+     */
+    format(value, { precision } = {}) {
+        const xlmValue = Number(value) / STROOPS_PER_XLM;
+        const decimalString = xlmValue.toLocaleString('fullwide', {
+            maximumFractionDigits: 20,
+            minimumFractionDigits: 0,
+            useGrouping: false,
+        });
+        return formatNumberText(decimalString, { precision });
+    }
+    /**
+     * Submits the transaction by creating it and calling onSubmit
+     *
+     * @returns The transaction hash from onSubmit
+     */
+    submit() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const transaction = (yield this.createTransaction());
+            return this.onSubmit(transaction);
+        });
+    }
+    /**
+     * Gets the balance of the sender's account in stroops
+     *
+     * @returns The balance as bigint in stroops
+     */
+    getBalance() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const account = yield this.horizonServer.loadAccount(this.from);
+                const balanceString = getAccountBalance(account);
+                // Balance comes back as a string with decimals (e.g., "100.5000000")
+                // We need to convert it to stroops
+                const xlmAmount = parseFloat(balanceString);
+                const stroops = Math.floor(xlmAmount * STROOPS_PER_XLM);
+                return BigInt(stroops);
+            }
+            catch (_a) {
+                return BigInt(0);
+            }
+        });
+    }
+    /**
+     * Validates that an address is a valid Stellar address format
+     *
+     * Stellar addresses are 56-character base32-encoded strings starting with 'G'
+     *
+     * @param address - The address to validate
+     * @returns true if the address format is valid
+     */
+    validateAddressFormat(address) {
+        if (address === 'dyn_send_transaction.multiple_recipients') {
+            return true;
+        }
+        // Use Stellar SDK's built-in validation
+        return StrKey.isValidEd25519PublicKey(address);
+    }
+    /**
+     * Creates a transaction for sending XLM or tokens
+     *
+     * @returns The transaction or undefined if invalid
+     */
+    createTransaction() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { value, to, nonNativeAddress, nonNativeValue } = this;
+            if (!to) {
+                throw new Error('Destination is required');
+            }
+            if (!value && !nonNativeValue) {
+                return undefined;
+            }
+            // Load the source account
+            const sourceAccount = yield this.horizonServer.loadAccount(this.from);
+            // Determine the asset to send
+            let asset;
+            let amount;
+            if (nonNativeAddress && nonNativeValue !== undefined) {
+                // Transfer non-native token
+                // nonNativeAddress format: "CODE:ISSUER" or "CODE-ISSUER" (e.g., "USDC:GXXXXXXX..." or "USDC-GXXXXXXX...")
+                const [code, issuer] = nonNativeAddress.split(/[:-]/);
+                asset = createPaymentAsset({ code, issuer });
+                amount = this.formatNonNativeToken(nonNativeValue, (_a = this.nonNativeDecimal) !== null && _a !== void 0 ? _a : 7);
+            }
+            else if (value) {
+                // Transfer native XLM
+                asset = Asset.native();
+                amount = (Number(value) / STROOPS_PER_XLM).toString();
+            }
+            else {
+                return undefined;
+            }
+            // Build the transaction
+            return buildPaymentTransaction({
+                amount,
+                asset,
+                networkPassphrase: this.networkPassphrase,
+                sourceAccount,
+                toAddress: to,
+            });
+        });
+    }
+    /**
+     * Safely creates a transaction, returning undefined on error
+     *
+     * @returns The transaction or undefined if creation fails
+     */
+    createTransactionSafe() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield this.createTransaction();
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+}
+
+export { StellarUiTransaction };

package/src/utils/StellarUiTransaction/index.d.ts

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

package/src/utils/index.d.ts

@@ -6,3 +6,4 @@ export { getAccountBalance } from './getAccountBalance';
 export { getNetworkFromAddress } from './getNetworkFromAddress';
 export { getNetworkPassphrase } from './getNetworkPassphrase';
 export { normalizeNetworkName } from './normalizeNetworkName';
+export { StellarUiTransaction } from './StellarUiTransaction';

package/src/wallet/StellarWallet.cjs

@@ -10,6 +10,7 @@ var buildPaymentTransaction = require('../utils/buildPaymentTransaction.cjs');
 var checkTrustline = require('../utils/checkTrustline.cjs');
 var createPaymentAsset = require('../utils/createPaymentAsset.cjs');
 var getAccountBalance = require('../utils/getAccountBalance.cjs');
+require('@dynamic-labs/utils');
 
 /**
  * Stellar wallet implementation that provides chain-specific functionality
@@ -29,8 +30,13 @@ class StellarWallet extends walletConnectorCore.Wallet {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             yield this._connector.connect();
             const horizonServer = yield this.getHorizonServer();
-            const account = yield horizonServer.loadAccount(this.address);
-            return getAccountBalance.getAccountBalance(account, assetCode, assetIssuer);
+            try {
+                const account = yield horizonServer.loadAccount(this.address);
+                return getAccountBalance.getAccountBalance(account, assetCode, assetIssuer);
+            }
+            catch (error) {
+                return '0';
+            }
         });
     }
     /**
@@ -54,9 +60,9 @@ class StellarWallet extends walletConnectorCore.Wallet {
             const networkPassphrase = yield this._connector.getNetworkPassphrase();
             let asset;
             if (token === null || token === void 0 ? void 0 : token.address) {
-                const [code, issuer] = token.address.split(':');
+                const [code, issuer] = token.address.split(/[:-]/);
                 if (!code || !issuer) {
-                    throw new Error('Invalid token address format. Expected "CODE:ISSUER" (e.g., "USDC:GXXXXXXX...")');
+                    throw new Error('Invalid token address format. Expected "CODE:ISSUER" or "CODE-ISSUER" (e.g., "USDC:GXXXXXXX..." or "USDC-GXXXXXXX...")');
                 }
                 asset = { code, issuer };
             }

package/src/wallet/StellarWallet.js

@@ -6,6 +6,7 @@ import { buildPaymentTransaction } from '../utils/buildPaymentTransaction.js';
 import { checkTrustline } from '../utils/checkTrustline.js';
 import { createPaymentAsset } from '../utils/createPaymentAsset.js';
 import { getAccountBalance } from '../utils/getAccountBalance.js';
+import '@dynamic-labs/utils';
 
 /**
  * Stellar wallet implementation that provides chain-specific functionality
@@ -25,8 +26,13 @@ class StellarWallet extends Wallet {
         return __awaiter(this, void 0, void 0, function* () {
             yield this._connector.connect();
             const horizonServer = yield this.getHorizonServer();
-            const account = yield horizonServer.loadAccount(this.address);
-            return getAccountBalance(account, assetCode, assetIssuer);
+            try {
+                const account = yield horizonServer.loadAccount(this.address);
+                return getAccountBalance(account, assetCode, assetIssuer);
+            }
+            catch (error) {
+                return '0';
+            }
         });
     }
     /**
@@ -50,9 +56,9 @@ class StellarWallet extends Wallet {
             const networkPassphrase = yield this._connector.getNetworkPassphrase();
             let asset;
             if (token === null || token === void 0 ? void 0 : token.address) {
-                const [code, issuer] = token.address.split(':');
+                const [code, issuer] = token.address.split(/[:-]/);
                 if (!code || !issuer) {
-                    throw new Error('Invalid token address format. Expected "CODE:ISSUER" (e.g., "USDC:GXXXXXXX...")');
+                    throw new Error('Invalid token address format. Expected "CODE:ISSUER" or "CODE-ISSUER" (e.g., "USDC:GXXXXXXX..." or "USDC-GXXXXXXX...")');
                 }
                 asset = { code, issuer };
             }