@compass-labs/api-sdk 2.2.46 → 2.2.47-rc.0

package/src/models/components/tokenizedassetsbuildorderrequest.ts

@@ -4,13 +4,18 @@
 
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
+import { Chain, Chain$outboundSchema } from "./chain.js";
 
 /**
  * Build a buy or sell order for a tokenized equity.
  */
 export type TokenizedAssetsBuildOrderRequest = {
   /**
-   * Token the sender is paying. Either an on-chain Ondo symbol (e.g. `TSLAon`), the literal `USDC`, or a 0x-prefixed Ethereum address.
+   * The chain to use.
+   */
+  chain: Chain;
+  /**
+   * Token the sender is paying. Either an on-chain symbol (e.g. `TSLAon`), the literal `USDC`, or a 0x-prefixed token address.
    */
   fromToken: string;
   /**
@@ -26,13 +31,14 @@ export type TokenizedAssetsBuildOrderRequest = {
    */
   owner: string;
   /**
-   * Max acceptable slippage in basis points (1 bp = 0.01%). Range 1-1000 (0.01%-10%); defaults to 50 (0.5%).
+   * Max acceptable slippage in basis points (1 bp = 0.01%). Range 1-5000 (0.01%-50%); defaults to 50 (0.5%). The upper bound is intentionally wide so callers can clear the wide auction floors quoted for thinly-traded tokenized stocks.
    */
   slippageBps?: number | undefined;
 };
 
 /** @internal */
 export type TokenizedAssetsBuildOrderRequest$Outbound = {
+  chain: string;
   from_token: string;
   to_token: string;
   amount: string;
@@ -46,6 +52,7 @@ export const TokenizedAssetsBuildOrderRequest$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   TokenizedAssetsBuildOrderRequest
 > = z.object({
+  chain: Chain$outboundSchema,
   fromToken: z.string(),
   toToken: z.string(),
   amount: z.string(),

package/src/models/components/tokenizedassetsquoterequest.ts

@@ -0,0 +1,78 @@
+/*
+ * 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 { Chain, Chain$outboundSchema } from "./chain.js";
+
+/**
+ * Preview a buy or sell quote for a tokenized equity.
+ *
+ * @remarks
+ *
+ * Read-only relative to Fusion: this hits ``/quote/receive`` only and does
+ * not consume a ``quote_id`` or commit an order. Use it to surface expected
+ * output, fees, and a thin-liquidity warning before the user confirms; pass
+ * the same body (plus ``slippage_bps``) to ``POST /tokenized_assets/order``
+ * when they do.
+ */
+export type TokenizedAssetsQuoteRequest = {
+  /**
+   * The chain to use.
+   */
+  chain: Chain;
+  /**
+   * Token the sender is paying. Either an on-chain symbol (e.g. `TSLAon`), the literal `USDC`, or a 0x-prefixed token address.
+   */
+  fromToken: string;
+  /**
+   * Token the sender is receiving. Same accepted forms as `from_token`.
+   */
+  toToken: string;
+  /**
+   * Human-readable amount of `from_token` to swap (decimal string). Decimals are applied server-side.
+   */
+  amount: string;
+  /**
+   * Wallet that owns the Tokenized Assets Account. Used to verify the account is deployed before quoting; the account address is derived deterministically from this owner.
+   */
+  owner: string;
+};
+
+/** @internal */
+export type TokenizedAssetsQuoteRequest$Outbound = {
+  chain: string;
+  from_token: string;
+  to_token: string;
+  amount: string;
+  owner: string;
+};
+
+/** @internal */
+export const TokenizedAssetsQuoteRequest$outboundSchema: z.ZodType<
+  TokenizedAssetsQuoteRequest$Outbound,
+  z.ZodTypeDef,
+  TokenizedAssetsQuoteRequest
+> = z.object({
+  chain: Chain$outboundSchema,
+  fromToken: z.string(),
+  toToken: z.string(),
+  amount: z.string(),
+  owner: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    fromToken: "from_token",
+    toToken: "to_token",
+  });
+});
+
+export function tokenizedAssetsQuoteRequestToJSON(
+  tokenizedAssetsQuoteRequest: TokenizedAssetsQuoteRequest,
+): string {
+  return JSON.stringify(
+    TokenizedAssetsQuoteRequest$outboundSchema.parse(
+      tokenizedAssetsQuoteRequest,
+    ),
+  );
+}

package/src/models/components/tokenizedassetsquoteresponse.ts

@@ -0,0 +1,54 @@
+/*
+ * 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 { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { Quote, Quote$inboundSchema } from "./quote.js";
+
+/**
+ * Preview of input/output amounts plus auction-derived risk hints.
+ */
+export type TokenizedAssetsQuoteResponse = {
+  /**
+   * Quote preview returned alongside an order.
+   */
+  quote: Quote;
+  /**
+   * Slippage tolerance in basis points (1 bp = 0.01%) the UI should echo back as `slippage_bps` on `POST /tokenized_assets/order`. Derived from Fusion's Dutch auction range (`auctionEndAmount` vs `toTokenAmount`) plus a small buffer; capped at 5000 bps.
+   */
+  recommendedSlippageBps: number;
+  /**
+   * Worst-case basis-points gap between the auction's end amount and the reference quote amount. Surfaces as a thin-liquidity warning before the user signs.
+   */
+  auctionRangeBps: number;
+};
+
+/** @internal */
+export const TokenizedAssetsQuoteResponse$inboundSchema: z.ZodType<
+  TokenizedAssetsQuoteResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  quote: Quote$inboundSchema,
+  recommended_slippage_bps: z.number().int(),
+  auction_range_bps: z.number().int(),
+}).transform((v) => {
+  return remap$(v, {
+    "recommended_slippage_bps": "recommendedSlippageBps",
+    "auction_range_bps": "auctionRangeBps",
+  });
+});
+
+export function tokenizedAssetsQuoteResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<TokenizedAssetsQuoteResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TokenizedAssetsQuoteResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TokenizedAssetsQuoteResponse' from JSON`,
+  );
+}

