@stable_sea/sdk 0.2.37 → 0.2.41

package/README.md

@@ -21,7 +21,7 @@ import { createStableSeaClient } from "@stable_sea/sdk";
 const client = createStableSeaClient({
   apiKey: process.env.STABLE_SEA_API_KEY!,
   baseUrl: process.env.STABLE_SEA_BASE_URL!,
-  version: "2026-10-16",
+  version: "2026-10-26",
 });
 ```
 
@@ -53,9 +53,9 @@ keys and rotations reuse that data.
 WTGXX supports standard and instant settlement. FLTTX supports standard
 settlement; instant orders are refused in both production and sandbox.
 
-Every fund order names the network it settles on, `ethereum` or `stellar`. The
-API never applies a business's default network. A BTC order settles on no network
-and must not name one. The generated `network` type is optional because BTC shares
+Every fund order names the network it settles on, `ethereum`, `stellar` or
+`solana`. The API never applies a business's default network. A BTC order settles
+on no network and must not name one. The generated `network` type is optional because BTC shares
 the request, so the server enforces both rules: a fund order without a network
 fails with `network_required`, and a BTC order with one fails with
 `network_not_applicable`. Sandbox settles on `ethereum`. Instant settlement is
@@ -621,15 +621,40 @@ its first chart refresh. The document's captured financial figures remain readab
   a platform movement; code that switches on `type` should accept the new value.
 - WisdomTree fund orders: an order settled over `onchain_solana` now fails with
   `FailedPrecondition` (or `Unavailable` when the business's Solana switch cannot
-  be read, which is retryable) instead of `InvalidArgument`. Solana settlement
-  for WisdomTree funds is not live yet, so the order still cannot succeed.
-  Clients that branch on the status code for this rail should accept both.
+  be read, which is retryable) instead of `InvalidArgument`. Clients that branch
+  on the status code for this rail should accept both.
+- Session trades: the `funding_source` and `proceeds_destination` enum
+  (`TradesSettlementSource`) gains `solana`. A WTGXX buy may name
+  `funding_source: "solana"` to fund it from the business's segregated Solana USDC
+  balance, for a business whose WisdomTree Solana switch is on (otherwise
+  `FailedPrecondition`); every other fund, and every sell with
+  `proceeds_destination: "solana"`, is refused with a 400
+  `invalid_settlement_source`. `/v1` fund orders name Solana from the
+  October 26 contract below. A
+  fund-trade approval's `fund_route` reports `source: "solana"` and
+  `source_network: "solana"` for such a buy.
+
+## October 26 API contract
+
+Update to the latest SDK before placing a fund order on Solana. `POST /v1/orders`
+accepts `network: "solana"` for a fund order, and every order read may return
+`network: "solana"`. A standard WTGXX buy on Solana is funded from the business's
+segregated Solana USDC balance, and a standard WTGXX sell on Solana returns its
+proceeds there, through the same execution path as Terminal. Any other Solana
+order (another fund, or instant settlement), and any Solana order from a business
+outside the WisdomTree Solana program or outside its Solana deposit rollout, ends
+`failed` with `network_not_eligible`. While the platform is still setting up the
+business's Solana wallet, or refilling the SOL it pays network fees with, the order
+stays `pending` and is retried.
+A business that turned Solana off gets `network_not_in_use`. The HTTP request pin
+is `2026-10-26`; the retired `2026-10-16` pin returns
+`400 unsupported_api_version`.
 
 ## October 16 API contract
 
 Update to the latest SDK before placing fund orders. `POST /v1/orders` takes a
 `network` for every fund order and refuses it for BTC, and every order read returns
-`network` (`null` for BTC). The HTTP request pin is `2026-10-16`; the retired
+`network` (`null` for BTC). The HTTP request pin was `2026-10-16`; the retired
 `2026-10-15` pin returns `400 unsupported_api_version`. An order whose network the
 business turned off, or cannot settle on, ends `failed` with `network_not_in_use`
 or `network_not_eligible`.
@@ -641,7 +666,7 @@ with `client.DELETE("/v1/bank_accounts/{id}")`, without a body or idempotency ke
 Read bank and wallet operation `status` instead of `state`. Retrieve issued
 statement content with `GET /v1/statements/{id}`; the `/content` route is retired.
 
-The HTTP request pin is `2026-10-16`. The retired pin returns
+The HTTP request pin is `2026-10-26`. The retired pin returns
 `400 unsupported_api_version`. Existing API keys remain valid; stored key and
 thin-event/webhook versions are preserved.
 

package/dist/gen/schema.d.ts

@@ -629,7 +629,7 @@ export interface paths {
         put?: never;
         /**
          * Place an order
-         * @description Creates an order for the authenticated business and returns it as `pending`. A fund order must name the `network` it settles on, `ethereum` or `stellar`; the API never applies a business's default network. A business that has turned that network off, or is not eligible for it, gets a failed order with a `failure_code` naming why. BTC orders require both `investments:write` and `investments:btc_write`, use standard settlement and settle on no network, so they must not name one. The BTC quote is indicative; execution uses the current native price and fees. Execution is asynchronous and uses the same authorization checks and trading engine as Terminal. Retrieve the order to follow it through `executing` to `filled` or `failed`.
+         * @description Creates an order for the authenticated business and returns it as `pending`. A fund order must name the `network` it settles on, `ethereum`, `stellar` or `solana`; the API never applies a business's default network. A business that has turned that network off, or is not eligible for it, gets a failed order with a `failure_code` naming why. BTC orders require both `investments:write` and `investments:btc_write`, use standard settlement and settle on no network, so they must not name one. The BTC quote is indicative; execution uses the current native price and fees. Execution is asynchronous and uses the same authorization checks and trading engine as Terminal. Retrieve the order to follow it through `executing` to `filled` or `failed`.
          *
          *     Fund orders check the quoted NAV at execution. Price changes and insufficient express liquidity can cause execution to fail. The failed order includes a reason. While the quote remains valid, an express refusal can be submitted as a new standard order.
          *
@@ -2043,7 +2043,7 @@ export interface components {
             observed_ts: string;
         };
         /** @enum {string} */
-        HTTPAPIVersion: "2026-10-16";
+        HTTPAPIVersion: "2026-10-26";
         List: {
             data: components["schemas"]["Resource"][];
             has_more: boolean;
@@ -2120,7 +2120,7 @@ export interface components {
              * @description The network the order settles on, as the request named it. Null for BTC, which settles on no network.
              * @enum {string|null}
              */
-            network: "ethereum" | "stellar" | null;
+            network: "ethereum" | "stellar" | "solana" | null;
             /** @enum {string} */
             object: "order";
             quoted_price: string;
@@ -2146,10 +2146,10 @@ export interface components {
              */
             funding_method?: "balance" | "wire";
             /**
-             * @description The network a fund order settles on. Required for a fund order and refused for BTC, which settles on no network. The API never applies a business's default network.
+             * @description The network a fund order settles on. Required for a fund order and refused for BTC, which settles on no network. The API never applies a business's default network. Solana settles a standard WTGXX buy or sell for a business in the WisdomTree Solana program and its Solana deposit rollout. A Solana order that cannot settle for any other reason fails with network_not_eligible, and one waiting on the business's Solana wallet stays pending and is retried.
              * @enum {string}
              */
-            network?: "ethereum" | "stellar";
+            network?: "ethereum" | "stellar" | "solana";
             /** @description The price_per_unit from GET /v1/quotes. Fund execution checks the NAV; BTC uses an indicative price and executes at the current native price. */
             quoted_price: string;
             /**
@@ -2736,7 +2736,7 @@ export interface components {
             /** @enum {string} */
             status: "completed" | "pending" | "failed";
             /** @enum {string} */
-            type: "ach_offramp" | "ach_onramp" | "adjustment" | "buy_fund_token" | "buy_fund_token_return" | "buy_fund_token_return_sweep" | "cash_home_transfer" | "deposit_hold" | "deposit_return" | "deposit_reversal" | "fund_cash_subscription" | "fund_dividend_payout" | "fund_distribution_payout" | "fund_gas_tank" | "fund_interest_payout" | "fund_sol_reserve" | "fund_xlm_reserve" | "gas_tank_refill" | "gas_wallet_funding" | "go_account_conversion" | "go_account_custodial_transfer" | "go_account_external_send" | "held_deposit_release" | "onchain_deposit" | "onchain_withdrawal" | "ramp_fee_refund" | "reclassification" | "sell_fund_token" | "sell_fund_token_return" | "trade_order" | "treasury_booking" | "treasury_wire_credit" | "wire_offramp" | "wire_onramp";
+            type: "ach_offramp" | "ach_onramp" | "adjustment" | "buy_fund_token" | "buy_fund_token_return" | "buy_fund_token_return_sweep" | "cash_home_transfer" | "deposit_hold" | "deposit_return" | "deposit_reversal" | "fund_cash_subscription" | "fund_dividend_payout" | "fund_distribution_payout" | "fund_gas_tank" | "fund_interest_payout" | "fund_sol_reserve" | "fund_xlm_reserve" | "gas_tank_refill" | "gas_wallet_funding" | "go_account_conversion" | "go_account_custodial_transfer" | "go_account_external_send" | "held_deposit_release" | "onchain_deposit" | "onchain_withdrawal" | "ramp_fee_refund" | "reclassification" | "sell_fund_token" | "sell_fund_token_return" | "swap" | "trade_order" | "treasury_booking" | "treasury_wire_credit" | "wire_offramp" | "wire_onramp";
             withdrawal?: components["schemas"]["StatementWithdrawal"];
         };
         StatementGeneration: {
@@ -2921,7 +2921,7 @@ export interface components {
              * @description What the movement is. The whole vocabulary a transaction can carry is published; a business only ever sees the members its own activity produces. Pay-ins and payouts are never served on this API.
              * @enum {string}
              */
-            type: "ach_offramp" | "ach_onramp" | "adjustment" | "buy_fund_token" | "buy_fund_token_return" | "buy_fund_token_return_sweep" | "cash_home_transfer" | "deposit_hold" | "deposit_return" | "deposit_reversal" | "fund_cash_subscription" | "fund_dividend_payout" | "fund_distribution_payout" | "fund_gas_tank" | "fund_interest_payout" | "fund_sol_reserve" | "fund_xlm_reserve" | "gas_tank_refill" | "gas_wallet_funding" | "go_account_conversion" | "go_account_custodial_transfer" | "go_account_external_send" | "held_deposit_release" | "onchain_deposit" | "onchain_withdrawal" | "ramp_fee_refund" | "reclassification" | "sell_fund_token" | "sell_fund_token_return" | "trade_order" | "treasury_booking" | "treasury_wire_credit" | "wire_offramp" | "wire_onramp";
+            type: "ach_offramp" | "ach_onramp" | "adjustment" | "buy_fund_token" | "buy_fund_token_return" | "buy_fund_token_return_sweep" | "cash_home_transfer" | "deposit_hold" | "deposit_return" | "deposit_reversal" | "fund_cash_subscription" | "fund_dividend_payout" | "fund_distribution_payout" | "fund_gas_tank" | "fund_interest_payout" | "fund_sol_reserve" | "fund_xlm_reserve" | "gas_tank_refill" | "gas_wallet_funding" | "go_account_conversion" | "go_account_custodial_transfer" | "go_account_external_send" | "held_deposit_release" | "onchain_deposit" | "onchain_withdrawal" | "ramp_fee_refund" | "reclassification" | "sell_fund_token" | "sell_fund_token_return" | "swap" | "trade_order" | "treasury_booking" | "treasury_wire_credit" | "wire_offramp" | "wire_onramp";
         };
         TransactionAssetChange: {
             /** @description The signed net change to the business's settled holdings of this asset, in the asset's own units. Negative amounts decrease holdings; positive amounts increase them. Net of the ledger's fees and taxes, on the same basis /v1/balances reports. For a business with no pay-ins or payouts, summing an asset's amounts across every transaction — not only the completed ones — gives the movement in its settled balance. Pay-ins and payouts are not served on this API but still move /v1/balances, so a business with payments cannot reconcile its balance from transactions alone. */
@@ -3003,7 +3003,7 @@ export interface components {
              * @description What the movement is. The whole vocabulary a transaction can carry is published; a business only ever sees the members its own activity produces. Pay-ins and payouts are never served on this API.
              * @enum {string}
              */
-            type: "ach_offramp" | "ach_onramp" | "adjustment" | "buy_fund_token" | "buy_fund_token_return" | "buy_fund_token_return_sweep" | "cash_home_transfer" | "deposit_hold" | "deposit_return" | "deposit_reversal" | "fund_cash_subscription" | "fund_dividend_payout" | "fund_distribution_payout" | "fund_gas_tank" | "fund_interest_payout" | "fund_sol_reserve" | "fund_xlm_reserve" | "gas_tank_refill" | "gas_wallet_funding" | "go_account_conversion" | "go_account_custodial_transfer" | "go_account_external_send" | "held_deposit_release" | "onchain_deposit" | "onchain_withdrawal" | "ramp_fee_refund" | "reclassification" | "sell_fund_token" | "sell_fund_token_return" | "trade_order" | "treasury_booking" | "treasury_wire_credit" | "wire_offramp" | "wire_onramp";
+            type: "ach_offramp" | "ach_onramp" | "adjustment" | "buy_fund_token" | "buy_fund_token_return" | "buy_fund_token_return_sweep" | "cash_home_transfer" | "deposit_hold" | "deposit_return" | "deposit_reversal" | "fund_cash_subscription" | "fund_dividend_payout" | "fund_distribution_payout" | "fund_gas_tank" | "fund_interest_payout" | "fund_sol_reserve" | "fund_xlm_reserve" | "gas_tank_refill" | "gas_wallet_funding" | "go_account_conversion" | "go_account_custodial_transfer" | "go_account_external_send" | "held_deposit_release" | "onchain_deposit" | "onchain_withdrawal" | "ramp_fee_refund" | "reclassification" | "sell_fund_token" | "sell_fund_token_return" | "swap" | "trade_order" | "treasury_booking" | "treasury_wire_credit" | "wire_offramp" | "wire_onramp";
         };
         TransactionFeeReturns: {
             original_transaction_id: string | null;
@@ -3026,7 +3026,7 @@ export interface components {
             deposit?: components["schemas"]["TransactionDepositAmounts"];
             /**
              * Format: date-time
-             * @description Pending fund settlement estimate. Null after the native receipt no longer reports an estimate.
+             * @description Pending fund settlement estimate. For a pending YLDS sale it is the time Figure is expected to pay the USDC proceeds, set once the YLDS reaches Figure: 5:00 p.m. ET that day if the YLDS reached Figure by 2:30 p.m. ET on a business day (an NYSE trading day that is not a Federal Reserve holiday), else 5:00 p.m. ET on the next business day. Same-day payment depends on Figure's liquidity, and the time is not guaranteed. Null for a YLDS buy, which Figure mints on receipt of the USDC at any hour, for a failed sale, and after the native receipt no longer reports an estimate.
              */
             estimated_settlement_ts: string | null;
             fee?: components["schemas"]["TransactionValue"];

package/dist/gen/session-schema.d.ts

@@ -2023,7 +2023,7 @@ export interface paths {
         };
         /**
          * Retrieve trading pathways
-         * @description Read settlement estimates and pathway availability for the signed-in business and trade direction before entering an amount. WTGXX buys include express-buy and cash-subscription availability and the cash minimum; WTGXX sells include instant-sell availability. Express-buy fees show the rate only. Request a quote for amount-specific fees, limits and share quantities. Availability is advisory: submission rechecks current eligibility and controls.
+         * @description Read settlement estimates and pathway availability for the signed-in business and trade direction before entering an amount. WTGXX buys include express-buy and cash-subscription availability and the cash minimum; WTGXX sells include instant-sell availability. USTB buys include the business's minimum buy when one applies. Express-buy fees show the rate only. Request a quote for amount-specific fees, limits and share quantities. Availability is advisory: submission rechecks current eligibility and controls.
          */
         get: operations["money.trades.pathways.get"];
         put?: never;
@@ -3879,6 +3879,7 @@ export interface components {
             /** Format: date-time */
             settlement_ts?: string;
             status: components["schemas"]["MoneyenumLifecycleStatus"];
+            swap?: components["schemas"]["MoneyMovementsSwapTradeView"];
             transaction_count: number;
             type: string;
         };
@@ -3941,6 +3942,15 @@ export interface components {
         };
         /** @enum {string} */
         MoneyenumLifecycleStatus: "pending" | "completed" | "failed";
+        MoneyMovementsSwapTradeView: {
+            chain: components["schemas"]["MoneyenumChain"];
+            /** @description The rate the trade filled at, to the asset received per one asset sent, before the swap fee: a decimal string at eight places. */
+            rate: string;
+            /** @description Whether the swap's trade is booked: both of its legs completed. A pending swap with a booked trade is waiting on its fee transfer. A failed swap with a booked trade moved the trade's funds; a failed one without moved nothing. */
+            trade_booked: boolean;
+        };
+        /** @enum {string} */
+        MoneyenumChain: "arbitrum" | "base" | "ethereum" | "polygon" | "solana" | "stellar";
         MoneyMovementsTransferApprovalView: {
             also_required_ind_id?: string | null;
             also_required_name?: string;
@@ -4041,12 +4051,13 @@ export interface components {
             pathway?: "standard" | "express";
             pathway_defaulted?: boolean;
             /** @enum {string} */
-            source?: "platform" | "stellar";
+            source?: "platform" | "stellar" | "solana";
             source_defaulted?: boolean;
-            /** @enum {string} */
-            source_network?: "ethereum" | "stellar";
+            source_network?: components["schemas"]["MoneyMovementsTransferApprovalNetwork"];
         };
         /** @enum {string} */
+        MoneyMovementsTransferApprovalNetwork: "ethereum" | "stellar" | "solana";
+        /** @enum {string} */
         MoneyMovementsTransferApprovalStatus: "pending" | "approved" | "denied" | "cancelled" | "expired" | "policy_changed" | "failed";
         MoneyMovementsTransferApprovalVoteView: {
             approver?: string;
@@ -4093,9 +4104,9 @@ export interface components {
             selected_route?: components["schemas"]["MoneyMovementsTransferApprovalFundRoute"];
             /**
              * Format: date-time
-             * @description Estimated time at which the trade settles.
+             * @description Estimated time at which the trade settles. Absent when the quote dates no settlement: a YLDS buy, which Figure mints on receipt of the USDC at any hour, a YLDS sale, and a USTB order.
              */
-            settled_ts?: string;
+            settled_ts?: string | null;
             settlement_duration_minutes?: number | null;
             settlement_trading_days?: number | null;
         };
@@ -4135,7 +4146,7 @@ export interface components {
             symbol: string;
         };
         /** @enum {string} */
-        TradesSettlementSource: "platform" | "stellar";
+        TradesSettlementSource: "platform" | "stellar" | "solana";
         /** @enum {string} */
         TradesSettlementPreference: "standard" | "instant";
         /** @enum {string} */
@@ -4145,6 +4156,8 @@ export interface components {
             express_buy?: components["schemas"]["TradesExpressBuyQuote"];
             express_settlement?: components["schemas"]["TradesPathwaySettlementEstimate"];
             instant_sell?: components["schemas"]["TradesInstantSellQuote"];
+            min_buy_usd?: string;
+            min_buy_usd_view?: components["schemas"]["MoneyfmtMoneyAmountView"];
             standard_settlement?: components["schemas"]["TradesPathwaySettlementEstimate"];
         };
         TradesCashSubscriptionQuote: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable_sea/sdk",
-  "version": "0.2.37",
+  "version": "0.2.41",
   "type": "module",
   "sideEffects": false,
   "files": [
@@ -38,7 +38,7 @@
     "@types/node": "26.6.5",
     "openapi-typescript": "7.13.0",
     "typescript": "5.9.3",
-    "vitest": "5.0.4"
+    "vitest": "5.0.5"
   },
   "overrides": {
     "js-yaml": "^4.3.2",