@mysten/deepbook-v3 2.1.3 → 2.3.0

package/package.json

@@ -2,7 +2,7 @@
   "name": "@mysten/deepbook-v3",
   "author": "Mysten Labs <build@mystenlabs.com>",
   "description": "Sui Deepbook SDK",
-  "version": "2.1.3",
+  "version": "2.3.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.28.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,

package/src/contracts/deepbook_predict/order_events.ts

@@ -36,14 +36,14 @@ export const OrderMinted = new MoveStruct({
 		/** 1e9-scaled range probability quoted at entry. */
 		entry_probability: U64,
 		quantity: U64,
-		/** Premium the user paid into LP backing, in DUSDC base units. */
+		/** Premium the user paid into LP backing, in USDC base units. */
 		premium: U64,
 		/** Full trading fee assessed for the mint, including any sponsor-paid subsidy. */
 		trading_fee: U64,
 		/** Portion of `trading_fee` paid from expiry-local fee incentives. */
 		fee_incentive_subsidy: U64,
 		builder_fee: U64,
-		/** EWMA gas-price congestion surcharge assessed for the mint, in DUSDC base units. */
+		/** EWMA gas-price congestion surcharge assessed for the mint, in USDC base units. */
 		penalty_fee: U64,
 		/**
 		 * Portion of the trader-paid trading fee and congestion surcharge delivered to the
@@ -62,8 +62,8 @@ export const OrderMinted = new MoveStruct({
 		onchain_timestamp_ms: U64,
 		/**
 		 * Oracle source timestamps present when this mint was priced: Pyth's canonical
-		 * source time and the Block Scholes batch-envelope times used for freshness. The
-		 * SVI one is also the roll-down anchor. Pyth is `0` only when unusable.
+		 * source time and the Block Scholes per-update source times used for freshness.
+		 * The SVI one is also the roll-down anchor. Pyth is `0` only when unusable.
 		 */
 		pyth_spot_source_timestamp_ms: U64,
 		block_scholes_spot_source_timestamp_ms: U64,
@@ -92,7 +92,7 @@ export const LiveOrderRedeemed = new MoveStruct({
 		redeem_amount: U64,
 		trading_fee: U64,
 		builder_fee: U64,
-		/** EWMA gas-price congestion surcharge retained by the pool, in DUSDC base units. */
+		/** EWMA gas-price congestion surcharge retained by the pool, in USDC base units. */
 		penalty_fee: U64,
 		/** Separate inventory-impact rebate paid from its isolated escrow. */
 		inventory_impact_rebate: U64,
@@ -104,7 +104,7 @@ export const LiveOrderRedeemed = new MoveStruct({
 		onchain_timestamp_ms: U64,
 		/**
 		 * Oracle source timestamps present when this redemption was priced: Pyth's
-		 * canonical source time and the Block Scholes batch-envelope times used for
+		 * canonical source time and the Block Scholes per-update source times used for
 		 * freshness. The SVI one is also the roll-down anchor. Pyth is `0` only when
 		 * unusable.
 		 */