@compass-labs/api-sdk 2.2.75-rc.0 → 2.2.76-rc.0

package/src/funcs/tokenizedAssetsTokenizedAssetsRedemptions.ts

@@ -0,0 +1,192 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { CompassApiSDKCore } from "../core.js";
+import { encodeFormQuery } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as components from "../models/components/index.js";
+import { CompassAPISDKError } from "../models/errors/compassapisdkerror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get IXS vault redemption requests for an owner
+ *
+ * @remarks
+ * Get an owner's IXS vault redemption requests (async redemption status).
+ *
+ * IXS managed-vault **sells** are asynchronous: `/transact/sell` returns a
+ * `requestRedeem` transaction, and the vault operator settles it off-chain
+ * later. This endpoint reconstructs the owner's requests directly from the
+ * vault on every call (Compass persists no async state) — each entry carries
+ * its `status` (`pending` | `finalized` | `rejected`), the `shares` requested,
+ * and, while `pending`, the `expected_net_assets` it would settle for at the
+ * current NAV (a preview, not a guarantee).
+ *
+ * IXS vaults live on BNB Smart Chain — pass `chain=bsc` (the default) and the
+ * `vault` handle (default `ixv1`).
+ */
+export function tokenizedAssetsTokenizedAssetsRedemptions(
+  client: CompassApiSDKCore,
+  request: operations.V2TokenizedAssetsRedemptionsRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.RedemptionsResponse,
+    | errors.TokenizedAssetsErrorResponse
+    | CompassAPISDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: CompassApiSDKCore,
+  request: operations.V2TokenizedAssetsRedemptionsRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.RedemptionsResponse,
+      | errors.TokenizedAssetsErrorResponse
+      | CompassAPISDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.V2TokenizedAssetsRedemptionsRequest$outboundSchema.parse(
+        value,
+      ),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const path = pathToFunc("/v2/tokenized_assets/redemptions")();
+
+  const query = encodeFormQuery({
+    "chain": payload.chain,
+    "owner": payload.owner,
+    "vault": payload.vault,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKeyAuth);
+  const securityInput = secConfig == null ? {} : { apiKeyAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "v2_tokenized_assets_redemptions",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKeyAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.RedemptionsResponse,
+    | errors.TokenizedAssetsErrorResponse
+    | CompassAPISDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.RedemptionsResponse$inboundSchema),
+    M.jsonErr(422, errors.TokenizedAssetsErrorResponse$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/models/components/compassapibackendv2modelstokenizedassetsmarketmarket.ts

@@ -34,7 +34,7 @@ export type CompassApiBackendV2ModelsTokenizedAssetsMarketMarket = {
    */
   name: string;
   /**
-   * Ethereum mainnet ERC-20 address for this token.
+   * On-chain ERC-20 address for this token, on the network given by `chain`.
    */
   contractAddress: string;
   /**
@@ -64,21 +64,23 @@ export type CompassApiBackendV2ModelsTokenizedAssetsMarketMarket = {
   /**
    * Issuer/provider of a tokenized asset.
    */
-  provider?: TokenizedAssetProvider | undefined;
+  provider: TokenizedAssetProvider;
   /**
    * Asset class of a tokenized asset.
    *
    * @remarks
    *
    * `EQUITY` trades via the order endpoints (build/submit/cancel); the RWA
-   * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) trade via the
-   * swap-based `transact/buy` and `transact/sell` endpoints.
+   * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) and `MANAGED_VAULT`
+   * trade via the swap-based `transact/buy` and `transact/sell` endpoints.
+   * `MANAGED_VAULT` (IXS ERC-4626 vaults) is special in that a sell is an
+   * *asynchronous* redemption request settled off-chain by the vault operator.
    */
-  assetClass?: TokenizedAssetClass | undefined;
+  assetClass: TokenizedAssetClass;
   /**
    * The chain to use.
    */
-  chain?: Chain | undefined;
+  chain: Chain;
   /**
    * Trailing 7-day annualized NAV growth (decimal fraction string, e.g. '0.0512' = 5.12%). RWA yield assets only; null until enough NAV history exists.
    */
@@ -110,9 +112,9 @@ export const CompassApiBackendV2ModelsTokenizedAssetsMarketMarket$inboundSchema:
     change_24h_pct: z.nullable(z.string()).optional(),
     sectors: z.array(z.string()).optional(),
     region_exposure: z.array(z.string()).optional(),
-    provider: TokenizedAssetProvider$inboundSchema.optional(),
-    asset_class: TokenizedAssetClass$inboundSchema.optional(),
-    chain: Chain$inboundSchema.optional(),
+    provider: TokenizedAssetProvider$inboundSchema,
+    asset_class: TokenizedAssetClass$inboundSchema,
+    chain: Chain$inboundSchema,
     apy_7d: z.nullable(z.string()).optional(),
     apy_30d: z.nullable(z.string()).optional(),
     tvl_usd: z.nullable(z.string()).optional(),

package/src/models/components/compassapibackendv2modelstokenizedassetsreadresponsepositionsposition.ts

@@ -72,8 +72,10 @@ export type CompassApiBackendV2ModelsTokenizedAssetsReadResponsePositionsPositio
      * @remarks
      *
      * `EQUITY` trades via the order endpoints (build/submit/cancel); the RWA
-     * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) trade via the
-     * swap-based `transact/buy` and `transact/sell` endpoints.
+     * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) and `MANAGED_VAULT`
+     * trade via the swap-based `transact/buy` and `transact/sell` endpoints.
+     * `MANAGED_VAULT` (IXS ERC-4626 vaults) is special in that a sell is an
+     * *asynchronous* redemption request settled off-chain by the vault operator.
      */
     assetClass?: TokenizedAssetClass | undefined;
     /**

package/src/models/components/index.ts

@@ -262,6 +262,8 @@ export * from "./pricepoint.js";
 export * from "./protocol.js";
 export * from "./quote.js";
 export * from "./quotefee.js";
+export * from "./redemption.js";
+export * from "./redemptionsresponse.js";
 export * from "./repay.js";
 export * from "./reserve.js";
 export * from "./reserveinfo.js";

package/src/models/components/marketdetail.ts

@@ -36,7 +36,7 @@ export type MarketDetail = {
    */
   name: string;
   /**
-   * Ethereum mainnet ERC-20 address for this token.
+   * On-chain ERC-20 address for this token, on the network given by `chain`.
    */
   contractAddress: string;
   /**
@@ -66,21 +66,23 @@ export type MarketDetail = {
   /**
    * Issuer/provider of a tokenized asset.
    */
-  provider?: TokenizedAssetProvider | undefined;
+  provider: TokenizedAssetProvider;
   /**
    * Asset class of a tokenized asset.
    *
    * @remarks
    *
    * `EQUITY` trades via the order endpoints (build/submit/cancel); the RWA
-   * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) trade via the
-   * swap-based `transact/buy` and `transact/sell` endpoints.
+   * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) and `MANAGED_VAULT`
+   * trade via the swap-based `transact/buy` and `transact/sell` endpoints.
+   * `MANAGED_VAULT` (IXS ERC-4626 vaults) is special in that a sell is an
+   * *asynchronous* redemption request settled off-chain by the vault operator.
    */
-  assetClass?: TokenizedAssetClass | undefined;
+  assetClass: TokenizedAssetClass;
   /**
    * The chain to use.
    */
-  chain?: Chain | undefined;
+  chain: Chain;
   /**
    * Trailing 7-day annualized NAV growth (decimal fraction string, e.g. '0.0512' = 5.12%). RWA yield assets only; null until enough NAV history exists.
    */
@@ -155,9 +157,9 @@ export const MarketDetail$inboundSchema: z.ZodType<
   change_24h_pct: z.nullable(z.string()).optional(),
   sectors: z.array(z.string()).optional(),
   region_exposure: z.array(z.string()).optional(),
-  provider: TokenizedAssetProvider$inboundSchema.optional(),
-  asset_class: TokenizedAssetClass$inboundSchema.optional(),
-  chain: Chain$inboundSchema.optional(),
+  provider: TokenizedAssetProvider$inboundSchema,
+  asset_class: TokenizedAssetClass$inboundSchema,
+  chain: Chain$inboundSchema,
   apy_7d: z.nullable(z.string()).optional(),
   apy_30d: z.nullable(z.string()).optional(),
   tvl_usd: z.nullable(z.string()).optional(),

package/src/models/components/redemption.ts

@@ -0,0 +1,89 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Lifecycle state: `pending` (awaiting operator settlement), `finalized` (settled — assets paid to the product account), `rejected` (operator declined; shares returned to the account), or `unknown` (an unrecognized on-chain status code — should not occur for the current contract, surfaced defensively instead of erroring).
+ */
+export const RedemptionStatus = {
+  Pending: "pending",
+  Finalized: "finalized",
+  Rejected: "rejected",
+  Unknown: "unknown",
+} as const;
+/**
+ * Lifecycle state: `pending` (awaiting operator settlement), `finalized` (settled — assets paid to the product account), `rejected` (operator declined; shares returned to the account), or `unknown` (an unrecognized on-chain status code — should not occur for the current contract, surfaced defensively instead of erroring).
+ */
+export type RedemptionStatus = ClosedEnum<typeof RedemptionStatus>;
+
+/**
+ * One IXS vault redemption request, reconstructed on-chain.
+ */
+export type Redemption = {
+  /**
+   * On-chain redemption request id.
+   */
+  id: number;
+  /**
+   * Lifecycle state: `pending` (awaiting operator settlement), `finalized` (settled — assets paid to the product account), `rejected` (operator declined; shares returned to the account), or `unknown` (an unrecognized on-chain status code — should not occur for the current contract, surfaced defensively instead of erroring).
+   */
+  status: RedemptionStatus;
+  /**
+   * Vault shares in the request (human units).
+   */
+  shares: string;
+  /**
+   * For a `pending` request, the estimated net assets (after the exit fee) it would settle for at the current NAV — a preview, not a guarantee (settlement depends on the operator and the vault's available assets). Null once finalized or rejected.
+   */
+  expectedNetAssets?: string | null | undefined;
+  /**
+   * Unix timestamp when the redemption was requested.
+   */
+  requestedAt: number;
+  /**
+   * Unix timestamp when finalized/rejected; null while pending.
+   */
+  processedAt?: number | null | undefined;
+};
+
+/** @internal */
+export const RedemptionStatus$inboundSchema: z.ZodNativeEnum<
+  typeof RedemptionStatus
+> = z.nativeEnum(RedemptionStatus);
+
+/** @internal */
+export const Redemption$inboundSchema: z.ZodType<
+  Redemption,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.number().int(),
+  status: RedemptionStatus$inboundSchema,
+  shares: z.string(),
+  expected_net_assets: z.nullable(z.string()).optional(),
+  requested_at: z.number().int(),
+  processed_at: z.nullable(z.number().int()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "expected_net_assets": "expectedNetAssets",
+    "requested_at": "requestedAt",
+    "processed_at": "processedAt",
+  });
+});
+
+export function redemptionFromJSON(
+  jsonString: string,
+): SafeParseResult<Redemption, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Redemption$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Redemption' from JSON`,
+  );
+}

