@dynamic-labs/stellar 4.63.1 → 4.64.0

package/CHANGELOG.md

@@ -1,4 +1,11 @@
 
+## [4.64.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.63.1...v4.64.0) (2026-02-25)
+
+
+### Features
+
+* add addTrustline method to the stellar wallet ([#10510](https://github.com/dynamic-labs/dynamic-auth/issues/10510)) ([e8690e8](https://github.com/dynamic-labs/dynamic-auth/commit/e8690e821dfe867355618d970380568487c3dd36))
+
 ### [4.63.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.63.0...v4.63.1) (2026-02-24)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

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

package/src/utils/buildTrustlineTransaction.cjs

@@ -0,0 +1,30 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var stellarSdk = require('@stellar/stellar-sdk');
+
+const DEFAULT_TIMEOUT = 180;
+/**
+ * Builds a Stellar change trust transaction to add or modify a trustline.
+ *
+ * @param params - Transaction parameters
+ * @param params.asset - The asset to establish a trustline for
+ * @param params.limit - Optional maximum balance limit. Defaults to max if not provided
+ * @param params.networkPassphrase - The network passphrase
+ * @param params.sourceAccount - The source account establishing the trustline
+ * @returns A built Stellar transaction
+ */
+const buildTrustlineTransaction = (params) => {
+    const { asset, limit, networkPassphrase, sourceAccount } = params;
+    return new stellarSdk.TransactionBuilder(sourceAccount, {
+        fee: stellarSdk.BASE_FEE,
+        networkPassphrase,
+    })
+        .addOperation(stellarSdk.Operation.changeTrust({ asset, limit }))
+        .setTimeout(DEFAULT_TIMEOUT)
+        .build();
+};
+
+exports.buildTrustlineTransaction = buildTrustlineTransaction;

package/src/utils/buildTrustlineTransaction.d.ts

@@ -0,0 +1,17 @@
+import { type Asset, type Horizon, Transaction } from '@stellar/stellar-sdk';
+/**
+ * Builds a Stellar change trust transaction to add or modify a trustline.
+ *
+ * @param params - Transaction parameters
+ * @param params.asset - The asset to establish a trustline for
+ * @param params.limit - Optional maximum balance limit. Defaults to max if not provided
+ * @param params.networkPassphrase - The network passphrase
+ * @param params.sourceAccount - The source account establishing the trustline
+ * @returns A built Stellar transaction
+ */
+export declare const buildTrustlineTransaction: (params: {
+    asset: Asset;
+    limit?: string;
+    networkPassphrase: string;
+    sourceAccount: Horizon.AccountResponse;
+}) => Transaction;

package/src/utils/buildTrustlineTransaction.js

@@ -0,0 +1,26 @@
+'use client'
+import { TransactionBuilder, BASE_FEE, Operation } from '@stellar/stellar-sdk';
+
+const DEFAULT_TIMEOUT = 180;
+/**
+ * Builds a Stellar change trust transaction to add or modify a trustline.
+ *
+ * @param params - Transaction parameters
+ * @param params.asset - The asset to establish a trustline for
+ * @param params.limit - Optional maximum balance limit. Defaults to max if not provided
+ * @param params.networkPassphrase - The network passphrase
+ * @param params.sourceAccount - The source account establishing the trustline
+ * @returns A built Stellar transaction
+ */
+const buildTrustlineTransaction = (params) => {
+    const { asset, limit, networkPassphrase, sourceAccount } = params;
+    return new TransactionBuilder(sourceAccount, {
+        fee: BASE_FEE,
+        networkPassphrase,
+    })
+        .addOperation(Operation.changeTrust({ asset, limit }))
+        .setTimeout(DEFAULT_TIMEOUT)
+        .build();
+};
+
+export { buildTrustlineTransaction };

package/src/utils/index.d.ts

@@ -1,4 +1,5 @@
 export { buildPaymentTransaction } from './buildPaymentTransaction';
+export { buildTrustlineTransaction } from './buildTrustlineTransaction';
 export { checkTrustline } from './checkTrustline';
 export { createPaymentAsset } from './createPaymentAsset';
 export { createTransactionMemo } from './createTransactionMemo';

package/src/wallet/StellarWallet.cjs

@@ -7,6 +7,7 @@ var _tslib = require('../../_virtual/_tslib.cjs');
 var stellarSdk = require('@stellar/stellar-sdk');
 var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
 var buildPaymentTransaction = require('../utils/buildPaymentTransaction.cjs');
+var buildTrustlineTransaction = require('../utils/buildTrustlineTransaction.cjs');
 var checkTrustline = require('../utils/checkTrustline.cjs');
 var createPaymentAsset = require('../utils/createPaymentAsset.cjs');
 var getAccountBalance = require('../utils/getAccountBalance.cjs');
@@ -99,6 +100,37 @@ class StellarWallet extends walletConnectorCore.Wallet {
             return response.hash;
         });
     }
