@mysten/deepbook-v3 2.6.4 → 2.8.0

package/dist/predict/config/generated.mjs

@@ -1,3 +1,5 @@
+import { PredictInputError } from "../errors.mjs";
+
 //#region src/predict/config/generated.ts
 function toGeneratedConfig(cfg) {
 	return {
@@ -11,7 +13,34 @@ function toGeneratedConfig(cfg) {
 		accountRegistry: cfg.objects.accountRegistry
 	};
 }
+/**
+* Project a config that records delayed execution onto {@link OrdersGeneratedConfig}. Throws
+* `PredictInputError` while the config lacks the Predict upgrade, the companion package, its desk
+* or its queue registry: building a queued order against a guessed package would abort on chain
+* or, worse, address the wrong one.
+*/
+function toOrdersConfig(cfg) {
+	const { predictDelayedExecution, predictOrders, predictOrdersV1, predictMath } = cfg.packages;
+	const { orderDesk, queueRegistry } = cfg.objects;
+	if (!predictDelayedExecution || !predictOrders || !orderDesk || !queueRegistry) {
+		const missing = [
+			!predictDelayedExecution && "`packages.predictDelayedExecution`",
+			!predictOrders && "`packages.predictOrders`",
+			!orderDesk && "`objects.orderDesk`",
+			!queueRegistry && "`objects.queueRegistry`"
+		].filter(Boolean);
+		throw new PredictInputError(`delayed execution isn't recorded for ${cfg.network} in this SDK version (missing ${missing.join(", ")}): pass a \`config\` that records the Predict upgrade, the \`deepbook_predict_orders\` package, its order desk and its queue registry`);
+	}
+	return {
+		...toGeneratedConfig(cfg),
+		predictOrdersPackageId: predictOrders,
+		predictOrdersPackageIdV1: predictOrdersV1 ?? predictOrders,
+		predictMathPackageId: predictMath,
+		orderDesk,
+		queueRegistry
+	};
+}
 
 //#endregion
-export { toGeneratedConfig };
+export { toGeneratedConfig, toOrdersConfig };
 //# sourceMappingURL=generated.mjs.map

package/dist/predict/config/generated.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"generated.mjs","names":[],"sources":["../../../src/predict/config/generated.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\nimport type { AccountConfig } from '../../account.js';\nimport type { DeepbookPredictConfig } from '../../contracts/deepbook_predict/config-arguments.js';\nimport type { PredictConfig } from './types.js';\n\n/**\n * The flat config slice the generated bindings resolve `options.config` against, projected from\n * the nested public `PredictConfig`. Each generated call declares only the keys it consumes, so a\n * single object carrying all of them satisfies every call site.\n *\n * Typed as the intersection of the two generated interfaces on purpose: if codegen adds, drops, or\n * renames a config key, this file stops compiling instead of silently building a PTB against the\n * wrong object.\n *\n * `predictPackageId` is narrowed to `string` because codegen types package ids as optional, while\n * this projection always supplies one. `predictPackageIdV1` separately supplies the original\n * identity for existing struct tags and dynamic-field keys. The two account ids restate a narrowing\n * `AccountConfig` already applies, so they are redundant today; they are kept so this projection\n * still compiles to plain ids if that package ever widens them back.\n */\nexport type GeneratedConfig = DeepbookPredictConfig &\n\tAccountConfig & {\n\t\tpredictPackageId: string;\n\t\tpredictPackageIdV1: string;\n\t\taccountPackageId: string;\n\t\taccountRegistry: string;\n\t};\n\nexport function toGeneratedConfig(cfg: PredictConfig): GeneratedConfig {\n\treturn {\n\t\tpredictPackageId: cfg.packages.predict,\n\t\tpredictPackageIdV1: cfg.packages.predictV1 ?? cfg.packages.predict,\n\t\taccountPackageId: cfg.packages.account,\n\t\tprotocolConfig: cfg.objects.protocolConfig,\n\t\tpoolVault: cfg.objects.poolVault,\n\t\tregistry: cfg.objects.registry,\n\t\toracleRegistry: cfg.objects.oracleRegistry,\n\t\taccountRegistry: cfg.objects.accountRegistry,\n\t};\n}\n"],"mappings":";AA6BA,SAAgB,kBAAkB,KAAqC;AACtE,QAAO;EACN,kBAAkB,IAAI,SAAS;EAC/B,oBAAoB,IAAI,SAAS,aAAa,IAAI,SAAS;EAC3D,kBAAkB,IAAI,SAAS;EAC/B,gBAAgB,IAAI,QAAQ;EAC5B,WAAW,IAAI,QAAQ;EACvB,UAAU,IAAI,QAAQ;EACtB,gBAAgB,IAAI,QAAQ;EAC5B,iBAAiB,IAAI,QAAQ;EAC7B"}
+{"version":3,"file":"generated.mjs","names":[],"sources":["../../../src/predict/config/generated.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\nimport type { AccountConfig } from '../../account.js';\nimport type { DeepbookPredictConfig } from '../../contracts/deepbook_predict/config-arguments.js';\nimport type { DeepbookPredictMathConfig } from '../../contracts/deepbook_predict_math/config-arguments.js';\nimport type { DeepbookPredictOrdersConfig } from '../../contracts/deepbook_predict_orders/config-arguments.js';\nimport { PredictInputError } from '../errors.js';\nimport type { PredictConfig } from './types.js';\n\n/**\n * The flat config slice the generated bindings resolve `options.config` against, projected from\n * the nested public `PredictConfig`. Each generated call declares only the keys it consumes, so a\n * single object carrying all of them satisfies every call site.\n *\n * Typed as the intersection of the two generated interfaces on purpose: if codegen adds, drops, or\n * renames a config key, this file stops compiling instead of silently building a PTB against the\n * wrong object.\n *\n * `predictPackageId` is narrowed to `string` because codegen types package ids as optional, while\n * this projection always supplies one. `predictPackageIdV1` separately supplies the original\n * identity for existing struct tags and dynamic-field keys. The two account ids restate a narrowing\n * `AccountConfig` already applies, so they are redundant today; they are kept so this projection\n * still compiles to plain ids if that package ever widens them back.\n */\nexport type GeneratedConfig = DeepbookPredictConfig &\n\tAccountConfig & {\n\t\tpredictPackageId: string;\n\t\tpredictPackageIdV1: string;\n\t\taccountPackageId: string;\n\t\taccountRegistry: string;\n\t};\n\nexport function toGeneratedConfig(cfg: PredictConfig): GeneratedConfig {\n\treturn {\n\t\tpredictPackageId: cfg.packages.predict,\n\t\tpredictPackageIdV1: cfg.packages.predictV1 ?? cfg.packages.predict,\n\t\taccountPackageId: cfg.packages.account,\n\t\tprotocolConfig: cfg.objects.protocolConfig,\n\t\tpoolVault: cfg.objects.poolVault,\n\t\tregistry: cfg.objects.registry,\n\t\toracleRegistry: cfg.objects.oracleRegistry,\n\t\taccountRegistry: cfg.objects.accountRegistry,\n\t};\n}\n\n/**\n * {@link GeneratedConfig} plus the order-flow companion (`deepbook_predict_orders`) and the math\n * library: the slice the queued-order thunks and reads take. A queued order calls the companion,\n * which calls into Predict, so one object carries both packages' keys. `predictOrdersPackageIdV1`\n * is the companion's original ID, which types `OrderFlow` and the queue events.\n */\nexport type OrdersGeneratedConfig = GeneratedConfig &\n\tDeepbookPredictOrdersConfig &\n\tDeepbookPredictMathConfig & {\n\t\tpredictOrdersPackageId: string;\n\t\tpredictOrdersPackageIdV1: string;\n\t\torderDesk: string;\n\t\tqueueRegistry: string;\n\t};\n\n/**\n * Project a config that records delayed execution onto {@link OrdersGeneratedConfig}. Throws\n * `PredictInputError` while the config lacks the Predict upgrade, the companion package, its desk\n * or its queue registry: building a queued order against a guessed package would abort on chain\n * or, worse, address the wrong one.\n */\nexport function toOrdersConfig(cfg: PredictConfig): OrdersGeneratedConfig {\n\tconst { predictDelayedExecution, predictOrders, predictOrdersV1, predictMath } = cfg.packages;\n\tconst { orderDesk, queueRegistry } = cfg.objects;\n\tif (!predictDelayedExecution || !predictOrders || !orderDesk || !queueRegistry) {\n\t\tconst missing = [\n\t\t\t!predictDelayedExecution && '`packages.predictDelayedExecution`',\n\t\t\t!predictOrders && '`packages.predictOrders`',\n\t\t\t!orderDesk && '`objects.orderDesk`',\n\t\t\t!queueRegistry && '`objects.queueRegistry`',\n\t\t].filter(Boolean);\n\t\tthrow new PredictInputError(\n\t\t\t`delayed execution isn't recorded for ${cfg.network} in this SDK version (missing ` +\n\t\t\t\t`${missing.join(', ')}): pass a \\`config\\` that records the Predict upgrade, the ` +\n\t\t\t\t'`deepbook_predict_orders` package, its order desk and its queue registry',\n\t\t);\n\t}\n\treturn {\n\t\t...toGeneratedConfig(cfg),\n\t\tpredictOrdersPackageId: predictOrders,\n\t\tpredictOrdersPackageIdV1: predictOrdersV1 ?? predictOrders,\n\t\tpredictMathPackageId: predictMath,\n\t\torderDesk,\n\t\tqueueRegistry,\n\t};\n}\n"],"mappings":";;;AAgCA,SAAgB,kBAAkB,KAAqC;AACtE,QAAO;EACN,kBAAkB,IAAI,SAAS;EAC/B,oBAAoB,IAAI,SAAS,aAAa,IAAI,SAAS;EAC3D,kBAAkB,IAAI,SAAS;EAC/B,gBAAgB,IAAI,QAAQ;EAC5B,WAAW,IAAI,QAAQ;EACvB,UAAU,IAAI,QAAQ;EACtB,gBAAgB,IAAI,QAAQ;EAC5B,iBAAiB,IAAI,QAAQ;EAC7B;;;;;;;;AAwBF,SAAgB,eAAe,KAA2C;CACzE,MAAM,EAAE,yBAAyB,eAAe,iBAAiB,gBAAgB,IAAI;CACrF,MAAM,EAAE,WAAW,kBAAkB,IAAI;AACzC,KAAI,CAAC,2BAA2B,CAAC,iBAAiB,CAAC,aAAa,CAAC,eAAe;EAC/E,MAAM,UAAU;GACf,CAAC,2BAA2B;GAC5B,CAAC,iBAAiB;GAClB,CAAC,aAAa;GACd,CAAC,iBAAiB;GAClB,CAAC,OAAO,QAAQ;AACjB,QAAM,IAAI,kBACT,wCAAwC,IAAI,QAAQ,gCAChD,QAAQ,KAAK,KAAK,CAAC,uIAEvB;;AAEF,QAAO;EACN,GAAG,kBAAkB,IAAI;EACzB,wBAAwB;EACxB,0BAA0B,mBAAmB;EAC7C,sBAAsB;EACtB;EACA;EACA"}