package/src/models/components/redemptionsresponse.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { Redemption, Redemption$inboundSchema } from "./redemption.js";
+
+/**
+ * An owner's IXS redemption requests for one vault.
+ */
+export type RedemptionsResponse = {
+  /**
+   * The owner's non-empty redemption requests for the vault, in ascending id order. Empty when the owner has never requested one.
+   */
+  redemptions?: Array<Redemption> | undefined;
+};
+
+/** @internal */
+export const RedemptionsResponse$inboundSchema: z.ZodType<
+  RedemptionsResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  redemptions: z.array(Redemption$inboundSchema).optional(),
+});
+
+export function redemptionsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<RedemptionsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RedemptionsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RedemptionsResponse' from JSON`,
+  );
+}

package/src/models/components/tokenizedassetclass.ts

@@ -11,14 +11,17 @@ import { ClosedEnum } from "../../types/enums.js";
  * @remarks
  *
  * `EQUITY` trades via the order endpoints (build/submit/cancel); the RWA
- * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) trade via the
- * swap-based `transact/buy` and `transact/sell` endpoints.
+ * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) and `MANAGED_VAULT`
+ * trade via the swap-based `transact/buy` and `transact/sell` endpoints.
+ * `MANAGED_VAULT` (IXS ERC-4626 vaults) is special in that a sell is an
+ * *asynchronous* redemption request settled off-chain by the vault operator.
  */
 export const TokenizedAssetClass = {
   Equity: "EQUITY",
   TBills: "T_BILLS",
   BasisTrade: "BASIS_TRADE",
   BtcYield: "BTC_YIELD",
+  ManagedVault: "MANAGED_VAULT",
 } as const;
 /**
  * Asset class of a tokenized asset.
@@ -26,8 +29,10 @@ export const TokenizedAssetClass = {
  * @remarks
  *
  * `EQUITY` trades via the order endpoints (build/submit/cancel); the RWA
- * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) trade via the
- * swap-based `transact/buy` and `transact/sell` endpoints.
+ * yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) and `MANAGED_VAULT`
+ * trade via the swap-based `transact/buy` and `transact/sell` endpoints.
+ * `MANAGED_VAULT` (IXS ERC-4626 vaults) is special in that a sell is an
+ * *asynchronous* redemption request settled off-chain by the vault operator.
  */
 export type TokenizedAssetClass = ClosedEnum<typeof TokenizedAssetClass>;
 

