@augustdigital/sdk 8.10.0 → 8.12.0

package/lib/types/subgraph.d.ts

@@ -12,6 +12,15 @@ export interface ISubgraphUserHistoryItem extends ISubgraphBase {
     type: 'withdraw-request' | 'deposit' | 'withdraw-processed';
     decimals?: number;
     isInstant?: boolean;
+    /**
+     * Receipt-token (vault share) amount burned, raw base units. Present on
+     * withdraw-request rows: an async withdrawal burns shares up front, but the
+     * assets ultimately received are only known once the request settles (share
+     * price can move). Consumers showing a pending request should surface these
+     * shares (the concrete on-chain fact) rather than the request's `assets`
+     * preview. Absent on deposits and settled withdraws.
+     */
+    shares?: string;
     /**
      * Deposit asset token address, when known. Pre-deposit vaults accept
      * multiple deposit assets with differing decimals (e.g. USDS at 18,

package/lib/types/vaults.d.ts

@@ -48,6 +48,26 @@ 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;
+    /**
+     * Receipt-token (vault share) amount burned on a withdraw **request**. An
+     * async withdrawal burns shares immediately, but the assets received are not
+     * known until the request settles (share price can drift), so `amount`'s
+     * asset figure is only a preview. UIs rendering a pending request should show
+     * these `shares` with the receipt symbol — the concrete on-chain fact — and
+     * reserve the asset amount for the settled ("processed") row. Present only on
+     * `withdraw-request` items.
+     */
+    shares?: INormalizedNumber;
 };
 /**
  * A single reward paired with its backend-provided logo.
@@ -561,3 +581,27 @@ export interface ISwapRouterDepositOptions extends Omit<ISwapRouterBaseOptions,
      */
     slippageBps?: number;
 }
+/**
+ * Options for {@link getSwapRouterDepositResult} — resolves the real,
+ * post-execution outcome of a SwapRouter deposit from its mined transaction
+ * receipt, rather than the pre-trade quote shown before submission.
+ */
+export interface ISwapRouterDepositResultOptions {
+    /** Hash of a mined SwapRouter deposit transaction (e.g. from {@link swapRouterDeposit}). */
+    txHash: string;
+    /** The vault that was deposited into — isolates its own `Deposit` event from the router's unrelated logs. */
+    vault: IAddress;
+}
+/**
+ * Real, on-chain outcome of a SwapRouter deposit, decoded from the vault's own
+ * `Deposit` event (the SwapRouter contract itself emits no deposit/amount-out
+ * event — see {@link getSwapRouterDepositResult}). For a swap deposit this is
+ * the actual post-swap amount that reached the vault, which can differ from
+ * the pre-trade quote a UI shows before the user submits.
+ */
+export interface ISwapRouterDepositResult {
+    /** Raw amount of the vault's reference asset recorded as deposited (reference-asset decimals). */
+    amountOut: bigint;
+    /** Raw vault shares minted to the receiver (share-token decimals). */
+    sharesOut: bigint;
+}

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.12.0",
   "main": "lib/index.js",
   "types": "lib/sdk.d.ts",
   "keywords": [