@stable_sea/sdk 0.2.36 → 0.2.40

package/README.md

@@ -615,11 +615,23 @@ its first chart refresh. The document's captured financial figures remain readab
   before this it reported `chain: "unknown"`. Code that switches on `chain`
   should accept the new value, and code that keyed a Solana balance by its
   `unknown` row should expect the `solana` row instead.
+- `GET /v1/transactions`, `GET /v1/transactions/{id}`, `GET /v1/statements/{id}`
+  and `GET /v1/statements/preview`: the transaction `type` enum gains
+  `fund_sol_reserve`, the platform's own top-up of a business's Solana wallet. It is
+  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 cannot name Solana yet. A
+  fund-trade approval's `fund_route` reports `source: "solana"` and
+  `source_network: "solana"` for such a buy.
 
 ## October 16 API contract
 

package/dist/gen/schema.d.ts

@@ -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_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_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_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,13 @@ 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;
+        };
+        /** @enum {string} */
+        MoneyenumChain: "arbitrum" | "base" | "ethereum" | "polygon" | "solana" | "stellar";
         MoneyMovementsTransferApprovalView: {
             also_required_ind_id?: string | null;
             also_required_name?: string;
@@ -4041,12 +4049,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 +4102,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 +4144,7 @@ export interface components {
             symbol: string;
         };
         /** @enum {string} */
-        TradesSettlementSource: "platform" | "stellar";
+        TradesSettlementSource: "platform" | "stellar" | "solana";
         /** @enum {string} */
         TradesSettlementPreference: "standard" | "instant";
         /** @enum {string} */
@@ -4145,6 +4154,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.36",
+  "version": "0.2.40",
   "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",