package/src/models/components/tokenizedassetprovider.ts

@@ -11,6 +11,7 @@ import { ClosedEnum } from "../../types/enums.js";
 export const TokenizedAssetProvider = {
   Ondo: "ondo",
   Midas: "midas",
+  Ixs: "ixs",
 } as const;
 /**
  * Issuer/provider of a tokenized asset.

package/src/models/components/tokenizedassetstraderesponse.ts

@@ -5,6 +5,7 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import {
@@ -16,6 +17,18 @@ import {
   UnsignedTransaction$inboundSchema,
 } from "./unsignedtransaction.js";
 
+/**
+ * How the trade settles. `instant`: the signed transaction completes the trade (Midas/Ondo swaps and IXS deposits). `async`: the transaction only *requests* an IXS redemption, which the vault operator settles off-chain later — poll `poll_endpoint` for status.
+ */
+export const Settlement = {
+  Instant: "instant",
+  Async: "async",
+} as const;
+/**
+ * How the trade settles. `instant`: the signed transaction completes the trade (Midas/Ondo swaps and IXS deposits). `async`: the transaction only *requests* an IXS redemption, which the vault operator settles off-chain later — poll `poll_endpoint` for status.
+ */
+export type Settlement = ClosedEnum<typeof Settlement>;
+
 /**
  * Unsigned trade execution for the owner to sign.
  *
@@ -41,8 +54,20 @@ export type TokenizedAssetsTradeResponse = {
    * Fee charged on the sell, in payout-token (USDC) units. Null when no fee was applied.
    */
   feeAmount?: string | null | undefined;
