@mysten/deepbook-v3 2.1.3 → 2.3.0

package/src/contracts/propbook/block_scholes_store.ts

@@ -23,29 +23,16 @@ import { type Transaction, type TransactionArgument } from '@mysten/sui/transact
 import * as table from './deps/sui/table.js';
 const $moduleName = '@local-pkg/propbook::block_scholes_store';
 /**
- * One accepted observation and the three clocks that describe it. The clocks
- * answer different questions and are not interchangeable: a calibration that has
- * not changed republishes under its original model time, so only
- * `source_timestamp_ms` distinguishes a quiet feed from a stopped one.
+ * One accepted observation paired with its signed source time and on-chain
+ * recording time.
  */
 export function BsRead<Value extends BcsType<any>>(...typeParameters: [Value]) {
 	return new MoveStruct({
 		name: `${$moduleName}::BsRead<${typeParameters[0].name as Value['name']}>`,
 		fields: {
 			/**
-			 * Provider calibration time — when the series was last re-derived, held fixed
-			 * across republishes of that calibration. The provider's per-series replay key:
-			 * ordering keys on this first. The published VALUES are as-of the envelope time:
-			 * per the provider contract, an SVI publish whose model time is unchanged carries
-			 * the same calibration already rolled down to its new publish time, never
-			 * duplicate data.
-			 */
-			model_timestamp_ms: U64,
-			/**
-			 * Envelope time of the batch this observation arrived in, advancing on every
-			 * provider flush and never regressing once stored (see `apply`). The economic
-			 * clock: consumers gate freshness on it and the SVI roll-down anchors on it, so a
-			 * republished unchanged value is re-asserted as current at its new envelope time.
+			 * Provider value/SVI time in Unix milliseconds. Latest ordering, exact history,
+			 * freshness, and SVI roll-down all key on this clock.
 			 */
 			source_timestamp_ms: U64,
 			/** Sui clock time when the accepting transaction executed. */
@@ -135,7 +122,7 @@ export const BlockScholesBatchIngested = new MoveStruct({
 		propbook_oracle_id: bcs.Address,
 		/** `0` = spot, `1` = forward, and `2` = SVI. */
 		series_kind: bcs.u8(),
-		source_timestamp_ms: U64,
+		batch_timestamp_ms: U64,
 		/** Sui clock time when the batch ingestion transaction executed. */
 		onchain_timestamp_ms: U64,
 		/** Verified observations carried by the batch. */
@@ -366,8 +353,8 @@ export interface SpotAtOptions {
 		  ];
 }
 /**
- * Returns the canonical spot observation published at exactly
- * `source_timestamp_ms`.
+ * Returns the canonical spot observation whose provider source timestamp is
+ * exactly `source_timestamp_ms`.
  */
 export function spotAt(options: SpotAtOptions) {
 	const packageAddress = options.package ?? '@local-pkg/propbook';
@@ -427,27 +414,6 @@ export function svi(options: SviOptions) {
 			arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
 		});
 }
-export interface ReadModelTimestampMsArguments {
-	read: TransactionArgument;
-}
-export interface ReadModelTimestampMsOptions {
-	package?: string;
-	arguments: ReadModelTimestampMsArguments | [read: TransactionArgument];
-	typeArguments: [string];
-}
-export function readModelTimestampMs(options: ReadModelTimestampMsOptions) {
-	const packageAddress = options.package ?? '@local-pkg/propbook';
-	const argumentsTypes = [null] satisfies (string | null)[];
-	const parameterNames = ['read'];
-	return (tx: Transaction) =>
-		tx.moveCall({
-			package: packageAddress,
-			module: 'block_scholes_store',
-			function: 'read_model_timestamp_ms',
-			arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
-			typeArguments: options.typeArguments,
-		});
-}
 export interface ReadSourceTimestampMsArguments {
 	read: TransactionArgument;
 }
@@ -717,7 +683,7 @@ export interface InsertAtOptions {
 }
 /**
  * Insert the canonical spot batch into exact minute-boundary history without
- * changing `latest`. A valid batch whose signed `source_timestamp_ms` is not a
+ * changing `latest`. A valid batch whose spot update source timestamp is not a
  * minute boundary, or whose spot is zero or wider than `u64`, is ignored without
  * aborting. The first admissible observation at a boundary owns the key and cannot
  * be replaced.

package/src/deployments/index.ts

@@ -12,6 +12,13 @@
 
 import type { SuiClientTypes } from '@mysten/sui/client';
 
+import {
+	MAINNET_ACCOUNT,
+	MAINNET_DEPLOYMENT,
+	MAINNET_PREDICT,
+	MAINNET_SESSIONS,
+	MAINNET_UNITS,
+} from './mainnet.js';
 import {
 	TESTNET_ACCOUNT,
 	TESTNET_DEPLOYMENT,
@@ -30,9 +37,10 @@ export type {
 } from './types.js';
 
 export { TESTNET_ACCOUNT, TESTNET_DEPLOYMENT, TESTNET_PREDICT, TESTNET_SESSIONS, TESTNET_UNITS };
+export { MAINNET_ACCOUNT, MAINNET_DEPLOYMENT, MAINNET_PREDICT, MAINNET_SESSIONS, MAINNET_UNITS };
 
-/** Networks this package carries ids for. Predict and sessions are testnet-only so far. */
-export type DeployedNetwork = 'testnet';
+/** Networks this package carries ids for. */
+export type DeployedNetwork = 'testnet' | 'mainnet';
 
 /**
  * Accepts the same wide network type the Sui client exposes, so `getUnits(client.network)`
@@ -45,7 +53,7 @@ export type NetworkArg = SuiClientTypes.Network;
 function unrecorded(network: string, override: string): Error {
 	return new Error(
 		`@mysten/deepbook-v3: no deployment recorded for network '${network}'. ` +
-			'Predict, sessions and the account primitive are testnet-only today. ' +
+			'Predict, sessions and the account primitive are recorded for testnet and mainnet. ' +
 			`For your own deployment, ${override}`,
 	);
 }
@@ -58,6 +66,7 @@ function unrecorded(network: string, override: string): Error {
  */
 export function getDeployment(network: NetworkArg): DeploymentInfo {
 	if (network === 'testnet') return TESTNET_DEPLOYMENT;
+	if (network === 'mainnet') return MAINNET_DEPLOYMENT;
 	throw unrecorded(network, 'read the deployment name and commit from your own deploy manifest.');
 }
 
@@ -69,5 +78,6 @@ export function getDeployment(network: NetworkArg): DeploymentInfo {
  */
 export function getUnits(network: NetworkArg): DeploymentUnits {
 	if (network === 'testnet') return TESTNET_UNITS;
+	if (network === 'mainnet') return MAINNET_UNITS;
 	throw unrecorded(network, 'read these scale constants from your own deploy manifest.');
 }

package/src/deployments/mainnet.ts

@@ -0,0 +1,107 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+// GENERATED by `pnpm sync-deployment` from the deploy tooling's own manifest
+// (`packages/predict/deployment/deployment.mainnet.json`). Do not hand-edit:
+// the next regeneration overwrites it, and a hand-patched id is exactly the drift this
+// file exists to prevent. To move to a new deployment, check the sibling deepbookv3
+// checkout out to the new anchor and re-run the script.
+//
+// Deployment: deepbook-predict-mainnet
+// sourceCommit: 14a7e8f822e0397df2d61fbfbce3ef21086891c2
+//
+// Runtime-dependency-free — every subpath reads a slice of this, so a value import here
+// would pull that module into all of their graphs. The type import below is erased.
+//
+// Frozen: these are shared module singletons, so an accessor handing one to a caller who
+// mutates it would change what every other caller sees.
+
+import type {
+	AccountIds,
+	DeploymentInfo,
+	DeploymentUnits,
+	PredictIds,
+	SessionsIds,
+} from './types.js';
+
+/** Which on-chain deployment the ids below came from. */
+export const MAINNET_DEPLOYMENT: DeploymentInfo = Object.freeze({
+	deployment: 'deepbook-predict-mainnet',
+	network: 'mainnet',
+	chainId: '35834a8a',
+	sourceCommit: '14a7e8f822e0397df2d61fbfbce3ef21086891c2',
+});
+
+/** Ids for the shared `account` primitive — the `/account` subpath's slice. */
+export const MAINNET_ACCOUNT: AccountIds = Object.freeze({
+	accountPackageId: '0xa6f1b22aaeb429f6fd8f01c13f605256e00876457fd122da8a0e2c1045c75929',
+	accountRegistry: '0x210ba485d973b5356e9078318837137efabdd5ffb9eeb3705ba7eef3340324fc',
+});
+
+/**
+ * Ids for time-limited sessions — the `/sessions` subpath's slice.
+ *
+ * `deepbookRegistry` is only needed by the DeepBook **spot** session wrappers; the Predict
+ * wrappers never take it. It is carried here so a spot caller does not have to reach into
+ * the package root for one id.
+ */
+export const MAINNET_SESSIONS: SessionsIds = Object.freeze({
+	sessionsPackageId: '0xebfa125baee571c1f8c903c1dd54a5bc57949db82469b836c32eca251756c82a',
+	sessionsConfig: '0x0c5f64365b3bf1f67827d6975893190079cc048247f9ff0b08390aa9ee697c5c',
+	accountPackageId: '0xa6f1b22aaeb429f6fd8f01c13f605256e00876457fd122da8a0e2c1045c75929',
+	accountRegistry: '0x210ba485d973b5356e9078318837137efabdd5ffb9eeb3705ba7eef3340324fc',
+	deepbookRegistry: '0xaf16199a2dff736e9f07a845f23c5da6df6f756eddb631aed9d24a93efc4549d',
+	deepbookCoreAccountPackageId:
+		'0xebcd5b403ee78021e3f78d1c77e2117a676caa8a9754dedb99e7b102b0d81872',
+	/** Required by every Predict session wrapper — they all take `config: &ProtocolConfig`. */
+	protocolConfig: '0x55e8800bcb31b792683ca4385bd533716e2a9721364236a69ee2c3bee61dd8f2',
+});
+
+/**
+ * Scale constants the deployment owns rather than the SDK. Deployment-wide:
+ * `quoteCoinDecimals` and `fixedPointScale` apply to any subpath formatting a custody
+ * balance, not just Predict.
+ */
+export const MAINNET_UNITS: DeploymentUnits = Object.freeze({
+	positionLotSize: 10000,
+	fixedPointScale: 1000000000,
+	quoteCoinDecimals: 6,
+	positionQuantityDecimals: 6,
+});
+
+/** Ids for DeepBook Predict — the `/predict` subpath's slice. */
+export const MAINNET_PREDICT: PredictIds = Object.freeze({
+	network: 'mainnet',
+	packages: Object.freeze({
+		predict: '0x774f9555865a7b96e31ec982f62d5bdf9d74bf57a6468b5ed41340c231afd7df',
+		account: '0xa6f1b22aaeb429f6fd8f01c13f605256e00876457fd122da8a0e2c1045c75929',
+		propbook: '0x2a63e378ab0138cdcb12651a093f3799f8b8e4f6c927ce6de0e8bc7ded0ec49d',
+	}),
+	objects: Object.freeze({
+		registry: '0xc98e430d82bed9f777288061faa1988da705a97db7f0da9f215ab372c53a2362',
+		protocolConfig: '0x55e8800bcb31b792683ca4385bd533716e2a9721364236a69ee2c3bee61dd8f2',
+		poolVault: '0x3f80653bf9324162254d89724276aae7b36ba7c83d4650214afbf266da98f492',
+		oracleRegistry: '0x1ff67a8499b0af7c0fbb26ba82c319be25413af93d9a961ee60f8d1229e7de7c',
+		accountRegistry: '0x210ba485d973b5356e9078318837137efabdd5ffb9eeb3705ba7eef3340324fc',
+	}),
+	quoteCoinType: '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC',
+	/**
+	 * `plp` is the LP share coin type. It is NOT derivable from `packages.predict`: a Move
+	 * type tag keeps the ORIGINAL package id across an upgrade, while `packages.predict`
+	 * moves to the latest. They agree only while predict is at v1.
+	 */
+	coinTypes: Object.freeze({
+		plp: '0x774f9555865a7b96e31ec982f62d5bdf9d74bf57a6468b5ed41340c231afd7df::plp::PLP',
+		deep: '0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP',
+	}),
+	units: MAINNET_UNITS,
+	underlyings: Object.freeze({
+		BTC: Object.freeze({
+			symbol: 'BTC',
+			propbookUnderlyingId: 1,
+			pythFeed: '0x44bd2e00549973bb6a58785836e97ed80b4979e67dc3bf312c997e56053e5376',
+			blockScholesValueStore: '0xe7c83ee4ac0c300d68d8d4c3d265d78287b4767dcbc5f279cd6f210b6248d493',
+			blockScholesSviStore: '0x8e5568aebf490c2adfd4e010a9b4ddcf7c774183f58c98fcd438bae1fc68f561',
+		}),
+	}),
+});

package/src/deployments/testnet.ts

@@ -7,8 +7,8 @@
 // file exists to prevent. To move to a new deployment, check the sibling deepbookv3
 // checkout out to the new anchor and re-run the script.
 //
-// Deployment: predict-testnet-8-21
-// sourceCommit: 1f79fe87ab2f6b9df40cfdc2e647c93f45e6d737
+// Deployment: deepbook-predict-testnet
+// sourceCommit: a928bd2da4b71abf7c4ea6f66abec2763308331e
 //
 // Runtime-dependency-free — every subpath reads a slice of this, so a value import here
 // would pull that module into all of their graphs. The type import below is erased.
@@ -26,16 +26,16 @@ import type {
 
 /** Which on-chain deployment the ids below came from. */
 export const TESTNET_DEPLOYMENT: DeploymentInfo = Object.freeze({
-	deployment: 'predict-testnet-8-21',
+	deployment: 'deepbook-predict-testnet',
 	network: 'testnet',
 	chainId: '4c78adac',
-	sourceCommit: '1f79fe87ab2f6b9df40cfdc2e647c93f45e6d737',
+	sourceCommit: 'a928bd2da4b71abf7c4ea6f66abec2763308331e',
 });
 
 /** Ids for the shared `account` primitive — the `/account` subpath's slice. */
 export const TESTNET_ACCOUNT: AccountIds = Object.freeze({
-	accountPackageId: '0xa94ec89b6cbb3e2609c7ca65bd77885b7513f852922ebdf8e766851fb6f85259',
-	accountRegistry: '0x5682c73d657de1546374e632369a25c82744c8a20e9b4f47e6558e3d4bde88d3',
+	accountPackageId: '0x543139156cb90d1a73df33b5dca37d7c8bdce62506c7874ebc854afd319b98f1',
+	accountRegistry: '0xb889caefe327cbdea58e529e3b9e10dc93f1e661ddef32824d28527edf8d6385',
 });
 
 /**
@@ -46,15 +46,15 @@ export const TESTNET_ACCOUNT: AccountIds = Object.freeze({
  * the package root for one id.
  */
 export const TESTNET_SESSIONS: SessionsIds = Object.freeze({
-	sessionsPackageId: '0xb74170443d6d2d37cbe95c7e530dd4a1605ef714ff4f9e88e27a7ac1455451db',
-	sessionsConfig: '0xdfb8e23246678649cfdd6f3f6610057d5cadd6a8911a21dbe8e34788abbfab93',
-	accountPackageId: '0xa94ec89b6cbb3e2609c7ca65bd77885b7513f852922ebdf8e766851fb6f85259',
-	accountRegistry: '0x5682c73d657de1546374e632369a25c82744c8a20e9b4f47e6558e3d4bde88d3',
+	sessionsPackageId: '0x10c91d168dc4a04357f9d23795a204092ca46e5b97f8b9ef26fea95664d5bb38',
+	sessionsConfig: '0x63cde7c7d846f15c51802ec3d44ba44918658e3155b0d2e0cb26d6fc1b4dadd8',
+	accountPackageId: '0x543139156cb90d1a73df33b5dca37d7c8bdce62506c7874ebc854afd319b98f1',
+	accountRegistry: '0xb889caefe327cbdea58e529e3b9e10dc93f1e661ddef32824d28527edf8d6385',
 	deepbookRegistry: '0x7c256edbda983a2cd6f946655f4bf3f00a41043993781f8674a7046e8c0e11d1',
 	deepbookCoreAccountPackageId:
-		'0xcc9cf1029127e7bda6da4c2ab90164d7bef751783ff13c21c2bb804cec69ebec',
+		'0x2dbb8e6a5b9a8ac6201c7aeff6de0c7e7bca5dcd8d6c16538cb1a7447a298071',
 	/** Required by every Predict session wrapper — they all take `config: &ProtocolConfig`. */
-	protocolConfig: '0x7ef1ac99c2f0a77e7aa2602b5ea7bff68750cff0d80f09bdf827bfb345128f33',
+	protocolConfig: '0xfeda745dfdef2cd9721c2ff1e1de538d103bc6012469d0eec10ea5de67f636d0',
 });
 
 /**
@@ -73,25 +73,25 @@ export const TESTNET_UNITS: DeploymentUnits = Object.freeze({
 export const TESTNET_PREDICT: PredictIds = Object.freeze({
 	network: 'testnet',
 	packages: Object.freeze({
-		predict: '0x421041754244cf0e985fb9c9f5e1f49428caf3df4cde3a7b266d8e18ea63597b',
-		account: '0xa94ec89b6cbb3e2609c7ca65bd77885b7513f852922ebdf8e766851fb6f85259',
-		propbook: '0xd8b402609b1728f60cf20bfaaec5255701df54350ec13e93aac39463b00bf97b',
+		predict: '0x25d075d2de915feda7ab9b8f855afe59cbcd4b2ce96f75324940c810f84da018',
+		account: '0x543139156cb90d1a73df33b5dca37d7c8bdce62506c7874ebc854afd319b98f1',
+		propbook: '0xa04a43dbbfb123feec96691a22809d8a87e9ac37ae9356079c439750145aa92b',
 	}),
 	objects: Object.freeze({
-		registry: '0x3d486bd50bb5bb5450ddbcb4f74776b6135f416c09024a6674ac266e77e1870a',
-		protocolConfig: '0x7ef1ac99c2f0a77e7aa2602b5ea7bff68750cff0d80f09bdf827bfb345128f33',
-		poolVault: '0x2a31f592d8fd3d0781e2233770d02d67797890ac82c3d18796d7eb0997896602',
-		oracleRegistry: '0x715f5ae4aac0078f4d0c6bf9ea2815614e799e909a90b577aeb8de9ad8bab142',
-		accountRegistry: '0x5682c73d657de1546374e632369a25c82744c8a20e9b4f47e6558e3d4bde88d3',
+		registry: '0xd21fab5444128eb65c5f6299564f583db72ad84d17581a4febe68878127100d5',
+		protocolConfig: '0xfeda745dfdef2cd9721c2ff1e1de538d103bc6012469d0eec10ea5de67f636d0',
+		poolVault: '0xd6b96a77d5acfd4f4a660cbd1098ed62abf2317e85a01274d1a4eeef19603767',
+		oracleRegistry: '0xda71af88a8b9d01b6913937a84c5a63bb4e1015a7a2142185ec9ef73f675615f',
+		accountRegistry: '0xb889caefe327cbdea58e529e3b9e10dc93f1e661ddef32824d28527edf8d6385',
 	}),
-	quoteCoinType: '0xe95040085976bfd54a1a07225cd46c8a2b4e8e2b6732f140a0fc49850ba73e1a::dusdc::DUSDC',
+	quoteCoinType: '0xc028557a1ed49e42ed091e115aedefd70a442b184c18fbec5c48d5b6c0b8c184::usdc::USDC',
 	/**
 	 * `plp` is the LP share coin type. It is NOT derivable from `packages.predict`: a Move
 	 * type tag keeps the ORIGINAL package id across an upgrade, while `packages.predict`
 	 * moves to the latest. They agree only while predict is at v1.
 	 */
 	coinTypes: Object.freeze({
-		plp: '0x421041754244cf0e985fb9c9f5e1f49428caf3df4cde3a7b266d8e18ea63597b::plp::PLP',
+		plp: '0x25d075d2de915feda7ab9b8f855afe59cbcd4b2ce96f75324940c810f84da018::plp::PLP',
 		deep: '0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP',
 	}),
 	units: TESTNET_UNITS,
@@ -99,9 +99,9 @@ export const TESTNET_PREDICT: PredictIds = Object.freeze({
 		BTC: Object.freeze({
 			symbol: 'BTC',
 			propbookUnderlyingId: 1,
-			pythFeed: '0xea8fd4624002516b28b495051c838b2c9a34a4f22ae281d328e1bec47f54cd24',
-			blockScholesValueStore: '0x9b64cc860ac09e6dcd675fc579c1048792ddce51cc018f2ca16aeb4a1a5684a3',
-			blockScholesSviStore: '0xd5bc586e99c8d595e0ba5e0a2ef2295e652db8934ffbeda630d60e207bedab8f',
+			pythFeed: '0x7179188b3a27758c53668a4ec09a81be114dea5ffabcf367f4e720a26db8ee59',
+			blockScholesValueStore: '0x77dee47fb870753c740439f436e0c30c00c60f13f171c901125b3d60f89518e5',
+			blockScholesSviStore: '0xe8aa80965d201e2cb18359c3aa315e3abc5bbf807a10a59d6e011ef41be5db7a',
 		}),
 	}),
 });

package/src/deployments/types.ts

@@ -25,7 +25,7 @@ export interface DeploymentInfo {
  *
  * Only `positionLotSize` is currently read by the SDK (`PredictClient#assertLot`); the other
  * three are shipped as the deployment's own record of its scales. `units.ts` still hardcodes
- * the DUSDC and fixed-point decimals, so do not read this as "the SDK derives its scaling
+ * the USDC and fixed-point decimals, so do not read this as "the SDK derives its scaling
  * from here" — wiring that up is separate work.
  */
 export interface DeploymentUnits {

package/src/predict/client.ts

@@ -135,6 +135,29 @@ export interface CloseOptions {
 	quantity: number;
 }
 
+/** Options for `supplyPlp`. */
+export interface PlpSupplyOptions {
+	/**
+	 * Floor on the PLP minted for the whole request, as raw `bigint` shares — PLP is raw
+	 * everywhere in this SDK. It is a floor on the MARK, not a share count: a flush quoting
+	 * less does not fill smaller, it declines. Omitted → `0n`, no floor.
+	 *
+	 * How a miss is handled is the deployment's `lp_request_limit_flush_attempts`: at the
+	 * shipped count of one the first flush below the floor cancels and refunds the request.
+	 */
+	minPlpOut?: bigint;
+}
+
+/** Options for `withdrawPlp`. */
+export interface PlpWithdrawOptions {
+	/**
+	 * Floor on the USDC paid for the whole request, in USD decimals like every other amount
+	 * here. A floor on the MARK, not an amount: a flush quoting less declines rather than
+	 * paying out smaller. Omitted → no floor. Measured after the protocol's withdraw fee.
+	 */
+	minUsdcOut?: number | string;
+}
+
 /** One tradeable market as returned by read.markets(). */
 export interface ActiveMarket {
 	id: string;
@@ -171,7 +194,7 @@ export interface MarketSummary {
 
 /** Aggregate pool figures. Balances in human units (shares raw); the pending fields
  * are request COUNTS, not amounts — the on-chain getters expose queue lengths, and
- * the escrowed DUSDC/PLP behind them is tracked separately. */
+ * the escrowed USDC/PLP behind them is tracked separately. */
 export interface PoolSummary {
 	plpTotalSupply: bigint;
 	idleUsdc: number;
@@ -566,7 +589,7 @@ export class PredictClient {
 		},
 
 		// Withdraw `amountUsdc` from the account back to `owner`. By default the funds land
-		// in the owner's DUSDC *address balance* (the versionless accumulator) via
+		// in the owner's USDC *address balance* (the versionless accumulator) via
 		// `0x2::coin::send_funds` — no coin-object churn, and they merge into the same
 		// balance `deposit` draws from, closing the loop. Pass `{ toCoinObject: true }` to
 		// instead receive a discrete `Coin<T>` object (for wallets/explorers that only
@@ -652,45 +675,52 @@ export class PredictClient {
 		},
 
 		// Queue a supply request pulling `amountUsdc` from the account's existing custody
-		// balance. `request_supply` auto-settles DUSDC then `account.withdraw`s the payment
+		// balance. `request_supply` auto-settles USDC then `account.withdraw`s the payment
 		// into queue escrow; the PLP fill is delivered at the next flush, not returned here.
 		// Command order is auth → request (auth is a hot potato consumed by this call). The
-		// `minPlpOut` slot is the per-request floor on PLP minted at flush — pinned to 0
-		// (no floor) here; after three flushes miss the floor the request is cancelled and
-		// refunded.
-		supplyPlp: (owner: string, amountUsdc: number | string): Transaction =>
+		// `minPlpOut` slot is the per-request floor on PLP minted at flush — `options.minPlpOut`
+		// when given, otherwise 0 (no floor). At the shipped attempt count of one, the first
+		// flush whose mark quotes less cancels and refunds the request; three is the
+		// configurable maximum, not the default.
+		supplyPlp: (
+			owner: string,
+			amountUsdc: number | string,
+			options: PlpSupplyOptions = {},
+		): Transaction =>
 			txOf(
 				requestSupply({
 					config: this.#config,
 					arguments: {
 						wrapper: this.wrapperIdFor(owner),
 						amount: usdcToRaw(amountUsdc),
-						minPlpOut: 0n,
+						minPlpOut: options.minPlpOut ?? 0n,
 					},
 				}),
 			),
 
 		// Queue a withdraw request pulling `shares` (raw PLP u64) from account custody into
 		// queue escrow — the Move parameter is named `amount`, but on `request_withdraw` it
-		// counts PLP SHARES, not DUSDC. Auto-settles flush-delivered PLP first; the DUSDC
+		// counts PLP SHARES, not USDC. Auto-settles flush-delivered PLP first; the USDC
 		// fill lands on the account at the next flush (no `withdraw_settled` entrypoint).
-		// Command order is auth → request. The `minDusdcOut` slot is the per-request floor
-		// on DUSDC paid at flush — pinned to 0 (no floor) here; after three flushes miss the
-		// floor the request is cancelled and refunded.
-		withdrawPlp: (owner: string, shares: bigint): Transaction =>
+		// Command order is auth → request. The `minUsdcOut` slot is the per-request floor
+		// on USDC paid at flush — `options.minUsdcOut` when given, otherwise 0 (no floor).
+		// At the shipped attempt count of one, the first flush whose mark quotes less
+		// cancels and refunds the request; three is the configurable maximum, not the
+		// default.
+		withdrawPlp: (owner: string, shares: bigint, options: PlpWithdrawOptions = {}): Transaction =>
 			txOf(
 				requestWithdraw({
 					config: this.#config,
 					arguments: {
 						wrapper: this.wrapperIdFor(owner),
 						amount: shares,
-						minDusdcOut: 0n,
+						minUsdcOut: options.minUsdcOut === undefined ? 0n : usdcToRaw(options.minUsdcOut),
 					},
 				}),
 			),
 
 		// Cancel a still-pending supply request by queue `index`, refunding its escrowed
-		// DUSDC straight back into the requesting account. Command order is auth → cancel.
+		// USDC straight back into the requesting account. Command order is auth → cancel.
 		cancelSupplyPlp: (owner: string, index: bigint): Transaction =>
 			txOf(
 				cancelSupplyRequest({

package/src/predict/config/index.ts

@@ -1,17 +1,20 @@
 // Copyright (c) Mysten Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
+import { MAINNET_CONFIG } from './mainnet.js';
 import { TESTNET_CONFIG } from './testnet.js';
 import type { PredictConfig } from './types.js';
 import type { NetworkArg } from '../../deployments/index.js';
 
-export { TESTNET_CONFIG };
+export { TESTNET_CONFIG, MAINNET_CONFIG };
 export type { PredictConfig, PredictPackages, UnderlyingConfig } from './types.js';
 
 export function getConfig(network: NetworkArg): PredictConfig {
 	if (network === 'testnet') return TESTNET_CONFIG;
+	if (network === 'mainnet') return MAINNET_CONFIG;
 	throw new Error(
 		`@mysten/deepbook-v3/predict: no Predict deployment recorded for network '${network}'. ` +
-			'Predict is testnet-only today; for your own deployment pass `config` to PredictClient ' +
+			'Predict is recorded for testnet and mainnet; for your own deployment pass `config` to ' +
+			'PredictClient ' +
 			'or `predict({ config })`.',
 	);
 }
@@ -20,6 +23,8 @@ export function getConfig(network: NetworkArg): PredictConfig {
 export {
 	getDeployment,
 	getUnits,
+	MAINNET_DEPLOYMENT,
+	MAINNET_UNITS,
 	TESTNET_DEPLOYMENT,
 	TESTNET_UNITS,
 } from '../../deployments/index.js';

package/src/predict/config/mainnet.ts

@@ -0,0 +1,27 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+import { MAINNET_PREDICT } from '../../deployments/mainnet.js';
+import type { PredictConfig } from './types.js';
+
+/**
+ * Mainnet deployment constants, read from the shared generated record in
+ * `src/deployments/` rather than transcribed here. `/account` and `/sessions` read slices of
+ * that same record, so a redeploy (`pnpm sync-deployment`) moves every subpath together and
+ * they cannot end up addressing different deployments.
+ *
+ * The record is generated from the deploy tooling's `deployment.mainnet.json`; see
+ * `scripts/sync-deployment.ts`. `getDeployment('mainnet')` names the deployment and the
+ * deepbookv3 commit these ids came from.
+ */
+export const MAINNET_CONFIG: PredictConfig = Object.freeze({
+	// The record widens `network` to `string` so the published types don't pin a literal;
+	// this file is the mainnet config by construction.
+	network: 'mainnet',
+	packages: MAINNET_PREDICT.packages,
+	objects: MAINNET_PREDICT.objects,
+	quoteCoinType: MAINNET_PREDICT.quoteCoinType,
+	coinTypes: MAINNET_PREDICT.coinTypes,
+	units: MAINNET_PREDICT.units,
+	underlyings: MAINNET_PREDICT.underlyings,
+});

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

@@ -16,6 +16,8 @@ export type {
 	MintAmountOptions,
 	MintOptions,
 	MintQuote,
+	PlpSupplyOptions,
+	PlpWithdrawOptions,
 	PoolSummary,
 	RedeemQuote,
 } from './client.js';
@@ -30,10 +32,13 @@ export { deriveAccountWrapperId, generateAuth } from './tx/common.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;