@mysten/deepbook-v3 2.1.4 → 2.4.0

package/dist/transactions/marginRegistry.d.mts

@@ -1,5 +1,5 @@
 import { DeepBookConfig } from "../utils/config.mjs";
-import * as _mysten_sui_transactions177 from "@mysten/sui/transactions";
+import * as _mysten_sui_transactions298 from "@mysten/sui/transactions";
 import { Transaction } from "@mysten/sui/transactions";
 
 //#region src/transactions/marginRegistry.d.ts
@@ -17,90 +17,90 @@ declare class MarginRegistryContract {
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  poolEnabled: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  poolEnabled: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the margin pool ID for a given asset
    * @param {string} coinKey The key to identify the coin
    * @returns A function that takes a Transaction object
    */
-  getMarginPoolId: (coinKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  getMarginPoolId: (coinKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the margin pool IDs (base and quote) for a deepbook pool
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  getDeepbookPoolMarginPoolIds: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  getDeepbookPoolMarginPoolIds: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the margin manager IDs for a given owner
    * @param {string} owner The owner address
    * @returns A function that takes a Transaction object
    */
-  getMarginManagerIds: (owner: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  getMarginManagerIds: (owner: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the base margin pool ID for a deepbook pool
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  baseMarginPoolId: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  baseMarginPoolId: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the quote margin pool ID for a deepbook pool
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  quoteMarginPoolId: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  quoteMarginPoolId: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the minimum withdraw risk ratio for a deepbook pool
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  minWithdrawRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  minWithdrawRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the minimum borrow risk ratio for a deepbook pool
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  minBorrowRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  minBorrowRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the minimum risk ratio required to open a new position on
    * a deepbook pool. Distinct from `minBorrowRiskRatio`, which gates borrowing.
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  minOpenRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  minOpenRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the liquidation risk ratio for a deepbook pool
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  liquidationRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  liquidationRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the target liquidation risk ratio for a deepbook pool
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  targetLiquidationRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  targetLiquidationRiskRatio: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the user liquidation reward for a deepbook pool
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  userLiquidationReward: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  userLiquidationReward: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get the pool liquidation reward for a deepbook pool
    * @param {string} poolKey The key to identify the pool
    * @returns A function that takes a Transaction object
    */
-  poolLiquidationReward: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  poolLiquidationReward: (poolKey: string) => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get all allowed maintainer cap IDs
    * @returns A function that takes a Transaction object
    */
-  allowedMaintainers: () => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  allowedMaintainers: () => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
   /**
    * @description Get all allowed pause cap IDs
    * @returns A function that takes a Transaction object
    */
-  allowedPauseCaps: () => (tx: Transaction) => _mysten_sui_transactions177.TransactionResult;
+  allowedPauseCaps: () => (tx: Transaction) => _mysten_sui_transactions298.TransactionResult;
 }
 //#endregion
 export { MarginRegistryContract };

package/dist/transactions/marginTPSL.d.mts

@@ -1,6 +1,6 @@
 import { AddConditionalOrderParams, PendingLimitOrderParams, PendingMarketOrderParams } from "../types/index.mjs";
 import { DeepBookConfig } from "../utils/config.mjs";
-import * as _mysten_sui_transactions113 from "@mysten/sui/transactions";
+import * as _mysten_sui_transactions134 from "@mysten/sui/transactions";
 import { Transaction } from "@mysten/sui/transactions";
 
 //#region src/transactions/marginTPSL.d.ts
@@ -20,21 +20,21 @@ declare class MarginTPSLContract {
    * @param {number} triggerPrice The price at which to trigger the order
    * @returns A function that takes a Transaction object
    */
-  newCondition: (poolKey: string, triggerBelowPrice: boolean, triggerPrice: number | bigint) => (tx: Transaction) => _mysten_sui_transactions113.TransactionResult;
+  newCondition: (poolKey: string, triggerBelowPrice: boolean, triggerPrice: number | bigint) => (tx: Transaction) => _mysten_sui_transactions134.TransactionResult;
   /**
    * @description Create a new pending limit order for use in conditional orders
    * @param {string} poolKey The key to identify the pool
    * @param {PendingLimitOrderParams} params Parameters for the pending limit order
    * @returns A function that takes a Transaction object
    */
-  newPendingLimitOrder: (poolKey: string, params: PendingLimitOrderParams) => (tx: Transaction) => _mysten_sui_transactions113.TransactionResult;
+  newPendingLimitOrder: (poolKey: string, params: PendingLimitOrderParams) => (tx: Transaction) => _mysten_sui_transactions134.TransactionResult;
   /**
    * @description Create a new pending market order for use in conditional orders
    * @param {string} poolKey The key to identify the pool
    * @param {PendingMarketOrderParams} params Parameters for the pending market order
    * @returns A function that takes a Transaction object
    */
-  newPendingMarketOrder: (poolKey: string, params: PendingMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions113.TransactionResult;
+  newPendingMarketOrder: (poolKey: string, params: PendingMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions134.TransactionResult;
   /**
    * @description Add a conditional order (take profit or stop loss)
    * @param {AddConditionalOrderParams} params Parameters for adding the conditional order
@@ -65,7 +65,7 @@ declare class MarginTPSLContract {
    * @param {number} maxOrdersToExecute Maximum number of orders to execute in this call
    * @returns A function that takes a Transaction object
    */
-  executeConditionalOrders: (managerAddress: string, poolKey: string, maxOrdersToExecute: number) => (tx: Transaction) => _mysten_sui_transactions113.TransactionResult;
+  executeConditionalOrders: (managerAddress: string, poolKey: string, maxOrdersToExecute: number) => (tx: Transaction) => _mysten_sui_transactions134.TransactionResult;
   /**
    * @description Execute conditional orders, deleveraging on each market-type
    * fill. Permissionless, with the same trigger and cancellation handling as
@@ -83,14 +83,14 @@ declare class MarginTPSLContract {
    * @param {number} maxOrdersToExecute Maximum number of orders to execute in this call
    * @returns A function that takes a Transaction object
    */
-  executeConditionalOrdersV3: (managerAddress: string, poolKey: string, maxOrdersToExecute: number) => (tx: Transaction) => _mysten_sui_transactions113.TransactionResult;
+  executeConditionalOrdersV3: (managerAddress: string, poolKey: string, maxOrdersToExecute: number) => (tx: Transaction) => _mysten_sui_transactions134.TransactionResult;
   /**
    * @description Get all conditional order IDs for a margin manager
    * @param {string} poolKey The key to identify the pool
    * @param {string} marginManagerId The ID of the margin manager
    * @returns A function that takes a Transaction object
    */
-  conditionalOrderIds: (poolKey: string, marginManagerId: string) => (tx: Transaction) => _mysten_sui_transactions113.TransactionResult;
+  conditionalOrderIds: (poolKey: string, marginManagerId: string) => (tx: Transaction) => _mysten_sui_transactions134.TransactionResult;
   /**
    * @description Get a specific conditional order by ID
    * @param {string} poolKey The key to identify the pool
@@ -98,7 +98,7 @@ declare class MarginTPSLContract {
    * @param {string} conditionalOrderId The ID of the conditional order
    * @returns A function that takes a Transaction object
    */
-  conditionalOrder: (poolKey: string, marginManagerId: string, conditionalOrderId: string) => (tx: Transaction) => _mysten_sui_transactions113.TransactionResult;
+  conditionalOrder: (poolKey: string, marginManagerId: string, conditionalOrderId: string) => (tx: Transaction) => _mysten_sui_transactions134.TransactionResult;
   /**
    * @description Get the lowest trigger price for trigger_above orders
    * Returns constants::max_u64() if there are no trigger_above orders
@@ -106,7 +106,7 @@ declare class MarginTPSLContract {
    * @param {string} marginManagerId The ID of the margin manager
    * @returns A function that takes a Transaction object
    */
-  lowestTriggerAbovePrice: (poolKey: string, marginManagerId: string) => (tx: Transaction) => _mysten_sui_transactions113.TransactionResult;
+  lowestTriggerAbovePrice: (poolKey: string, marginManagerId: string) => (tx: Transaction) => _mysten_sui_transactions134.TransactionResult;
   /**
    * @description Get the highest trigger price for trigger_below orders
    * Returns 0 if there are no trigger_below orders
@@ -114,7 +114,7 @@ declare class MarginTPSLContract {
    * @param {string} marginManagerId The ID of the margin manager
    * @returns A function that takes a Transaction object
    */
-  highestTriggerBelowPrice: (poolKey: string, marginManagerId: string) => (tx: Transaction) => _mysten_sui_transactions113.TransactionResult;
+  highestTriggerBelowPrice: (poolKey: string, marginManagerId: string) => (tx: Transaction) => _mysten_sui_transactions134.TransactionResult;
 }
 //#endregion
 export { MarginTPSLContract };

package/dist/transactions/poolProxy.d.mts

@@ -1,6 +1,6 @@
 import { MarginProposalParams, PlaceMarginLimitOrderParams, PlaceMarginMarketOrderParams } from "../types/index.mjs";
 import { DeepBookConfig } from "../utils/config.mjs";
-import * as _mysten_sui_transactions106 from "@mysten/sui/transactions";
+import * as _mysten_sui_transactions127 from "@mysten/sui/transactions";
 import { Transaction } from "@mysten/sui/transactions";
 
 //#region src/transactions/poolProxy.d.ts
@@ -20,7 +20,7 @@ declare class PoolProxyContract {
    * @param {PlaceMarginLimitOrderParams} params Parameters for placing a limit order
    * @returns A function that takes a Transaction object
    */
-  placeLimitOrder: (params: PlaceMarginLimitOrderParams) => (tx: Transaction) => _mysten_sui_transactions106.TransactionResult;
+  placeLimitOrder: (params: PlaceMarginLimitOrderParams) => (tx: Transaction) => _mysten_sui_transactions127.TransactionResult;
   /**
    * @description Place a market order. Enforces a post-trade `risk_ratio >=
    * min_borrow_risk_ratio` invariant on the manager (skipped when the manager
@@ -28,7 +28,7 @@ declare class PoolProxyContract {
    * @param {PlaceMarginMarketOrderParams} params Parameters for placing a market order
    * @returns A function that takes a Transaction object
    */
-  placeMarketOrder: (params: PlaceMarginMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions106.TransactionResult;
+  placeMarketOrder: (params: PlaceMarginMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions127.TransactionResult;
   /**
    * @description Place a reduce only limit order. Requires the manager to have
    * debt on the relevant side; enforces a monotonic `risk_ratio_after >=
@@ -37,7 +37,7 @@ declare class PoolProxyContract {
    * @param {PlaceMarginLimitOrderParams} params Parameters for placing a reduce only limit order
    * @returns A function that takes a Transaction object
    */
-  placeReduceOnlyLimitOrder: (params: PlaceMarginLimitOrderParams) => (tx: Transaction) => _mysten_sui_transactions106.TransactionResult;
+  placeReduceOnlyLimitOrder: (params: PlaceMarginLimitOrderParams) => (tx: Transaction) => _mysten_sui_transactions127.TransactionResult;
   /**
    * @description Place a reduce only market order. Requires the manager to
    * have debt on the relevant side; enforces a monotonic `risk_ratio_after >=
@@ -46,7 +46,7 @@ declare class PoolProxyContract {
    * @param {PlaceMarginMarketOrderParams} params Parameters for placing a reduce only market order
    * @returns A function that takes a Transaction object
    */
-  placeReduceOnlyMarketOrder: (params: PlaceMarginMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions106.TransactionResult;
+  placeReduceOnlyMarketOrder: (params: PlaceMarginMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions127.TransactionResult;
   /**
    * @description Place a market order and repay the loan from the fill proceeds.
    * The taker fill settles into the manager's balance, so the proceeds (plus any
@@ -58,7 +58,7 @@ declare class PoolProxyContract {
    * @param {PlaceMarginMarketOrderParams} params Parameters for placing a market order
    * @returns A function that takes a Transaction object
    */
-  placeMarketOrderAndRepayLoan: (params: PlaceMarginMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions106.TransactionResult;
+  placeMarketOrderAndRepayLoan: (params: PlaceMarginMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions127.TransactionResult;
   /**
    * @description Place a reduce only limit order and repay the loan from the
    * fill proceeds. Requires debt on the relevant side (a bid needs base debt; an
@@ -68,7 +68,7 @@ declare class PoolProxyContract {
    * @param {PlaceMarginLimitOrderParams} params Parameters for placing a reduce only limit order
    * @returns A function that takes a Transaction object
    */
-  placeReduceOnlyLimitOrderAndRepayLoan: (params: PlaceMarginLimitOrderParams) => (tx: Transaction) => _mysten_sui_transactions106.TransactionResult;
+  placeReduceOnlyLimitOrderAndRepayLoan: (params: PlaceMarginLimitOrderParams) => (tx: Transaction) => _mysten_sui_transactions127.TransactionResult;
   /**
    * @description Place a reduce only market order and repay the loan from the
    * fill proceeds. Same reduce-only direction guard as
@@ -78,7 +78,7 @@ declare class PoolProxyContract {
    * @param {PlaceMarginMarketOrderParams} params Parameters for placing a reduce only market order
    * @returns A function that takes a Transaction object
    */
-  placeReduceOnlyMarketOrderAndRepayLoan: (params: PlaceMarginMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions106.TransactionResult;
+  placeReduceOnlyMarketOrderAndRepayLoan: (params: PlaceMarginMarketOrderParams) => (tx: Transaction) => _mysten_sui_transactions127.TransactionResult;
   /**
    * @description Modify an existing order
    * @param {string} marginManagerKey The key to identify the MarginManager

package/package.json

@@ -2,7 +2,7 @@
   "name": "@mysten/deepbook-v3",
   "author": "Mysten Labs <build@mystenlabs.com>",
   "description": "Sui Deepbook SDK",
-  "version": "2.1.4",
+  "version": "2.4.0",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
@@ -61,11 +61,11 @@
     "ts-retry-promise": "^0.8.1",
     "typescript": "^7.0.2",
     "vite": "^8.2.1",
-    "vitest": "^4.1.10",
+    "vitest": "^4.1.11",
     "wait-on": "^9.1.0"
   },
   "peerDependencies": {
-    "@mysten/sui": "^2.29.0"
+    "@mysten/sui": "^2.30.0"
   },
   "scripts": {
     "clean": "rm -rf tsconfig.tsbuildinfo ./dist",

package/src/account.ts

@@ -11,6 +11,7 @@ import { deriveObjectID } from '@mysten/sui/utils';
 import * as account from './contracts/account/account.js';
 import * as accountRegistry from './contracts/account/account_registry.js';
 import type { AccountConfig as GeneratedAccountConfig } from './contracts/account/config-arguments.js';
+import { MAINNET_ACCOUNT } from './deployments/mainnet.js';
 import { TESTNET_ACCOUNT } from './deployments/testnet.js';
 import type { NetworkArg } from './deployments/index.js';
 
@@ -53,9 +54,10 @@ export interface AccountConfig extends GeneratedAccountConfig {
  */
 export function getAccountConfig(network: NetworkArg): AccountConfig {
 	if (network === 'testnet') return TESTNET_ACCOUNT;
+	if (network === 'mainnet') return MAINNET_ACCOUNT;
 	throw new Error(
 		`@mysten/deepbook-v3/account: no account deployment recorded for network '${network}'. ` +
-			'The account primitive is testnet-only today; for your own deployment pass ' +
+			'The account primitive is recorded for testnet and mainnet; for your own deployment pass ' +
 			'`{ accountPackageId, accountRegistry }` to AccountContract directly.',
 	);
 }

package/src/contracts/deepbook_predict/builder_code.ts

@@ -3,7 +3,7 @@
  **************************************************************/
 
 /**
- * Owns deterministic builder referral codes and the DUSDC fees delivered to their
+ * Owns deterministic builder referral codes and the USDC fees delivered to their
  * object addresses through the funds accumulator. Codes are derived per owner and
  * index, and only the immutable owner may withdraw accumulated fees.
  */
@@ -112,7 +112,7 @@ export interface ClaimableBuilderFeesOptions {
 		predictPackageId?: string;
 	};
 }
-/** Return visible DUSDC builder fees for SDK and devInspect reads. */
+/** Return visible USDC builder fees for SDK and devInspect reads. */
 export function claimableBuilderFees(options: ClaimableBuilderFeesOptions) {
 	const packageAddress =
 		options.package ?? options.config?.predictPackageId ?? '@local-pkg/deepbook_predict';
@@ -137,7 +137,7 @@ export interface ClaimAllBuilderFeesOptions {
 	};
 }
 /**
- * Claims all settled DUSDC builder fees for the immutable owner; an empty
+ * Claims all settled USDC builder fees for the immutable owner; an empty
  * accumulator returns a zero coin.
  */
 export function claimAllBuilderFees(options: ClaimAllBuilderFeesOptions) {

package/src/contracts/deepbook_predict/config_events.ts

@@ -50,6 +50,13 @@ export const PlpFeeRatesUpdated = new MoveStruct({
 		onchain_timestamp_ms: U64,
 	},
 });
+export const NoTradeWindowUpdated = new MoveStruct({
+	name: `${$moduleName}::NoTradeWindowUpdated`,
+	fields: {
+		no_trade_window_ms: U64,
+		onchain_timestamp_ms: U64,
+	},
+});
 export const TradingPausedUpdated = new MoveStruct({
 	name: `${$moduleName}::TradingPausedUpdated`,
 	fields: {
@@ -79,9 +86,9 @@ export const MarketCreated = new MoveStruct({
 		tick_size: U64,
 		/** Coarser raw-price step that new finite mint boundaries must align to. */
 		admission_tick_size: U64,
-		/** DUSDC pool allocation cap snapshotted for this expiry. */
+		/** USDC pool allocation cap snapshotted for this expiry. */
 		max_expiry_allocation: U64,
-		/** Minimum DUSDC cash target snapshotted for this expiry. */
+		/** Minimum USDC cash target snapshotted for this expiry. */
 		initial_expiry_cash: U64,
 		backing_buffer_lambda: U64,
 		base_fee: U64,

package/src/contracts/deepbook_predict/deps/sui/vec_map.ts

@@ -0,0 +1,33 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+import { type BcsType, bcs } from '@mysten/sui/bcs';
+import { MoveStruct } from '../../../utils/index.js';
+const $moduleName = '0x2::vec_map';
+/** An entry in the map */
+export function Entry<K extends BcsType<any>, V extends BcsType<any>>(...typeParameters: [K, V]) {
+	return new MoveStruct({
+		name: `${$moduleName}::Entry<${typeParameters[0].name as K['name']}, ${typeParameters[1].name as V['name']}>`,
+		fields: {
+			key: typeParameters[0],
+			value: typeParameters[1],
+		},
+	});
+}
+/**
+ * A map data structure backed by a vector. The map is guaranteed not to contain
+ * duplicate keys, but entries are _not_ sorted by key--entries are included in
+ * insertion order. All operations are O(N) in the size of the map--the intention
+ * of this data structure is only to provide the convenience of programming against
+ * a map API. Large maps should use handwritten parent/child relationships instead.
+ * Maps that need sorted iteration rather than insertion order iteration should
+ * also be handwritten.
+ */
+export function VecMap<K extends BcsType<any>, V extends BcsType<any>>(...typeParameters: [K, V]) {
+	return new MoveStruct({
+		name: `${$moduleName}::VecMap<${typeParameters[0].name as K['name']}, ${typeParameters[1].name as V['name']}>`,
+		fields: {
+			contents: bcs.vector(Entry(typeParameters[0], typeParameters[1])),
+		},
+	});
+}

package/src/contracts/deepbook_predict/expiry_cash.ts

@@ -3,7 +3,7 @@
  **************************************************************/
 
 /**
- * Expiry-local DUSDC custody and isolated reserve accounting.
+ * Expiry-local USDC custody and isolated reserve accounting.
  *
  * This leaf owns cash balance arithmetic and the inventory-impact escrow used only
  * for live-close rebates. It does not decide payment eligibility, pool allocation,

package/src/contracts/deepbook_predict/expiry_market.ts

@@ -19,14 +19,24 @@ import {
 	type RawTransactionArgument,
 	type ConfigValue,
 } from '../utils/index.js';
-import { bcs } from '@mysten/sui/bcs';
 import { U64 } from '../../bcs/integers.js';
+import { bcs } from '@mysten/sui/bcs';
 import { type Transaction, type TransactionArgument } from '@mysten/sui/transactions';
 import * as expiry_cash from './expiry_cash.js';
 import * as balance from './deps/sui/balance.js';
 import * as strike_exposure from './strike_exposure.js';
 import * as ewma from './ewma.js';
 const $moduleName = '@local-pkg/deepbook_predict::expiry_market';
+export const ValuationStamp = new MoveStruct({
+	name: `${$moduleName}::ValuationStamp`,
+	fields: {
+		flush_seq: U64,
+		/** `cash.balance()` at the snapshot instant. */
+		snapshot_cash: U64,
+		/** `cash.inventory_impact_reserve()` at the snapshot instant. */
+		snapshot_impact_reserve: U64,
+	},
+});
 export const ExpiryMarket = new MoveStruct({
 	name: `${$moduleName}::ExpiryMarket`,
 	fields: {
@@ -34,9 +44,9 @@ export const ExpiryMarket = new MoveStruct({
 		/** Propbook underlying this market was created for. */
 		propbook_underlying_id: bcs.u32(),
 		expiry: U64,
-		/** DUSDC custody and payout backing. */
+		/** USDC custody and payout backing. */
 		cash: expiry_cash.ExpiryCash,
-		/** Sponsor-funded DUSDC available to subsidize this market's taker fees. */
+		/** Sponsor-funded USDC available to subsidize this market's taker fees. */
 		fee_incentive_balance: balance.Balance,
 		/** Exposure lifecycle state for this expiry's strike ticks. */
 		strike_exposure: strike_exposure.StrikeExposure,
@@ -48,6 +58,14 @@ export const ExpiryMarket = new MoveStruct({
 		 * through the registry (ungated kill switch).
 		 */
 		mint_paused: bcs.bool(),
+		/**
+		 * `Some` from the flush's snapshot stage until this market's `value_expiry` (or
+		 * lazily discarded once the stamp goes stale — see `ValuationStamp`). Trading is
+		 * never gated on it and never touches it: the cash rows are captured eagerly here
+		 * at the snapshot instant, and the payout tree captures its own boundary shadows
+		 * as trades first touch each node.
+		 */
+		valuation_stamp: bcs.option(ValuationStamp),
 	},
 });
 export const MintQuote = new MoveStruct({
@@ -224,7 +242,7 @@ export interface CashBalanceOptions {
 		predictPackageId?: string;
 	};
 }
-/** Return expiry DUSDC custody for SDK and devInspect state reads. */
+/** Return expiry USDC custody for SDK and devInspect state reads. */
 export function cashBalance(options: CashBalanceOptions) {
 	const packageAddress =
 		options.package ?? options.config?.predictPackageId ?? '@local-pkg/deepbook_predict';
@@ -396,7 +414,7 @@ export interface InventoryImpactScaleOptions {
 	};
 }
 /**
- * Return the immutable DUSDC scale of this market's inventory-impact curve for SDK
+ * Return the immutable USDC scale of this market's inventory-impact curve for SDK
  * and devInspect state reads.
  */
 export function inventoryImpactScale(options: InventoryImpactScaleOptions) {
@@ -614,6 +632,45 @@ export function loadLivePricer(options: LoadLivePricerOptions) {
 			),
 		});
 }
+export interface IsPendingValuationArguments {
+	market: RawTransactionArgument<string>;
+	config?: RawTransactionArgument<string>;
+}
+export interface IsPendingValuationOptions {
+	package?: string;
+	arguments: IsPendingValuationArguments;
+	config?: {
+		protocolConfig: ConfigValue;
+		predictPackageId?: string;
+	};
+}
+/**
+ * Return whether this market is snapshotted into the in-flight flush and still
+ * awaiting its `value_expiry`. For SDK, keeper, and devInspect reads. It gates
+ * nothing: settlement and trading both run regardless — the frozen mark is
+ * settlement-invariant, so a stamped market settles the instant it expires. Do not
+ * defer a settlement attempt on this read.
+ */
+export function isPendingValuation(options: IsPendingValuationOptions) {
+	const packageAddress =
+		options.package ?? options.config?.predictPackageId ?? '@local-pkg/deepbook_predict';
+	const argumentsTypes = [null, null] satisfies (string | null)[];
+	const parameterNames = ['market', 'config'];
+	return (tx: Transaction) =>
+		tx.moveCall({
+			package: packageAddress,
+			module: 'expiry_market',
+			function: 'is_pending_valuation',
+			arguments: normalizeMoveArguments(
+				{
+					...options.arguments,
+					config: options.arguments?.config ?? options.config?.protocolConfig,
+				},
+				argumentsTypes,
+				parameterNames,
+			),
+		});
+}
 export interface CurrentNavArguments {
 	market: RawTransactionArgument<string>;
 	pricer: TransactionArgument;
@@ -1118,7 +1175,7 @@ export interface MintExactQuantityOptions {
  * withdraw through the loaded account. The position's strike range is the tick
  * pair `(lower_tick, higher_tick]` (`lower_tick = 0` is `-inf`,
  * `higher_tick = pos_inf_tick` is `+inf`); the SDK converts raw strikes to ticks.
- * `max_cost` caps the all-in DUSDC withdrawal, while `max_probability` caps the
+ * `max_cost` caps the all-in USDC withdrawal, while `max_probability` caps the
  * quoted per-contract probability before fees. Callers can pass
  * `std::u64::max_value!()` for either uncapped guard. Returns the minted order ID
  * for future order-scoped flows.
@@ -1193,12 +1250,12 @@ export interface MintExactAmountOptions {
  * must meet `min_quantity`.
  *
  * Fees, builder fees, and EWMA congestion penalties are charged on top of
- * `max_premium`, so `max_cost` — not `max_premium` — bounds the all-in DUSDC
+ * `max_premium`, so `max_cost` — not `max_premium` — bounds the all-in USDC
  * withdrawal (`premium + trader-paid fee + builder_fee + EWMA penalty`).
  * `max_cost` is required: unlike `mint_exact_quantity`'s guards there is no value
  * that disables it, because the budget shape exists to bound spend. The sizing
- * budget is first capped to the account's available DUSDC after settlement; fees
- * still require additional available DUSDC at payment time. Any unspent premium
+ * budget is first capped to the account's available USDC after settlement; fees
+ * still require additional available USDC at payment time. Any unspent premium
  * dust remains in the account because order quantity must be an integer number of
  * `position_lot_size` lots.
  */
@@ -1275,7 +1332,7 @@ export interface RedeemLiveOptions {
  * Two close-side slippage floors, the mirror of mint's `max_probability` /
  * `max_cost` pair; pass `0` to disable either. `min_probability` floors the quoted
  * per-contract range probability (same units as mint's `max_probability`).
- * `min_proceeds` floors the all-in net DUSDC credited to the account
+ * `min_proceeds` floors the all-in net USDC credited to the account
  * (`redeem_amount` minus trading fee, builder fee, and EWMA penalty), the mirror
  * of mint's all-in `max_cost`.
  */
@@ -1440,7 +1497,9 @@ export interface SetReferenceTickOptions {
  * Set this expiry's reference fine-grid tick from the exact previous-window
  * Propbook Pyth observation. The source observation must be inserted into the feed
  * at `reference_tick_source_timestamp_ms` before this call, and the normalized
- * spot is floored to the market's `tick_size`.
+ * spot is floored to the market's `tick_size`. Not gated on the valuation lock:
+ * the reference tick shapes mint admission only, and a mint it admits mid-flush is
+ * invisible to the captured snapshot like any other.
  */
 export function setReferenceTick(options: SetReferenceTickOptions) {
 	const packageAddress =

package/src/contracts/deepbook_predict/market_lifecycle_cap.ts

@@ -3,10 +3,9 @@
  **************************************************************/
 
 /**
- * Defines revocable authority for market creation and coordinated pool valuation
- * without granting oracle-write or root-admin power. `Registry` owns the allowlist
- * and converts a valid capability into the ability-less proof consumed by
- * cross-module lifecycle flows.
+ * Defines revocable authority for market creation without granting pool-valuation,
+ * oracle-write, or root-admin power. `Registry` owns the allowlist and the
+ * creation entrypoint this capability gates.
  */
 
 import { MoveStruct, normalizeMoveArguments, type RawTransactionArgument } from '../utils/index.js';
@@ -19,12 +18,6 @@ export const MarketLifecycleCap = new MoveStruct({
 		id: bcs.Address,
 	},
 });
-export const MarketLifecycleProof = new MoveStruct({
-	name: `${$moduleName}::MarketLifecycleProof`,
-	fields: {
-		dummy_field: bcs.bool(),
-	},
-});
 export interface IdArguments {
 	cap: RawTransactionArgument<string>;
 }

package/src/contracts/deepbook_predict/market_manager.ts

@@ -40,12 +40,12 @@ export const CadenceConfig = new MoveStruct({
 		/** Coarser raw-price step that new finite mint boundaries must align to. */
 		admission_tick_size: U64,
 		/**
-		 * DUSDC pool allocation cap snapshotted into pool accounting for each created
+		 * USDC pool allocation cap snapshotted into pool accounting for each created
 		 * expiry.
 		 */
 		max_expiry_allocation: U64,
 		/**
-		 * Minimum DUSDC cash target snapshotted into pool accounting for each created
+		 * Minimum USDC cash target snapshotted into pool accounting for each created
 		 * expiry.
 		 */
 		initial_expiry_cash: U64,