@dynamic-labs/stellar 4.59.1 → 4.60.0

package/src/wallet/StellarWallet.d.ts

@@ -1,15 +1,7 @@
 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>;
-};
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+import type { StellarWalletConnector } from '../connectors/StellarWalletConnector/StellarWalletConnector';
+import type { StellarSendBalanceProps } from '../types';
 /**
  * Stellar wallet implementation that provides chain-specific functionality
  * for interacting with the Stellar blockchain.
@@ -17,22 +9,27 @@ type StellarWalletConnectorType = WalletConnectorBase<typeof StellarWallet> & {
  * 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> {
+export declare class StellarWallet extends Wallet<StellarWalletConnector> {
     /**
      * Get balance of the wallet.
-     * @returns Balance of the wallet in XLM
+     * @param assetCode - Optional asset code. If not provided, returns native XLM balance
+     * @param assetIssuer - Optional asset issuer. Required if assetCode is provided
+     * @returns Balance of the wallet
      */
-    getBalance(): Promise<string>;
+    getBalance(assetCode?: string, assetIssuer?: string): Promise<string>;
     /**
      * Sends balance to another address.
-     * @param amount - Amount to send (in XLM for native transfers)
-     * @param toAddress - Recipient address
+     * Supports both native XLM and custom Stellar assets.
+     *
+     * @param params - Send balance parameters
+     * @param params.amount - Amount to send
+     * @param params.toAddress - Recipient address (Stellar public key)
+     * @param params.token - Optional token information for non-XLM transfers
+     * @param params.token.address - Token address in format "CODE:ISSUER"
+     * @param params.token.decimals - Token decimals (optional, Stellar uses 7 decimals by default)
      * @returns Transaction hash
      */
-    sendBalance({ amount, toAddress, }: {
-        amount: string;
-        toAddress: string;
-    }): Promise<string>;
+    sendBalance(params: StellarSendBalanceProps): Promise<string>;
     /**
      * Signs a Stellar transaction XDR.
      *
@@ -60,4 +57,3 @@ export declare class StellarWallet extends Wallet<StellarWalletConnectorType> {
      */
     getHorizonServer(): Promise<Horizon.Server>;
 }
-export {};

package/src/wallet/StellarWallet.js

@@ -1,6 +1,11 @@
 'use client'
 import { __awaiter } from '../../_virtual/_tslib.js';
+import { TransactionBuilder } from '@stellar/stellar-sdk';
 import { Wallet } from '@dynamic-labs/wallet-connector-core';
+import { buildPaymentTransaction } from '../utils/buildPaymentTransaction.js';
+import { checkTrustline } from '../utils/checkTrustline.js';
+import { createPaymentAsset } from '../utils/createPaymentAsset.js';
+import { getAccountBalance } from '../utils/getAccountBalance.js';
 
 /**
  * Stellar wallet implementation that provides chain-specific functionality
@@ -12,26 +17,76 @@ import { Wallet } from '@dynamic-labs/wallet-connector-core';
 class StellarWallet extends Wallet {
     /**
      * Get balance of the wallet.
-     * @returns Balance of the wallet in XLM
+     * @param assetCode - Optional asset code. If not provided, returns native XLM balance
+     * @param assetIssuer - Optional asset issuer. Required if assetCode is provided
+     * @returns Balance of the wallet
      */
-    getBalance() {
+    getBalance(assetCode, assetIssuer) {
         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';
+            const horizonServer = yield this.getHorizonServer();
+            const account = yield horizonServer.loadAccount(this.address);
+            return getAccountBalance(account, assetCode, assetIssuer);
         });
     }
     /**
      * Sends balance to another address.
-     * @param amount - Amount to send (in XLM for native transfers)
-     * @param toAddress - Recipient address
+     * Supports both native XLM and custom Stellar assets.
+     *
+     * @param params - Send balance parameters
+     * @param params.amount - Amount to send
+     * @param params.toAddress - Recipient address (Stellar public key)
+     * @param params.token - Optional token information for non-XLM transfers
+     * @param params.token.address - Token address in format "CODE:ISSUER"
+     * @param params.token.decimals - Token decimals (optional, Stellar uses 7 decimals by default)
      * @returns Transaction hash
      */
-    sendBalance(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ amount, toAddress, }) {
+    sendBalance(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { amount, toAddress, token } = params;
             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}`);
+            const horizonServer = yield this.getHorizonServer();
+            const sourceAccount = yield horizonServer.loadAccount(this.address);
+            const networkPassphrase = yield this._connector.getNetworkPassphrase();
+            let asset;
+            if (token === null || token === void 0 ? void 0 : token.address) {
+                const [code, issuer] = token.address.split(':');
+                if (!code || !issuer) {
+                    throw new Error('Invalid token address format. Expected "CODE:ISSUER" (e.g., "USDC:GXXXXXXX...")');
+                }
+                asset = { code, issuer };
+            }
+            const paymentAsset = createPaymentAsset(asset);
+            let destinationAccount;
+            try {
+                destinationAccount = yield horizonServer.loadAccount(toAddress);
+            }
+            catch (error) {
+                throw new Error(`Failed to load destination account ${toAddress}. The account may not exist or be funded.`);
+            }
+            // Check if destination account has trustline for non-native assets
+            if (!paymentAsset.isNative()) {
+                const hasTrustline = checkTrustline(destinationAccount, paymentAsset);
+                if (!hasTrustline) {
+                    const assetCode = paymentAsset.getCode();
+                    const assetIssuer = paymentAsset.getIssuer();
+                    throw new Error(`Destination account ${toAddress} does not have a trustline for asset ${assetCode}:${assetIssuer}. ` +
+                        'The recipient must establish a trustline before receiving this asset.');
+                }
+            }
+            const transaction = buildPaymentTransaction({
+                amount,
+                asset: paymentAsset,
+                memo: undefined,
+                networkPassphrase,
+                sourceAccount,
+                toAddress,
+            });
+            const transactionXdr = transaction.toXDR();
+            const signedXdr = yield this.signTransaction(transactionXdr);
+            const transactionToSubmit = TransactionBuilder.fromXDR(signedXdr, networkPassphrase);
+            const response = yield horizonServer.submitTransaction(transactionToSubmit);
+            return response.hash;
         });
     }
     /**

package/src/wallet/index.d.ts

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

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

@@ -0,0 +1 @@
+export * from './isStellarWallet';

package/src/wallet/isStellarWallet/isStellarWallet.cjs

@@ -0,0 +1,8 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const isStellarWallet = (wallet) => wallet.chain === 'STELLAR';
+
+exports.isStellarWallet = isStellarWallet;

package/src/wallet/isStellarWallet/isStellarWallet.js

@@ -0,0 +1,4 @@
+'use client'
+const isStellarWallet = (wallet) => wallet.chain === 'STELLAR';
+
+export { isStellarWallet };