@compass-labs/api-sdk 2.2.45 → 2.2.46-rc.1

package/dist/esm/sdk/tokenizedassets.js

@@ -4,7 +4,6 @@
 import { tokenizedAssetsTokenizedAssetsCreateAccount } from "../funcs/tokenizedAssetsTokenizedAssetsCreateAccount.js";
 import { tokenizedAssetsTokenizedAssetsMarkets } from "../funcs/tokenizedAssetsTokenizedAssetsMarkets.js";
 import { tokenizedAssetsTokenizedAssetsMarketsSymbol } from "../funcs/tokenizedAssetsTokenizedAssetsMarketsSymbol.js";
-import { tokenizedAssetsTokenizedAssetsMarketsSymbolOhlc } from "../funcs/tokenizedAssetsTokenizedAssetsMarketsSymbolOhlc.js";
 import { tokenizedAssetsTokenizedAssetsOrder } from "../funcs/tokenizedAssetsTokenizedAssetsOrder.js";
 import { tokenizedAssetsTokenizedAssetsOrderOrderHash } from "../funcs/tokenizedAssetsTokenizedAssetsOrderOrderHash.js";
 import { tokenizedAssetsTokenizedAssetsOrderOrderHashCancel } from "../funcs/tokenizedAssetsTokenizedAssetsOrderOrderHashCancel.js";