package/dist/predict/config/mainnet.mjs

@@ -13,12 +13,20 @@ import { MAINNET_PREDICT } from "../../deployments/mainnet.mjs";
 */
 const MAINNET_CONFIG = Object.freeze({
 	network: "mainnet",
-	packages: MAINNET_PREDICT.packages,
-	objects: MAINNET_PREDICT.objects,
+	packages: Object.freeze({
+		...MAINNET_PREDICT.packages,
+		predictDelayedExecution: "0x98235c5842831c9b5f51dc637cf34c91db2aca5510802eb6ebfec63f5b71a7bb"
+	}),
+	objects: Object.freeze({
+		...MAINNET_PREDICT.objects,
+		orderDesk: "0x87b0a87262aacf58eaff567eed2fb7cb0f9cbc1f5ce33ef79216cd26d13a1b5b",
+		queueRegistry: "0x8d4f0c671862f065ac7f2c2cb24abc47cf75ed8fc8e5e52c1d4bdfa53eee164f"
+	}),
 	quoteCoinType: MAINNET_PREDICT.quoteCoinType,
 	coinTypes: MAINNET_PREDICT.coinTypes,
 	units: MAINNET_PREDICT.units,
-	underlyings: MAINNET_PREDICT.underlyings
+	underlyings: MAINNET_PREDICT.underlyings,
+	oracle: MAINNET_PREDICT.oracle
 });
 
 //#endregion