package/src/sdk/tokenizedassets.ts

@@ -10,6 +10,7 @@ import { tokenizedAssetsTokenizedAssetsOrderOrderHash } from "../funcs/tokenized
 import { tokenizedAssetsTokenizedAssetsOrderOrderHashCancel } from "../funcs/tokenizedAssetsTokenizedAssetsOrderOrderHashCancel.js";
 import { tokenizedAssetsTokenizedAssetsOrderSubmit } from "../funcs/tokenizedAssetsTokenizedAssetsOrderSubmit.js";
 import { tokenizedAssetsTokenizedAssetsPositions } from "../funcs/tokenizedAssetsTokenizedAssetsPositions.js";
+import { tokenizedAssetsTokenizedAssetsQuote } from "../funcs/tokenizedAssetsTokenizedAssetsQuote.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import * as operations from "../models/operations/index.js";
@@ -156,6 +157,40 @@ export class TokenizedAssets extends ClientSDK {
     ));
   }
 
+  /**
+   * Preview a buy/sell quote
+   *
+   * @remarks
+   * Preview the input/output amounts, fees, and slippage tolerance for an order.
+   *
+   * Read-only relative to Fusion: hits ``/quote/receive`` only and does not
+   * consume a ``quote_id`` or commit an order. Pair with `POST /order`:
+   * surface this preview to the user, and on confirm pass the body plus
+   * ``recommended_slippage_bps`` to `/order`.
+   *
+   * The response carries:
+   *
+   * - **`quote`** — input/output token amounts, fees, and an
+   *   ``est_fill_seconds`` upper bound.
+   * - **`recommended_slippage_bps`** — system-derived slippage tolerance
+   *   that clears Fusion's current auction floor; pass back as
+   *   ``slippage_bps`` on `/order` so the build call validates against the
+   *   same floor the user was shown.
+   * - **`auction_range_bps`** — worst-case bps gap between the auction
+   *   end amount and the reference quote amount. Use to surface a
+   *   thin-liquidity warning to the user.
+   */
+  async tokenizedAssetsQuote(
+    request: components.TokenizedAssetsQuoteRequest,
+    options?: RequestOptions,
+  ): Promise<components.TokenizedAssetsQuoteResponse> {
+    return unwrapAsync(tokenizedAssetsTokenizedAssetsQuote(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Build a buy/sell order
    *