+  /**
+   * How the trade settles. `instant`: the signed transaction completes the trade (Midas/Ondo swaps and IXS deposits). `async`: the transaction only *requests* an IXS redemption, which the vault operator settles off-chain later — poll `poll_endpoint` for status.
+   */
+  settlement?: Settlement | undefined;
+  /**
+   * For `async` settlements, the endpoint to poll for redemption status (`GET /v2/tokenized_assets/redemptions`). Null for instant trades.
+   */
+  pollEndpoint?: string | null | undefined;
 };
 
+/** @internal */
+export const Settlement$inboundSchema: z.ZodNativeEnum<typeof Settlement> = z
+  .nativeEnum(Settlement);
+
 /** @internal */
 export const TokenizedAssetsTradeResponse$inboundSchema: z.ZodType<
   TokenizedAssetsTradeResponse,
@@ -54,11 +79,14 @@ export const TokenizedAssetsTradeResponse$inboundSchema: z.ZodType<
     .optional(),
   estimated_amount_out: z.string(),
   fee_amount: z.nullable(z.string()).optional(),
+  settlement: Settlement$inboundSchema.optional(),
+  poll_endpoint: z.nullable(z.string()).optional(),
 }).transform((v) => {
   return remap$(v, {
     "eip_712": "eip712",
     "estimated_amount_out": "estimatedAmountOut",
     "fee_amount": "feeAmount",
+    "poll_endpoint": "pollEndpoint",
   });
 });
 

package/src/models/operations/index.ts

@@ -63,3 +63,4 @@ export * from "./v2tokenizedassetsorderorderhash.js";
 export * from "./v2tokenizedassetsorderorderhashcancel.js";
 export * from "./v2tokenizedassetsorderorderhashchargefee.js";
 export * from "./v2tokenizedassetspositions.js";
+export * from "./v2tokenizedassetsredemptions.js";

package/src/models/operations/v2tokenizedassetsredemptions.ts