@@ -17,145 +16,163 @@ export class TokenizedAssets extends ClientSDK {
      * List tokenized equity markets
      *
      * @remarks
-     * List tokenized equities surfaced on Ethereum.
+     * List the tokenized US equities available on Ethereum.
      *
-     * Composed from Ondo's metadata + enhanced-prices feeds. Non-Ethereum-only
-     * assets (BSC/Solana deployments without an Ethereum twin) are skipped.
+     * Each entry includes the symbol, the underlying ticker, the on-chain
+     * contract address, the latest USD price, and 24h price change. Filter
+     * by `category` (sector tag) or `search` (substring match against symbol,
+     * ticker, or name).
+     *
+     * Only Ethereum-deployed tokens are returned; assets that exist only on
+     * other chains are omitted.
      */
     async tokenizedAssetsMarkets(request, options) {
         return unwrapAsync(tokenizedAssetsTokenizedAssetsMarkets(this, request, options));
     }
     /**
-     * Get a single tokenized market
+     * Get a single market
      *
      * @remarks
-     * Single-market detail for the on-chain Ondo symbol (e.g. `TSLAon`).
+     * Get extended detail for a single tokenized equity (e.g. `TSLAon`).
+     *
+     * Includes 52-week range, volume, market cap, holder count, and tradable
+     * sessions in addition to the fields returned by `/markets`.
+     *
+     * **OHLC candles** are opt-in: pass both `interval` and `range` query
+     * params to include a `candles` array in the response. They must be
+     * provided together and must form one of the supported pairs:
+     *
+     * - `1min` / `5min` / `15min` with `range=1day`
+     * - `1hour` / `4hour` with `range=1month`
+     * - `12hour` with `range=3month`
+     * - `1day` with `range=3month` / `6month` / `1year` / `all`
+     *
+     * Omitting both returns the market detail without `candles`.
      */
     async tokenizedAssetsMarketsSymbol(request, options) {
         return unwrapAsync(tokenizedAssetsTokenizedAssetsMarketsSymbol(this, request, options));
     }
     /**
-     * Get OHLC candles for a market
+     * Get tokenized-asset positions for a wallet
      *
      * @remarks
-     * OHLC candles for the given Ondo symbol.
-     *
-     * `interval` + `range` must form one of the closed Ondo pairs (see request
-     * model docstring); invalid pairs return 400.
-     */
-    async tokenizedAssetsMarketsSymbolOhlc(request, options) {
-        return unwrapAsync(tokenizedAssetsTokenizedAssetsMarketsSymbolOhlc(this, request, options));
-    }
-    /**
-     * Get on-chain tokenized-asset positions for a wallet
+     * Get the tokenized-asset holdings for a wallet.
      *
-     * @remarks
-     * On-chain ERC-20 balance reads for a wallet across all listed Ondo GM tokens.
+     * Returns the balance of every listed tokenized equity at the queried
+     * address, plus the latest USD price and a USD-valued balance when
+     * pricing is available. Zero balances are omitted, and a `total_usd`
+     * aggregate is returned across all priced positions.
      *
-     * Reads each Ethereum-deployed Ondo GM token's `balanceOf(wallet)` via a
-     * single Multicall3 batch and enriches non-zero balances with the latest USD
-     * price. Returns human-readable amounts (decimals applied).
+     * Pass the **Tokenized Assets Account address** (returned by
+     * `/create_account`), not the owner's wallet — proceeds from filled
+     * orders settle into the Tokenized Assets Account.
      */
     async tokenizedAssetsPositions(request, options) {
         return unwrapAsync(tokenizedAssetsTokenizedAssetsPositions(this, request, options));
     }
     /**
-     * Get tokenized-asset order status
+     * Get order status
      *
      * @remarks
-     * Status of a relayed Fusion order — `pending` / `filled` / `expired` / `cancelled`.
+     * Get the lifecycle state of a submitted order.
      *
-     * Fusion's finer-grained states (`refunded`, `false-predicate`, etc.) are
-     * collapsed into the 4-value enum the SDK promises. Unknown upstream states
-     * surface as 502 to alert on schema drift.
+     * The `status` field is one of `pending`, `filled`, `expired`, or
+     * `cancelled`. Partial fills stay in `pending` while `filled_amount` is
+     * populated as fills come in; once an order fully fills, `fill_tx_hash`
+     * is also returned.
+     *
+     * Upstream protocol states beyond these four (e.g. `partially-filled`,
+     * `refunded`) are mapped onto this set.
      */
     async tokenizedAssetsOrderOrderHash(request, options) {
         return unwrapAsync(tokenizedAssetsTokenizedAssetsOrderOrderHash(this, request, options));
     }
     /**
-     * Create tokenized assets account
+     * Create a Tokenized Assets Account
      *
      * @remarks
      * Create a Tokenized Assets Account for a wallet address.
      *
-     * Each wallet address has one Tokenized Assets Account per chain. It is owned by
-     * `owner` and isolated from the owner's Earn, Credit, and Traditional Investing
-     * accounts.
+     * Before placing orders, the owner must create a Tokenized Assets Account.
+     * Each wallet address has one Tokenized Assets Account, isolated from the
+     * owner's Earn, Credit, and other product accounts.
+     *
+     * The account address is deterministic. If it already exists, the
+     * response returns `transaction: null` and you can skip straight to
+     * building orders.
      *
-     * Returns an unsigned transaction to create the account. The `sender` signs and
-     * broadcasts this transaction.
+     * Returns an unsigned transaction to create the account. The `sender`
+     * signs and broadcasts this transaction.
      *
      * **If owner pays gas:** Set `sender` to the owner's address.
      *
-     * **If someone else pays gas:** Set `sender` to the wallet that will sign and
-     * broadcast the transaction on behalf of the owner.
+     * **If someone else pays gas:** Set `sender` to the wallet that will
+     * sign and broadcast the transaction on behalf of the owner.
      */
     async tokenizedAssetsCreateAccount(request, options) {
         return unwrapAsync(tokenizedAssetsTokenizedAssetsCreateAccount(this, request, options));
     }
     /**
-     * Build a tokenized-asset buy/sell order
+     * Build a buy/sell order
      *
      * @remarks
-     * Build a quote, optional approve SafeTx, and SafeMessage EIP-712 to sign.
-     *
-     * Returns everything the SDK needs to take an `owner` from "I want to buy"
-     * to a relayed Fusion order whose maker is the Tokenized Assets Account.
-     * The flow is **signing-based, not transaction-based**:
-     *
-     * 1. If `approval_safe_tx_eip712` is populated (Safe→LOP allowance is
-     *    insufficient), sign it with `wallet.signTypedData(...)` and relay via
-     *    `POST /v2/gas_sponsorship/prepare` so the sponsor broadcasts the resulting
-     *    `Safe.execTransaction(USDC.approve(LOP_v4, ...))`. Wait for that tx
-     *    to confirm before signing the order.
-     * 2. Sign `order.safe_message_eip712` with the same owner wallet — this is
-     *    a Safe ERC-1271 wrapper around the Fusion order hash. POST the
-     *    resulting 65-byte ECDSA together with the rest of the `order` fields
-     *    to `/order/submit`.
-     *
-     * The owner never broadcasts an on-chain transaction in this flow; all
-     * on-chain action goes through the product account via the sponsor relay.
+     * Build a buy or sell order whose maker is the Tokenized Assets Account.
+     *
+     * Returns up to three pieces in a single round-trip:
+     *
+     * - **`quote`** — preview of the input/output amounts and fees.
+     * - **`approval_safe_tx_eip712`** — only present when the account's
+     *   allowance to the settlement contract is below `amount`. The owner
+     *   signs this EIP-712 payload, then it is broadcast via
+     *   `POST /v2/gas_sponsorship/prepare` (or the owner can broadcast
+     *   directly) to set the on-chain allowance. Wait for that transaction
+     *   to confirm before signing the order.
+     * - **`order`** — the order metadata (`order_hash`, `extension`,
+     *   `quote_id`, `order_message`) plus `safe_message_eip712`, an EIP-712
+     *   payload the owner signs off-chain to authorize the order. The
+     *   signature is submitted to `/order/submit` and is **never** broadcast
+     *   on-chain.
+     *
+     * The owner never broadcasts the order itself — only the (one-time)
+     * approval transaction ever hits the chain.
      */
     async tokenizedAssetsOrder(request, options) {
         return unwrapAsync(tokenizedAssetsTokenizedAssetsOrder(this, request, options));
     }
     /**
-     * Submit a signed tokenized-asset order to 1inch Fusion
+     * Submit a signed order
      *
      * @remarks
-     * Relay an owner-signed Fusion order to the 1inch relayer.
-     *
-     * The body carries the signature produced by
-     * `wallet.signTypedData(order.safe_message_eip712)` from the `/order`
-     * response, plus the order struct (`signed_order`), opaque `extension`,
-     * and `quote_id`. The signature is validated via ERC-1271
-     * (`Safe.isValidSignature`) at fill time — the maker on the order struct
-     * is the Tokenized Assets Account, not the EOA owner.
-     *
-     * Returns the order hash and a server-side timestamp. Subsequent calls to
-     * `GET /order/{order_hash}` track lifecycle (`pending` → `filled` /
-     * `expired` / `cancelled`).
+     * Submit a signed order to the resolver network.
+     *
+     * The body echoes the `order` fields from `/order` (`signed_order`,
+     * `extension`, `quote_id`, optionally `order_hash`) plus the owner's
+     * signature over `order.safe_message_eip712`. The maker on the order
+     * struct is the Tokenized Assets Account, not the owner's wallet —
+     * pass `signed_order` back unchanged.
+     *
+     * Returns the order hash and a server-side ISO 8601 timestamp.
+     * Subsequent calls to `GET /order/{order_hash}` track the lifecycle
+     * (`pending` → `filled` / `expired` / `cancelled`).
      */
     async tokenizedAssetsOrderSubmit(request, options) {
         return unwrapAsync(tokenizedAssetsTokenizedAssetsOrderSubmit(this, request, options));
     }
     /**
-     * Cancel an unfilled tokenized-asset order
+     * Cancel an unfilled order
      *
      * @remarks
-     * Build a SafeTx EIP-712 wrapping the on-chain cancel for a Fusion order.
-     *
-     * Returns ``cancel_safe_tx_eip712``: an EIP-712 ``Safe.execTransaction``
-     * payload whose inner call is ``LOP.cancelOrder(makerTraits, orderHash)``.
-     * Sign with the Tokenized Assets Account's owner via
-     * ``wallet.signTypedData(...)`` and relay via ``POST /v2/gas_sponsorship/prepare``
-     * so the sponsor broadcasts ``execTransaction`` on the product account
-     * (the order's maker). The owner can also broadcast ``execTransaction``
-     * directly if not using gas sponsorship.
-     *
-     * Authorization is on the *predicted* Safe address: the Tokenized Assets
-     * Account computed from ``owner`` must match the order's on-chain maker.
-     * Mismatches return 403 ``OWNER_NOT_MAKER`` before any on-chain reads.
+     * Build the EIP-712 payload to cancel an unfilled order on-chain.
+     *
+     * Returns ``cancel_safe_tx_eip712``, an EIP-712 payload that authorizes
+     * the on-chain cancellation. Sign with the Tokenized Assets Account's
+     * owner via ``wallet.signTypedData(...)`` and relay via
+     * ``POST /v2/gas_sponsorship/prepare`` so the sponsor broadcasts the
+     * cancellation on the product account. The owner can also broadcast
+     * the resulting transaction directly without using gas sponsorship.
+     *
+     * Cancellation works on `pending` and `expired` orders only. Only the
+     * Tokenized Assets Account that placed the order can cancel it.
      */
     async tokenizedAssetsOrderOrderHashCancel(request, options) {
         return unwrapAsync(tokenizedAssetsTokenizedAssetsOrderOrderHashCancel(this, request, options));

package/dist/esm/sdk/tokenizedassets.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenizedassets.js","sourceRoot":"","sources":["../../../src/sdk/tokenizedassets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,2CAA2C,EAAE,MAAM,yDAAyD,CAAC;AACtH,OAAO,EAAE,qCAAqC,EAAE,MAAM,mDAAmD,CAAC;AAC1G,OAAO,EAAE,2CAA2C,EAAE,MAAM,yDAAyD,CAAC;AACtH,OAAO,EAAE,+CAA+C,EAAE,MAAM,6DAA6D,CAAC;AAC9H,OAAO,EAAE,mCAAmC,EAAE,MAAM,iDAAiD,CAAC;AACtG,OAAO,EAAE,4CAA4C,EAAE,MAAM,0DAA0D,CAAC;AACxH,OAAO,EAAE,kDAAkD,EAAE,MAAM,gEAAgE,CAAC;AACpI,OAAO,EAAE,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAClH,OAAO,EAAE,uCAAuC,EAAE,MAAM,qDAAqD,CAAC;AAC9G,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C;;;;;;;;OAQG;IACH,KAAK,CAAC,sBAAsB,CAC1B,OAAmD,EACnD,OAAwB;QAExB,OAAO,WAAW,CAAC,qCAAqC,CACtD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,4BAA4B,CAChC,OAAyD,EACzD,OAAwB;QAExB,OAAO,WAAW,CAAC,2CAA2C,CAC5D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,gCAAgC,CACpC,OAA6D,EAC7D,OAAwB;QAExB,OAAO,WAAW,CAAC,+CAA+C,CAChE,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,wBAAwB,CAC5B,OAAqD,EACrD,OAAwB;QAExB,OAAO,WAAW,CAAC,uCAAuC,CACxD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,6BAA6B,CACjC,OAA0D,EAC1D,OAAwB;QAExB,OAAO,WAAW,CAAC,4CAA4C,CAC7D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,4BAA4B,CAChC,OAAuD,EACvD,OAAwB;QAExB,OAAO,WAAW,CAAC,2CAA2C,CAC5D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,oBAAoB,CACxB,OAAoD,EACpD,OAAwB;QAExB,OAAO,WAAW,CAAC,mCAAmC,CACpD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,0BAA0B,CAC9B,OAAqD,EACrD,OAAwB;QAExB,OAAO,WAAW,CAAC,yCAAyC,CAC1D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,mCAAmC,CACvC,OAAgE,EAChE,OAAwB;QAExB,OAAO,WAAW,CAAC,kDAAkD,CACnE,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"tokenizedassets.js","sourceRoot":"","sources":["../../../src/sdk/tokenizedassets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,2CAA2C,EAAE,MAAM,yDAAyD,CAAC;AACtH,OAAO,EAAE,qCAAqC,EAAE,MAAM,mDAAmD,CAAC;AAC1G,OAAO,EAAE,2CAA2C,EAAE,MAAM,yDAAyD,CAAC;AACtH,OAAO,EAAE,mCAAmC,EAAE,MAAM,iDAAiD,CAAC;AACtG,OAAO,EAAE,4CAA4C,EAAE,MAAM,0DAA0D,CAAC;AACxH,OAAO,EAAE,kDAAkD,EAAE,MAAM,gEAAgE,CAAC;AACpI,OAAO,EAAE,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAClH,OAAO,EAAE,uCAAuC,EAAE,MAAM,qDAAqD,CAAC;AAC9G,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,sBAAsB,CAC1B,OAAmD,EACnD,OAAwB;QAExB,OAAO,WAAW,CAAC,qCAAqC,CACtD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,4BAA4B,CAChC,OAAyD,EACzD,OAAwB;QAExB,OAAO,WAAW,CAAC,2CAA2C,CAC5D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,wBAAwB,CAC5B,OAAqD,EACrD,OAAwB;QAExB,OAAO,WAAW,CAAC,uCAAuC,CACxD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,6BAA6B,CACjC,OAA0D,EAC1D,OAAwB;QAExB,OAAO,WAAW,CAAC,4CAA4C,CAC7D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,4BAA4B,CAChC,OAAuD,EACvD,OAAwB;QAExB,OAAO,WAAW,CAAC,2CAA2C,CAC5D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,oBAAoB,CACxB,OAAoD,EACpD,OAAwB;QAExB,OAAO,WAAW,CAAC,mCAAmC,CACpD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,0BAA0B,CAC9B,OAAqD,EACrD,OAAwB;QAExB,OAAO,WAAW,CAAC,yCAAyC,CAC1D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,mCAAmC,CACvC,OAAgE,EAChE,OAAwB;QAExB,OAAO,WAAW,CAAC,kDAAkD,CACnE,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF"}

package/docs/models/components/compassapibackendv2modelstokenizedassetsmarketmarket.md

@@ -27,9 +27,9 @@ let value: CompassApiBackendV2ModelsTokenizedAssetsMarketMarket = {
 | `symbol`                                                                                                                                                     | *string*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                           | On-chain token symbol (e.g. 'TSLAon').                                                                                                                       |                                                                                                                                                              |
 | `underlyingTicker`                                                                                                                                           | *string*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                           | Underlying equity ticker (e.g. 'TSLA').                                                                                                                      |                                                                                                                                                              |
 | `name`                                                                                                                                                       | *string*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                           | Underlying equity full name (e.g. 'Tesla, Inc. Common Stock').                                                                                               |                                                                                                                                                              |
-| `chain`                                                                                                                                                      | [components.CompassApiBackendV2ModelsTokenizedAssetsMarketMarketChain](../../models/components/compassapibackendv2modelstokenizedassetsmarketmarketchain.md) | :heavy_minus_sign:                                                                                                                                           | Chain on which the surfaced contract is deployed.                                                                                                            | ethereum                                                                                                                                                     |
+| `chain`                                                                                                                                                      | [components.CompassApiBackendV2ModelsTokenizedAssetsMarketMarketChain](../../models/components/compassapibackendv2modelstokenizedassetsmarketmarketchain.md) | :heavy_minus_sign:                                                                                                                                           | Chain on which the contract is deployed.                                                                                                                     | ethereum                                                                                                                                                     |
 | `contractAddress`                                                                                                                                            | *string*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                           | Ethereum mainnet ERC-20 address for this token.                                                                                                              |                                                                                                                                                              |
-| `decimals`                                                                                                                                                   | *number*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                           | ERC-20 decimals on the surfaced chain.                                                                                                                       |                                                                                                                                                              |
+| `decimals`                                                                                                                                                   | *number*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                           | ERC-20 decimals for this token.                                                                                                                              |                                                                                                                                                              |
 | `currentPriceUsd`                                                                                                                                            | *string*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                           | Latest price in USD as a decimal string.                                                                                                                     |                                                                                                                                                              |
 | `change24hUsd`                                                                                                                                               | *string*                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                           | Absolute USD price change vs 24h ago (decimal string).                                                                                                       |                                                                                                                                                              |
 | `change24hPct`                                                                                                                                               | *string*                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                           | Percent price change vs 24h ago (decimal string).                                                                                                            |                                                                                                                                                              |

package/docs/models/components/compassapibackendv2modelstokenizedassetsmarketmarketchain.md

@@ -1,6 +1,6 @@
 # CompassApiBackendV2ModelsTokenizedAssetsMarketMarketChain
 
-Chain on which the surfaced contract is deployed.
+Chain on which the contract is deployed.
 
 ## Example Usage
 

package/docs/models/components/marketdetail.md

@@ -24,26 +24,27 @@ let value: MarketDetail = {
 
 ## Fields
 
-| Field                                                                        | Type                                                                         | Required                                                                     | Description                                                                  | Example                                                                      |
-| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
-| `symbol`                                                                     | *string*                                                                     | :heavy_check_mark:                                                           | On-chain token symbol (e.g. 'TSLAon').                                       |                                                                              |
-| `underlyingTicker`                                                           | *string*                                                                     | :heavy_check_mark:                                                           | Underlying equity ticker (e.g. 'TSLA').                                      |                                                                              |
-| `name`                                                                       | *string*                                                                     | :heavy_check_mark:                                                           | Underlying equity full name (e.g. 'Tesla, Inc. Common Stock').               |                                                                              |
-| `chain`                                                                      | [components.MarketDetailChain](../../models/components/marketdetailchain.md) | :heavy_minus_sign:                                                           | Chain on which the surfaced contract is deployed.                            | ethereum                                                                     |
-| `contractAddress`                                                            | *string*                                                                     | :heavy_check_mark:                                                           | Ethereum mainnet ERC-20 address for this token.                              |                                                                              |
-| `decimals`                                                                   | *number*                                                                     | :heavy_check_mark:                                                           | ERC-20 decimals on the surfaced chain.                                       |                                                                              |
-| `currentPriceUsd`                                                            | *string*                                                                     | :heavy_check_mark:                                                           | Latest price in USD as a decimal string.                                     |                                                                              |
-| `change24hUsd`                                                               | *string*                                                                     | :heavy_minus_sign:                                                           | Absolute USD price change vs 24h ago (decimal string).                       |                                                                              |
-| `change24hPct`                                                               | *string*                                                                     | :heavy_minus_sign:                                                           | Percent price change vs 24h ago (decimal string).                            |                                                                              |
-| `sectors`                                                                    | *string*[]                                                                   | :heavy_minus_sign:                                                           | Sector / industry tags from the issuer (e.g. ['Technology']).                | []                                                                           |
-| `regionExposure`                                                             | *string*[]                                                                   | :heavy_minus_sign:                                                           | Regional market exposure tags (e.g. ['US']).                                 | []                                                                           |
-| `priceHistory24h`                                                            | [components.PricePoint](../../models/components/pricepoint.md)[]             | :heavy_minus_sign:                                                           | 24h price sparkline (sampled timestamps, descending or ascending).           | []                                                                           |
-| `priceHigh52w`                                                               | *string*                                                                     | :heavy_minus_sign:                                                           | 52-week high of the underlying equity (USD).                                 |                                                                              |
-| `priceLow52w`                                                                | *string*                                                                     | :heavy_minus_sign:                                                           | 52-week low of the underlying equity (USD).                                  |                                                                              |
-| `volume24h`                                                                  | *string*                                                                     | :heavy_minus_sign:                                                           | 24h trading volume of the underlying equity.                                 |                                                                              |
-| `averageVolume`                                                              | *string*                                                                     | :heavy_minus_sign:                                                           | Average trading volume of the underlying equity.                             |                                                                              |
-| `sharesOutstanding`                                                          | *string*                                                                     | :heavy_minus_sign:                                                           | Shares outstanding of the underlying equity.                                 |                                                                              |
-| `marketCap`                                                                  | *string*                                                                     | :heavy_minus_sign:                                                           | Market cap of the underlying equity (USD).                                   |                                                                              |
-| `totalHolders`                                                               | *number*                                                                     | :heavy_minus_sign:                                                           | On-chain holder count for the tokenized asset.                               |                                                                              |
-| `tradableSessions`                                                           | *string*[]                                                                   | :heavy_minus_sign:                                                           | Sessions in which the token can be traded (e.g. 'regular', 'premarket').     | []                                                                           |
-| `sharesMultiplier`                                                           | *string*                                                                     | :heavy_minus_sign:                                                           | Shares-multiplier ratio (= 1 if no recent split / corporate action).         |                                                                              |
+| Field                                                                                                                           | Type                                                                                                                            | Required                                                                                                                        | Description                                                                                                                     | Example                                                                                                                         |
+| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `symbol`                                                                                                                        | *string*                                                                                                                        | :heavy_check_mark:                                                                                                              | On-chain token symbol (e.g. 'TSLAon').                                                                                          |                                                                                                                                 |
+| `underlyingTicker`                                                                                                              | *string*                                                                                                                        | :heavy_check_mark:                                                                                                              | Underlying equity ticker (e.g. 'TSLA').                                                                                         |                                                                                                                                 |
+| `name`                                                                                                                          | *string*                                                                                                                        | :heavy_check_mark:                                                                                                              | Underlying equity full name (e.g. 'Tesla, Inc. Common Stock').                                                                  |                                                                                                                                 |
+| `chain`                                                                                                                         | [components.MarketDetailChain](../../models/components/marketdetailchain.md)                                                    | :heavy_minus_sign:                                                                                                              | Chain on which the contract is deployed.                                                                                        | ethereum                                                                                                                        |
+| `contractAddress`                                                                                                               | *string*                                                                                                                        | :heavy_check_mark:                                                                                                              | Ethereum mainnet ERC-20 address for this token.                                                                                 |                                                                                                                                 |
+| `decimals`                                                                                                                      | *number*                                                                                                                        | :heavy_check_mark:                                                                                                              | ERC-20 decimals for this token.                                                                                                 |                                                                                                                                 |
+| `currentPriceUsd`                                                                                                               | *string*                                                                                                                        | :heavy_check_mark:                                                                                                              | Latest price in USD as a decimal string.                                                                                        |                                                                                                                                 |
+| `change24hUsd`                                                                                                                  | *string*                                                                                                                        | :heavy_minus_sign:                                                                                                              | Absolute USD price change vs 24h ago (decimal string).                                                                          |                                                                                                                                 |
+| `change24hPct`                                                                                                                  | *string*                                                                                                                        | :heavy_minus_sign:                                                                                                              | Percent price change vs 24h ago (decimal string).                                                                               |                                                                                                                                 |
+| `sectors`                                                                                                                       | *string*[]                                                                                                                      | :heavy_minus_sign:                                                                                                              | Sector / industry tags from the issuer (e.g. ['Technology']).                                                                   | []                                                                                                                              |
+| `regionExposure`                                                                                                                | *string*[]                                                                                                                      | :heavy_minus_sign:                                                                                                              | Regional market exposure tags (e.g. ['US']).                                                                                    | []                                                                                                                              |
+| `priceHistory24h`                                                                                                               | [components.PricePoint](../../models/components/pricepoint.md)[]                                                                | :heavy_minus_sign:                                                                                                              | 24h price sparkline as `(timestamp, price)` samples in chronological order.                                                     | []                                                                                                                              |
+| `priceHigh52w`                                                                                                                  | *string*                                                                                                                        | :heavy_minus_sign:                                                                                                              | 52-week high of the underlying equity (USD).                                                                                    |                                                                                                                                 |
+| `priceLow52w`                                                                                                                   | *string*                                                                                                                        | :heavy_minus_sign:                                                                                                              | 52-week low of the underlying equity (USD).                                                                                     |                                                                                                                                 |
+| `volume24h`                                                                                                                     | *string*                                                                                                                        | :heavy_minus_sign:                                                                                                              | 24h trading volume of the underlying equity.                                                                                    |                                                                                                                                 |
+| `averageVolume`                                                                                                                 | *string*                                                                                                                        | :heavy_minus_sign:                                                                                                              | Average trading volume of the underlying equity.                                                                                |                                                                                                                                 |
+| `sharesOutstanding`                                                                                                             | *string*                                                                                                                        | :heavy_minus_sign:                                                                                                              | Shares outstanding of the underlying equity.                                                                                    |                                                                                                                                 |
+| `marketCap`                                                                                                                     | *string*                                                                                                                        | :heavy_minus_sign:                                                                                                              | Market cap of the underlying equity (USD).                                                                                      |                                                                                                                                 |
+| `totalHolders`                                                                                                                  | *number*                                                                                                                        | :heavy_minus_sign:                                                                                                              | On-chain holder count for the tokenized asset.                                                                                  |                                                                                                                                 |
+| `tradableSessions`                                                                                                              | *string*[]                                                                                                                      | :heavy_minus_sign:                                                                                                              | Sessions in which the token can be traded (e.g. 'regular', 'premarket').                                                        | []                                                                                                                              |
+| `sharesMultiplier`                                                                                                              | *string*                                                                                                                        | :heavy_minus_sign:                                                                                                              | Shares-multiplier ratio (= 1 if no recent split / corporate action).                                                            |                                                                                                                                 |
+| `candles`                                                                                                                       | [components.OhlcCandle](../../models/components/ohlccandle.md)[]                                                                | :heavy_minus_sign:                                                                                                              | OHLC candles. Present only when both `interval` and `range` query params are provided and form a valid pair; omitted otherwise. |                                                                                                                                 |

package/docs/models/components/marketdetailchain.md

@@ -1,6 +1,6 @@
 # MarketDetailChain
 
-Chain on which the surfaced contract is deployed.
+Chain on which the contract is deployed.
 
 ## Example Usage
 

package/docs/models/components/ohlccandle.md

@@ -1,6 +1,6 @@
 # OhlcCandle
 
-A single OHLC candle. Note: Ondo does not return per-candle volume.
+A single OHLC candle. Per-candle volume is not provided.
 
 ## Example Usage
 

package/docs/models/components/orderstatus.md

@@ -16,12 +16,12 @@ let value: OrderStatus = {
 
 ## Fields
 
-| Field                                                                                                                                                                                                                     | Type                                                                                                                                                                                                                      | Required                                                                                                                                                                                                                  | Description                                                                                                                                                                                                               |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `orderHash`                                                                                                                                                                                                               | *string*                                                                                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                                        | On-chain order hash.                                                                                                                                                                                                      |
-| `status`                                                                                                                                                                                                                  | [components.Status](../../models/components/status.md)                                                                                                                                                                    | :heavy_check_mark:                                                                                                                                                                                                        | Coarse-grained order state. Compass collapses Fusion's finer-grained states (`refunded`, `false-predicate`, etc.) into this 4-value enum.                                                                                 |
-| `fillTxHash`                                                                                                                                                                                                              | *string*                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                        | Tx hash of the most recent resolver fill (populated when filled or partially filled).                                                                                                                                     |
-| `fillPriceUsd`                                                                                                                                                                                                            | *string*                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                        | Implied USD execution rate per unit of the taker token, derived from filled amounts and the maker-side USD price. For USDC→equity buys this is the USD paid per equity unit. Omitted if maker/taker decimals are unknown. |
-| `filledAmount`                                                                                                                                                                                                            | *string*                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                        | Sum of base-unit amounts filled so far. Populated for partial fills while `status` is still `pending`, and for fully filled orders.                                                                                       |
-| `submittedAt`                                                                                                                                                                                                             | *string*                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                        | ISO 8601 UTC timestamp of order submission.                                                                                                                                                                               |
-| `updatedAt`                                                                                                                                                                                                               | *string*                                                                                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                                        | ISO 8601 UTC timestamp of this status read.                                                                                                                                                                               |
+| Field                                                                                                                                                                                                                                           | Type                                                                                                                                                                                                                                            | Required                                                                                                                                                                                                                                        | Description                                                                                                                                                                                                                                     |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `orderHash`                                                                                                                                                                                                                                     | *string*                                                                                                                                                                                                                                        | :heavy_check_mark:                                                                                                                                                                                                                              | On-chain order hash.                                                                                                                                                                                                                            |
+| `status`                                                                                                                                                                                                                                        | [components.Status](../../models/components/status.md)                                                                                                                                                                                          | :heavy_check_mark:                                                                                                                                                                                                                              | Order lifecycle state. One of `pending`, `filled`, `expired`, or `cancelled`. Upstream protocol states beyond these four (e.g. `partially-filled`, `refunded`) are mapped onto this set.                                                        |
+| `fillTxHash`                                                                                                                                                                                                                                    | *string*                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                              | Transaction hash of the most recent fill. Populated for fully filled orders and for partial fills while `status` is still `pending`.                                                                                                            |
+| `fillPriceUsd`                                                                                                                                                                                                                                  | *string*                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                              | Implied USD execution rate per unit of the received token, derived from filled amounts and the input token's USD price. For USDC → equity buys, this is the USD paid per equity unit. Omitted when token decimals or pricing are not available. |
+| `filledAmount`                                                                                                                                                                                                                                  | *string*                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                              | Total amount filled so far, expressed as a raw integer in the input token's decimals. Populated for partial fills while `status` is still `pending`, and for fully filled orders.                                                               |
+| `submittedAt`                                                                                                                                                                                                                                   | *string*                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                              | ISO 8601 UTC timestamp at which the order was submitted.                                                                                                                                                                                        |
+| `updatedAt`                                                                                                                                                                                                                                     | *string*                                                                                                                                                                                                                                        | :heavy_check_mark:                                                                                                                                                                                                                              | ISO 8601 UTC timestamp at which this status was read.                                                                                                                                                                                           |

package/docs/models/components/ordertosign.md

@@ -1,12 +1,11 @@
 # OrderToSign
 
-Fusion order metadata bundled with the SafeMessage EIP-712 to sign.
+Order metadata plus the EIP-712 payload the owner signs to authorize it.
 
-The owner signs ``safe_message_eip712`` (a `SafeMessage(bytes message)`
-payload wrapping ``order_hash`` for ERC-1271). At submit time the SDK
-relays the resulting 65-byte ECDSA together with ``order_message``,
-``extension``, and ``quote_id`` so 1inch's relayer can broadcast the
-order; resolvers fill it via ``Safe.isValidSignature``.
+The owner signs ``safe_message_eip712`` off-chain. At submit time the
+signature is sent back to ``/order/submit`` together with
+``order_message``, ``extension``, and ``quote_id``; resolvers validate
+the signature against the Tokenized Assets Account at fill time.
 
 ## Example Usage
 
@@ -46,10 +45,10 @@ let value: OrderToSign = {
 
 ## Fields
 
-| Field                                                                                                                                                                                                               | Type                                                                                                                                                                                                                | Required                                                                                                                                                                                                            | Description                                                                                                                                                                                                         |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `orderHash`                                                                                                                                                                                                         | *string*                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                  | The 1inch LOP order hash. Wrapped inside `safe_message_eip712.message.message` for ERC-1271 signing; also relayed to `/order/submit` so the API can fall back to it if the upstream submit response omits the hash. |
-| `extension`                                                                                                                                                                                                         | *string*                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                  | Opaque hex blob from 1inch — pass back to `/order/submit` unchanged.                                                                                                                                                |
-| `quoteId`                                                                                                                                                                                                           | *string*                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                  | 1inch quote identifier — must be echoed back at `/order/submit`.                                                                                                                                                    |
-| `orderMessage`                                                                                                                                                                                                      | Record<string, *any*>                                                                                                                                                                                               | :heavy_check_mark:                                                                                                                                                                                                  | Fusion order struct (maker, makerAsset, makingAmount, etc.) — pass back to `/order/submit` unchanged. Maker is the Tokenized Assets Account, not the EOA owner.                                                     |
-| `safeMessageEip712`                                                                                                                                                                                                 | [components.SafeMessageEip712Response](../../models/components/safemessageeip712response.md)                                                                                                                        | :heavy_check_mark:                                                                                                                                                                                                  | ``signTypedData`` payload for ``SafeMessage(bytes message)``.                                                                                                                                                       |
+| Field                                                                                                                                                                                                                               | Type                                                                                                                                                                                                                                | Required                                                                                                                                                                                                                            | Description                                                                                                                                                                                                                         |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `orderHash`                                                                                                                                                                                                                         | *string*                                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                                  | The on-chain order hash. Wrapped inside `safe_message_eip712.message.message` for the owner to sign; also passed back to `/order/submit` so the API can return a usable handle even if the upstream submit response omits the hash. |
+| `extension`                                                                                                                                                                                                                         | *string*                                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                                  | Opaque hex blob from the upstream quote — pass back to `/order/submit` unchanged.                                                                                                                                                   |
+| `quoteId`                                                                                                                                                                                                                           | *string*                                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                                  | Upstream quote identifier — must be echoed back at `/order/submit`.                                                                                                                                                                 |
+| `orderMessage`                                                                                                                                                                                                                      | Record<string, *any*>                                                                                                                                                                                                               | :heavy_check_mark:                                                                                                                                                                                                                  | Order struct (maker, makerAsset, makingAmount, etc.) — pass back to `/order/submit` unchanged. The maker is the Tokenized Assets Account, not the owner's wallet.                                                                   |
+| `safeMessageEip712`                                                                                                                                                                                                                 | [components.SafeMessageEip712Response](../../models/components/safemessageeip712response.md)                                                                                                                                        | :heavy_check_mark:                                                                                                                                                                                                                  | ``signTypedData`` payload for ``SafeMessage(bytes message)``.                                                                                                                                                                       |

package/docs/models/components/quote.md

@@ -25,9 +25,9 @@ let value: Quote = {
 
 ## Fields
 
-| Field                                                              | Type                                                               | Required                                                           | Description                                                        |
-| ------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------ |
-| `input`                                                            | [components.TokenAmount](../../models/components/tokenamount.md)   | :heavy_check_mark:                                                 | A token + amount pair for one leg of the quote.                    |
-| `output`                                                           | [components.TokenAmount](../../models/components/tokenamount.md)   | :heavy_check_mark:                                                 | A token + amount pair for one leg of the quote.                    |
-| `fee`                                                              | [components.QuoteFee](../../models/components/quotefee.md)         | :heavy_check_mark:                                                 | Aggregate fee charged by the Fusion auction (resolver + protocol). |
-| `estFillSeconds`                                                   | *number*                                                           | :heavy_check_mark:                                                 | Auction duration upper-bound in seconds.                           |
+| Field                                                            | Type                                                             | Required                                                         | Description                                                      |
+| ---------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `input`                                                          | [components.TokenAmount](../../models/components/tokenamount.md) | :heavy_check_mark:                                               | A token + amount pair for one leg of the quote.                  |
+| `output`                                                         | [components.TokenAmount](../../models/components/tokenamount.md) | :heavy_check_mark:                                               | A token + amount pair for one leg of the quote.                  |
+| `fee`                                                            | [components.QuoteFee](../../models/components/quotefee.md)       | :heavy_check_mark:                                               | Aggregate fee charged for the order.                             |
+| `estFillSeconds`                                                 | *number*                                                         | :heavy_check_mark:                                               | Estimated upper bound on time-to-fill, in seconds.               |

package/docs/models/components/quotefee.md

@@ -1,6 +1,6 @@
 # QuoteFee
 
-Aggregate fee charged by the Fusion auction (resolver + protocol).
+Aggregate fee charged for the order.
 
 ## Example Usage
 
@@ -14,5 +14,5 @@ let value: QuoteFee = {};
 
 | Field                                    | Type                                     | Required                                 | Description                              |
 | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
-| `amountUsd`                              | *string*                                 | :heavy_minus_sign:                       | Total fee in USD, decimal string.        |
+| `amountUsd`                              | *string*                                 | :heavy_minus_sign:                       | Total fee in USD as a decimal string.    |
 | `bps`                                    | *number*                                 | :heavy_minus_sign:                       | Fee as basis points of the input amount. |

package/docs/models/components/status.md

@@ -1,6 +1,6 @@
 # Status
 
-Coarse-grained order state. Compass collapses Fusion's finer-grained states (`refunded`, `false-predicate`, etc.) into this 4-value enum.
+Order lifecycle state. One of `pending`, `filled`, `expired`, or `cancelled`. Upstream protocol states beyond these four (e.g. `partially-filled`, `refunded`) are mapped onto this set.
 
 ## Example Usage