@augustdigital/sdk 8.9.0 → 8.11.0

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). */
@@ -20191,6 +20204,8 @@ export declare function depositNative(signer: Signer | Wallet, options: INativeD
             */
            export declare function isHubOnlyReceipt(vault: IAddress): boolean;
 
+           export declare function isInsufficientFundsError(error: unknown): boolean;
+
            /**
             * True when `NODE_ENV` is `'development'` or `'test'`. The SDK auto-disables
             * analytics in these environments so partners' local dev runs and Jest suites
@@ -20317,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';
@@ -20333,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;
            }
 
            /**
@@ -21194,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
@@ -21445,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 {
@@ -23703,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;
@@ -23820,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`).
@@ -23839,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.9.0",
+  "version": "8.11.0",
   "main": "lib/index.js",
   "types": "lib/sdk.d.ts",
   "keywords": [