@augustdigital/sdk 8.10.0 → 8.11.0

package/lib/core/analytics/sanitize.js

@@ -25,6 +25,11 @@ const SENSITIVE_KEYS = [
     'privateKey',
     'mnemonic',
     'seed',
+    // RPC endpoints can carry the API key in the path (e.g. Alchemy `/v2/<key>`),
+    // so a `sorobanRpcUrl` / `rpcUrl` argument must never reach telemetry. Matched
+    // as a substring, so it also covers `sorobanRpcUrls` and snake_case variants.
+    'rpcurl',
+    'rpc_url',
 ];
 /** Regex patterns applied in order to scrub secrets from free-form strings. */
 const STRING_REDACTION_PATTERNS = [
@@ -34,6 +39,9 @@ const STRING_REDACTION_PATTERNS = [
         '$1[REDACTED]',
     ],
     [/(gateway\.thegraph\.com\/api\/)[A-Za-z0-9]{20,}(\/)/g, '$1[REDACTED]$2'],
+    // Provider path-embedded API keys (e.g. Alchemy `…/v2/<key>`, Infura `…/v3/<key>`):
+    // a 16+ char token right after a `/vN/` segment is a key, not a resource path.
+    [/(\/v\d+\/)[A-Za-z0-9_-]{16,}/g, '$1[REDACTED]'],
     [/eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g, '[REDACTED_JWT]'],
     [/\bnpm_[A-Za-z0-9]{30,}\b/g, '[REDACTED_NPM_TOKEN]'],
     // Stop value match at & # so adjacent query params aren't swallowed.
@@ -172,8 +180,10 @@ function sanitizeArgs(args) {
             return;
         }
         if (typeof arg === 'string') {
-            // Truncate long strings
-            sanitized[key] = arg.length > 100 ? `${arg.substring(0, 100)}...` : arg;
+            // Scrub embedded secrets, then truncate long strings.
+            const scrubbed = sanitizeString(arg);
+            sanitized[key] =
+                scrubbed.length > 100 ? `${scrubbed.substring(0, 100)}...` : scrubbed;
             return;
         }
         if (typeof arg === 'number' || typeof arg === 'boolean') {
@@ -214,8 +224,14 @@ function sanitizeObject(obj, depth = 0) {
                 sanitized[key] = '[REDACTED_HEX]';
                 continue;
             }
+            // Scrub embedded secrets (API keys in URL paths/queries, bearer tokens,
+            // JWTs, …) from free-form values before truncating — key-name matching
+            // alone misses a secret carried inside a value under a benign key.
+            const scrubbedValue = sanitizeString(value);
             sanitized[key] =
-                value.length > 100 ? `${value.substring(0, 100)}...` : value;
+                scrubbedValue.length > 100
+                    ? `${scrubbedValue.substring(0, 100)}...`
+                    : scrubbedValue;
             continue;
         }
         if (typeof value === 'number' || typeof value === 'boolean') {

package/lib/core/analytics/version.d.ts

@@ -3,4 +3,4 @@
  * Generated during publish from package.json version
  * This file is gitignored and created at publish time
  */
-export declare const SDK_VERSION = "8.10.0";
+export declare const SDK_VERSION = "8.11.0";

package/lib/core/analytics/version.js

@@ -6,5 +6,5 @@ exports.SDK_VERSION = void 0;
  * Generated during publish from package.json version
  * This file is gitignored and created at publish time
  */
-exports.SDK_VERSION = '8.10.0';
+exports.SDK_VERSION = '8.11.0';
 //# sourceMappingURL=version.js.map

package/lib/core/base.class.d.ts

@@ -1,4 +1,4 @@
-import type { ISolanaConfig, IAddress, IChainId, IEnv, IProvidersConfig, IWSMonitorHeaders } from '../types';
+import type { ISolanaConfig, IStellarConfig, IAddress, IChainId, IEnv, IProvidersConfig, IWSMonitorHeaders } from '../types';
 import { type IAnalyticsConfig } from './analytics';
 import { type IVersionCheckConfig } from './version-check';
 interface IKeys {
@@ -38,6 +38,7 @@ export interface IAugustBase {
     appName: string;
     providers?: IProvidersConfig;
     solana?: ISolanaConfig;
+    stellar?: IStellarConfig;
     keys: IKeys;
     monitoring?: IMonitoring;
     /** Analytics configuration. Enabled by default (opt-out model). */

package/lib/main.js

@@ -108,7 +108,12 @@ class AugustSDK extends core_1.AugustBase {
             (0, analytics_1.instrumentClass)(this.solana, () => core_1.SPECIAL_CHAINS.solana.chainId);
         }
         this.sui = new sui_1.default();
-        this.stellar = new stellar_1.default();
+        // @stellar: mirror the Solana injection — the consumer may supply a keyed
+        // Soroban RPC (e.g. Alchemy) via `baseConfig.stellar`; otherwise the adapter
+        // uses its built-in public endpoints. Endpoint is injected, not hardcoded.
+        this.stellar = new stellar_1.default(baseConfig.stellar?.network, {
+            sorobanRpcUrl: baseConfig.stellar?.rpcUrl,
+        });
         this.vaults = new vaults_1.AugustVaults(baseConfig, this.solana, this.sui);
         this.subaccounts = new sub_accounts_1.AugustSubAccounts(baseConfig);
         this.api = new api_1.AugustApi(baseConfig);

package/lib/modules/vaults/getters.js

@@ -1058,7 +1058,11 @@ async function getVaultPositions({ vault, wallet, solanaWallet, stellarWallet, o
                     let balance = (0, core_1.toNormalizedBn)(0);
                     if (stellarWallet && (0, utils_3.isStellarAddress)(stellarWallet)) {
                         const stellarNetwork = v.stellar_vault_metadata?.network_name ?? 'mainnet';
-                        const position = await StellarGetters.getStellarUserPosition(v.address, stellarWallet, stellarNetwork);
+                        // Only use the configured RPC override for its own network.
+                        const stellarOverrideRpcUrl = options.stellarRpc?.network === stellarNetwork
+                            ? options.stellarRpc.rpcUrl
+                            : undefined;
+                        const position = await StellarGetters.getStellarUserPosition(v.address, stellarWallet, stellarNetwork, stellarOverrideRpcUrl);
                         if (position && !position.decimalsFromFallback) {
                             balance = (0, core_1.toNormalizedBn)(BigInt(position.shares), position.decimals);
                         }

package/lib/modules/vaults/main.d.ts

@@ -23,6 +23,12 @@ export declare class AugustVaults extends AugustBase {
     private solanaService;
     private suiService;
     private headers;
+    /**
+     * Consumer-supplied Soroban RPC override for Stellar vault reads, with the
+     * network it was configured for so it's only applied to matching-network
+     * vaults (see `IVaultBaseOptions.stellarRpc`).
+     */
+    private _stellarRpc?;
     constructor(baseConfig: IAugustBase, solana: SolanaAdapter, sui: SuiAdapter);
     /**
      * @description deposit underlying token into the specified pool with adapter support. This is for when we cannot pass in a signer in sdk and need to do so as an arg

package/lib/modules/vaults/main.js

@@ -74,10 +74,23 @@ class AugustVaults extends core_1.AugustBase {
     solanaService;
     suiService;
     headers = null;
+    /**
+     * Consumer-supplied Soroban RPC override for Stellar vault reads, with the
+     * network it was configured for so it's only applied to matching-network
+     * vaults (see `IVaultBaseOptions.stellarRpc`).
+     */
+    _stellarRpc;
     constructor(baseConfig, solana, sui) {
         super(baseConfig);
         this.solanaService = solana;
         this.suiService = sui || new sui_1.default();
+        // Network defaults to mainnet, matching the StellarAdapter constructor.
+        this._stellarRpc = baseConfig.stellar?.rpcUrl
+            ? {
+                rpcUrl: baseConfig.stellar.rpcUrl,
+                network: baseConfig.stellar.network ?? 'mainnet',
+            }
+            : undefined;
         this.headers = {
             'x-environment': this.monitoring?.['x-environment'],
             'x-user-id': this.monitoring?.['x-user-id'],
@@ -166,6 +179,7 @@ class AugustVaults extends core_1.AugustBase {
                 options: {
                     rpcUrl,
                     solanaService: this.solanaService,
+                    stellarRpc: this._stellarRpc,
                     env: this.monitoring?.env,
                     augustKey: this.keys?.august,
                     subgraphKey: this.keys?.graph,
@@ -243,6 +257,7 @@ class AugustVaults extends core_1.AugustBase {
                 options: {
                     rpcUrl: this.providers?.[v.chain],
                     solanaService: this.solanaService,
+                    stellarRpc: this._stellarRpc,
                     env: this.monitoring?.env,
                     augustKey: this.keys?.august,
                     subgraphKey: this.keys?.graph,
@@ -316,6 +331,7 @@ class AugustVaults extends core_1.AugustBase {
                     ? this.providers?.[chainId]
                     : this.activeNetwork?.rpcUrl,
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,
@@ -340,6 +356,7 @@ class AugustVaults extends core_1.AugustBase {
                         ? this.providers?.[chainId]
                         : this.activeNetwork?.rpcUrl,
                     solanaService: this.solanaService,
+                    stellarRpc: this._stellarRpc,
                     env: this.monitoring?.env,
                     augustKey: this.keys?.august,
                     subgraphKey: this.keys?.graph,
@@ -385,6 +402,7 @@ class AugustVaults extends core_1.AugustBase {
             subgraphKey: this.keys?.graph,
             chainId: chainId,
             solanaService: this.solanaService,
+            stellarRpc: this._stellarRpc,
             headers: this.headers,
         });
         return vaultResponse;
@@ -416,6 +434,7 @@ class AugustVaults extends core_1.AugustBase {
             subgraphKey: this.keys?.graph,
             chainId: chainId,
             solanaService: this.solanaService,
+            stellarRpc: this._stellarRpc,
             headers: this.headers,
         });
         return vaultResponse;
@@ -447,6 +466,7 @@ class AugustVaults extends core_1.AugustBase {
                     ? this.providers?.[chainId]
                     : this.activeNetwork?.rpcUrl,
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,
@@ -527,6 +547,7 @@ class AugustVaults extends core_1.AugustBase {
                     ? this.providers?.[chainId]
                     : this.activeNetwork?.rpcUrl,
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,
@@ -611,6 +632,7 @@ class AugustVaults extends core_1.AugustBase {
                         ? this.providers?.[chainId]
                         : this.activeNetwork?.rpcUrl,
                     solanaService: this.solanaService,
+                    stellarRpc: this._stellarRpc,
                     env: this.monitoring?.env,
                     augustKey: this.keys?.august,
                     subgraphKey: this.keys?.graph,
@@ -632,6 +654,7 @@ class AugustVaults extends core_1.AugustBase {
                 options: {
                     rpcUrl: this.providers?.[v.chain],
                     solanaService: this.solanaService,
+                    stellarRpc: this._stellarRpc,
                     env: this.monitoring?.env,
                     augustKey: this.keys?.august,
                     subgraphKey: this.keys?.graph,
@@ -667,6 +690,7 @@ class AugustVaults extends core_1.AugustBase {
             options: {
                 rpcUrl: this.providers?.[v.chain],
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,
@@ -706,6 +730,10 @@ class AugustVaults extends core_1.AugustBase {
                 chainId: _chainId,
                 type: h.type,
                 transactionHash: h.transactionHash_,
+                // Deposit rows on multi-asset (pre-deposit) vaults carry the actual
+                // deposited token address; propagate it so consumers render the right
+                // asset symbol instead of guessing the vault's first deposit asset.
+                assetIn: h.assetIn,
             }));
         }
         // Helper function to fetch history for a vault
@@ -826,6 +854,7 @@ class AugustVaults extends core_1.AugustBase {
                     ? this.providers?.[chainId]
                     : this.requireActiveNetwork().rpcUrl,
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,
@@ -851,6 +880,7 @@ class AugustVaults extends core_1.AugustBase {
                     ? this.providers?.[chainId]
                     : this.requireActiveNetwork().rpcUrl,
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,
@@ -1033,6 +1063,7 @@ class AugustVaults extends core_1.AugustBase {
                 rpcUrl: rpcUrl,
                 chainId: resolvedChainId,
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,
@@ -1056,6 +1087,7 @@ class AugustVaults extends core_1.AugustBase {
             options: {
                 rpcUrl: rpcUrl,
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,
@@ -1103,6 +1135,7 @@ class AugustVaults extends core_1.AugustBase {
                         ? this.providers?.[chainId]
                         : rpcUrl || this.requireActiveNetwork().rpcUrl,
                     solanaService: this.solanaService,
+                    stellarRpc: this._stellarRpc,
                     env: this.monitoring?.env,
                     augustKey: this.keys?.august,
                     subgraphKey: this.keys?.graph,
@@ -1376,6 +1409,7 @@ class AugustVaults extends core_1.AugustBase {
             options: {
                 rpcUrl: chainId ? this.providers?.[chainId] : this.activeNetwork.rpcUrl,
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,
@@ -1428,6 +1462,7 @@ class AugustVaults extends core_1.AugustBase {
             options: {
                 rpcUrl,
                 solanaService: this.solanaService,
+                stellarRpc: this._stellarRpc,
                 env: this.monitoring?.env,
                 augustKey: this.keys?.august,
                 subgraphKey: this.keys?.graph,

package/lib/modules/vaults/types.d.ts

@@ -1,5 +1,5 @@
 import type { Connection } from '@solana/web3.js';
-import type { IAddress, IEnv, IWSMonitorHeaders } from '../../types';
+import type { IAddress, IEnv, IStellarNetwork, IWSMonitorHeaders } from '../../types';
 /**
  * Structural interface for the Solana adapter surface used by vault operations.
  * Avoids importing the concrete SolanaAdapter class to prevent circular dependencies.
@@ -40,6 +40,16 @@ export interface IVaultBaseOptions {
     subgraphKey?: string;
     chainId?: number;
     solanaService?: ISolanaService;
+    /**
+     * Optional Soroban RPC override (e.g. a keyed Alchemy URL) for Stellar vault
+     * reads, threaded from the SDK's `stellar` config. Carries the network it was
+     * configured for so it is only applied to matching-network vaults — a testnet
+     * override must not be used for a mainnet read. Unset → built-in endpoints.
+     */
+    stellarRpc?: {
+        rpcUrl: string;
+        network: IStellarNetwork;
+    };
     headers?: IWSMonitorHeaders;
     /**
      * Portfolio mode: when true, the per-vault EVM getter does NOT null out a

package/lib/sdk.d.ts

@@ -16257,6 +16257,12 @@ export declare class AugustVaults extends AugustBase {
     private solanaService;
     private suiService;
     private headers;
+    /**
+     * Consumer-supplied Soroban RPC override for Stellar vault reads, with the
+     * network it was configured for so it's only applied to matching-network
+     * vaults (see `IVaultBaseOptions.stellarRpc`).
+     */
+    private _stellarRpc?;
     constructor(baseConfig: IAugustBase, solana: SolanaAdapter, sui: SuiAdapter);
     /**
      * @description deposit underlying token into the specified pool with adapter support. This is for when we cannot pass in a signer in sdk and need to do so as an arg
@@ -16949,8 +16955,11 @@ export declare function computeArgShape(args: unknown[]): string[];
  * @param vaultAddress  Stellar contract ID (C… address)
  * @param rawAmount     Deposit amount in the deposit token's smallest unit
  * @param network       'mainnet' | 'testnet'
+ * @param sorobanRpcUrl - Optional override Soroban RPC endpoint (e.g. a keyed
+ *   Alchemy URL); becomes the primary with the SDK's public endpoints kept as
+ *   failover. Omit to use the public endpoints.
  */
-declare const convertToShares: (vaultAddress: string, rawAmount: string, network?: IStellarNetwork) => Promise<string | null>;
+declare const convertToShares: (vaultAddress: string, rawAmount: string, network?: IStellarNetwork, sorobanRpcUrl?: string) => Promise<string | null>;
 
 /**
  * Create ethers contract instance with address validation.
@@ -18163,6 +18172,9 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
             * @param vaultAddress - Stellar vault contract ID (C… address)
             * @param walletAddress - User's Stellar account (G… address); validated upfront
             * @param network - 'mainnet' | 'testnet' (defaults to 'mainnet')
+            * @param sorobanRpcUrl - Optional override Soroban RPC endpoint (e.g. a keyed
+            *   Alchemy URL); becomes the primary with the SDK's public endpoints kept as
+            *   failover. Omit to use the public endpoints.
             * @returns The position, or `null` if the balance read failed or was unparseable.
             * @throws AugustValidationError on an invalid `walletAddress`.
             * @example
@@ -18175,7 +18187,7 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
             * const human = Number(pos.shares) / 10 ** pos.decimals;
             * ```
             */
-           declare const getStellarUserPosition: (vaultAddress: string, walletAddress: string, network?: IStellarNetwork) => Promise<IStellarUserPosition | null>;
+           declare const getStellarUserPosition: (vaultAddress: string, walletAddress: string, network?: IStellarNetwork, sorobanRpcUrl?: string) => Promise<IStellarUserPosition | null>;
 
            /**
             * Build a unified IVault from backend + on-chain data for Stellar vaults.
@@ -18183,7 +18195,7 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
             * Falls back to backend `latest_reported_tvl` for total assets, or zero
             * for total supply, when on-chain queries fail.
             */
-           declare const getStellarVault: (tokenizedVault: ITokenizedVault, _options: IVaultBaseOptions) => Promise<IVault>;
+           declare const getStellarVault: (tokenizedVault: ITokenizedVault, options: IVaultBaseOptions) => Promise<IVault>;
 
            declare function getStructuredLogger(): ILogger | null;
 
@@ -18800,6 +18812,7 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
                appName: string;
                providers?: IProvidersConfig;
                solana?: ISolanaConfig;
+               stellar?: IStellarConfig;
                keys: IKeys;
                monitoring?: IMonitoring;
                /** Analytics configuration. Enabled by default (opt-out model). */
@@ -20319,12 +20332,34 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
             */
            export declare function isSwapRouterEligible(vaultAddress: IAddress): boolean;
 
+           /**
+            * Stellar-specific configuration for `new AugustSDK({ stellar })`. All
+            * fields are optional — omit it entirely to target Stellar mainnet through the
+            * SDK's built-in public Soroban RPC endpoints.
+            */
+           export declare interface IStellarConfig {
+               /**
+                * Override Soroban RPC endpoint (e.g. a consumer's keyed Alchemy URL). When
+                * set it becomes the primary, with the SDK's built-in public endpoints kept
+                * behind it as failover. Optional — omit to use the public endpoints.
+                */
+               rpcUrl?: string;
+               /** Stellar network; defaults to mainnet when omitted. */
+               network?: IStellarNetwork;
+           }
+
            /** Parameters for building an unsigned Stellar vault deposit transaction. */
            declare interface IStellarDepositParams {
                contractId: string;
                amount: string;
                senderAddress: string;
                network: IStellarNetwork;
+               /**
+                * Optional override Soroban RPC endpoint (e.g. a keyed Alchemy URL). When set
+                * it is the primary, with the SDK's public endpoints kept behind it as
+                * failover.
+                */
+               sorobanRpcUrl?: string;
            }
 
            export declare type IStellarNetwork = 'mainnet' | 'testnet';
@@ -20335,6 +20370,12 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
                shares: string;
                receiverAddress: string;
                network: IStellarNetwork;
+               /**
+                * Optional override Soroban RPC endpoint (e.g. a keyed Alchemy URL). When set
+                * it is the primary, with the SDK's public endpoints kept behind it as
+                * failover.
+                */
+               sorobanRpcUrl?: string;
            }
 
            /**
@@ -21196,6 +21237,16 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
                subgraphKey?: string;
                chainId?: number;
                solanaService?: ISolanaService;
+               /**
+                * Optional Soroban RPC override (e.g. a keyed Alchemy URL) for Stellar vault
+                * reads, threaded from the SDK's `stellar` config. Carries the network it was
+                * configured for so it is only applied to matching-network vaults — a testnet
+                * override must not be used for a mainnet read. Unset → built-in endpoints.
+                */
+               stellarRpc?: {
+                   rpcUrl: string;
+                   network: IStellarNetwork;
+               };
                headers?: IWSMonitorHeaders;
                /**
                 * Portfolio mode: when true, the per-vault EVM getter does NOT null out a
@@ -21447,6 +21498,16 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
                chainId: number;
                type: 'withdraw-request' | 'deposit' | 'withdraw-processed' | 'redeem';
                transactionHash: IAddress;
+               /**
+                * The token address that was actually deposited, when known. Pre-deposit
+                * vaults accept multiple deposit assets (e.g. a sentUSD vault taking RLUSD,
+                * USDC, and USDT), so the vault's own metadata cannot tell a consumer which
+                * asset a given deposit used — only this per-row address can. UIs should
+                * resolve the displayed asset symbol/logo from `assetIn` rather than assuming
+                * the vault's first deposit asset. Absent for single-asset vaults and for
+                * withdraw/redeem rows, where the vault's underlying asset applies.
+                */
+               assetIn?: IAddress;
            };
 
            export declare interface IVaultUserLifetimePnl {
@@ -23705,9 +23766,24 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
              * // Sign xdr with wallet (e.g. Freighter), then submit via adapter.submitTransaction()
              * ```
              */
-            declare class StellarAdapter {
+            export declare class StellarAdapter {
                 private _network;
-                constructor(network?: IStellarNetwork);
+                /**
+                 * Optional consumer-supplied Soroban RPC endpoint (e.g. a keyed Alchemy URL).
+                 * When set it is the primary, with the SDK's public endpoints as failover.
+                 */
+                private _sorobanRpcUrl?;
+                /**
+                 * @param network - Stellar network to operate on; defaults to `'mainnet'`.
+                 * @param options - Optional adapter configuration. Its `sorobanRpcUrl` field
+                 *   overrides the Soroban RPC endpoint (e.g. a keyed Alchemy URL): it becomes
+                 *   the primary with the SDK's built-in public endpoints kept behind it as
+                 *   failover, and a per-call `sorobanRpcUrl` (on the deposit/redeem params)
+                 *   takes precedence over this adapter-level one.
+                 */
+                constructor(network?: IStellarNetwork, options?: {
+                    sorobanRpcUrl?: string;
+                });
                 get network(): IStellarNetwork;
                 isStellarAddress(address: string): boolean;
                 getExplorerLink(id: string, type?: 'contract' | 'account' | 'tx'): string;
@@ -23822,6 +23898,9 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
                   *
                   * @param signedXdr - Base64-encoded XDR of the signed transaction
                   * @param network - Stellar network name
+                  * @param sorobanRpcUrl - Optional override Soroban RPC endpoint (e.g. a keyed
+                  *   Alchemy URL); becomes the primary with the SDK's public endpoints kept as
+                  *   failover. Omit to use the public endpoints.
                   * @returns The transaction hash once the network confirms it as successful
                   * @throws {@link AugustTimeoutError} when the transaction is not confirmed
                       *   within the poll budget (`MAX_POLL_ATTEMPTS`).
@@ -23841,7 +23920,7 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
                           * }
                           * ```
                           */
-                      declare function submitStellarTransaction(signedXdr: string, network: IStellarNetwork): Promise<string>;
+                      declare function submitStellarTransaction(signedXdr: string, network: IStellarNetwork, sorobanRpcUrl?: string): Promise<string>;
 
                       /**
                        * Sui Adapter for August SDK

package/lib/types/vaults.d.ts

@@ -48,6 +48,16 @@ export type IVaultUserHistoryItem = {
     chainId: number;
     type: 'withdraw-request' | 'deposit' | 'withdraw-processed' | 'redeem';
     transactionHash: IAddress;
+    /**
+     * The token address that was actually deposited, when known. Pre-deposit
+     * vaults accept multiple deposit assets (e.g. a sentUSD vault taking RLUSD,
+     * USDC, and USDT), so the vault's own metadata cannot tell a consumer which
+     * asset a given deposit used — only this per-row address can. UIs should
+     * resolve the displayed asset symbol/logo from `assetIn` rather than assuming
+     * the vault's first deposit asset. Absent for single-asset vaults and for
+     * withdraw/redeem rows, where the vault's underlying asset applies.
+     */
+    assetIn?: IAddress;
 };
 /**
  * A single reward paired with its backend-provided logo.

package/lib/types/web3.d.ts

@@ -34,3 +34,18 @@ export interface ISolanaConfig {
     rpcUrl: string;
     network: ISolanaNetwork;
 }
+/**
+ * Stellar-specific configuration for `new AugustSDK({ stellar })`. All
+ * fields are optional — omit it entirely to target Stellar mainnet through the
+ * SDK's built-in public Soroban RPC endpoints.
+ */
+export interface IStellarConfig {
+    /**
+     * Override Soroban RPC endpoint (e.g. a consumer's keyed Alchemy URL). When
+     * set it becomes the primary, with the SDK's built-in public endpoints kept
+     * behind it as failover. Optional — omit to use the public endpoints.
+     */
+    rpcUrl?: string;
+    /** Stellar network; defaults to mainnet when omitted. */
+    network?: IStellarNetwork;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augustdigital/sdk",
-  "version": "8.10.0",
+  "version": "8.11.0",
   "main": "lib/index.js",
   "types": "lib/sdk.d.ts",
   "keywords": [