@mysten/deepbook-v3 2.1.4 → 2.4.0

package/src/predict/config/types.ts

@@ -34,7 +34,13 @@ export interface PredictConfig {
 		oracleRegistry: string;
 		accountRegistry: string;
 	};
-	quoteCoinType: string; // DUSDC on testnet
+	/**
+	 * The deployment's settlement coin type. Always read this rather than assuming a type:
+	 * the contracts renamed the collateral to `usdc::usdc::USDC`, but a deployment published
+	 * before that rename still serves its original coin type, and this field is what the
+	 * deployment record actually carries.
+	 */
+	quoteCoinType: string;
 	/**
 	 * Coin types the deployment owns. `plp` is NOT derivable from `packages.predict`: a Move
 	 * type tag keeps the ORIGINAL package id across an upgrade, while `packages.predict`

package/src/predict/index.ts

@@ -2,8 +2,8 @@
 // SPDX-License-Identifier: Apache-2.0
 // Public API for `@mysten/deepbook-v3/predict`. The curated surface is the `PredictClient`
 // facade plus the value types, unit conversions, tick helpers, typed errors, and typed
-// execution-result decoders — and the few primitives below that compose predict
-// accounts into PTBs on FOREIGN packages, which no facade shape can cover.
+// execution-result decoders — and, for composing your own PTBs, the few primitives below
+// that compose predict accounts with FOREIGN packages plus the generated move-call bindings.
 
 // === Facade === (register as a client extension: `client.$extend(predict({ network }))`)
 export { POSITION_LOT_SIZE, PredictClient, predict } from './client.js';
@@ -16,6 +16,8 @@ export type {
 	MintAmountOptions,
 	MintOptions,
 	MintQuote,
+	PlpSupplyOptions,
+	PlpWithdrawOptions,
 	PoolSummary,
 	RedeemQuote,
 } from './client.js';
@@ -28,12 +30,39 @@ export type {
 // shared account primitive — reach for its `AccountContract` to drive it directly.
 export { deriveAccountWrapperId, generateAuth } from './tx/common.js';
 
+// === Move-call bindings === the generated transaction thunks for every Predict module with a
+// callable function, for putting Predict calls into a PTB you are building — each facade `tx.*`
+// builder returns a finished `Transaction` instead. Mirrors `/account`'s `accountMoveCalls`. Pass
+// `config: toGeneratedConfig(cfg)` and the shared objects fill themselves in; owner-authorized
+// calls take an `Auth` from `generateAuth(cfg)`. Each namespace also carries its module's BCS
+// structs; the `*Events` namespaces are event layouts only.
+export * as adminMoveCalls from '../contracts/deepbook_predict/admin.js';
+export * as builderCodeMoveCalls from '../contracts/deepbook_predict/builder_code.js';
+export * as expiryMarketMoveCalls from '../contracts/deepbook_predict/expiry_market.js';
+export * as marketLifecycleCapMoveCalls from '../contracts/deepbook_predict/market_lifecycle_cap.js';
+export * as marketManagerMoveCalls from '../contracts/deepbook_predict/market_manager.js';
+export * as pauseCapMoveCalls from '../contracts/deepbook_predict/pause_cap.js';
+export * as plpMoveCalls from '../contracts/deepbook_predict/plp.js';
+export * as poolValuationCapMoveCalls from '../contracts/deepbook_predict/pool_valuation_cap.js';
+export * as predictAccountMoveCalls from '../contracts/deepbook_predict/predict_account.js';
+export * as pricingMoveCalls from '../contracts/deepbook_predict/pricing.js';
+export * as protocolConfigMoveCalls from '../contracts/deepbook_predict/protocol_config.js';
+export * as rangeCodecMoveCalls from '../contracts/deepbook_predict/range_codec.js';
+export * as registryMoveCalls from '../contracts/deepbook_predict/registry.js';
+export * as builderCodeEvents from '../contracts/deepbook_predict/builder_code_events.js';
+export * as configEvents from '../contracts/deepbook_predict/config_events.js';
+export * as orderEvents from '../contracts/deepbook_predict/order_events.js';
+export * as vaultEvents from '../contracts/deepbook_predict/vault_events.js';
+
 // === Config ===
 export {
+	MAINNET_CONFIG,
 	TESTNET_CONFIG,
 	getConfig,
 	getDeployment,
 	getUnits,
+	MAINNET_DEPLOYMENT,
+	MAINNET_UNITS,
 	TESTNET_DEPLOYMENT,
 	TESTNET_UNITS,
 } from './config/index.js';

package/src/predict/pricing.ts

@@ -1,7 +1,9 @@
 // Copyright (c) Mysten Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
-// Faithful float port of the deployed `deepbook_predict::pricing::compute_nd2`
-// (testnet `predict-testnet-8-21`, sourceCommit 1f79fe87) — the SVI-adjusted digital
+// Faithful float port of `deepbook_predict::pricing::compute_nd2` as of the anchor the
+// generated bindings are pinned to (`sui-codegen.config.ts`: the `deepbook-predict-testnet`
+// deployment). `pricing.move` is untouched across the anchors this SDK has used, so the
+// formula is unchanged from earlier deployments — the SVI-adjusted digital
 // probability, WITH the skew-correction term. It operates on the pricer's
 // ALREADY-RESOLVED forward and ALREADY-ROLLED-DOWN SVI, exactly as `load_live_pricer`
 // returns them (decoded by `reads/pricing.ts`). So the two on-chain steps that pick the
@@ -16,7 +18,7 @@
 // sits at its floor (float64 here is the more precise side, not the less); negligible for
 // display. `tests/testnet/pricing.test.ts` bounds it live against the deployment.
 //
-// The on-chain formula (pricing.move `compute_nd2`, 1f79fe87):
+// The on-chain formula (pricing/pricing.move `compute_nd2`):
 //   k  = ln(strike / forward)
 //   x  = k - m
 //   w  = a + b·(ρ·x + √(x² + σ²))            // a, b already rolled down
@@ -146,12 +148,12 @@ export function strikeAtProbability(inputs: PricerInputs, p: number): number | n
 
 /** Roll `a` and `b` down by the fraction of anchored time remaining, matching the chain's
  * `roll_down_svi` (variance decays toward expiry). `remainingMs` = expiry − now;
- * `anchorTteMs` = expiry − the SVI observation's **batch envelope time** — the same clock the
- * freshness gate uses, and what the chain anchors on. It is NOT the provider's calibration
- * (model) time, which stays on the stored observation: using that rolls by the wrong
- * fraction. `read.pricer` avoids the question entirely (the chain has already rolled).
- * `rho`, `m`, `sigma` are unchanged. Feed an UNrolled provider surface; the result is what {@link upProbability}
- * expects. */
+ * `anchorTteMs` = expiry − the SVI observation's **provider `svi_timestamp`** (its per-update
+ * source timestamp) — the same clock the freshness gate accepts, and what the chain anchors on
+ * (`pricing.move`: "One clock serves every job"). Anchoring on the batch's ingestion time
+ * instead rolls by the wrong fraction. `read.pricer` avoids the question entirely (the chain
+ * has already rolled). `rho`, `m`, `sigma` are unchanged. Feed an UNrolled provider surface;
+ * the result is what {@link upProbability} expects. */
 export function rollDown(svi: Svi, remainingMs: number, anchorTteMs: number): Svi {
 	const frac = anchorTteMs > 0 ? remainingMs / anchorTteMs : 0;
 	return { ...svi, a: svi.a * frac, b: svi.b * frac };

package/src/predict/reads/balances.ts

@@ -9,7 +9,7 @@ import { inspectReturns, type ReadClient } from './inspect.js';
 import { parseU64LE } from './parse.js';
 
 // An owner's stored account balance for `coinType` (the deployment's quote coin,
-// DUSDC on testnet, unless the caller asks for another). Chains `account::load_account(wrapper)` →
+// USDC on testnet, unless the caller asks for another). Chains `account::load_account(wrapper)` →
 // `account::balance<T>(account, root, clock)`; the u64 is command 1's return —
 // see packages/account/sources/account.move:{80,86}. The clock is auto-injected by
 // the generated `balance` wrapper; the wrapper id is derived off-chain (no read).

package/src/predict/reads/markets.ts

@@ -28,7 +28,7 @@ export async function activeMarketIds(
 
 // The expiry market id for one underlying at one expiry, or null if none exists.
 // `registry::expiry_market_id(registry, propbook_underlying_id: u32, expiry: u64):
-// Option<ID>` — see packages/predict/sources/registry/registry.move:53.
+// Option<ID>` — see packages/predict/sources/registry/registry.move:58.
 export async function expiryMarketId(
 	client: ReadClient,
 	config: GeneratedConfig,

package/src/predict/reads/pricing.ts

@@ -23,7 +23,8 @@ const i64 = (v: { magnitude: string | number | bigint; is_negative: boolean }):
 /** A resolved pricer snapshot read from the chain: the decimal forward + rolled SVI the
  * client-side math consumes, plus the oracle source timestamps behind it (ms; for
  * staleness display — Pyth is 0 when no usable spot existed). The Block-Scholes entries are
- * batch ENVELOPE times (what freshness and the SVI roll-down anchor on), not model times. */
+ * the provider's PER-UPDATE source timestamps (`value_timestamp` for spot/forward,
+ * `svi_timestamp` for SVI) — the clocks freshness and the SVI roll-down anchor on. */
 export interface PricerSnapshot extends PricerInputs {
 	sources: {
 		pythSpotMs: number;

package/src/sessions.ts

@@ -4,6 +4,7 @@ import { bcs } from '@mysten/sui/bcs';
 import type { Transaction, TransactionArgument, TransactionResult } from '@mysten/sui/transactions';
 import { deriveDynamicFieldID, deriveObjectID } from '@mysten/sui/utils';
 
+import { MAINNET_SESSIONS } from './deployments/mainnet.js';
 import { TESTNET_SESSIONS } from './deployments/testnet.js';
 import type { NetworkArg } from './deployments/index.js';
 
@@ -69,9 +70,11 @@ export function getSessionsConfig(
 	// The frozen record itself, matching `/account` — returning a spread here would have
 	// quietly exempted this subpath from the immutability the others guarantee.
 	if (network === 'testnet') return TESTNET_SESSIONS;
+	if (network === 'mainnet') return MAINNET_SESSIONS;
 	throw new Error(
 		`@mysten/deepbook-v3/sessions: no sessions deployment recorded for network '${network}'. ` +
-			'Sessions is testnet-only today; for your own deployment construct a `SessionsConfig` ' +
+			'Sessions is recorded for testnet and mainnet; for your own deployment construct a ' +
+			'`SessionsConfig` ' +
 			'and pass it to SessionsContract directly.',
 	);
 }