@@ -0,0 +1,72 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+/**
+ * The chain to use.
+ */
+export const V2TokenizedAssetsRedemptionsChain = {
+  Base: "base",
+  Ethereum: "ethereum",
+  Arbitrum: "arbitrum",
+  Hyperevm: "hyperevm",
+  Tempo: "tempo",
+  Bsc: "bsc",
+} as const;
+/**
+ * The chain to use.
+ */
+export type V2TokenizedAssetsRedemptionsChain = ClosedEnum<
+  typeof V2TokenizedAssetsRedemptionsChain
+>;
+
+export type V2TokenizedAssetsRedemptionsRequest = {
+  /**
+   * The owner of the Tokenized Assets Account whose IXS redemption requests to read. Requests are reconstructed on-chain from the derived product account (the request receiver).
+   */
+  owner: string;
+  /**
+   * Network the IXS vault lives on (IXS managed vaults are on BNB Smart Chain).
+   */
+  chain?: V2TokenizedAssetsRedemptionsChain | undefined;
+  /**
+   * The IXS vault handle to read redemptions for (e.g. 'ixv1').
+   */
+  vault?: string | undefined;
+};
+
+/** @internal */
+export const V2TokenizedAssetsRedemptionsChain$outboundSchema: z.ZodNativeEnum<
+  typeof V2TokenizedAssetsRedemptionsChain
+> = z.nativeEnum(V2TokenizedAssetsRedemptionsChain);
+
+/** @internal */
+export type V2TokenizedAssetsRedemptionsRequest$Outbound = {
+  owner: string;
+  chain?: string | undefined;
+  vault?: string | undefined;
+};
+
+/** @internal */
+export const V2TokenizedAssetsRedemptionsRequest$outboundSchema: z.ZodType<
+  V2TokenizedAssetsRedemptionsRequest$Outbound,
+  z.ZodTypeDef,
+  V2TokenizedAssetsRedemptionsRequest
+> = z.object({
+  owner: z.string(),
+  chain: V2TokenizedAssetsRedemptionsChain$outboundSchema.optional(),
+  vault: z.string().optional(),
+});
+
+export function v2TokenizedAssetsRedemptionsRequestToJSON(
+  v2TokenizedAssetsRedemptionsRequest: V2TokenizedAssetsRedemptionsRequest,
+): string {
+  return JSON.stringify(
+    V2TokenizedAssetsRedemptionsRequest$outboundSchema.parse(
+      v2TokenizedAssetsRedemptionsRequest,
+    ),
+  );
+}

package/src/sdk/tokenizedassets.ts

@@ -13,6 +13,7 @@ import { tokenizedAssetsTokenizedAssetsOrderOrderHashChargeFee } from "../funcs/
 import { tokenizedAssetsTokenizedAssetsOrderSubmit } from "../funcs/tokenizedAssetsTokenizedAssetsOrderSubmit.js";
 import { tokenizedAssetsTokenizedAssetsPositions } from "../funcs/tokenizedAssetsTokenizedAssetsPositions.js";
 import { tokenizedAssetsTokenizedAssetsQuote } from "../funcs/tokenizedAssetsTokenizedAssetsQuote.js";
+import { tokenizedAssetsTokenizedAssetsRedemptions } from "../funcs/tokenizedAssetsTokenizedAssetsRedemptions.js";
 import { tokenizedAssetsTokenizedAssetsTransactBuy } from "../funcs/tokenizedAssetsTokenizedAssetsTransactBuy.js";
 import { tokenizedAssetsTokenizedAssetsTransactSell } from "../funcs/tokenizedAssetsTokenizedAssetsTransactSell.js";
 import { tokenizedAssetsTokenizedAssetsTransfer } from "../funcs/tokenizedAssetsTokenizedAssetsTransfer.js";
@@ -162,6 +163,34 @@ export class TokenizedAssets extends ClientSDK {
     ));
   }
 
+  /**
+   * Get IXS vault redemption requests for an owner
+   *
+   * @remarks
+   * Get an owner's IXS vault redemption requests (async redemption status).
+   *
+   * IXS managed-vault **sells** are asynchronous: `/transact/sell` returns a
+   * `requestRedeem` transaction, and the vault operator settles it off-chain
+   * later. This endpoint reconstructs the owner's requests directly from the
+   * vault on every call (Compass persists no async state) — each entry carries
+   * its `status` (`pending` | `finalized` | `rejected`), the `shares` requested,
+   * and, while `pending`, the `expected_net_assets` it would settle for at the
+   * current NAV (a preview, not a guarantee).
+   *
+   * IXS vaults live on BNB Smart Chain — pass `chain=bsc` (the default) and the
+   * `vault` handle (default `ixv1`).
+   */
+  async tokenizedAssetsRedemptions(
+    request: operations.V2TokenizedAssetsRedemptionsRequest,
+    options?: RequestOptions,
+  ): Promise<components.RedemptionsResponse> {
+    return unwrapAsync(tokenizedAssetsTokenizedAssetsRedemptions(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Create a Tokenized Assets Account
    *