@upshiftfinance/sdk 0.4.0 → 0.5.0

package/lib/adapters/sui/index.js

@@ -33,13 +33,18 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Sui = void 0;
+exports.SuiAdapter = exports.Sui = void 0;
 const SuiActions = __importStar(require("./actions"));
 const SuiClient = __importStar(require("./client"));
 const SuiConstants = __importStar(require("./constants"));
 const SuiGetters = __importStar(require("./getters"));
 const SuiTargets = __importStar(require("./targets"));
 const SuiUtils = __importStar(require("./utils"));
+/**
+ * Sui helpers by area: chain identity (`utils`), constants, the gRPC client
+ * with failover (`client`), move-call targets (`targets`), vault reads
+ * (`getters`) and deposit / instant-redeem builders (`actions`).
+ */
 exports.Sui = {
     utils: SuiUtils,
     constants: SuiConstants,
@@ -108,7 +113,8 @@ class SuiAdapter {
      * RPC cost: one dry run (plus the coin lookup it needs).
      *
      * @param params - The vault, `amount` in asset base units, the `sender`, and
-     *   an optional `minSharesOut` (defaults to the dry run's exact preview).
+     *   optionally `minSharesOut` or `slippageBps` (the minimum defaults to the
+     *   dry run's preview less 0.1%).
      * @returns The unsigned transaction for the sender's wallet, the shares the
      *   dry run minted, and the minimum it enforces.
      * @throws {@link UpshiftValidationError} for malformed input, unknown
@@ -124,21 +130,25 @@ class SuiAdapter {
      *   amount: 1_000_000n,
      *   sender: account.address,
      * });
-     * await dAppKit.signAndExecuteTransaction({ transaction });
+     * const digest = await sdk.sui.executeTransaction(
+     *   await dAppKit.signTransaction({ transaction }),
+     * );
      * ```
      */
     async vaultDeposit(params) {
-        const { amount, sender, minSharesOut, ...vault } = params;
+        const { amount, sender, minSharesOut, slippageBps, ...vault } = params;
         return SuiActions.buildSuiDepositTransaction({
             vault: { ...vault, network: this.network },
             amount,
             sender,
             minSharesOut,
+            slippageBps,
         }, this._config);
     }
     /**
-     * Build an unsigned instant redemption on the configured network: redeem
-     * shares with a minimum net asset amount, send the assets to the sender.
+     * Build an unsigned instant redemption on the configured network: charge
+     * the management fee, redeem shares with a minimum net asset amount, send
+     * the assets to the sender.
      * Dry-runs it first; a vault with a withdrawal queue attached fails with
      * `queue_attached`.
      *
@@ -148,8 +158,8 @@ class SuiAdapter {
      * RPC cost: one dry run (plus the coin lookup it needs).
      *
      * @param params - The vault, `shares` in share base units, the `sender`, and
-     *   an optional `minAssetsOut` net of the instant fee (defaults to the dry
-     *   run's exact preview).
+     *   optionally `minAssetsOut` (net of the instant fee) or `slippageBps` (the
+     *   minimum defaults to the dry run's preview less 0.1%).
      * @returns The unsigned transaction, the dry run's gross and net assets, and
      *   the minimum it enforces.
      * @throws {@link UpshiftValidationError} for malformed input, unknown
@@ -158,14 +168,160 @@ class SuiAdapter {
      * @throws {@link UpshiftNetworkError} when every Sui endpoint fails.
      */
     async vaultRedeem(params) {
-        const { shares, sender, minAssetsOut, ...vault } = params;
+        const { shares, sender, minAssetsOut, slippageBps, ...vault } = params;
         return SuiActions.buildSuiRedeemTransaction({
             vault: { ...vault, network: this.network },
             shares,
             sender,
             minAssetsOut,
+            slippageBps,
+        }, this._config);
+    }
+    /**
+     * Build an unsigned withdrawal request on the configured network, for a
+     * vault with a withdrawal queue attached (where instant redemption is off).
+     * Escrows the shares in a new request; dry-runs it first, so a vault that
+     * would reject it fails here.
+     *
+     * The request is priced when it is claimed. Once the vault's cooldown has
+     * run, claim it with {@link SuiAdapter.claimWithdrawal}; cancel it at any
+     * time with {@link SuiAdapter.vaultCancelRedeemRequest}. List a wallet's
+     * requests with {@link SuiAdapter.getWithdrawalRequests}.
+     *
+     * RPC cost: one object read for a wallet with up to 23 earlier requests on
+     * the vault (one more per further 25), then one dry run.
+     *
+     * @param params - The vault, `shares` in share base units, the `sender`, and
+     *   optionally `payout` (defaults to the sender) and `finalizer`: who besides
+     *   the owner may claim during the first day the request is claimable
+     *   (anyone may after). Defaults to the owner alone; pass a keeper address,
+     *   or `null` to let anyone claim as soon as the cooldown ends.
+     * @returns The unsigned transaction, the request ID, the request's object ID
+     *   (`request`) for claiming or cancelling, and `expectedAssets` at today's
+     *   price.
+     * @throws {@link UpshiftValidationError} for malformed input, unknown
+     *   contract IDs, or a transaction that cannot be built.
+     * @throws {@link UpshiftVaultAbortError} when the vault would reject it,
+     *   e.g. `queue_not_attached` (redeem instantly instead) or `paused`.
+     * @throws {@link UpshiftNetworkError} when every Sui endpoint fails.
+     * @example
+     * ```ts
+     * const { transaction, request } = await sdk.sui.vaultRequestRedeem({
+     *   vaultId: vault.address,
+     *   assetCoinType: vault.depositAssets[0].address,
+     *   shareCoinType: vault.receipt.address,
+     *   shares: 1_000_000n,
+     *   sender: account.address,
+     * });
+     * await sdk.sui.executeTransaction(await dAppKit.signTransaction({ transaction }));
+     * ```
+     */
+    async vaultRequestRedeem(params) {
+        const { shares, sender, payout, finalizer, ...vault } = params;
+        return SuiActions.buildSuiRequestRedeemTransaction({
+            vault: { ...vault, network: this.network },
+            shares,
+            sender,
+            payout,
+            finalizer,
+        }, this._config);
+    }
+    /**
+     * Build an unsigned cancellation of a pending withdrawal request on the
+     * configured network; the escrowed shares go back to the sender. Allowed at
+     * any time while the request exists, also while the vault is paused. Only
+     * the wallet that made the request may cancel it.
+     *
+     * RPC cost: one dry run.
+     *
+     * @param params - The vault, the `request` object ID and the `sender`.
+     * @returns The unsigned transaction and the shares it returns.
+     * @throws {@link UpshiftValidationError} for malformed input, unknown
+     *   contract IDs, or a request that no longer exists.
+     * @throws {@link UpshiftVaultAbortError} when the vault would reject it,
+     *   e.g. `not_request_owner`.
+     * @throws {@link UpshiftNetworkError} when every Sui endpoint fails.
+     * @example
+     * ```ts
+     * const { transaction } = await sdk.sui.vaultCancelRedeemRequest({
+     *   vaultId, assetCoinType, shareCoinType, request, sender: account.address,
+     * });
+     * ```
+     */
+    async vaultCancelRedeemRequest(params) {
+        const { request, sender, ...vault } = params;
+        return SuiActions.buildSuiCancelRedeemRequestTransaction({ vault: { ...vault, network: this.network }, request, sender }, this._config);
+    }
+    /**
+     * Build an unsigned claim of a withdrawal request on the configured
+     * network: burns the escrowed shares and pays their current value, with no
+     * instant fee, to the request's payout.
+     *
+     * The payout lands in the payout address's address balance, not as a coin
+     * object. A request can be claimed from `eligibleAtMs` until `expiresAtMs`
+     * by its owner or finalizer (anyone when it names none), and by anyone from
+     * one day after it became eligible.
+     *
+     * RPC cost: one dry run.
+     *
+     * @param params - The vault, the `request` object ID, the `sender`, and
+     *   optionally `minAssetsOut` or `slippageBps` (the minimum defaults to the
+     *   dry run's payout less 0.1%).
+     * @returns The unsigned transaction, the shares it burns, the dry run's
+     *   payout, and the minimum it enforces.
+     * @throws {@link UpshiftValidationError} for malformed input, unknown
+     *   contract IDs, or a request that no longer exists.
+     * @throws {@link UpshiftVaultAbortError} when the vault would reject it,
+     *   e.g. `not_eligible_yet`, `request_expired` or `insufficient_liquidity`.
+     * @throws {@link UpshiftNetworkError} when every Sui endpoint fails.
+     * @example
+     * ```ts
+     * const [pending] = await sdk.sui.getWithdrawalRequests({ ...vault, owner: account.address });
+     * const { transaction } = await sdk.sui.claimWithdrawal({
+     *   ...vault, request: pending.request, sender: account.address,
+     * });
+     * ```
+     */
+    async claimWithdrawal(params) {
+        const { request, sender, minAssetsOut, slippageBps, ...vault } = params;
+        return SuiActions.buildSuiClaimWithdrawalTransaction({
+            vault: { ...vault, network: this.network },
+            request,
+            sender,
+            minAssetsOut,
+            slippageBps,
         }, this._config);
     }
+    /**
+     * A wallet's pending withdrawal requests on a vault, on the configured
+     * network, oldest first. Finds every request made through the SDK however
+     * old; claimed and cancelled requests are left out.
+     *
+     * RPC cost: one object read for a wallet that has made up to 23 requests on
+     * the vault (most wallets), one more per further 25.
+     *
+     * @param params - The vault and the `owner` wallet.
+     * @returns The pending requests, with shares, payout, and the times they
+     *   become claimable and expire; empty when there are none.
+     * @throws {@link UpshiftValidationError} for malformed input, unknown
+     *   contract IDs, or a vault ID that is not a vault of the configured
+     *   `sui.originalPackageId`.
+     * @throws {@link UpshiftNetworkError} when every Sui endpoint fails.
+     * @example
+     * ```ts
+     * const pending = await sdk.sui.getWithdrawalRequests({
+     *   vaultId, assetCoinType, shareCoinType, owner: account.address,
+     * });
+     * const now = Date.now();
+     * const claimable = pending.filter(
+     *   (r) => r.eligibleAtMs <= now && (r.expiresAtMs === null || now < r.expiresAtMs),
+     * );
+     * ```
+     */
+    async getWithdrawalRequests(params) {
+        const { owner, ...vault } = params;
+        return SuiGetters.getSuiWithdrawalRequests({ ...vault, network: this.network }, owner, this._config);
+    }
     /**
      * Execute a wallet-signed transaction on the configured network and wait
      * until it is indexed. Not needed when the wallet executes the transaction
@@ -186,5 +342,6 @@ class SuiAdapter {
         return SuiActions.submitSuiTransaction(signed, this.network, this._config);
     }
 }
+exports.SuiAdapter = SuiAdapter;
 exports.default = SuiAdapter;
 //# sourceMappingURL=index.js.map

package/lib/adapters/sui/targets.d.ts

@@ -29,7 +29,8 @@ export interface ISuiVaultTargetSpec {
  * Every `upshift_vault` function the SDK calls, keyed by a stable name.
  *
  * Vault functions take the `<Asset, Share>` type arguments built by
- * {@link suiVaultTypeArguments}; `withdrawal::share` takes `<Share>` only.
+ * {@link suiVaultTypeArguments}; `withdrawal::share` and `withdrawal::shares`
+ * take `<Share>` only.
  */
 export declare const SUI_VAULT_TARGETS: {
     readonly deposit: {
@@ -67,6 +68,11 @@ export declare const SUI_VAULT_TARGETS: {
         readonly function: "share";
         readonly params: readonly ["WithdrawalRequest<Share>"];
     };
+    readonly withdrawalRequestShares: {
+        readonly module: "withdrawal";
+        readonly function: "shares";
+        readonly params: readonly ["&WithdrawalRequest<Share>"];
+    };
     readonly finalizeWithdrawal: {
         readonly module: "vault";
         readonly function: "finalize_withdrawal";

package/lib/adapters/sui/targets.js

@@ -12,7 +12,8 @@ const constants_1 = require("./constants");
  * Every `upshift_vault` function the SDK calls, keyed by a stable name.
  *
  * Vault functions take the `<Asset, Share>` type arguments built by
- * {@link suiVaultTypeArguments}; `withdrawal::share` takes `<Share>` only.
+ * {@link suiVaultTypeArguments}; `withdrawal::share` and `withdrawal::shares`
+ * take `<Share>` only.
  */
 exports.SUI_VAULT_TARGETS = {
     deposit: {
@@ -86,6 +87,11 @@ exports.SUI_VAULT_TARGETS = {
         function: 'share',
         params: ['WithdrawalRequest<Share>'],
     },
+    withdrawalRequestShares: {
+        module: 'withdrawal',
+        function: 'shares',
+        params: ['&WithdrawalRequest<Share>'],
+    },
     finalizeWithdrawal: {
         module: 'vault',
         function: 'finalize_withdrawal',

package/lib/core/analytics/method-taxonomy.js

@@ -65,6 +65,8 @@ exports.METHOD_CATEGORIES = {
     getVaultPendingRedemptions: 'read.redemption',
     getVaultWithdrawals: 'read.redemption',
     getWithdrawalRequestsWithStatus: 'read.redemption',
+    // Sui withdrawal queue: a wallet's pending requests on a vault.
+    getWithdrawalRequests: 'read.redemption',
     previewRedemption: 'read.redemption',
     previewRwaRedemption: 'read.redemption',
     getBurnableAmountByReceiver: 'read.redemption',

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

@@ -3,4 +3,4 @@
  * Generated at build time from package.json version
  * This file is gitignored and regenerated by every build
  */
-export declare const SDK_VERSION = "0.4.0";
+export declare const SDK_VERSION = "0.5.0";

package/lib/core/analytics/version.js

@@ -6,5 +6,5 @@ exports.SDK_VERSION = void 0;
  * Generated at build time from package.json version
  * This file is gitignored and regenerated by every build
  */
-exports.SDK_VERSION = '0.4.0';
+exports.SDK_VERSION = '0.5.0';
 //# sourceMappingURL=version.js.map

package/lib/core/errors/index.d.ts

@@ -210,10 +210,23 @@ export declare class UpshiftTransactionError extends UpshiftSDKError {
  *   withdrawal queue.
  * - `slippage` — the output is below the minimum the transaction set.
  * - `zero_output` — the amount is too small to mint shares or pay assets.
- * - `version_retired` — the vault package version is retired; upgrade the SDK.
+ * - `version_retired` — the transaction targets a retired package version;
+ *   point it at the current `upshift_vault` package (`sui.packageId`).
+ * - `queue_not_attached` — withdrawal requests are off; the vault has no
+ *   withdrawal queue (redeem instantly instead).
+ * - `invalid_payout` — the request's payout address could never receive the
+ *   assets (the zero, vault, Registry or request address).
+ * - `request_id_in_use` — the wallet already used this request ID on the
+ *   vault; build the request again to pick the next one.
+ * - `not_request_owner` — only the wallet that made the request may cancel it.
+ * - `not_finalizer` — this wallet may not claim the request yet: only its
+ *   owner or named finalizer may, until one day after it became eligible.
+ * - `not_eligible_yet` — the request's cooldown has not run out.
+ * - `request_expired` — the request's fulfillment window has passed; cancel it
+ *   to get the shares back.
  * - `other` — any other abort; see `module` and `constant`.
  */
-export type UpshiftVaultAbortReason = 'paused' | 'below_min_deposit' | 'above_max_deposit' | 'deposit_cap_exceeded' | 'above_max_withdrawal' | 'insufficient_liquidity' | 'queue_attached' | 'slippage' | 'zero_output' | 'version_retired' | 'other';
+export type UpshiftVaultAbortReason = 'paused' | 'below_min_deposit' | 'above_max_deposit' | 'deposit_cap_exceeded' | 'above_max_withdrawal' | 'insufficient_liquidity' | 'queue_attached' | 'slippage' | 'zero_output' | 'version_retired' | 'queue_not_attached' | 'invalid_payout' | 'request_id_in_use' | 'not_request_owner' | 'not_finalizer' | 'not_eligible_yet' | 'request_expired' | 'other';
 /**
  * A vault contract rejected a transaction, in a dry run before signing or on
  * chain. `reason` is stable to branch on; `module` and `constant` name the

package/lib/evm/methods/crossChainVault.js

@@ -8,39 +8,6 @@
  *
  * @module evm/methods/crossChainVault
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LAYERZERO_ENDPOINT_IDS = void 0;
 exports.buildCrossChainVaultTx = buildCrossChainVaultTx;
@@ -59,6 +26,7 @@ exports.getAvailableChains = getAvailableChains;
 exports.formatCrossChainError = formatCrossChainError;
 exports.getLayerZeroScanUrl = getLayerZeroScanUrl;
 const attribution_1 = require("../../core/attribution");
+const ethers_1 = require("ethers");
 const core_1 = require("../../core");
 const crossChain_1 = require("../types/crossChain");
 const OFT_1 = require("../../abis/OFT");
@@ -369,19 +337,33 @@ async function buildCrossChainVaultTx(props) {
         const hubRpc = hubChain?.rpcUrls;
         const hubRpcUrl = hubRpc?.default?.http?.[0];
         let hubPublicClient;
-        try {
-            // Dynamic import to keep viem optional at the module level
-            const viem = await Promise.resolve().then(() => __importStar(require('viem')));
-            hubPublicClient = viem.createPublicClient({
-                chain: hubChain,
-                transport: viem.http(hubRpcUrl),
-            });
+        if (hubRpcUrl) {
+            // Hub reads (multi-asset previews) go through ethers, which is a hard
+            // dependency. This used to dynamically import the optional `viem` peer, which tsc
+            // compiles to a literal CJS require that bundlers resolve at build time
+            // and fail on when `viem` is not installed.
+            // `createProvider` is cached per (url, chainId) and uses a static
+            // network, so each readContract costs exactly one `eth_call`.
+            const hubChainId = hubChain?.id;
+            const provider = (0, core_1.createProvider)(hubRpcUrl, hubChainId);
+            hubPublicClient = {
+                readContract: async (args) => {
+                    const { address, abi, functionName, args: callArgs = [], } = args;
+                    const result = await new ethers_1.Contract(address, abi, provider)
+                        .getFunction(functionName)
+                        .staticCallResult(...callArgs);
+                    // Match viem's readContract shape: a single output is returned
+                    // bare; multiple outputs as a positional array.
+                    return result.length === 1 ? result[0] : result.toArray();
+                },
+            };
         }
-        catch {
-            // If viem is not available, provide a stub that will fail on multi-asset only
+        else {
+            // No hub RPC on the chain object: only multi-asset paths read the hub,
+            // so fail those (redeem previews fall back to 1:1, as before).
             hubPublicClient = {
                 readContract: async () => {
-                    throw new Error('viem is required for multi-asset vault operations. Install viem as a peer dependency.');
+                    throw new core_1.UpshiftValidationError('INVALID_INPUT', 'hubChain.rpcUrls.default.http[0] is required for multi-asset vault operations.');
                 },
             };
         }

package/lib/index.d.ts

@@ -22,6 +22,10 @@ export * from './adapters/solana';
  * Stellar export
  */
 export * from './adapters/stellar';
+/**
+ * Sui export
+ */
+export * from './adapters/sui';
 export declare const VAULT_ADDRESSES: Record<"musd" | "predlp" | "sentusd" | "pregrid" | "repouscc" | "earnxrp" | "tivkbtc" | "tivusdt0" | "supermon" | "earnmon" | "k3europ" | "wmon/ausd" | "wbtc/ausd" | "earnausd_monad" | "sausd" | "farmbold" | "sentuscc" | "sentbtc" | "svusdc" | "apusdc" | "testwethtsa" | "tacusr" | "upinjusdt" | "tac-teth" | "upausd" | "taccbbtc" | "xupusdc" | "uptbtc" | "gteth" | "ageth" | "upusdc" | "hgeth" | "upssylva" | "hbbtc" | "hbhype" | "upazt" | "susdt" | "upedge" | "coreusdc" | "upcusdo" | "shifteth" | "upsusde" | "uplbtc" | "upavax" | "tacrseth" | "earnausd" | "alpineusdcflagship" | "alpinecoinshiftusdc" | "upbtc" | "upstrbtc" | "maxiusr" | "upgammausdc" | "xhype" | "wildusd" | "alpinebtc" | "prenusd" | "upyzusd" | "upnusd" | "hlpe" | "nemo eth yield", `0x${string}`>;
 /**
  * Export the SDK class as default

package/lib/index.js

@@ -39,6 +39,10 @@ __exportStar(require("./adapters/solana"), exports);
  * Stellar export
  */
 __exportStar(require("./adapters/stellar"), exports);
+/**
+ * Sui export
+ */
+__exportStar(require("./adapters/sui"), exports);
 /**
  * Upshift Vaults
  */

package/lib/main.d.ts

@@ -266,8 +266,10 @@ export declare class UpshiftSDK extends UpshiftBase {
         solanaWallet?: string;
         stellarWallet?: string;
         /**
-         * Sui wallet address (`0x` + 64 hex chars). Its share balance is read for
-         * each Sui vault; Sui positions have no redemptions in v1.
+         * Sui wallet address (`0x` + 64 hex chars). Its share balance and its
+         * pending withdrawal requests (as redemptions) are read for each Sui vault:
+         * one balance read plus, when the SDK has the contract IDs, one object read
+         * (one more per further 25 requests the wallet has made on the vault).
          */
         suiWallet?: string;
         options?: IVaultBaseOptions;

package/lib/modules/vaults/getters.js

@@ -185,7 +185,15 @@ async function getVault({ vault, loans = false, allocations = false, options, lo
         // caller sees the same throw either way, so it is recorded as a breadcrumb
         // rather than a billed Sentry issue. Everything else stays at error.
         (0, core_1.logChainError)('getVault', err, (0, core_1.isRetryableRpcError)(err) || (0, core_1.isEmptyViewResponse)(err), { vault });
-        throw new Error(`#getVault::${vault}: ${err?.message}`);
+        // Typed SDK errors (rate limit, server, validation, …) pass through
+        // unchanged so callers can branch on `instanceof` / `code` and Sentry
+        // groups them by class. Anything else is wrapped in a typed error with the
+        // original kept as `cause`; the `#getVault::` message is unchanged.
+        if (err instanceof errors_1.UpshiftSDKError)
+            throw err;
+        throw new errors_1.UpshiftSDKError('UNKNOWN', `#getVault::${vault}: ${err?.message}`, {
+            cause: err,
+        });
     }
     // Loans enrichment stays EVM-only — there is no non-EVM loan book to read.
     // Allocations additionally covers Stellar (Untangled) and Solana (Octav, per
@@ -1606,6 +1614,10 @@ async function getVaultPositions({ vault, wallet, solanaWallet, stellarWallet, s
                     const shareCoinType = v.sui_vault_metadata?.share_coin_type;
                     const network = v.sui_vault_metadata?.network_name;
                     let balance = (0, core_1.toNormalizedBn)(0, decimals ?? 0);
+                    let redemptions = {
+                        availableRedemptions: [],
+                        pendingRedemptions: [],
+                    };
                     // No metadata at all: a legacy Ember/Gamma vault, nothing to read.
                     if (suiWallet && (0, chain_address_1.isSuiAddress)(suiWallet) && v.sui_vault_metadata) {
                         if (decimals == null || !shareCoinType || !network) {
@@ -1613,15 +1625,31 @@ async function getVaultPositions({ vault, wallet, solanaWallet, stellarWallet, s
                             // read or no way to scale it: fail the row, don't show zero.
                             throw new errors_1.UpshiftValidationError('INVALID_INPUT', 'getVaultPositions: Sui vault is missing sui_vault_metadata share type, decimals or network', { context: { vault: v.address } });
                         }
-                        const shares = await SuiGetters.getSuiShareBalance(suiWallet, shareCoinType, network, options.sui);
+                        const ref = SuiGetters.suiVaultRefFromRow(v);
+                        const [shares, queued] = await Promise.all([
+                            SuiGetters.getSuiShareBalance(suiWallet, shareCoinType, network, options.sui),
+                            // Shares escrowed in withdrawal requests have left the wallet.
+                            // A failed request read keeps the balance, as on Solana.
+                            ref
+                                ? SuiGetters.getSuiPositionRedemptions(ref, suiWallet, decimals, options.sui).catch((error) => {
+                                    core_1.Logger.log.warn('getVaultPositions', 'Sui withdrawal requests unread — position shows the share balance only', { vault: v.address, error });
+                                    return redemptions;
+                                })
+                                : redemptions,
+                        ]);
                         balance = (0, core_1.toNormalizedBn)(shares, decimals);
+                        redemptions = queued;
                     }
-                    // Sui vaults have no redemption reads in v1.
                     return {
                         vault: v.address,
-                        status: renderStatus([], balance),
-                        availableRedemptions: [],
-                        pendingRedemptions: [],
+                        // Any queued request, waiting or claimable, marks the position
+                        // REDEEM, as on Solana.
+                        status: renderStatus([
+                            ...redemptions.availableRedemptions,
+                            ...redemptions.pendingRedemptions,
+                        ], balance),
+                        availableRedemptions: redemptions.availableRedemptions,
+                        pendingRedemptions: redemptions.pendingRedemptions,
                         redeemable: (0, core_1.toNormalizedBn)(0),
                         walletBalance: balance,
                     };

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

@@ -242,8 +242,10 @@ export declare class UpshiftVaults extends UpshiftBase {
         solanaWallet?: string;
         stellarWallet?: string;
         /**
-         * Sui wallet address (`0x` + 64 hex chars). Its share balance is read for
-         * each Sui vault; Sui positions have no redemptions in v1.
+         * Sui wallet address (`0x` + 64 hex chars). Its share balance and its
+         * pending withdrawal requests (as redemptions) are read for each Sui vault:
+         * one balance read plus, when the SDK has the contract IDs, one object read
+         * (one more per further 25 requests the wallet has made on the vault).
          */
         suiWallet?: string;
         options?: IVaultBaseOptions;

package/lib/modules/vaults/main.js

@@ -738,7 +738,9 @@ class UpshiftVaults extends core_1.UpshiftBase {
         }
         const allVaults = await (0, core_1.fetchTokenizedVaults)(undefined, this.headers, false, false);
         if (chainId) {
-            const vaultsPerChain = allVaults.filter((v) => v.chain === chainId);
+            // Sui rows without sui_vault_metadata are legacy Ember/Gamma vaults.
+            const vaultsPerChain = allVaults.filter((v) => v.chain === chainId &&
+                !(v.chain_type === 'sui' && !v.sui_vault_metadata));
             // Batch balanceOf/lagDuration via Multicall3 before the per-vault
             // fan-out; un-batched vaults fall back to their own reads.
             const prefetchedReads = await (0, prefetch_1.prefetchVaultPositionReads)({