+    /**
+     * Adds a trustline for a non-native Stellar asset to the wallet.
+     *
+     * Trustlines allow an account to hold and transact with non-native assets.
+     * Each trustline reserves a small amount of XLM as a base reserve.
+     *
+     * @param assetCode - Asset code (e.g., "USDC")
+     * @param assetIssuer - Asset issuer public key
+     * @param limit - Optional maximum balance the account can hold. Defaults to max if not provided
+     * @returns Transaction hash
+     */
+    addTrustline(_a) {
+        return _tslib.__awaiter(this, arguments, void 0, function* ({ assetCode, assetIssuer, limit, }) {
+            yield this._connector.connect();
+            const horizonServer = yield this.getHorizonServer();
+            const sourceAccount = yield horizonServer.loadAccount(this.address);
+            const networkPassphrase = yield this._connector.getNetworkPassphrase();
+            const asset = createPaymentAsset.createPaymentAsset({ code: assetCode, issuer: assetIssuer });
+            const transaction = buildTrustlineTransaction.buildTrustlineTransaction({
+                asset,
+                limit,
+                networkPassphrase,
+                sourceAccount,
+            });
+            const transactionXdr = transaction.toXDR();
+            const signedXdr = yield this.signTransaction(transactionXdr);
+            const transactionToSubmit = stellarSdk.TransactionBuilder.fromXDR(signedXdr, networkPassphrase);
+            const response = yield horizonServer.submitTransaction(transactionToSubmit);
+            return response.hash;
+        });
+    }
     /**
      * Signs a Stellar transaction XDR.
      *

package/src/wallet/StellarWallet.d.ts

@@ -30,6 +30,22 @@ export declare class StellarWallet extends Wallet<StellarWalletConnector> {
      * @returns Transaction hash
      */
     sendBalance(params: StellarSendBalanceProps): Promise<string>;
+    /**
+     * Adds a trustline for a non-native Stellar asset to the wallet.
+     *
+     * Trustlines allow an account to hold and transact with non-native assets.
+     * Each trustline reserves a small amount of XLM as a base reserve.
+     *
+     * @param assetCode - Asset code (e.g., "USDC")
+     * @param assetIssuer - Asset issuer public key
+     * @param limit - Optional maximum balance the account can hold. Defaults to max if not provided
+     * @returns Transaction hash
+     */
+    addTrustline({ assetCode, assetIssuer, limit, }: {
+        assetCode: string;
+        assetIssuer: string;
+        limit?: string;
+    }): Promise<string>;
     /**
      * Signs a Stellar transaction XDR.
      *

package/src/wallet/StellarWallet.js

@@ -3,6 +3,7 @@ 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 { buildTrustlineTransaction } from '../utils/buildTrustlineTransaction.js';
 import { checkTrustline } from '../utils/checkTrustline.js';
 import { createPaymentAsset } from '../utils/createPaymentAsset.js';
 import { getAccountBalance } from '../utils/getAccountBalance.js';
@@ -95,6 +96,37 @@ class StellarWallet extends Wallet {
             return response.hash;
         });
     }
+    /**
+     * Adds a trustline for a non-native Stellar asset to the wallet.
+     *
+     * Trustlines allow an account to hold and transact with non-native assets.
+     * Each trustline reserves a small amount of XLM as a base reserve.
+     *
+     * @param assetCode - Asset code (e.g., "USDC")
+     * @param assetIssuer - Asset issuer public key
+     * @param limit - Optional maximum balance the account can hold. Defaults to max if not provided
+     * @returns Transaction hash
+     */
+    addTrustline(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ assetCode, assetIssuer, limit, }) {
+            yield this._connector.connect();
+            const horizonServer = yield this.getHorizonServer();
+            const sourceAccount = yield horizonServer.loadAccount(this.address);
+            const networkPassphrase = yield this._connector.getNetworkPassphrase();
+            const asset = createPaymentAsset({ code: assetCode, issuer: assetIssuer });
+            const transaction = buildTrustlineTransaction({
+                asset,
+                limit,
+                networkPassphrase,
+                sourceAccount,
+            });
+            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;
+        });
+    }
     /**
      * Signs a Stellar transaction XDR.
      *