package/dist/predict/config/mainnet.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mainnet.mjs","names":[],"sources":["../../../src/predict/config/mainnet.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { MAINNET_PREDICT } from '../../deployments/mainnet.js';\nimport type { PredictConfig } from './types.js';\n\n/**\n * Mainnet deployment constants, read from the shared generated record in\n * `src/deployments/` rather than transcribed here. `/account` and `/sessions` read slices of\n * that same record, so a redeploy (`pnpm sync-deployment`) moves every subpath together and\n * they cannot end up addressing different deployments.\n *\n * The record is generated from the deploy tooling's `deployment.mainnet.json`; see\n * `scripts/sync-deployment.ts`. `getDeployment('mainnet')` names the deployment and the\n * deepbookv3 commit these ids came from.\n */\nexport const MAINNET_CONFIG: PredictConfig = Object.freeze({\n\t// The record widens `network` to `string` so the published types don't pin a literal;\n\t// this file is the mainnet config by construction.\n\tnetwork: 'mainnet',\n\tpackages: MAINNET_PREDICT.packages,\n\tobjects: MAINNET_PREDICT.objects,\n\tquoteCoinType: MAINNET_PREDICT.quoteCoinType,\n\tcoinTypes: MAINNET_PREDICT.coinTypes,\n\tunits: MAINNET_PREDICT.units,\n\tunderlyings: MAINNET_PREDICT.underlyings,\n});\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAa,iBAAgC,OAAO,OAAO;CAG1D,SAAS;CACT,UAAU,gBAAgB;CAC1B,SAAS,gBAAgB;CACzB,eAAe,gBAAgB;CAC/B,WAAW,gBAAgB;CAC3B,OAAO,gBAAgB;CACvB,aAAa,gBAAgB;CAC7B,CAAC"}
+{"version":3,"file":"mainnet.mjs","names":[],"sources":["../../../src/predict/config/mainnet.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { MAINNET_PREDICT } from '../../deployments/mainnet.js';\nimport type { PredictConfig } from './types.js';\n\n/**\n * Mainnet deployment constants, read from the shared generated record in\n * `src/deployments/` rather than transcribed here. `/account` and `/sessions` read slices of\n * that same record, so a redeploy (`pnpm sync-deployment`) moves every subpath together and\n * they cannot end up addressing different deployments.\n *\n * The record is generated from the deploy tooling's `deployment.mainnet.json`; see\n * `scripts/sync-deployment.ts`. `getDeployment('mainnet')` names the deployment and the\n * deepbookv3 commit these ids came from.\n */\nexport const MAINNET_CONFIG: PredictConfig = Object.freeze({\n\t// The record widens `network` to `string` so the published types don't pin a literal;\n\t// this file is the mainnet config by construction.\n\tnetwork: 'mainnet',\n\t// Delayed execution (DBU-885) is recorded on Mainnet. The generated record carries the package\n\t// IDs that move with upgrades (Predict, `deepbook_predict_orders`, `deepbook_predict_math`) and\n\t// the Lazer `State`. The three IDs pinned below are in no publication record and never move:\n\t// the Predict version that introduced delayed execution (Mainnet v4), which defines its new\n\t// types and events, and the `OrderDesk` and `QueueRegistry` that `deepbook_predict_orders`'s\n\t// `init` shared at publish.\n\tpackages: Object.freeze({\n\t\t...MAINNET_PREDICT.packages,\n\t\tpredictDelayedExecution: '0x98235c5842831c9b5f51dc637cf34c91db2aca5510802eb6ebfec63f5b71a7bb',\n\t}),\n\tobjects: Object.freeze({\n\t\t...MAINNET_PREDICT.objects,\n\t\torderDesk: '0x87b0a87262aacf58eaff567eed2fb7cb0f9cbc1f5ce33ef79216cd26d13a1b5b',\n\t\tqueueRegistry: '0x8d4f0c671862f065ac7f2c2cb24abc47cf75ed8fc8e5e52c1d4bdfa53eee164f',\n\t}),\n\tquoteCoinType: MAINNET_PREDICT.quoteCoinType,\n\tcoinTypes: MAINNET_PREDICT.coinTypes,\n\tunits: MAINNET_PREDICT.units,\n\tunderlyings: MAINNET_PREDICT.underlyings,\n\toracle: MAINNET_PREDICT.oracle,\n});\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAa,iBAAgC,OAAO,OAAO;CAG1D,SAAS;CAOT,UAAU,OAAO,OAAO;EACvB,GAAG,gBAAgB;EACnB,yBAAyB;EACzB,CAAC;CACF,SAAS,OAAO,OAAO;EACtB,GAAG,gBAAgB;EACnB,WAAW;EACX,eAAe;EACf,CAAC;CACF,eAAe,gBAAgB;CAC/B,WAAW,gBAAgB;CAC3B,OAAO,gBAAgB;CACvB,aAAa,gBAAgB;CAC7B,QAAQ,gBAAgB;CACxB,CAAC"}

package/dist/predict/config/testnet.mjs

@@ -13,12 +13,20 @@ import { TESTNET_PREDICT } from "../../deployments/testnet.mjs";
 */
 const TESTNET_CONFIG = Object.freeze({
 	network: "testnet",
-	packages: TESTNET_PREDICT.packages,
-	objects: TESTNET_PREDICT.objects,
+	packages: Object.freeze({
+		...TESTNET_PREDICT.packages,
+		predictDelayedExecution: "0x0654ecbed7c0f2645d9de7cb6cf08e65c2ee05cdbb39a415f17a6bd1cd92e267"
+	}),
+	objects: Object.freeze({
+		...TESTNET_PREDICT.objects,
+		orderDesk: "0x160fc026c4143f3dec36acfc6556379d54661d37fe28ad837b6a85e42aeddfea",
+		queueRegistry: "0xe9d75ed05b089d52a660a94b94963cdc89aeb7f3c75b57f76771454c81faae1f"
+	}),
 	quoteCoinType: TESTNET_PREDICT.quoteCoinType,
 	coinTypes: TESTNET_PREDICT.coinTypes,
 	units: TESTNET_PREDICT.units,
-	underlyings: TESTNET_PREDICT.underlyings
+	underlyings: TESTNET_PREDICT.underlyings,
+	oracle: TESTNET_PREDICT.oracle
 });
 
 //#endregion

package/dist/predict/config/testnet.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testnet.mjs","names":[],"sources":["../../../src/predict/config/testnet.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { TESTNET_PREDICT } from '../../deployments/testnet.js';\nimport type { PredictConfig } from './types.js';\n\n/**\n * Testnet deployment constants, read from the shared generated record in\n * `src/deployments/` rather than transcribed here. `/account` and `/sessions` read slices of\n * that same record, so a redeploy (`pnpm sync-deployment`) moves every subpath together and\n * they cannot end up addressing different deployments.\n *\n * The record is generated from the deploy tooling's `deployment.testnet.json`; see\n * `scripts/sync-deployment.ts`. `getDeployment('testnet')` names the deployment and the\n * deepbookv3 commit these ids came from.\n */\nexport const TESTNET_CONFIG: PredictConfig = Object.freeze({\n\t// The record widens `network` to `string` so the published types don't pin a literal;\n\t// this file is the testnet config by construction.\n\tnetwork: 'testnet',\n\tpackages: TESTNET_PREDICT.packages,\n\tobjects: TESTNET_PREDICT.objects,\n\tquoteCoinType: TESTNET_PREDICT.quoteCoinType,\n\tcoinTypes: TESTNET_PREDICT.coinTypes,\n\tunits: TESTNET_PREDICT.units,\n\tunderlyings: TESTNET_PREDICT.underlyings,\n});\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAa,iBAAgC,OAAO,OAAO;CAG1D,SAAS;CACT,UAAU,gBAAgB;CAC1B,SAAS,gBAAgB;CACzB,eAAe,gBAAgB;CAC/B,WAAW,gBAAgB;CAC3B,OAAO,gBAAgB;CACvB,aAAa,gBAAgB;CAC7B,CAAC"}
+{"version":3,"file":"testnet.mjs","names":[],"sources":["../../../src/predict/config/testnet.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { TESTNET_PREDICT } from '../../deployments/testnet.js';\nimport type { PredictConfig } from './types.js';\n\n/**\n * Testnet deployment constants, read from the shared generated record in\n * `src/deployments/` rather than transcribed here. `/account` and `/sessions` read slices of\n * that same record, so a redeploy (`pnpm sync-deployment`) moves every subpath together and\n * they cannot end up addressing different deployments.\n *\n * The record is generated from the deploy tooling's `deployment.testnet.json`; see\n * `scripts/sync-deployment.ts`. `getDeployment('testnet')` names the deployment and the\n * deepbookv3 commit these ids came from.\n */\nexport const TESTNET_CONFIG: PredictConfig = Object.freeze({\n\t// The record widens `network` to `string` so the published types don't pin a literal;\n\t// this file is the testnet config by construction.\n\tnetwork: 'testnet',\n\t// Delayed execution (DBU-885) is recorded on Testnet. The generated record carries the package\n\t// IDs that move with upgrades (Predict, `deepbook_predict_orders`, `deepbook_predict_math`) and\n\t// the Lazer `State`. The three IDs pinned below are in no publication record and never move:\n\t// the Predict version that introduced delayed execution (Testnet v5), which defines its new\n\t// types and events, and the `OrderDesk` and `QueueRegistry` that `deepbook_predict_orders`'s\n\t// `init` shared at publish.\n\tpackages: Object.freeze({\n\t\t...TESTNET_PREDICT.packages,\n\t\tpredictDelayedExecution: '0x0654ecbed7c0f2645d9de7cb6cf08e65c2ee05cdbb39a415f17a6bd1cd92e267',\n\t}),\n\tobjects: Object.freeze({\n\t\t...TESTNET_PREDICT.objects,\n\t\torderDesk: '0x160fc026c4143f3dec36acfc6556379d54661d37fe28ad837b6a85e42aeddfea',\n\t\tqueueRegistry: '0xe9d75ed05b089d52a660a94b94963cdc89aeb7f3c75b57f76771454c81faae1f',\n\t}),\n\tquoteCoinType: TESTNET_PREDICT.quoteCoinType,\n\tcoinTypes: TESTNET_PREDICT.coinTypes,\n\tunits: TESTNET_PREDICT.units,\n\tunderlyings: TESTNET_PREDICT.underlyings,\n\toracle: TESTNET_PREDICT.oracle,\n});\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAa,iBAAgC,OAAO,OAAO;CAG1D,SAAS;CAOT,UAAU,OAAO,OAAO;EACvB,GAAG,gBAAgB;EACnB,yBAAyB;EACzB,CAAC;CACF,SAAS,OAAO,OAAO;EACtB,GAAG,gBAAgB;EACnB,WAAW;EACX,eAAe;EACf,CAAC;CACF,eAAe,gBAAgB;CAC/B,WAAW,gBAAgB;CAC3B,OAAO,gBAAgB;CACvB,aAAa,gBAAgB;CAC7B,QAAQ,gBAAgB;CACxB,CAAC"}

package/dist/predict/config/types.d.mts

@@ -1,10 +1,41 @@
 //#region src/predict/config/types.d.ts
-/** The three published Move packages a Predict deployment spans. */
+/**
+ * The published Move packages a Predict deployment spans.
+ *
+ * Delayed execution (DBU-885) ships as three packages: the Predict upgrade, the order-flow
+ * companion `deepbook_predict_orders` (a fresh publish), and the math library
+ * `deepbook_predict_math` (a fresh publish). The queued-order builders, reads and decoders need
+ * `predictDelayedExecution`, `predictOrders`, `objects.orderDesk` and `objects.queueRegistry` all
+ * recorded, and throw
+ * `PredictInputError` otherwise rather than address the wrong package. Pass a custom `config`
+ * (a localnet publish) to use them before a network record exists.
+ */
 interface PredictPackages {
   /** Latest published package ID, used for Move calls. */
   predict: string;
   /** Original ID for v1 structs/events. Omit only for an unupgraded custom deployment. */
   predictV1?: string;
+  /**
+   * The Predict version that introduced delayed execution (Mainnet v4, Testnet v5): the
+   * defining ID of the Predict types and events that version added (`ExpiryPnlRealized`,
+   * `FlushOperatorUpdated`, `OrderFlowUpdated`, `OrderReceipt`). A later upgrade does not move
+   * it, so it is pinned once per network rather than read from the latest publication.
+   */
+  predictDelayedExecution?: string;
+  /**
+   * Latest published `deepbook_predict_orders` package ID: the call target of every queued-order
+   * entry point (`queue::enqueue_*`, `commit`, `resolve`, `refund`, `settle_step`, …), the queue
+   * reads and the desk setters.
+   */
+  predictOrders?: string;
+  /**
+   * Original `deepbook_predict_orders` ID, which types `MarketQueue`, `OrderDesk`, the queue
+   * events and the `OrderFlow` witness. Omit until the package is first upgraded: it then
+   * defaults to `predictOrders`.
+   */
+  predictOrdersV1?: string;
+  /** The `deepbook_predict_math` package ID, for its pure calls and layouts. */
+  predictMath?: string;
   account: string;
   propbook: string;
 }
@@ -33,6 +64,17 @@ interface PredictConfig {
     poolVault: string;
     oracleRegistry: string;
     accountRegistry: string;
+    /**
+     * The order-flow companion's shared `OrderDesk`: the delayed-execution policy and the
+     * companion's version floor. Created once, by the package's `init` at publish.
+     */
+    orderDesk?: string;
+    /**
+     * The order-flow companion's shared `QueueRegistry`, created next to the desk by the same
+     * `init`. Each market's `MarketQueue` sits at an ID derived from it and the market
+     * (`deriveQueueId`), and `queue::create_and_share` writes it.
+     */
+    queueRegistry?: string;
   };
   /**
    * The deployment's settlement coin type. Always read this rather than assuming a type:
@@ -58,6 +100,13 @@ interface PredictConfig {
     positionQuantityDecimals: number;
   };
   underlyings: Record<string, UnderlyingConfig>;
+  /**
+   * Oracle objects only the delayed-execution filler needs. Optional: traders never pass
+   * them, and a filler can name the Lazer `State` per call instead.
+   */
+  oracle?: {
+    /** Pyth Lazer's shared `State`, which carries the current Lazer package ID. */pythLazerState?: string;
+  };
 }
 //#endregion
 export { PredictConfig, PredictPackages, UnderlyingConfig };

package/dist/predict/config/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/predict/config/types.ts"],"mappings":";;UAGiB,eAAA;EAAe;EAE/B,OAAA;EAF+B;EAI/B,SAAA;EACA,OAAA;EACA,QAAA;AAAA;;;AAQD;;;UAAiB,gBAAA;EAChB,MAAA;EACA,oBAAA;EAEA;EAAA,QAAA;EAIA;EAFA,sBAAA;EAEoB;EAApB,oBAAA;AAAA;;UAIgB,aAAA;EAChB,OAAA;EACA,QAAA,EAAU,eAAA;EACV,OAAA;IACC,QAAA;IACA,cAAA;IACA,SAAA;IACA,cAAA;IACA,eAAA;EAAA;EAHA;;;;;;EAWD,aAAA;EAM0B;;;;;EAA1B,SAAA;IAAa,GAAA;IAAa,IAAA;EAAA;EAQkB;EAN5C,KAAA;IACC,eAAA;IACA,eAAA;IACA,iBAAA;IACA,wBAAA;EAAA;EAED,WAAA,EAAa,MAAA,SAAe,gBAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/predict/config/types.ts"],"mappings":";;AAaA;;;;;;;;;;UAAiB,eAAA;EA2BhB;EAzBA,OAAA;EAyBQ;EAvBR,SAAA;EA+BgC;;;;;;EAxBhC,uBAAA;EAgCA;;;AAID;;EA9BC,aAAA;EAgCU;;;;;EA1BV,eAAA;EA0BA;EAxBA,WAAA;EACA,OAAA;EACA,QAAA;AAAA;;;;;;UAQgB,gBAAA;EAChB,MAAA;EACA,oBAAA;EA2C0B;EAzC1B,QAAA;EA4CC;EA1CD,sBAAA;EA4CC;EA1CD,oBAAA;AAAA;;UAIgB,aAAA;EAChB,OAAA;EACA,QAAA,EAAU,eAAA;EACV,OAAA;IACC,QAAA;IACA,cAAA;IACA,SAAA;IACA,cAAA;IACA,eAAA;;;;;IAKA,SAAA;;;;;;IAMA,aAAA;EAAA;;;;;;;EAQD,aAAA;;;;;;EAMA,SAAA;IAAa,GAAA;IAAa,IAAA;EAAA;;EAE1B,KAAA;IACC,eAAA;IACA,eAAA;IACA,iBAAA;IACA,wBAAA;EAAA;EAED,WAAA,EAAa,MAAA,SAAe,gBAAA;;;;;EAK5B,MAAA;mFAEC,cAAA;EAAA;AAAA"}

package/dist/predict/cost.d.mts

@@ -3,7 +3,7 @@ import { POS_INF_TICK } from "./ticks.mjs";
 
 //#region src/predict/cost.d.ts
 declare namespace cost_d_exports {
-  export { BUILDER_FEE_MULTIPLIER, Boundaries, CloseBookTerms, CongestionPolicy, CongestionState, FEE_INCENTIVE_SUBSIDY_RATE, FLOAT_SCALING, FeePolicy, MAX_BUILDER_FEE_RATE, MAX_QUANTITY_LOTS, MIN_PREMIUM, MintBookTerms, MintBudgetCost, MintBudgetInputs, MintCost, MintCostInputs, OrderRange, POSITION_LOT_SIZE, POS_INF_TICK, ProbabilitySource, RedeemLiveInputs, RedeemLiveProceeds, SHIPPED_FEE_POLICY, bernoulliFeeRate, boundaryProbabilities, builderFee, closeInventoryImpact, congestionPenaltyRate, decodeOrderRange, expiryFeeMultiplier, feeIncentiveSubsidy, inventoryImpactPotential, mintCost, mintCostForBudget, mintInventoryImpact, orderStrikes, rangeProbability, redeemLiveProceeds, sqrtDown, tradingFee };
+  export { BUILDER_FEE_MULTIPLIER, Boundaries, CloseBookTerms, CongestionPolicy, CongestionState, FEE_INCENTIVE_SUBSIDY_RATE, FLOAT_SCALING, FeePolicy, MAX_BUILDER_FEE_RATE, MAX_QUANTITY_LOTS, MIN_PREMIUM, MintBookTerms, MintBudgetCost, MintBudgetInputs, MintCost, MintCostInputs, OrderRange, POSITION_LOT_SIZE, POS_INF_TICK, ProbabilitySource, RedeemLiveInputs, RedeemLiveProceeds, SHIPPED_FEE_POLICY, bernoulliFeeRate, boundaryProbabilities, builderFee, closeInventoryImpact, congestionPenaltyRate, decodeOrderRange, expiryFeeMultiplier, feeIncentiveSubsidy, inventoryImpactPotential, mintCost, mintCostForBudget, mintInventoryImpact, orderStrikes, rangeProbability, redeemLiveProceeds, settledPayout, sqrtDown, tradingFee };
 }
 /** `math::float_scaling` — 1e9 is 1.0 for every rate and probability here. */
 declare const FLOAT_SCALING = 1000000000n;
@@ -15,7 +15,14 @@ declare const MIN_PREMIUM = 1000000n;
 declare const BUILDER_FEE_MULTIPLIER = 100000000n;
 /** `constants::max_builder_fee_rate` — cap on the builder fee as a share of quantity (0.5%). */
 declare const MAX_BUILDER_FEE_RATE = 5000000n;
-/** `constants::fee_incentive_subsidy_rate` — sponsor share of a trader's mint fee (20%). */
+/**
+ * The default sponsor share of a trader's mint fee (20%), and the rate the chain reads while the
+ * admin hasn't set one.
+ * @deprecated From delayed execution (DBU-885) the rate is admin-set: read it with
+ * `protocol_config::fee_incentive_subsidy_rate` (`read.queue(...).protocol.feeIncentiveSubsidyRate`)
+ * and pass it as `feeIncentiveSubsidyRate`. A hardcoded 20% underquotes every mint once the rate
+ * moves.
+ */
 declare const FEE_INCENTIVE_SUBSIDY_RATE = 200000000n;
 /** `order::max_quantity_lots` — the order ID's 32-bit lot field. */
 declare const MAX_QUANTITY_LOTS: bigint;
@@ -24,8 +31,8 @@ declare function sqrtDown(x: bigint): bigint;
 /**
  * One market's fee policy: the `StrikeExposureConfig` it snapshotted at creation, in raw 1e9
  * rates. Snapshotted means later admin changes do NOT reprice a market already trading, so
- * read it per market (the `MarketCreated` event carries every field) rather than assuming the
- * template. The last three are the inventory-impact parameters, inert while
+ * read it per market with `read.feePolicy(market)` (the `MarketCreated` event carries every field
+ * too) rather than assuming the template. The last three are the inventory-impact parameters, inert while
  * `inventoryImpactMaxRate` is `0n` (the shipped value).
  */
 interface FeePolicy {
@@ -51,9 +58,11 @@ interface FeePolicy {
 /**
  * The shipped template (`config_constants` defaults): 10% Bernoulli fee, a 2.2% per-leg floor,
  * a one-day ramp window that is inert at a 1.0 multiplier, a 1%–99% entry band, and inventory
- * impact disabled. A market that was created under these values charges exactly this; one
- * created after an admin change does not, which is why the per-market snapshot is the real
- * answer. Verify against the deployment's `MarketCreated` before pricing money on it.
+ * impact disabled. Neither recorded deployment's template matches it any more: both charge a
+ * 20.4% Bernoulli fee, ramp it to 3× over the last 60 s and admit entries in 25%–75% (checked
+ * 2026-10-09), so a live market's costs from this policy come out low. Pass
+ * `read.feePolicy(market)` instead. This stays for tests and for a deployment still on the
+ * defaults.
  */
 declare const SHIPPED_FEE_POLICY: FeePolicy;
 /** A range's two boundary UP probabilities, raw 1e9. `null` is an infinite boundary — the
@@ -119,8 +128,9 @@ declare function tradingFee(policy: FeePolicy, boundaries: Boundaries, quantity:
  * multiple of its trading fee, capped as a share of quantity. */
 declare function builderFee(fee: bigint, quantity: bigint, hasBuilderCode: boolean): bigint;
 /** `expiry_market::fee_incentive_subsidy_amount` — a sponsor pays part of the trader's MINT
- * fee, bounded by the expiry's remaining sponsored balance. Mints only; redeems pay in full. */
-declare function feeIncentiveSubsidy(fee: bigint, feeIncentiveBalance: bigint): bigint;
+ * fee, bounded by the expiry's remaining sponsored balance. Mints only; redeems pay in full.
+ * `rate` is the protocol's `fee_incentive_subsidy_rate` (1e9-scaled), 20% when omitted. */
+declare function feeIncentiveSubsidy(fee: bigint, feeIncentiveBalance: bigint, rate?: bigint): bigint;
 /**
  * `ewma::penalty_fee`'s firing test, as a per-unit RATE: `penalty_rate` when the transaction's
  * gas price is a high outlier against the market's pre-trade EWMA, else zero. It is a rate and
@@ -163,7 +173,15 @@ interface MintInputsBase {
   builderCode?: boolean;
   /** The expiry's remaining sponsored fee balance (`fee_incentive_balance`). Default `0n`. */
   feeIncentiveBalance?: number | bigint;
-  /** Per-unit congestion surcharge rate — see {@link congestionPenaltyRate}. Default `0n`. */
+  /**
+   * The protocol's admin-set mint fee subsidy rate (`protocol_config::fee_incentive_subsidy_rate`),
+   * 1e9-scaled. Defaults to the 20% the chain reads while unset.
+   */
+  feeIncentiveSubsidyRate?: bigint;
+  /**
+   * Per-unit congestion surcharge rate — see {@link congestionPenaltyRate}. Default `0n`. A
+   * queued (delayed-execution) fill pays no congestion penalty, so queued previews keep it 0.
+   */
   penaltyRate?: bigint;
   /** Pre-trade payout-tree terms. Required when inventory impact is enabled. */
   book?: MintBookTerms;
@@ -341,6 +359,15 @@ interface OrderRange {
 /** Decode an order ID's range and quantity — the TypeScript mirror of `order::lower_tick` /
  * `higher_tick` / `quantity`. */
 declare function decodeOrderRange(orderId: bigint, lotSize?: bigint): OrderRange;
+/**
+ * What an order pays at settlement, raw USDC: its full quantity when the settlement price lies
+ * in `(lower, higher]`, else 0. The mirror of `strike_exposure::settled_order_payout`, which
+ * rounds the settlement price up to the market's tick grid (`range_codec::limit_tick`) before
+ * comparing it with the order's ticks, so a price inside a tick counts as that tick's upper edge.
+ * Pass `read.settlement`'s `settlementPriceRaw` and `tickSizeRaw`, and the config's
+ * `units.positionLotSize` when it isn't the default.
+ */
+declare function settledPayout(orderId: bigint, settlementPriceRaw: bigint, tickSizeRaw: bigint, lotSize?: bigint): bigint;
 /** The strikes an {@link OrderRange} prices against, in USD, with `null` for each infinite
  * side — the shape {@link boundaryProbabilities} takes. `tickSize` is the market's raw tick
  * size (`ActiveMarket.tickSize` in USD, or the raw value from the deployment). */
@@ -349,5 +376,5 @@ declare function orderStrikes(range: OrderRange, tickSizeRaw: bigint): {
   upper: number | null;
 };
 //#endregion
-export { cost_d_exports };
+export { FeePolicy, cost_d_exports };
 //# sourceMappingURL=cost.d.mts.map

package/dist/predict/cost.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cost.d.mts","names":[],"sources":["../../src/predict/cost.ts"],"mappings":"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"}
+{"version":3,"file":"cost.d.mts","names":[],"sources":["../../src/predict/cost.ts"],"mappings":"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"}

package/dist/predict/cost.mjs

@@ -1,8 +1,8 @@
 import { __exportAll } from "../_virtual/rolldown_runtime.mjs";
 import { PredictInputError } from "./errors.mjs";
-import { U64_MAX, fromRaw, usdcToRaw } from "./units.mjs";
-import { POS_INF_TICK } from "./ticks.mjs";
 import { upProbability } from "./pricing.mjs";
+import { POS_INF_TICK } from "./ticks.mjs";
+import { U64_MAX, fromRaw, usdcToRaw } from "./units.mjs";
 
 //#region src/predict/cost.ts
 var cost_exports = /* @__PURE__ */ __exportAll({
@@ -30,6 +30,7 @@ var cost_exports = /* @__PURE__ */ __exportAll({
 	orderStrikes: () => orderStrikes,
 	rangeProbability: () => rangeProbability,
 	redeemLiveProceeds: () => redeemLiveProceeds,
+	settledPayout: () => settledPayout,
 	sqrtDown: () => sqrtDown,
 	tradingFee: () => tradingFee
 });
@@ -43,7 +44,14 @@ const MIN_PREMIUM = 1000000n;
 const BUILDER_FEE_MULTIPLIER = 100000000n;
 /** `constants::max_builder_fee_rate` — cap on the builder fee as a share of quantity (0.5%). */
 const MAX_BUILDER_FEE_RATE = 5000000n;
-/** `constants::fee_incentive_subsidy_rate` — sponsor share of a trader's mint fee (20%). */
+/**
+* The default sponsor share of a trader's mint fee (20%), and the rate the chain reads while the
+* admin hasn't set one.
+* @deprecated From delayed execution (DBU-885) the rate is admin-set: read it with
+* `protocol_config::fee_incentive_subsidy_rate` (`read.queue(...).protocol.feeIncentiveSubsidyRate`)
+* and pass it as `feeIncentiveSubsidyRate`. A hardcoded 20% underquotes every mint once the rate
+* moves.
+*/
 const FEE_INCENTIVE_SUBSIDY_RATE = 200000000n;
 /** `order::max_quantity_lots` — the order ID's 32-bit lot field. */
 const MAX_QUANTITY_LOTS = (1n << 32n) - 1n;
@@ -101,9 +109,11 @@ function sqrtDown(x) {
 /**
 * The shipped template (`config_constants` defaults): 10% Bernoulli fee, a 2.2% per-leg floor,
 * a one-day ramp window that is inert at a 1.0 multiplier, a 1%–99% entry band, and inventory
-* impact disabled. A market that was created under these values charges exactly this; one
-* created after an admin change does not, which is why the per-market snapshot is the real
-* answer. Verify against the deployment's `MarketCreated` before pricing money on it.
+* impact disabled. Neither recorded deployment's template matches it any more: both charge a
+* 20.4% Bernoulli fee, ramp it to 3× over the last 60 s and admit entries in 25%–75% (checked
+* 2026-10-09), so a live market's costs from this policy come out low. Pass
+* `read.feePolicy(market)` instead. This stays for tests and for a deployment still on the
+* defaults.
 */
 const SHIPPED_FEE_POLICY = Object.freeze({
 	baseFee: 100000000n,
@@ -185,11 +195,13 @@ function builderFee(fee, quantity, hasBuilderCode) {
 	return min(mulDown(fee, BUILDER_FEE_MULTIPLIER), mulDown(quantity, MAX_BUILDER_FEE_RATE));
 }
 /** `expiry_market::fee_incentive_subsidy_amount` — a sponsor pays part of the trader's MINT
-* fee, bounded by the expiry's remaining sponsored balance. Mints only; redeems pay in full. */
-function feeIncentiveSubsidy(fee, feeIncentiveBalance) {
+* fee, bounded by the expiry's remaining sponsored balance. Mints only; redeems pay in full.
+* `rate` is the protocol's `fee_incentive_subsidy_rate` (1e9-scaled), 20% when omitted. */
+function feeIncentiveSubsidy(fee, feeIncentiveBalance, rate = FEE_INCENTIVE_SUBSIDY_RATE) {
 	assertUint(fee, "fee");
 	assertUint(feeIncentiveBalance, "feeIncentiveBalance");
-	return min(mulDown(fee, FEE_INCENTIVE_SUBSIDY_RATE), feeIncentiveBalance);
+	assertUint(rate, "feeIncentiveSubsidyRate", FLOAT_SCALING);
+	return min(mulDown(fee, rate), feeIncentiveBalance);
 }
 /**
 * `ewma::penalty_fee`'s firing test, as a per-unit RATE: `penalty_rate` when the transaction's
@@ -323,7 +335,7 @@ function timeToExpiry(expiryMs, nowMs) {
 function mintQuoteAt(inputs, boundaries, quantity, timeToExpiryMs) {
 	const premium = mulDown(rangeProbability(boundaries), quantity);
 	const fee = tradingFee(inputs.fees, boundaries, quantity, timeToExpiryMs);
-	const subsidy = feeIncentiveSubsidy(fee, rawAmount(inputs.feeIncentiveBalance ?? 0n));
+	const subsidy = feeIncentiveSubsidy(fee, rawAmount(inputs.feeIncentiveBalance ?? 0n), inputs.feeIncentiveSubsidyRate);
 	const builder = builderFee(fee, quantity, inputs.builderCode ?? false);
 	const penalty = mulDown(inputs.penaltyRate ?? 0n, quantity);
 	const impact = inputs.book ? mintInventoryImpact(inputs.fees, inputs.book, quantity) : 0n;
@@ -540,6 +552,20 @@ function decodeOrderRange(orderId, lotSize = POSITION_LOT_SIZE) {
 		quantity: (orderId >> QUANTITY_LOTS_OFFSET & U32_MASK) * lotSize
 	};
 }
+/**
+* What an order pays at settlement, raw USDC: its full quantity when the settlement price lies
+* in `(lower, higher]`, else 0. The mirror of `strike_exposure::settled_order_payout`, which
+* rounds the settlement price up to the market's tick grid (`range_codec::limit_tick`) before
+* comparing it with the order's ticks, so a price inside a tick counts as that tick's upper edge.
+* Pass `read.settlement`'s `settlementPriceRaw` and `tickSizeRaw`, and the config's
+* `units.positionLotSize` when it isn't the default.
+*/
+function settledPayout(orderId, settlementPriceRaw, tickSizeRaw, lotSize = POSITION_LOT_SIZE) {
+	if (tickSizeRaw <= 0n) throw new PredictInputError("tickSizeRaw must be positive");
+	const { lowerTick, higherTick, quantity } = decodeOrderRange(orderId, lotSize);
+	const limit = (settlementPriceRaw + tickSizeRaw - 1n) / tickSizeRaw;
+	return lowerTick < limit && (higherTick === POS_INF_TICK || limit <= higherTick) ? quantity : 0n;
+}
 /** The strikes an {@link OrderRange} prices against, in USD, with `null` for each infinite
 * side — the shape {@link boundaryProbabilities} takes. `tickSize` is the market's raw tick
 * size (`ActiveMarket.tickSize` in USD, or the raw value from the deployment). */
@@ -551,5 +577,5 @@ function orderStrikes(range, tickSizeRaw) {
 }
 
 //#endregion
-export { cost_exports };
+export { FLOAT_SCALING, MAX_QUANTITY_LOTS, MIN_PREMIUM, POSITION_LOT_SIZE, cost_exports, decodeOrderRange };
 //# sourceMappingURL=cost.mjs.map