@mysten/deepbook-v3 2.6.4 → 2.8.0

package/dist/predict/reads/queue.mjs

@@ -0,0 +1,445 @@
+import { balance, loadAccount } from "../../contracts/account/account.mjs";
+import { OrderView } from "../../contracts/deepbook_predict_orders/order_queue.mjs";
+import { DelayedExecutionPolicy } from "../../contracts/deepbook_predict_orders/delayed_execution_config.mjs";
+import { DELAYED_EXECUTION_VERSION, PREDICT_PACKAGE_VERSION, policyFromBcs } from "../queue.mjs";
+import { inspectReturns } from "./inspect.mjs";
+import { deriveAccountIdFrom, deriveAccountWrapperIdFrom } from "../tx/common.mjs";
+import { policy, versionWatermark as versionWatermark$1 } from "../../contracts/deepbook_predict_orders/desk.mjs";
+import { order, payoutProgress, pendingCounts, queueHeads, queueStuck, quoteRedeemOpen as quoteRedeemOpen$1, waitingCohorts, waitingOrders } from "../../contracts/deepbook_predict_orders/queue.mjs";
+import { queueIdOf } from "../tx/queue.mjs";
+import { MintQuote, RedeemQuote, backingBufferLambda, cashBalance, expiry, mintPaused, orderFlowState, quoteMint, quoteMintExactCostForAccount, quoteMintForAccount as quoteMintForAccount$1, requiredCash } from "../../contracts/deepbook_predict/expiry_market.mjs";
+import { loadLivePricer } from "../tx/trade.mjs";
+import { ProtocolConfig, feeIncentiveSubsidyRate, frozen, isOrderFlow, noTradeWindowMs, tradingPaused, versionWatermark as versionWatermark$2 } from "../../contracts/deepbook_predict/protocol_config.mjs";
+import { parseOptionalU64, parseU64LE } from "./parse.mjs";
+import { bcs } from "@mysten/sui/bcs";
+import { Transaction } from "@mysten/sui/transactions";
+import { normalizeSuiAddress } from "@mysten/sui/utils";
+
+//#region src/predict/reads/queue.ts
+const parseBool = (bytes) => (bytes[0] ?? 0) !== 0;
+const OptionalOrderView = bcs.option(OrderView);
+/** The companion's `order_flow::OrderFlow` witness type, which Predict's allowlist names. */
+function orderFlowWitnessType(config) {
+	return `${config.predictOrdersPackageIdV1}::order_flow::OrderFlow`;
+}
+/**
+* Read a market's queue state in one simulate: Predict's cash figures and gates, the queue's
+* stuck gate, cohorts, heads and counters, and the desk's policy. With `owner`, also the
+* account's waiting-order count and USDC balance (the owner must have an account: loading a
+* missing wrapper aborts the read). With `recordIds`, also those records. The queue must exist.
+*/
+async function marketQueueState(client, config, marketId, opts = {}) {
+	const queueId = queueIdOf(config, {
+		expiryMarketId: marketId,
+		queueId: opts.queueId
+	});
+	const tx = new Transaction();
+	let next = 0;
+	const results = [];
+	const add = (command) => {
+		results.push(tx.add(command));
+		return next++;
+	};
+	const market = { market: marketId };
+	const onQueue = { queue: queueId };
+	const i = {
+		expiry: add(expiry({
+			config,
+			arguments: market
+		})),
+		mintPaused: add(mintPaused({
+			config,
+			arguments: market
+		})),
+		cashBalance: add(cashBalance({
+			config,
+			arguments: market
+		})),
+		requiredCash: add(requiredCash({
+			config,
+			arguments: market
+		})),
+		backingBufferLambda: add(backingBufferLambda({
+			config,
+			arguments: market
+		})),
+		orderFlow: add(orderFlowState({
+			config,
+			arguments: market
+		})),
+		stuck: add(queueStuck({
+			config,
+			arguments: onQueue
+		})),
+		cohorts: add(waitingCohorts({
+			config,
+			arguments: onQueue
+		})),
+		heads: add(queueHeads({
+			config,
+			arguments: onQueue
+		})),
+		pending: add(pendingCounts({
+			config,
+			arguments: onQueue
+		})),
+		payout: add(payoutProgress({
+			config,
+			arguments: onQueue
+		})),
+		policy: add(policy({ config })),
+		deskWatermark: add(versionWatermark$1({ config })),
+		noTradeWindowMs: add(noTradeWindowMs({ config })),
+		subsidyRate: add(feeIncentiveSubsidyRate({ config })),
+		tradingPaused: add(tradingPaused({ config })),
+		frozen: add(frozen({ config })),
+		watermark: add(versionWatermark$2({ config })),
+		orderFlowEnabled: add(isOrderFlow({
+			config,
+			typeArguments: [orderFlowWitnessType(config)]
+		}))
+	};
+	let accountIdx = null;
+	if (opts.owner) {
+		if (!opts.quoteCoinType) throw new Error("marketQueueState: owner reads need quoteCoinType");
+		const accountId = deriveAccountIdFrom(config, opts.owner);
+		const waiting = add(waitingOrders({
+			config,
+			arguments: {
+				...onQueue,
+				accountId
+			}
+		}));
+		const loaded = add(loadAccount({
+			config,
+			arguments: { self: deriveAccountWrapperIdFrom(config, opts.owner) }
+		}));
+		accountIdx = {
+			waiting,
+			balance: add(balance({
+				config,
+				typeArguments: [opts.quoteCoinType],
+				arguments: { self: results[loaded] }
+			})),
+			accountId
+		};
+	}
+	const recordIdx = (opts.recordIds ?? []).map((recordId) => add(order({
+		config,
+		arguments: {
+			...onQueue,
+			recordId
+		}
+	})));
+	const cmds = await inspectReturns(client, tx);
+	const u64 = (idx, value = 0) => parseU64LE(cmds[idx][value]);
+	const cashBalance$1 = u64(i.cashBalance);
+	const requiredCash$1 = u64(i.requiredCash);
+	return {
+		marketId: normalizeSuiAddress(marketId),
+		queueId: normalizeSuiAddress(queueId),
+		expiryMs: u64(i.expiry),
+		mintPaused: parseBool(cmds[i.mintPaused][0]),
+		cashBalance: cashBalance$1,
+		requiredCash: requiredCash$1,
+		spareCash: cashBalance$1 > requiredCash$1 ? cashBalance$1 - requiredCash$1 : 0n,
+		waitingCashNeed: u64(i.orderFlow, 0),
+		payoutTreeNodeCount: u64(i.orderFlow, 1),
+		minEntryProbability: u64(i.orderFlow, 2),
+		backingBufferLambda: u64(i.backingBufferLambda),
+		stuck: parseBool(cmds[i.stuck][0]),
+		cohorts: {
+			count: u64(i.cohorts, 0),
+			oldestUncommittedTauMs: parseOptionalU64(cmds[i.cohorts][1]),
+			oldestUncommittedTauAboveCommittedMs: parseOptionalU64(cmds[i.cohorts][2])
+		},
+		heads: {
+			resolveHead: u64(i.heads, 0),
+			nextId: u64(i.heads, 1),
+			lastTauMs: u64(i.heads, 2),
+			lastCommittedTauMs: u64(i.heads, 3)
+		},
+		pending: {
+			mints: u64(i.pending, 0),
+			sells: u64(i.pending, 1)
+		},
+		payout: {
+			cursor: u64(i.payout, 0),
+			nextId: u64(i.payout, 1),
+			completed: parseBool(cmds[i.payout][2])
+		},
+		desk: {
+			id: normalizeSuiAddress(config.orderDesk),
+			policy: policyFromBcs(DelayedExecutionPolicy.parse(cmds[i.policy][0])),
+			versionWatermark: u64(i.deskWatermark)
+		},
+		protocol: {
+			noTradeWindowMs: u64(i.noTradeWindowMs),
+			feeIncentiveSubsidyRate: u64(i.subsidyRate),
+			tradingPaused: parseBool(cmds[i.tradingPaused][0]),
+			frozen: parseBool(cmds[i.frozen][0]),
+			versionWatermark: u64(i.watermark),
+			orderFlowEnabled: parseBool(cmds[i.orderFlowEnabled][0])
+		},
+		account: accountIdx ? {
+			accountId: accountIdx.accountId,
+			waitingOrders: u64(accountIdx.waiting),
+			availableRaw: u64(accountIdx.balance)
+		} : null,
+		records: recordIdx.map((idx) => OptionalOrderView.parse(cmds[idx][0]) ?? null)
+	};
+}
+/** Queue records by record ID (`queue::order`), `null` for a missing or cleaned-up one. One simulate. */
+async function queuedOrders(client, config, target, recordIds) {
+	if (recordIds.length === 0) return [];
+	const queueId = queueIdOf(config, target);
+	const tx = new Transaction();
+	for (const recordId of recordIds) tx.add(order({
+		config,
+		arguments: {
+			queue: queueId,
+			recordId
+		}
+	}));
+	return (await inspectReturns(client, tx)).map((rv) => OptionalOrderView.parse(rv[0]) ?? null);
+}
+/**
+* `ProtocolConfig.version_watermark`, read from the object's own BCS rather than a getter, so it
+* works against any package version: the getter only exists from the delayed-execution package
+* on, while the struct layout is frozen since v1.
+*/
+async function versionWatermark(client, protocolConfigId) {
+	const { object } = await client.core.getObject({
+		objectId: protocolConfigId,
+		include: { content: true }
+	});
+	if (!object.content) throw new Error(`ProtocolConfig ${protocolConfigId} returned no content`);
+	return ProtocolConfig.parse(object.content).version_watermark;
+}
+/**
+* The {@link ExecutionMode} for a watermark and what the config records.
+* `recordsDelayedExecution`: the Predict upgrade, the order-flow companion and its desk, which
+* queued orders need. `recordsPredictUpgrade`: the Predict upgrade alone
+* (`packages.predictDelayedExecution`), which makes the config's Predict call target the package
+* that retired the immediate trades. It defaults to `recordsDelayedExecution`.
+*/
+function executionModeFor(watermark, recordsDelayedExecution, recordsPredictUpgrade = recordsDelayedExecution) {
+	if (watermark >= DELAYED_EXECUTION_VERSION) {
+		if (!recordsDelayedExecution) return "unsupported";
+		return watermark > PREDICT_PACKAGE_VERSION ? "retired" : "delayed";
+	}
+	return recordsDelayedExecution || recordsPredictUpgrade ? "awaiting-cutover" : "immediate";
+}
+/**
+* USDC sent to an account's wrapper address with `send_funds` that the account hasn't settled
+* yet: refunds, sell proceeds and settled payouts land here. `account::balance` already counts
+* them, so this is for display ("pending funds"), not for sizing.
+*/
+async function pendingFunds(client, wrapperId, coinType) {
+	const { balance: balance$1 } = await client.core.getBalance({
+		owner: wrapperId,
+		coinType
+	});
+	return BigInt(balance$1.addressBalance);
+}
+const LazerStatePrefix = bcs.struct("State", {
+	id: bcs.Address,
+	trusted_signers: bcs.vector(bcs.struct("TrustedSignerInfo", {
+		public_key: bcs.vector(bcs.u8()),
+		expires_at: bcs.u64()
+	})),
+	upgrade_cap: bcs.struct("UpgradeCap", {
+		id: bcs.Address,
+		package: bcs.Address,
+		version: bcs.u64(),
+		policy: bcs.u8()
+	})
+});
+/**
+* The current Pyth Lazer package (from `State.upgrade_cap.package`) and the original ID that
+* types `update::Update` (from the State's own type). Read it per filler batch and never cache
+* it: a Lazer upgrade retires the old package at once.
+*/
+async function lazerPackages(client, stateId) {
+	const { object } = await client.core.getObject({
+		objectId: stateId,
+		include: { content: true }
+	});
+	if (!object.content) throw new Error(`Lazer State ${stateId} returned no content`);
+	const [originalId, module, name] = object.type.split("::");
+	if (module !== "state" || name !== "State") throw new Error(`${stateId} is a ${object.type}, not a Pyth Lazer State`);
+	return {
+		stateId: normalizeSuiAddress(stateId),
+		packageId: normalizeSuiAddress(LazerStatePrefix.parse(object.content).upgrade_cap.package),
+		originalId: normalizeSuiAddress(originalId)
+	};
+}
+/**
+* Quote an early sell of an Open record at a fresh live pricer (`load_live_pricer`, then the
+* queue's `quote_redeem_open`, which prices through Predict's `quote_close`), and read the desk's
+* policy for the order fee. `proceeds` is before the order fee, with no congestion penalty.
+* Aborts `ERecordNotOpen` when the record isn't Open. It doesn't check that the wrapper's account
+* owns the record: the wrapper only supplies the builder code.
+*/
+async function quoteRedeemOpen(client, config, args) {
+	const tx = new Transaction();
+	const pricer = tx.add(loadLivePricer(config, args));
+	tx.add(quoteRedeemOpen$1({
+		config,
+		arguments: {
+			queue: queueIdOf(config, args),
+			market: args.expiryMarketId,
+			wrapper: args.wrapperId,
+			pricer,
+			recordId: args.recordId,
+			closeQuantity: args.closeQuantityRaw
+		}
+	}));
+	tx.add(policy({ config }));
+	const cmds = await inspectReturns(client, tx);
+	const q = RedeemQuote.parse(cmds[1][0]);
+	return {
+		quote: {
+			closeQuantity: q.close_quantity,
+			probability: q.probability,
+			proceeds: q.proceeds,
+			tradingFee: q.trading_fee,
+			builderFee: q.builder_fee,
+			inventoryImpactRebate: q.inventory_impact_rebate
+		},
+		policy: policyFromBcs(DelayedExecutionPolicy.parse(cmds[2][0]))
+	};
+}
+/**
+* Quote a mint for one account without placing it: Predict's `quote_mint_for_account` (exact
+* quantity and premium budget) or `quote_mint_exact_cost_for_account` (all-in budget), at a fresh
+* live pricer. Both read the account's builder code and cap a budget at its balance. From the
+* delayed-execution package on they price like a queued fill at the clock: no congestion penalty,
+* and no trade-window or Pyth-staleness abort. They abort `EOrderFailsLimits` when the mint would
+* be refused at the clock. With `ordersConfig`, also reads the order desk's policy.
+*/
+async function quoteMintForAccount(client, config, args) {
+	const tx = new Transaction();
+	const pricer = tx.add(loadLivePricer(config, args));
+	const base = {
+		market: args.expiryMarketId,
+		wrapper: args.wrapperId,
+		pricer,
+		lowerTick: args.lowerTick,
+		higherTick: args.higherTick
+	};
+	const r = args.request;
+	if (r.shape === "exact-cost") tx.add(quoteMintExactCostForAccount({
+		config,
+		arguments: {
+			...base,
+			maxCost: r.maxCostRaw,
+			minQuantity: r.minQuantityRaw
+		}
+	}));
+	else tx.add(quoteMintForAccount$1({
+		config,
+		arguments: r.shape === "exact-quantity" ? {
+			...base,
+			maxPremium: 0n,
+			minQuantity: r.quantityRaw,
+			exactQuantity: true
+		} : {
+			...base,
+			maxPremium: r.maxPremiumRaw,
+			minQuantity: r.minQuantityRaw,
+			exactQuantity: false
+		}
+	}));
+	if (args.ordersConfig) tx.add(policy({ config: args.ordersConfig }));
+	const cmds = await inspectReturns(client, tx);
+	const q = MintQuote.parse(cmds[1][0]);
+	return {
+		quote: {
+			quantity: q.quantity,
+			entryProbability: q.entry_probability,
+			premium: q.premium,
+			tradingFee: q.trading_fee,
+			feeIncentiveSubsidy: q.fee_incentive_subsidy,
+			builderFee: q.builder_fee,
+			penaltyFee: q.penalty_fee,
+			inventoryImpactCharge: q.inventory_impact_charge,
+			allInCost: q.all_in_cost
+		},
+		policy: args.ordersConfig ? policyFromBcs(DelayedExecutionPolicy.parse(cmds[2][0])) : null
+	};
+}
+/**
+* Quote a mint for no particular account: Predict's `quote_mint`, at a fresh live pricer. It
+* prices like a queued fill at the clock with no builder fee, so it previews a mint for a visitor
+* without an account or a funded balance. It has no all-in budget mode. It aborts
+* `EOrderFailsLimits` when the mint would be refused at the clock, for example below the 1 USDC
+* minimum premium. With `ordersConfig`, also reads the order desk's policy.
+*/
+async function quoteMintAnonymous(client, config, args) {
+	const tx = new Transaction();
+	const pricer = tx.add(loadLivePricer(config, args));
+	const r = args.request;
+	tx.add(quoteMint({
+		config,
+		arguments: {
+			market: args.expiryMarketId,
+			pricer,
+			lowerTick: args.lowerTick,
+			higherTick: args.higherTick,
+			...r.shape === "exact-quantity" ? {
+				maxPremium: 0n,
+				minQuantity: r.quantityRaw,
+				exactQuantity: true
+			} : {
+				maxPremium: r.maxPremiumRaw,
+				minQuantity: r.minQuantityRaw,
+				exactQuantity: false
+			}
+		}
+	}));
+	if (args.ordersConfig) tx.add(policy({ config: args.ordersConfig }));
+	const cmds = await inspectReturns(client, tx);
+	const q = MintQuote.parse(cmds[1][0]);
+	return {
+		quote: {
+			quantity: q.quantity,
+			entryProbability: q.entry_probability,
+			premium: q.premium,
+			tradingFee: q.trading_fee,
+			feeIncentiveSubsidy: q.fee_incentive_subsidy,
+			builderFee: q.builder_fee,
+			penaltyFee: q.penalty_fee,
+			inventoryImpactCharge: q.inventory_impact_charge,
+			allInCost: q.all_in_cost
+		},
+		policy: args.ordersConfig ? policyFromBcs(DelayedExecutionPolicy.parse(cmds[2][0])) : null
+	};
+}
+/**
+* The order desk's policy and an owner's USDC balance, in one simulate. The queued exact-cost
+* quote needs both: enqueue escrows `min(max_cost, available − fee)`, while the chain quote caps
+* at the whole balance.
+*/
+async function orderFeeAndBalance(client, config, owner, coinType) {
+	const tx = new Transaction();
+	tx.add(policy({ config }));
+	const loaded = tx.add(loadAccount({
+		config,
+		arguments: { self: deriveAccountWrapperIdFrom(config, owner) }
+	}));
+	tx.add(balance({
+		config,
+		typeArguments: [coinType],
+		arguments: { self: loaded }
+	}));
+	const cmds = await inspectReturns(client, tx);
+	return {
+		policy: policyFromBcs(DelayedExecutionPolicy.parse(cmds[0][0])),
+		availableRaw: parseU64LE(cmds[2][0])
+	};
+}
+
+//#endregion
+export { executionModeFor, lazerPackages, marketQueueState, orderFeeAndBalance, orderFlowWitnessType, pendingFunds, queuedOrders, quoteMintAnonymous, quoteMintForAccount, quoteRedeemOpen, versionWatermark };
+//# sourceMappingURL=queue.mjs.map

package/dist/predict/reads/queue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.mjs","names":["OrderViewBcs","expiryMarket.expiry","expiryMarket.mintPaused","expiryMarket.cashBalance","expiryMarket.requiredCash","expiryMarket.backingBufferLambda","expiryMarket.orderFlowState","queue.queueStuck","queue.waitingCohorts","queue.queueHeads","queue.pendingCounts","queue.payoutProgress","desk.policy","desk.versionWatermark","protocolConfig.noTradeWindowMs","protocolConfig.feeIncentiveSubsidyRate","protocolConfig.tradingPaused","protocolConfig.frozen","protocolConfig.versionWatermark","protocolConfig.isOrderFlow","queue.waitingOrders","account.loadAccount","account.balance","queue.order","cashBalance","requiredCash","DelayedExecutionPolicyBcs","balance","queue.quoteRedeemOpen","expiryMarket.quoteMintExactCostForAccount","expiryMarket.quoteMintForAccount","expiryMarket.quoteMint"],"sources":["../../../src/predict/reads/queue.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n// Delayed execution (DBU-885): chain reads for the order queue. A market's queue is a\n// `MarketQueue` in the order-flow companion (`deepbook_predict_orders`), at an ID derived from the\n// companion's `OrderDesk` and the market, so these reads take `OrdersGeneratedConfig` and the\n// facade gates them on the config recording the companion. The market's cash figures stay\n// Predict reads. A market whose queue doesn't exist yet can't be read: the facade checks that\n// first.\nimport type { ClientWithCoreApi } from '@mysten/sui/client';\nimport { bcs } from '@mysten/sui/bcs';\nimport { Transaction, type TransactionResult } from '@mysten/sui/transactions';\nimport { normalizeSuiAddress } from '@mysten/sui/utils';\nimport type { GeneratedConfig, OrdersGeneratedConfig } from '../config/generated.js';\nimport {\n\tDELAYED_EXECUTION_VERSION,\n\tPREDICT_PACKAGE_VERSION,\n\tpolicyFromBcs,\n\ttype DelayedExecutionPolicy,\n\ttype QueueHeads,\n\ttype QueuedOrder,\n} from '../queue.js';\nimport { deriveAccountIdFrom, deriveAccountWrapperIdFrom } from '../tx/common.js';\nimport { queueIdOf, type QueueTarget } from '../tx/queue.js';\nimport { loadLivePricer, type MarketFeeds } from '../tx/trade.js';\nimport { accountMoveCalls as account } from '../../account.js';\nimport * as expiryMarket from '../../contracts/deepbook_predict/expiry_market.js';\nimport * as protocolConfig from '../../contracts/deepbook_predict/protocol_config.js';\nimport { DelayedExecutionPolicy as DelayedExecutionPolicyBcs } from '../../contracts/deepbook_predict_orders/delayed_execution_config.js';\nimport * as desk from '../../contracts/deepbook_predict_orders/desk.js';\nimport { OrderView as OrderViewBcs } from '../../contracts/deepbook_predict_orders/order_queue.js';\nimport * as queue from '../../contracts/deepbook_predict_orders/queue.js';\nimport { inspectReturns, type ReadClient } from './inspect.js';\nimport { parseOptionalU64, parseU64LE } from './parse.js';\n\nconst parseBool = (bytes: Uint8Array): boolean => (bytes[0] ?? 0) !== 0;\nconst OptionalOrderView = bcs.option(OrderViewBcs);\n\n/** The companion's `order_flow::OrderFlow` witness type, which Predict's allowlist names. */\nexport function orderFlowWitnessType(\n\tconfig: Pick<OrdersGeneratedConfig, 'predictOrdersPackageIdV1'>,\n) {\n\treturn `${config.predictOrdersPackageIdV1}::order_flow::OrderFlow`;\n}\n\n/** Everything the queued-order preflight and the app's queue view read, from one simulate. */\nexport interface MarketQueueState {\n\tmarketId: string;\n\t/** The market's `MarketQueue`. */\n\tqueueId: string;\n\texpiryMs: bigint;\n\tmintPaused: boolean;\n\tcashBalance: bigint;\n\trequiredCash: bigint;\n\t/**\n\t * Cash above required cash, 0 when below: the largest cash need a new queued mint may have\n\t * now (Predict's admission refuses a larger one).\n\t */\n\tspareCash: bigint;\n\t/** Summed cash need of the admitted orders; `rebalance_expiry_cash` funds it. */\n\twaitingCashNeed: bigint;\n\t/** 1e9-scaled. The mint cash-need formulas take it. */\n\tminEntryProbability: bigint;\n\t/** 1e9-scaled λ. The sell cash-need formula takes it. */\n\tbackingBufferLambda: bigint;\n\t/** Sizes a filler's resolve batch. */\n\tpayoutTreeNodeCount: bigint;\n\t/** `queue_stuck`: enqueue would refuse as stuck right now (\"pricing delayed\"). */\n\tstuck: boolean;\n\tcohorts: {\n\t\tcount: bigint;\n\t\toldestUncommittedTauMs: bigint | null;\n\t\t/** The cohort the stuck gate's first rule watches. */\n\t\toldestUncommittedTauAboveCommittedMs: bigint | null;\n\t};\n\theads: QueueHeads;\n\t/** Unfinished mints and sells, against the policy capacities. */\n\tpending: { mints: bigint; sells: bigint };\n\t/**\n\t * The settlement payout walk (`settle_step`): it resumes at `cursor`, and `completed` is set\n\t * by the call that emits `MarketPayoutsCompleted`.\n\t */\n\tpayout: { cursor: bigint; nextId: bigint; completed: boolean };\n\t/** The companion's `OrderDesk`: the policy every queue runs under, and its version floor. */\n\tdesk: {\n\t\tid: string;\n\t\tpolicy: DelayedExecutionPolicy;\n\t\tversionWatermark: bigint;\n\t};\n\tprotocol: {\n\t\tnoTradeWindowMs: bigint;\n\t\t/** The admin-set mint fee subsidy rate, 1e9-scaled (20% when unset). */\n\t\tfeeIncentiveSubsidyRate: bigint;\n\t\ttradingPaused: boolean;\n\t\tfrozen: boolean;\n\t\t/** Predict's version floor. Enqueue needs it at `DELAYED_EXECUTION_VERSION`. */\n\t\tversionWatermark: bigint;\n\t\t/**\n\t\t * Whether Predict allowlists this companion's `OrderFlow` witness\n\t\t * (`protocol_config::set_order_flow`). Predict's admission, commit and fill refuse it until\n\t\t * then (`EOrderFlowNotAllowed`).\n\t\t */\n\t\torderFlowEnabled: boolean;\n\t};\n\t/** Present when an owner was given. */\n\taccount: {\n\t\taccountId: string;\n\t\t/**\n\t\t * Unfinished orders the account holds in this market, against `per_account_cap`. Stale\n\t\t * after expiry: the settlement drain refunds without lowering it.\n\t\t */\n\t\twaitingOrders: bigint;\n\t\t/** `account::balance<USDC>`, unsettled accumulator funds included. */\n\t\tavailableRaw: bigint;\n\t} | null;\n\t/** One entry per requested record ID: the record, or `null` when missing or deleted. */\n\trecords: (QueuedOrder | null)[];\n}\n\n/**\n * Read a market's queue state in one simulate: Predict's cash figures and gates, the queue's\n * stuck gate, cohorts, heads and counters, and the desk's policy. With `owner`, also the\n * account's waiting-order count and USDC balance (the owner must have an account: loading a\n * missing wrapper aborts the read). With `recordIds`, also those records. The queue must exist.\n */\nexport async function marketQueueState(\n\tclient: ReadClient,\n\tconfig: OrdersGeneratedConfig,\n\tmarketId: string,\n\topts: {\n\t\towner?: string;\n\t\tquoteCoinType?: string;\n\t\trecordIds?: readonly bigint[];\n\t\tqueueId?: string;\n\t} = {},\n): Promise<MarketQueueState> {\n\tconst queueId = queueIdOf(config, { expiryMarketId: marketId, queueId: opts.queueId });\n\tconst tx = new Transaction();\n\tlet next = 0;\n\tconst results: TransactionResult[] = [];\n\tconst add = (command: (tx: Transaction) => TransactionResult): number => {\n\t\tresults.push(tx.add(command));\n\t\treturn next++;\n\t};\n\tconst market = { market: marketId };\n\tconst onQueue = { queue: queueId };\n\tconst i = {\n\t\texpiry: add(expiryMarket.expiry({ config, arguments: market })),\n\t\tmintPaused: add(expiryMarket.mintPaused({ config, arguments: market })),\n\t\tcashBalance: add(expiryMarket.cashBalance({ config, arguments: market })),\n\t\trequiredCash: add(expiryMarket.requiredCash({ config, arguments: market })),\n\t\tbackingBufferLambda: add(expiryMarket.backingBufferLambda({ config, arguments: market })),\n\t\torderFlow: add(expiryMarket.orderFlowState({ config, arguments: market })),\n\t\tstuck: add(queue.queueStuck({ config, arguments: onQueue })),\n\t\tcohorts: add(queue.waitingCohorts({ config, arguments: onQueue })),\n\t\theads: add(queue.queueHeads({ config, arguments: onQueue })),\n\t\tpending: add(queue.pendingCounts({ config, arguments: onQueue })),\n\t\tpayout: add(queue.payoutProgress({ config, arguments: onQueue })),\n\t\tpolicy: add(desk.policy({ config })),\n\t\tdeskWatermark: add(desk.versionWatermark({ config })),\n\t\tnoTradeWindowMs: add(protocolConfig.noTradeWindowMs({ config })),\n\t\tsubsidyRate: add(protocolConfig.feeIncentiveSubsidyRate({ config })),\n\t\ttradingPaused: add(protocolConfig.tradingPaused({ config })),\n\t\tfrozen: add(protocolConfig.frozen({ config })),\n\t\twatermark: add(protocolConfig.versionWatermark({ config })),\n\t\torderFlowEnabled: add(\n\t\t\tprotocolConfig.isOrderFlow({ config, typeArguments: [orderFlowWitnessType(config)] }),\n\t\t),\n\t};\n\tlet accountIdx: { waiting: number; balance: number; accountId: string } | null = null;\n\tif (opts.owner) {\n\t\tif (!opts.quoteCoinType) throw new Error('marketQueueState: owner reads need quoteCoinType');\n\t\tconst accountId = deriveAccountIdFrom(config, opts.owner);\n\t\tconst waiting = add(queue.waitingOrders({ config, arguments: { ...onQueue, accountId } }));\n\t\tconst loaded = add(\n\t\t\taccount.loadAccount({\n\t\t\t\tconfig,\n\t\t\t\targuments: { self: deriveAccountWrapperIdFrom(config, opts.owner) },\n\t\t\t}),\n\t\t);\n\t\tconst balance = add(\n\t\t\taccount.balance({\n\t\t\t\tconfig,\n\t\t\t\ttypeArguments: [opts.quoteCoinType],\n\t\t\t\targuments: { self: results[loaded] },\n\t\t\t}),\n\t\t);\n\t\taccountIdx = { waiting, balance, accountId };\n\t}\n\tconst recordIdx = (opts.recordIds ?? []).map((recordId) =>\n\t\tadd(queue.order({ config, arguments: { ...onQueue, recordId } })),\n\t);\n\n\tconst cmds = await inspectReturns(client, tx);\n\tconst u64 = (idx: number, value = 0) => parseU64LE(cmds[idx][value]);\n\tconst cashBalance = u64(i.cashBalance);\n\tconst requiredCash = u64(i.requiredCash);\n\treturn {\n\t\tmarketId: normalizeSuiAddress(marketId),\n\t\tqueueId: normalizeSuiAddress(queueId),\n\t\texpiryMs: u64(i.expiry),\n\t\tmintPaused: parseBool(cmds[i.mintPaused][0]),\n\t\tcashBalance,\n\t\trequiredCash,\n\t\tspareCash: cashBalance > requiredCash ? cashBalance - requiredCash : 0n,\n\t\twaitingCashNeed: u64(i.orderFlow, 0),\n\t\tpayoutTreeNodeCount: u64(i.orderFlow, 1),\n\t\tminEntryProbability: u64(i.orderFlow, 2),\n\t\tbackingBufferLambda: u64(i.backingBufferLambda),\n\t\tstuck: parseBool(cmds[i.stuck][0]),\n\t\tcohorts: {\n\t\t\tcount: u64(i.cohorts, 0),\n\t\t\toldestUncommittedTauMs: parseOptionalU64(cmds[i.cohorts][1]),\n\t\t\toldestUncommittedTauAboveCommittedMs: parseOptionalU64(cmds[i.cohorts][2]),\n\t\t},\n\t\theads: {\n\t\t\tresolveHead: u64(i.heads, 0),\n\t\t\tnextId: u64(i.heads, 1),\n\t\t\tlastTauMs: u64(i.heads, 2),\n\t\t\tlastCommittedTauMs: u64(i.heads, 3),\n\t\t},\n\t\tpending: { mints: u64(i.pending, 0), sells: u64(i.pending, 1) },\n\t\tpayout: {\n\t\t\tcursor: u64(i.payout, 0),\n\t\t\tnextId: u64(i.payout, 1),\n\t\t\tcompleted: parseBool(cmds[i.payout][2]),\n\t\t},\n\t\tdesk: {\n\t\t\tid: normalizeSuiAddress(config.orderDesk),\n\t\t\tpolicy: policyFromBcs(DelayedExecutionPolicyBcs.parse(cmds[i.policy][0])),\n\t\t\tversionWatermark: u64(i.deskWatermark),\n\t\t},\n\t\tprotocol: {\n\t\t\tnoTradeWindowMs: u64(i.noTradeWindowMs),\n\t\t\tfeeIncentiveSubsidyRate: u64(i.subsidyRate),\n\t\t\ttradingPaused: parseBool(cmds[i.tradingPaused][0]),\n\t\t\tfrozen: parseBool(cmds[i.frozen][0]),\n\t\t\tversionWatermark: u64(i.watermark),\n\t\t\torderFlowEnabled: parseBool(cmds[i.orderFlowEnabled][0]),\n\t\t},\n\t\taccount: accountIdx\n\t\t\t? {\n\t\t\t\t\taccountId: accountIdx.accountId,\n\t\t\t\t\twaitingOrders: u64(accountIdx.waiting),\n\t\t\t\t\tavailableRaw: u64(accountIdx.balance),\n\t\t\t\t}\n\t\t\t: null,\n\t\trecords: recordIdx.map((idx) => OptionalOrderView.parse(cmds[idx][0]) ?? null),\n\t};\n}\n\n/** Queue records by record ID (`queue::order`), `null` for a missing or cleaned-up one. One simulate. */\nexport async function queuedOrders(\n\tclient: ReadClient,\n\tconfig: OrdersGeneratedConfig,\n\ttarget: QueueTarget,\n\trecordIds: readonly bigint[],\n): Promise<(QueuedOrder | null)[]> {\n\tif (recordIds.length === 0) return [];\n\tconst queueId = queueIdOf(config, target);\n\tconst tx = new Transaction();\n\tfor (const recordId of recordIds) {\n\t\ttx.add(queue.order({ config, arguments: { queue: queueId, recordId } }));\n\t}\n\tconst cmds = await inspectReturns(client, tx);\n\treturn cmds.map((rv) => OptionalOrderView.parse(rv[0]) ?? null);\n}\n\n/**\n * `ProtocolConfig.version_watermark`, read from the object's own BCS rather than a getter, so it\n * works against any package version: the getter only exists from the delayed-execution package\n * on, while the struct layout is frozen since v1.\n */\nexport async function versionWatermark(\n\tclient: ClientWithCoreApi,\n\tprotocolConfigId: string,\n): Promise<bigint> {\n\tconst { object } = await client.core.getObject({\n\t\tobjectId: protocolConfigId,\n\t\tinclude: { content: true },\n\t});\n\tif (!object.content) throw new Error(`ProtocolConfig ${protocolConfigId} returned no content`);\n\treturn protocolConfig.ProtocolConfig.parse(object.content).version_watermark;\n}\n\n/**\n * Which trade path a network is on:\n * - `'immediate'`: the watermark isn't raised and this SDK has no delayed-execution record, so\n *   its call target is a pre-v4 Predict package. Use the immediate `mint*` / `redeem` builders.\n * - `'awaiting-cutover'`: the config records delayed execution but the watermark isn't raised.\n *   Nothing trades: enqueue aborts `ECutoverNotReached`, and the immediate builders abort in the\n *   v4 package the config calls (`EDelayedExecutionRequired`). Trading stays paused through the\n *   cutover.\n * - `'delayed'`: the watermark is raised. Use the `enqueue*` builders; the immediate ones abort\n *   `EDelayedExecutionRequired`.\n * - `'unsupported'`: the watermark is raised but this SDK's config has no delayed-execution\n *   record for the network. Upgrade the SDK, or pass a config that records it.\n * - `'retired'`: the watermark is above the Predict code version this SDK calls\n *   (`PREDICT_PACKAGE_VERSION`), so every version-gated call aborts `EPackageVersionDisabled`.\n *   Upgrade the SDK.\n */\nexport type ExecutionMode =\n\t'immediate' | 'awaiting-cutover' | 'delayed' | 'unsupported' | 'retired';\n\n/**\n * The {@link ExecutionMode} for a watermark and what the config records.\n * `recordsDelayedExecution`: the Predict upgrade, the order-flow companion and its desk, which\n * queued orders need. `recordsPredictUpgrade`: the Predict upgrade alone\n * (`packages.predictDelayedExecution`), which makes the config's Predict call target the package\n * that retired the immediate trades. It defaults to `recordsDelayedExecution`.\n */\nexport function executionModeFor(\n\twatermark: bigint,\n\trecordsDelayedExecution: boolean,\n\trecordsPredictUpgrade: boolean = recordsDelayedExecution,\n): ExecutionMode {\n\tif (watermark >= DELAYED_EXECUTION_VERSION) {\n\t\tif (!recordsDelayedExecution) return 'unsupported';\n\t\treturn watermark > PREDICT_PACKAGE_VERSION ? 'retired' : 'delayed';\n\t}\n\treturn recordsDelayedExecution || recordsPredictUpgrade ? 'awaiting-cutover' : 'immediate';\n}\n\n/**\n * USDC sent to an account's wrapper address with `send_funds` that the account hasn't settled\n * yet: refunds, sell proceeds and settled payouts land here. `account::balance` already counts\n * them, so this is for display (\"pending funds\"), not for sizing.\n */\nexport async function pendingFunds(\n\tclient: ClientWithCoreApi,\n\twrapperId: string,\n\tcoinType: string,\n): Promise<bigint> {\n\tconst { balance } = await client.core.getBalance({ owner: wrapperId, coinType });\n\treturn BigInt(balance.addressBalance);\n}\n\n// The prefix of `pyth_lazer::state::State` up to the upgrade cap, identical in the testnet and\n// mainnet vendored sources. Parsing a prefix ignores the trailing `governance` field.\nconst LazerStatePrefix = bcs.struct('State', {\n\tid: bcs.Address,\n\ttrusted_signers: bcs.vector(\n\t\tbcs.struct('TrustedSignerInfo', { public_key: bcs.vector(bcs.u8()), expires_at: bcs.u64() }),\n\t),\n\tupgrade_cap: bcs.struct('UpgradeCap', {\n\t\tid: bcs.Address,\n\t\tpackage: bcs.Address,\n\t\tversion: bcs.u64(),\n\t\tpolicy: bcs.u8(),\n\t}),\n});\n\n/**\n * The current Pyth Lazer package (from `State.upgrade_cap.package`) and the original ID that\n * types `update::Update` (from the State's own type). Read it per filler batch and never cache\n * it: a Lazer upgrade retires the old package at once.\n */\nexport async function lazerPackages(\n\tclient: ClientWithCoreApi,\n\tstateId: string,\n): Promise<{ stateId: string; packageId: string; originalId: string }> {\n\tconst { object } = await client.core.getObject({ objectId: stateId, include: { content: true } });\n\tif (!object.content) throw new Error(`Lazer State ${stateId} returned no content`);\n\tconst [originalId, module, name] = object.type.split('::');\n\tif (module !== 'state' || name !== 'State') {\n\t\tthrow new Error(`${stateId} is a ${object.type}, not a Pyth Lazer State`);\n\t}\n\treturn {\n\t\tstateId: normalizeSuiAddress(stateId),\n\t\tpackageId: normalizeSuiAddress(LazerStatePrefix.parse(object.content).upgrade_cap.package),\n\t\toriginalId: normalizeSuiAddress(originalId),\n\t};\n}\n\n/** `expiry_market::RedeemQuote` with camelCase keys. `proceeds` is before the order fee. */\nexport interface RedeemOpenQuoteRaw {\n\tcloseQuantity: bigint;\n\tprobability: bigint;\n\tproceeds: bigint;\n\ttradingFee: bigint;\n\tbuilderFee: bigint;\n\tinventoryImpactRebate: bigint;\n}\n\n/**\n * Quote an early sell of an Open record at a fresh live pricer (`load_live_pricer`, then the\n * queue's `quote_redeem_open`, which prices through Predict's `quote_close`), and read the desk's\n * policy for the order fee. `proceeds` is before the order fee, with no congestion penalty.\n * Aborts `ERecordNotOpen` when the record isn't Open. It doesn't check that the wrapper's account\n * owns the record: the wrapper only supplies the builder code.\n */\nexport async function quoteRedeemOpen(\n\tclient: ReadClient,\n\tconfig: OrdersGeneratedConfig,\n\targs: QueueTarget & {\n\t\twrapperId: string;\n\t\trecordId: bigint;\n\t\tcloseQuantityRaw: bigint;\n\t} & MarketFeeds,\n): Promise<{ quote: RedeemOpenQuoteRaw; policy: DelayedExecutionPolicy }> {\n\tconst tx = new Transaction();\n\tconst pricer = tx.add(loadLivePricer(config, args));\n\ttx.add(\n\t\tqueue.quoteRedeemOpen({\n\t\t\tconfig,\n\t\t\targuments: {\n\t\t\t\tqueue: queueIdOf(config, args),\n\t\t\t\tmarket: args.expiryMarketId,\n\t\t\t\twrapper: args.wrapperId,\n\t\t\t\tpricer,\n\t\t\t\trecordId: args.recordId,\n\t\t\t\tcloseQuantity: args.closeQuantityRaw,\n\t\t\t},\n\t\t}),\n\t);\n\ttx.add(desk.policy({ config }));\n\tconst cmds = await inspectReturns(client, tx);\n\tconst q = expiryMarket.RedeemQuote.parse(cmds[1][0]);\n\treturn {\n\t\tquote: {\n\t\t\tcloseQuantity: q.close_quantity,\n\t\t\tprobability: q.probability,\n\t\t\tproceeds: q.proceeds,\n\t\t\ttradingFee: q.trading_fee,\n\t\t\tbuilderFee: q.builder_fee,\n\t\t\tinventoryImpactRebate: q.inventory_impact_rebate,\n\t\t},\n\t\tpolicy: policyFromBcs(DelayedExecutionPolicyBcs.parse(cmds[2][0])),\n\t};\n}\n\n/**\n * `expiry_market::MintQuote` with camelCase keys. `allInCost` includes `penaltyFee`, which the\n * delayed-execution package always quotes as 0: its quotes price like a queued fill.\n */\nexport interface MintQuoteRaw {\n\tquantity: bigint;\n\tentryProbability: bigint;\n\tpremium: bigint;\n\ttradingFee: bigint;\n\tfeeIncentiveSubsidy: bigint;\n\tbuilderFee: bigint;\n\tpenaltyFee: bigint;\n\tinventoryImpactCharge: bigint;\n\tallInCost: bigint;\n}\n\n/** What to quote: an exact quantity, a premium budget, or an all-in budget. */\nexport type MintQuoteRequest =\n\t| { shape: 'exact-quantity'; quantityRaw: bigint }\n\t| { shape: 'exact-amount'; maxPremiumRaw: bigint; minQuantityRaw: bigint }\n\t| { shape: 'exact-cost'; maxCostRaw: bigint; minQuantityRaw: bigint };\n\n/**\n * Quote a mint for one account without placing it: Predict's `quote_mint_for_account` (exact\n * quantity and premium budget) or `quote_mint_exact_cost_for_account` (all-in budget), at a fresh\n * live pricer. Both read the account's builder code and cap a budget at its balance. From the\n * delayed-execution package on they price like a queued fill at the clock: no congestion penalty,\n * and no trade-window or Pyth-staleness abort. They abort `EOrderFailsLimits` when the mint would\n * be refused at the clock. With `ordersConfig`, also reads the order desk's policy.\n */\nexport async function quoteMintForAccount(\n\tclient: ReadClient,\n\tconfig: GeneratedConfig,\n\targs: {\n\t\texpiryMarketId: string;\n\t\twrapperId: string;\n\t\tlowerTick: bigint;\n\t\thigherTick: bigint;\n\t\trequest: MintQuoteRequest;\n\t\t/** Also read the order desk's policy, in the same simulate. */\n\t\tordersConfig?: OrdersGeneratedConfig;\n\t} & MarketFeeds,\n): Promise<{ quote: MintQuoteRaw; policy: DelayedExecutionPolicy | null }> {\n\tconst tx = new Transaction();\n\tconst pricer = tx.add(loadLivePricer(config, args));\n\tconst base = {\n\t\tmarket: args.expiryMarketId,\n\t\twrapper: args.wrapperId,\n\t\tpricer,\n\t\tlowerTick: args.lowerTick,\n\t\thigherTick: args.higherTick,\n\t};\n\tconst r = args.request;\n\tif (r.shape === 'exact-cost') {\n\t\ttx.add(\n\t\t\texpiryMarket.quoteMintExactCostForAccount({\n\t\t\t\tconfig,\n\t\t\t\targuments: { ...base, maxCost: r.maxCostRaw, minQuantity: r.minQuantityRaw },\n\t\t\t}),\n\t\t);\n\t} else {\n\t\ttx.add(\n\t\t\texpiryMarket.quoteMintForAccount({\n\t\t\t\tconfig,\n\t\t\t\targuments:\n\t\t\t\t\tr.shape === 'exact-quantity'\n\t\t\t\t\t\t? { ...base, maxPremium: 0n, minQuantity: r.quantityRaw, exactQuantity: true }\n\t\t\t\t\t\t: {\n\t\t\t\t\t\t\t\t...base,\n\t\t\t\t\t\t\t\tmaxPremium: r.maxPremiumRaw,\n\t\t\t\t\t\t\t\tminQuantity: r.minQuantityRaw,\n\t\t\t\t\t\t\t\texactQuantity: false,\n\t\t\t\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t}\n\tif (args.ordersConfig) tx.add(desk.policy({ config: args.ordersConfig }));\n\tconst cmds = await inspectReturns(client, tx);\n\tconst q = expiryMarket.MintQuote.parse(cmds[1][0]);\n\tconst quote: MintQuoteRaw = {\n\t\tquantity: q.quantity,\n\t\tentryProbability: q.entry_probability,\n\t\tpremium: q.premium,\n\t\ttradingFee: q.trading_fee,\n\t\tfeeIncentiveSubsidy: q.fee_incentive_subsidy,\n\t\tbuilderFee: q.builder_fee,\n\t\tpenaltyFee: q.penalty_fee,\n\t\tinventoryImpactCharge: q.inventory_impact_charge,\n\t\tallInCost: q.all_in_cost,\n\t};\n\tconst policy = args.ordersConfig\n\t\t? policyFromBcs(DelayedExecutionPolicyBcs.parse(cmds[2][0]))\n\t\t: null;\n\treturn { quote, policy };\n}\n\n/** What `quote_mint` quotes: an exact quantity, or the largest quantity a premium budget buys. */\nexport type AnonymousMintQuoteRequest = Exclude<MintQuoteRequest, { shape: 'exact-cost' }>;\n\n/**\n * Quote a mint for no particular account: Predict's `quote_mint`, at a fresh live pricer. It\n * prices like a queued fill at the clock with no builder fee, so it previews a mint for a visitor\n * without an account or a funded balance. It has no all-in budget mode. It aborts\n * `EOrderFailsLimits` when the mint would be refused at the clock, for example below the 1 USDC\n * minimum premium. With `ordersConfig`, also reads the order desk's policy.\n */\nexport async function quoteMintAnonymous(\n\tclient: ReadClient,\n\tconfig: GeneratedConfig,\n\targs: {\n\t\texpiryMarketId: string;\n\t\tlowerTick: bigint;\n\t\thigherTick: bigint;\n\t\trequest: AnonymousMintQuoteRequest;\n\t\tordersConfig?: OrdersGeneratedConfig;\n\t} & MarketFeeds,\n): Promise<{ quote: MintQuoteRaw; policy: DelayedExecutionPolicy | null }> {\n\tconst tx = new Transaction();\n\tconst pricer = tx.add(loadLivePricer(config, args));\n\tconst r = args.request;\n\ttx.add(\n\t\texpiryMarket.quoteMint({\n\t\t\tconfig,\n\t\t\targuments: {\n\t\t\t\tmarket: args.expiryMarketId,\n\t\t\t\tpricer,\n\t\t\t\tlowerTick: args.lowerTick,\n\t\t\t\thigherTick: args.higherTick,\n\t\t\t\t...(r.shape === 'exact-quantity'\n\t\t\t\t\t? { maxPremium: 0n, minQuantity: r.quantityRaw, exactQuantity: true }\n\t\t\t\t\t: { maxPremium: r.maxPremiumRaw, minQuantity: r.minQuantityRaw, exactQuantity: false }),\n\t\t\t},\n\t\t}),\n\t);\n\tif (args.ordersConfig) tx.add(desk.policy({ config: args.ordersConfig }));\n\tconst cmds = await inspectReturns(client, tx);\n\tconst q = expiryMarket.MintQuote.parse(cmds[1][0]);\n\treturn {\n\t\tquote: {\n\t\t\tquantity: q.quantity,\n\t\t\tentryProbability: q.entry_probability,\n\t\t\tpremium: q.premium,\n\t\t\ttradingFee: q.trading_fee,\n\t\t\tfeeIncentiveSubsidy: q.fee_incentive_subsidy,\n\t\t\tbuilderFee: q.builder_fee,\n\t\t\tpenaltyFee: q.penalty_fee,\n\t\t\tinventoryImpactCharge: q.inventory_impact_charge,\n\t\t\tallInCost: q.all_in_cost,\n\t\t},\n\t\tpolicy: args.ordersConfig ? policyFromBcs(DelayedExecutionPolicyBcs.parse(cmds[2][0])) : null,\n\t};\n}\n\n/**\n * The order desk's policy and an owner's USDC balance, in one simulate. The queued exact-cost\n * quote needs both: enqueue escrows `min(max_cost, available − fee)`, while the chain quote caps\n * at the whole balance.\n */\nexport async function orderFeeAndBalance(\n\tclient: ReadClient,\n\tconfig: OrdersGeneratedConfig,\n\towner: string,\n\tcoinType: string,\n): Promise<{ policy: DelayedExecutionPolicy; availableRaw: bigint }> {\n\tconst tx = new Transaction();\n\ttx.add(desk.policy({ config }));\n\tconst loaded = tx.add(\n\t\taccount.loadAccount({ config, arguments: { self: deriveAccountWrapperIdFrom(config, owner) } }),\n\t);\n\ttx.add(account.balance({ config, typeArguments: [coinType], arguments: { self: loaded } }));\n\tconst cmds = await inspectReturns(client, tx);\n\treturn {\n\t\tpolicy: policyFromBcs(DelayedExecutionPolicyBcs.parse(cmds[0][0])),\n\t\tavailableRaw: parseU64LE(cmds[2][0]),\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkCA,MAAM,aAAa,WAAgC,MAAM,MAAM,OAAO;AACtE,MAAM,oBAAoB,IAAI,OAAOA,UAAa;;AAGlD,SAAgB,qBACf,QACC;AACD,QAAO,GAAG,OAAO,yBAAyB;;;;;;;;AAmF3C,eAAsB,iBACrB,QACA,QACA,UACA,OAKI,EAAE,EACsB;CAC5B,MAAM,UAAU,UAAU,QAAQ;EAAE,gBAAgB;EAAU,SAAS,KAAK;EAAS,CAAC;CACtF,MAAM,KAAK,IAAI,aAAa;CAC5B,IAAI,OAAO;CACX,MAAM,UAA+B,EAAE;CACvC,MAAM,OAAO,YAA4D;AACxE,UAAQ,KAAK,GAAG,IAAI,QAAQ,CAAC;AAC7B,SAAO;;CAER,MAAM,SAAS,EAAE,QAAQ,UAAU;CACnC,MAAM,UAAU,EAAE,OAAO,SAAS;CAClC,MAAM,IAAI;EACT,QAAQ,IAAIC,OAAoB;GAAE;GAAQ,WAAW;GAAQ,CAAC,CAAC;EAC/D,YAAY,IAAIC,WAAwB;GAAE;GAAQ,WAAW;GAAQ,CAAC,CAAC;EACvE,aAAa,IAAIC,YAAyB;GAAE;GAAQ,WAAW;GAAQ,CAAC,CAAC;EACzE,cAAc,IAAIC,aAA0B;GAAE;GAAQ,WAAW;GAAQ,CAAC,CAAC;EAC3E,qBAAqB,IAAIC,oBAAiC;GAAE;GAAQ,WAAW;GAAQ,CAAC,CAAC;EACzF,WAAW,IAAIC,eAA4B;GAAE;GAAQ,WAAW;GAAQ,CAAC,CAAC;EAC1E,OAAO,IAAIC,WAAiB;GAAE;GAAQ,WAAW;GAAS,CAAC,CAAC;EAC5D,SAAS,IAAIC,eAAqB;GAAE;GAAQ,WAAW;GAAS,CAAC,CAAC;EAClE,OAAO,IAAIC,WAAiB;GAAE;GAAQ,WAAW;GAAS,CAAC,CAAC;EAC5D,SAAS,IAAIC,cAAoB;GAAE;GAAQ,WAAW;GAAS,CAAC,CAAC;EACjE,QAAQ,IAAIC,eAAqB;GAAE;GAAQ,WAAW;GAAS,CAAC,CAAC;EACjE,QAAQ,IAAIC,OAAY,EAAE,QAAQ,CAAC,CAAC;EACpC,eAAe,IAAIC,mBAAsB,EAAE,QAAQ,CAAC,CAAC;EACrD,iBAAiB,IAAIC,gBAA+B,EAAE,QAAQ,CAAC,CAAC;EAChE,aAAa,IAAIC,wBAAuC,EAAE,QAAQ,CAAC,CAAC;EACpE,eAAe,IAAIC,cAA6B,EAAE,QAAQ,CAAC,CAAC;EAC5D,QAAQ,IAAIC,OAAsB,EAAE,QAAQ,CAAC,CAAC;EAC9C,WAAW,IAAIC,mBAAgC,EAAE,QAAQ,CAAC,CAAC;EAC3D,kBAAkB,IACjBC,YAA2B;GAAE;GAAQ,eAAe,CAAC,qBAAqB,OAAO,CAAC;GAAE,CAAC,CACrF;EACD;CACD,IAAI,aAA6E;AACjF,KAAI,KAAK,OAAO;AACf,MAAI,CAAC,KAAK,cAAe,OAAM,IAAI,MAAM,mDAAmD;EAC5F,MAAM,YAAY,oBAAoB,QAAQ,KAAK,MAAM;EACzD,MAAM,UAAU,IAAIC,cAAoB;GAAE;GAAQ,WAAW;IAAE,GAAG;IAAS;IAAW;GAAE,CAAC,CAAC;EAC1F,MAAM,SAAS,IACdC,YAAoB;GACnB;GACA,WAAW,EAAE,MAAM,2BAA2B,QAAQ,KAAK,MAAM,EAAE;GACnE,CAAC,CACF;AAQD,eAAa;GAAE;GAAS,SAPR,IACfC,QAAgB;IACf;IACA,eAAe,CAAC,KAAK,cAAc;IACnC,WAAW,EAAE,MAAM,QAAQ,SAAS;IACpC,CAAC,CACF;GACgC;GAAW;;CAE7C,MAAM,aAAa,KAAK,aAAa,EAAE,EAAE,KAAK,aAC7C,IAAIC,MAAY;EAAE;EAAQ,WAAW;GAAE,GAAG;GAAS;GAAU;EAAE,CAAC,CAAC,CACjE;CAED,MAAM,OAAO,MAAM,eAAe,QAAQ,GAAG;CAC7C,MAAM,OAAO,KAAa,QAAQ,MAAM,WAAW,KAAK,KAAK,OAAO;CACpE,MAAMC,gBAAc,IAAI,EAAE,YAAY;CACtC,MAAMC,iBAAe,IAAI,EAAE,aAAa;AACxC,QAAO;EACN,UAAU,oBAAoB,SAAS;EACvC,SAAS,oBAAoB,QAAQ;EACrC,UAAU,IAAI,EAAE,OAAO;EACvB,YAAY,UAAU,KAAK,EAAE,YAAY,GAAG;EAC5C;EACA;EACA,WAAWD,gBAAcC,iBAAeD,gBAAcC,iBAAe;EACrE,iBAAiB,IAAI,EAAE,WAAW,EAAE;EACpC,qBAAqB,IAAI,EAAE,WAAW,EAAE;EACxC,qBAAqB,IAAI,EAAE,WAAW,EAAE;EACxC,qBAAqB,IAAI,EAAE,oBAAoB;EAC/C,OAAO,UAAU,KAAK,EAAE,OAAO,GAAG;EAClC,SAAS;GACR,OAAO,IAAI,EAAE,SAAS,EAAE;GACxB,wBAAwB,iBAAiB,KAAK,EAAE,SAAS,GAAG;GAC5D,sCAAsC,iBAAiB,KAAK,EAAE,SAAS,GAAG;GAC1E;EACD,OAAO;GACN,aAAa,IAAI,EAAE,OAAO,EAAE;GAC5B,QAAQ,IAAI,EAAE,OAAO,EAAE;GACvB,WAAW,IAAI,EAAE,OAAO,EAAE;GAC1B,oBAAoB,IAAI,EAAE,OAAO,EAAE;GACnC;EACD,SAAS;GAAE,OAAO,IAAI,EAAE,SAAS,EAAE;GAAE,OAAO,IAAI,EAAE,SAAS,EAAE;GAAE;EAC/D,QAAQ;GACP,QAAQ,IAAI,EAAE,QAAQ,EAAE;GACxB,QAAQ,IAAI,EAAE,QAAQ,EAAE;GACxB,WAAW,UAAU,KAAK,EAAE,QAAQ,GAAG;GACvC;EACD,MAAM;GACL,IAAI,oBAAoB,OAAO,UAAU;GACzC,QAAQ,cAAcC,uBAA0B,MAAM,KAAK,EAAE,QAAQ,GAAG,CAAC;GACzE,kBAAkB,IAAI,EAAE,cAAc;GACtC;EACD,UAAU;GACT,iBAAiB,IAAI,EAAE,gBAAgB;GACvC,yBAAyB,IAAI,EAAE,YAAY;GAC3C,eAAe,UAAU,KAAK,EAAE,eAAe,GAAG;GAClD,QAAQ,UAAU,KAAK,EAAE,QAAQ,GAAG;GACpC,kBAAkB,IAAI,EAAE,UAAU;GAClC,kBAAkB,UAAU,KAAK,EAAE,kBAAkB,GAAG;GACxD;EACD,SAAS,aACN;GACA,WAAW,WAAW;GACtB,eAAe,IAAI,WAAW,QAAQ;GACtC,cAAc,IAAI,WAAW,QAAQ;GACrC,GACA;EACH,SAAS,UAAU,KAAK,QAAQ,kBAAkB,MAAM,KAAK,KAAK,GAAG,IAAI,KAAK;EAC9E;;;AAIF,eAAsB,aACrB,QACA,QACA,QACA,WACkC;AAClC,KAAI,UAAU,WAAW,EAAG,QAAO,EAAE;CACrC,MAAM,UAAU,UAAU,QAAQ,OAAO;CACzC,MAAM,KAAK,IAAI,aAAa;AAC5B,MAAK,MAAM,YAAY,UACtB,IAAG,IAAIH,MAAY;EAAE;EAAQ,WAAW;GAAE,OAAO;GAAS;GAAU;EAAE,CAAC,CAAC;AAGzE,SADa,MAAM,eAAe,QAAQ,GAAG,EACjC,KAAK,OAAO,kBAAkB,MAAM,GAAG,GAAG,IAAI,KAAK;;;;;;;AAQhE,eAAsB,iBACrB,QACA,kBACkB;CAClB,MAAM,EAAE,WAAW,MAAM,OAAO,KAAK,UAAU;EAC9C,UAAU;EACV,SAAS,EAAE,SAAS,MAAM;EAC1B,CAAC;AACF,KAAI,CAAC,OAAO,QAAS,OAAM,IAAI,MAAM,kBAAkB,iBAAiB,sBAAsB;AAC9F,uBAAqC,MAAM,OAAO,QAAQ,CAAC;;;;;;;;;AA6B5D,SAAgB,iBACf,WACA,yBACA,wBAAiC,yBACjB;AAChB,KAAI,aAAa,2BAA2B;AAC3C,MAAI,CAAC,wBAAyB,QAAO;AACrC,SAAO,YAAY,0BAA0B,YAAY;;AAE1D,QAAO,2BAA2B,wBAAwB,qBAAqB;;;;;;;AAQhF,eAAsB,aACrB,QACA,WACA,UACkB;CAClB,MAAM,EAAE,uBAAY,MAAM,OAAO,KAAK,WAAW;EAAE,OAAO;EAAW;EAAU,CAAC;AAChF,QAAO,OAAOI,UAAQ,eAAe;;AAKtC,MAAM,mBAAmB,IAAI,OAAO,SAAS;CAC5C,IAAI,IAAI;CACR,iBAAiB,IAAI,OACpB,IAAI,OAAO,qBAAqB;EAAE,YAAY,IAAI,OAAO,IAAI,IAAI,CAAC;EAAE,YAAY,IAAI,KAAK;EAAE,CAAC,CAC5F;CACD,aAAa,IAAI,OAAO,cAAc;EACrC,IAAI,IAAI;EACR,SAAS,IAAI;EACb,SAAS,IAAI,KAAK;EAClB,QAAQ,IAAI,IAAI;EAChB,CAAC;CACF,CAAC;;;;;;AAOF,eAAsB,cACrB,QACA,SACsE;CACtE,MAAM,EAAE,WAAW,MAAM,OAAO,KAAK,UAAU;EAAE,UAAU;EAAS,SAAS,EAAE,SAAS,MAAM;EAAE,CAAC;AACjG,KAAI,CAAC,OAAO,QAAS,OAAM,IAAI,MAAM,eAAe,QAAQ,sBAAsB;CAClF,MAAM,CAAC,YAAY,QAAQ,QAAQ,OAAO,KAAK,MAAM,KAAK;AAC1D,KAAI,WAAW,WAAW,SAAS,QAClC,OAAM,IAAI,MAAM,GAAG,QAAQ,QAAQ,OAAO,KAAK,0BAA0B;AAE1E,QAAO;EACN,SAAS,oBAAoB,QAAQ;EACrC,WAAW,oBAAoB,iBAAiB,MAAM,OAAO,QAAQ,CAAC,YAAY,QAAQ;EAC1F,YAAY,oBAAoB,WAAW;EAC3C;;;;;;;;;AAoBF,eAAsB,gBACrB,QACA,QACA,MAKyE;CACzE,MAAM,KAAK,IAAI,aAAa;CAC5B,MAAM,SAAS,GAAG,IAAI,eAAe,QAAQ,KAAK,CAAC;AACnD,IAAG,IACFC,kBAAsB;EACrB;EACA,WAAW;GACV,OAAO,UAAU,QAAQ,KAAK;GAC9B,QAAQ,KAAK;GACb,SAAS,KAAK;GACd;GACA,UAAU,KAAK;GACf,eAAe,KAAK;GACpB;EACD,CAAC,CACF;AACD,IAAG,IAAIhB,OAAY,EAAE,QAAQ,CAAC,CAAC;CAC/B,MAAM,OAAO,MAAM,eAAe,QAAQ,GAAG;CAC7C,MAAM,gBAA6B,MAAM,KAAK,GAAG,GAAG;AACpD,QAAO;EACN,OAAO;GACN,eAAe,EAAE;GACjB,aAAa,EAAE;GACf,UAAU,EAAE;GACZ,YAAY,EAAE;GACd,YAAY,EAAE;GACd,uBAAuB,EAAE;GACzB;EACD,QAAQ,cAAcc,uBAA0B,MAAM,KAAK,GAAG,GAAG,CAAC;EAClE;;;;;;;;;;AAiCF,eAAsB,oBACrB,QACA,QACA,MAS0E;CAC1E,MAAM,KAAK,IAAI,aAAa;CAC5B,MAAM,SAAS,GAAG,IAAI,eAAe,QAAQ,KAAK,CAAC;CACnD,MAAM,OAAO;EACZ,QAAQ,KAAK;EACb,SAAS,KAAK;EACd;EACA,WAAW,KAAK;EAChB,YAAY,KAAK;EACjB;CACD,MAAM,IAAI,KAAK;AACf,KAAI,EAAE,UAAU,aACf,IAAG,IACFG,6BAA0C;EACzC;EACA,WAAW;GAAE,GAAG;GAAM,SAAS,EAAE;GAAY,aAAa,EAAE;GAAgB;EAC5E,CAAC,CACF;KAED,IAAG,IACFC,sBAAiC;EAChC;EACA,WACC,EAAE,UAAU,mBACT;GAAE,GAAG;GAAM,YAAY;GAAI,aAAa,EAAE;GAAa,eAAe;GAAM,GAC5E;GACA,GAAG;GACH,YAAY,EAAE;GACd,aAAa,EAAE;GACf,eAAe;GACf;EACJ,CAAC,CACF;AAEF,KAAI,KAAK,aAAc,IAAG,IAAIlB,OAAY,EAAE,QAAQ,KAAK,cAAc,CAAC,CAAC;CACzE,MAAM,OAAO,MAAM,eAAe,QAAQ,GAAG;CAC7C,MAAM,cAA2B,MAAM,KAAK,GAAG,GAAG;AAelD,QAAO;EAAE,OAdmB;GAC3B,UAAU,EAAE;GACZ,kBAAkB,EAAE;GACpB,SAAS,EAAE;GACX,YAAY,EAAE;GACd,qBAAqB,EAAE;GACvB,YAAY,EAAE;GACd,YAAY,EAAE;GACd,uBAAuB,EAAE;GACzB,WAAW,EAAE;GACb;EAIe,QAHD,KAAK,eACjB,cAAcc,uBAA0B,MAAM,KAAK,GAAG,GAAG,CAAC,GAC1D;EACqB;;;;;;;;;AAazB,eAAsB,mBACrB,QACA,QACA,MAO0E;CAC1E,MAAM,KAAK,IAAI,aAAa;CAC5B,MAAM,SAAS,GAAG,IAAI,eAAe,QAAQ,KAAK,CAAC;CACnD,MAAM,IAAI,KAAK;AACf,IAAG,IACFK,UAAuB;EACtB;EACA,WAAW;GACV,QAAQ,KAAK;GACb;GACA,WAAW,KAAK;GAChB,YAAY,KAAK;GACjB,GAAI,EAAE,UAAU,mBACb;IAAE,YAAY;IAAI,aAAa,EAAE;IAAa,eAAe;IAAM,GACnE;IAAE,YAAY,EAAE;IAAe,aAAa,EAAE;IAAgB,eAAe;IAAO;GACvF;EACD,CAAC,CACF;AACD,KAAI,KAAK,aAAc,IAAG,IAAInB,OAAY,EAAE,QAAQ,KAAK,cAAc,CAAC,CAAC;CACzE,MAAM,OAAO,MAAM,eAAe,QAAQ,GAAG;CAC7C,MAAM,cAA2B,MAAM,KAAK,GAAG,GAAG;AAClD,QAAO;EACN,OAAO;GACN,UAAU,EAAE;GACZ,kBAAkB,EAAE;GACpB,SAAS,EAAE;GACX,YAAY,EAAE;GACd,qBAAqB,EAAE;GACvB,YAAY,EAAE;GACd,YAAY,EAAE;GACd,uBAAuB,EAAE;GACzB,WAAW,EAAE;GACb;EACD,QAAQ,KAAK,eAAe,cAAcc,uBAA0B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG;EACzF;;;;;;;AAQF,eAAsB,mBACrB,QACA,QACA,OACA,UACoE;CACpE,MAAM,KAAK,IAAI,aAAa;AAC5B,IAAG,IAAId,OAAY,EAAE,QAAQ,CAAC,CAAC;CAC/B,MAAM,SAAS,GAAG,IACjBS,YAAoB;EAAE;EAAQ,WAAW,EAAE,MAAM,2BAA2B,QAAQ,MAAM,EAAE;EAAE,CAAC,CAC/F;AACD,IAAG,IAAIC,QAAgB;EAAE;EAAQ,eAAe,CAAC,SAAS;EAAE,WAAW,EAAE,MAAM,QAAQ;EAAE,CAAC,CAAC;CAC3F,MAAM,OAAO,MAAM,eAAe,QAAQ,GAAG;AAC7C,QAAO;EACN,QAAQ,cAAcI,uBAA0B,MAAM,KAAK,GAAG,GAAG,CAAC;EAClE,cAAc,WAAW,KAAK,GAAG,GAAG;EACpC"}

package/dist/predict/ticks.d.mts

@@ -6,6 +6,14 @@ declare function binaryRangeTicks(strikeRaw: bigint, side: Side, tickSize: bigin
   lowerTick: bigint;
   higherTick: bigint;
 };
+/**
+ * Snap a strike in USD to a market's admission grid (`MarketSummary.admissionTickSize`), the step
+ * every new mint boundary must be a whole multiple of. Use it on a form's bound inputs: `'down'`
+ * for a lower bound and `'up'` for an upper bound keep a range from shrinking past what was typed,
+ * and `'nearest'` (the default) suits a single strike. Exact: it rounds in the 1e9-scaled integers
+ * the chain uses, not in floating point.
+ */
+declare function snapStrike(price: number, admissionTickSize: number, mode?: 'down' | 'up' | 'nearest'): number;
 //#endregion
-export { POS_INF_TICK, Side, binaryRangeTicks };
+export { POS_INF_TICK, Side, binaryRangeTicks, snapStrike };
 //# sourceMappingURL=ticks.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ticks.d.mts","names":[],"sources":["../../src/predict/ticks.ts"],"mappings":";;cAOa,YAAA;AAAA,KAED,IAAA;AAAA,iBAOI,gBAAA,CACf,SAAA,UACA,IAAA,EAAM,IAAA,EACN,QAAA;EACI,SAAA;EAAmB,UAAA;AAAA"}
+{"version":3,"file":"ticks.d.mts","names":[],"sources":["../../src/predict/ticks.ts"],"mappings":";;cAOa,YAAA;AAAA,KAED,IAAA;AAAA,iBAOI,gBAAA,CACf,SAAA,UACA,IAAA,EAAM,IAAA,EACN,QAAA;EACI,SAAA;EAAmB,UAAA;AAAA;;;;;AAJxB;;;iBAkCgB,UAAA,CACf,KAAA,UACA,iBAAA,UACA,IAAA"}

package/dist/predict/ticks.mjs

@@ -15,7 +15,24 @@ function binaryRangeTicks(strikeRaw, side, tickSize) {
 		higherTick: isUp ? POS_INF_TICK : tick
 	};
 }
+/**
+* Snap a strike in USD to a market's admission grid (`MarketSummary.admissionTickSize`), the step
+* every new mint boundary must be a whole multiple of. Use it on a form's bound inputs: `'down'`
+* for a lower bound and `'up'` for an upper bound keep a range from shrinking past what was typed,
+* and `'nearest'` (the default) suits a single strike. Exact: it rounds in the 1e9-scaled integers
+* the chain uses, not in floating point.
+*/
+function snapStrike(price, admissionTickSize, mode = "nearest") {
+	if (!(Number.isFinite(price) && price > 0)) throw new PredictInputError(`strike must be a positive number, got ${price}`);
+	if (!(Number.isFinite(admissionTickSize) && admissionTickSize > 0)) throw new PredictInputError(`admissionTickSize must be positive, got ${admissionTickSize}`);
+	const step = BigInt(Math.round(admissionTickSize * 1e9));
+	const raw = BigInt(Math.round(price * 1e9));
+	const below = raw / step * step;
+	const snapped = mode === "down" || raw === below ? below : mode === "up" ? below + step : raw - below < below + step - raw ? below : below + step;
+	if (snapped === 0n) throw new PredictInputError(`strike ${price} snaps below the first ${admissionTickSize} step`);
+	return Number(snapped) / 1e9;
+}
 
 //#endregion
-export { POS_INF_TICK, binaryRangeTicks };
+export { POS_INF_TICK, binaryRangeTicks, snapStrike };
 //# sourceMappingURL=ticks.mjs.map

package/dist/predict/ticks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ticks.mjs","names":[],"sources":["../../src/predict/ticks.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\nimport { PredictInputError } from './errors.js';\n\nconst TICK_BITS = 30n;\n\n/** +inf sentinel tick: the upper bound of an UP range. */\nexport const POS_INF_TICK = (1n << TICK_BITS) - 1n;\n\nexport type Side = 'up' | 'down';\n\n// Convert a raw binary-range strike to the `(lower_tick, higher_tick)` pair the\n// `mint` entrypoint takes directly (there is no standalone packed range key).\n// An UP order is `(strike, +inf)` -> lower_tick = strike/tick_size, higher_tick =\n// POS_INF_TICK; a DOWN order is `(-inf, strike)` -> lower_tick = 0 (neg-inf),\n// higher_tick = strike/tick_size.\nexport function binaryRangeTicks(\n\tstrikeRaw: bigint,\n\tside: Side,\n\ttickSize: bigint,\n): { lowerTick: bigint; higherTick: bigint } {\n\t// Anything not exactly 'up' used to fall through to DOWN, byte-identical to a real\n\t// down mint — no build error, no simulate error, no chain abort. `side` arrives from UI\n\t// state, JSON, or a DB column at runtime, where the literal type does not protect.\n\tif (side !== 'up' && side !== 'down') {\n\t\tthrow new PredictInputError(`side must be 'up' or 'down', got ${JSON.stringify(side)}`);\n\t}\n\tconst tick = strikeRaw / tickSize;\n\tif (tick * tickSize !== strikeRaw) {\n\t\tthrow new PredictInputError(`strike ${strikeRaw} is not a whole tick multiple of ${tickSize}`);\n\t}\n\tif (tick <= 0n || tick >= POS_INF_TICK) {\n\t\tthrow new PredictInputError(\n\t\t\t`strike tick ${tick} outside the finite tick domain (1..POS_INF_TICK-1)`,\n\t\t);\n\t}\n\tconst isUp = side === 'up';\n\treturn {\n\t\tlowerTick: isUp ? tick : 0n,\n\t\thigherTick: isUp ? POS_INF_TICK : tick,\n\t};\n}\n"],"mappings":";;;AAIA,MAAM,YAAY;;AAGlB,MAAa,gBAAgB,MAAM,aAAa;AAShD,SAAgB,iBACf,WACA,MACA,UAC4C;AAI5C,KAAI,SAAS,QAAQ,SAAS,OAC7B,OAAM,IAAI,kBAAkB,oCAAoC,KAAK,UAAU,KAAK,GAAG;CAExF,MAAM,OAAO,YAAY;AACzB,KAAI,OAAO,aAAa,UACvB,OAAM,IAAI,kBAAkB,UAAU,UAAU,mCAAmC,WAAW;AAE/F,KAAI,QAAQ,MAAM,QAAQ,aACzB,OAAM,IAAI,kBACT,eAAe,KAAK,qDACpB;CAEF,MAAM,OAAO,SAAS;AACtB,QAAO;EACN,WAAW,OAAO,OAAO;EACzB,YAAY,OAAO,eAAe;EAClC"}
+{"version":3,"file":"ticks.mjs","names":[],"sources":["../../src/predict/ticks.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\nimport { PredictInputError } from './errors.js';\n\nconst TICK_BITS = 30n;\n\n/** +inf sentinel tick: the upper bound of an UP range. */\nexport const POS_INF_TICK = (1n << TICK_BITS) - 1n;\n\nexport type Side = 'up' | 'down';\n\n// Convert a raw binary-range strike to the `(lower_tick, higher_tick)` pair the\n// `mint` entrypoint takes directly (there is no standalone packed range key).\n// An UP order is `(strike, +inf)` -> lower_tick = strike/tick_size, higher_tick =\n// POS_INF_TICK; a DOWN order is `(-inf, strike)` -> lower_tick = 0 (neg-inf),\n// higher_tick = strike/tick_size.\nexport function binaryRangeTicks(\n\tstrikeRaw: bigint,\n\tside: Side,\n\ttickSize: bigint,\n): { lowerTick: bigint; higherTick: bigint } {\n\t// Anything not exactly 'up' used to fall through to DOWN, byte-identical to a real\n\t// down mint — no build error, no simulate error, no chain abort. `side` arrives from UI\n\t// state, JSON, or a DB column at runtime, where the literal type does not protect.\n\tif (side !== 'up' && side !== 'down') {\n\t\tthrow new PredictInputError(`side must be 'up' or 'down', got ${JSON.stringify(side)}`);\n\t}\n\tconst tick = strikeRaw / tickSize;\n\tif (tick * tickSize !== strikeRaw) {\n\t\tthrow new PredictInputError(`strike ${strikeRaw} is not a whole tick multiple of ${tickSize}`);\n\t}\n\tif (tick <= 0n || tick >= POS_INF_TICK) {\n\t\tthrow new PredictInputError(\n\t\t\t`strike tick ${tick} outside the finite tick domain (1..POS_INF_TICK-1)`,\n\t\t);\n\t}\n\tconst isUp = side === 'up';\n\treturn {\n\t\tlowerTick: isUp ? tick : 0n,\n\t\thigherTick: isUp ? POS_INF_TICK : tick,\n\t};\n}\n\n/**\n * Snap a strike in USD to a market's admission grid (`MarketSummary.admissionTickSize`), the step\n * every new mint boundary must be a whole multiple of. Use it on a form's bound inputs: `'down'`\n * for a lower bound and `'up'` for an upper bound keep a range from shrinking past what was typed,\n * and `'nearest'` (the default) suits a single strike. Exact: it rounds in the 1e9-scaled integers\n * the chain uses, not in floating point.\n */\nexport function snapStrike(\n\tprice: number,\n\tadmissionTickSize: number,\n\tmode: 'down' | 'up' | 'nearest' = 'nearest',\n): number {\n\tif (!(Number.isFinite(price) && price > 0)) {\n\t\tthrow new PredictInputError(`strike must be a positive number, got ${price}`);\n\t}\n\tif (!(Number.isFinite(admissionTickSize) && admissionTickSize > 0)) {\n\t\tthrow new PredictInputError(`admissionTickSize must be positive, got ${admissionTickSize}`);\n\t}\n\tconst step = BigInt(Math.round(admissionTickSize * 1e9));\n\tconst raw = BigInt(Math.round(price * 1e9));\n\tconst below = (raw / step) * step;\n\tconst snapped =\n\t\tmode === 'down' || raw === below\n\t\t\t? below\n\t\t\t: mode === 'up'\n\t\t\t\t? below + step\n\t\t\t\t: raw - below < below + step - raw\n\t\t\t\t\t? below\n\t\t\t\t\t: below + step;\n\tif (snapped === 0n) {\n\t\tthrow new PredictInputError(`strike ${price} snaps below the first ${admissionTickSize} step`);\n\t}\n\treturn Number(snapped) / 1e9;\n}\n"],"mappings":";;;AAIA,MAAM,YAAY;;AAGlB,MAAa,gBAAgB,MAAM,aAAa;AAShD,SAAgB,iBACf,WACA,MACA,UAC4C;AAI5C,KAAI,SAAS,QAAQ,SAAS,OAC7B,OAAM,IAAI,kBAAkB,oCAAoC,KAAK,UAAU,KAAK,GAAG;CAExF,MAAM,OAAO,YAAY;AACzB,KAAI,OAAO,aAAa,UACvB,OAAM,IAAI,kBAAkB,UAAU,UAAU,mCAAmC,WAAW;AAE/F,KAAI,QAAQ,MAAM,QAAQ,aACzB,OAAM,IAAI,kBACT,eAAe,KAAK,qDACpB;CAEF,MAAM,OAAO,SAAS;AACtB,QAAO;EACN,WAAW,OAAO,OAAO;EACzB,YAAY,OAAO,eAAe;EAClC;;;;;;;;;AAUF,SAAgB,WACf,OACA,mBACA,OAAkC,WACzB;AACT,KAAI,EAAE,OAAO,SAAS,MAAM,IAAI,QAAQ,GACvC,OAAM,IAAI,kBAAkB,yCAAyC,QAAQ;AAE9E,KAAI,EAAE,OAAO,SAAS,kBAAkB,IAAI,oBAAoB,GAC/D,OAAM,IAAI,kBAAkB,2CAA2C,oBAAoB;CAE5F,MAAM,OAAO,OAAO,KAAK,MAAM,oBAAoB,IAAI,CAAC;CACxD,MAAM,MAAM,OAAO,KAAK,MAAM,QAAQ,IAAI,CAAC;CAC3C,MAAM,QAAS,MAAM,OAAQ;CAC7B,MAAM,UACL,SAAS,UAAU,QAAQ,QACxB,QACA,SAAS,OACR,QAAQ,OACR,MAAM,QAAQ,QAAQ,OAAO,MAC5B,QACA,QAAQ;AACd,KAAI,YAAY,GACf,OAAM,IAAI,kBAAkB,UAAU,MAAM,yBAAyB,kBAAkB,OAAO;AAE/F,QAAO,OAAO,QAAQ,GAAG"}

package/dist/predict/tx/authed.mjs

@@ -1,7 +1,7 @@
 import { depositFunds as depositFunds$1, withdrawFunds as withdrawFunds$1 } from "../../contracts/account/account.mjs";
 import { withAuth } from "./common.mjs";
-import { setBuilderCode as setBuilderCode$1, unsetBuilderCode as unsetBuilderCode$1 } from "../../contracts/deepbook_predict/predict_account.mjs";
 import { cancelSupplyRequest as cancelSupplyRequest$1, cancelWithdrawRequest as cancelWithdrawRequest$1, requestSupply as requestSupply$1, requestWithdraw as requestWithdraw$1 } from "../../contracts/deepbook_predict/plp.mjs";
+import { setBuilderCode as setBuilderCode$1, unsetBuilderCode as unsetBuilderCode$1 } from "../../contracts/deepbook_predict/predict_account.mjs";
 
 //#region src/predict/tx/authed.ts
 const depositFunds = withAuth(depositFunds$1);

package/dist/predict/tx/common.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.mts","names":[],"sources":["../../../src/predict/tx/common.ts"],"mappings":";;;;;;;AAwBA;;;;;iBAAgB,YAAA,CAAa,GAAA,EAAK,aAAA,IAAiB,EAAA,EAAI,WAAA,KAAgB,iBAAA;;iBAiEvD,sBAAA,CAAuB,GAAA,EAAK,aAAA,EAAe,KAAA"}
+{"version":3,"file":"common.d.mts","names":[],"sources":["../../../src/predict/tx/common.ts"],"mappings":";;;;;;;AA0BA;;;;;iBAAgB,YAAA,CAAa,GAAA,EAAK,aAAA,IAAiB,EAAA,EAAI,WAAA,KAAgB,iBAAA;;iBAmEvD,sBAAA,CAAuB,GAAA,EAAK,aAAA,EAAe,KAAA"}

package/dist/predict/tx/common.mjs

@@ -1,6 +1,8 @@
 import { generateAuth as generateAuth$1 } from "../../contracts/account/account.mjs";
 import { AccountContract } from "../../account.mjs";
 import { toGeneratedConfig } from "../config/generated.mjs";
+import { bcs } from "@mysten/sui/bcs";
+import { deriveObjectID } from "@mysten/sui/utils";
 
 //#region src/predict/tx/common.ts
 function accountContract(cfg) {
@@ -46,7 +48,16 @@ function deriveAccountWrapperIdFrom(config, owner) {
 function deriveAccountWrapperId(cfg, owner) {
 	return deriveAccountWrapperIdFrom(toGeneratedConfig(cfg), owner);
 }
+const AccountKey = bcs.struct("AccountKey", { pos0: bcs.Address });
+/**
+* The owner's canonical ACCOUNT id (`Account.account_id`), a different derived object from the
+* wrapper: `derive_address(registry, AccountKey(owner))`. Queue records and events name accounts
+* by it, and `queue::waiting_orders` takes it.
+*/
+function deriveAccountIdFrom(config, owner) {
+	return deriveObjectID(config.accountRegistry, `${config.accountPackageId}::account_registry::AccountKey`, AccountKey.serialize({ pos0: owner }).toBytes());
+}
 
 //#endregion
-export { accountContract, deriveAccountWrapperId, deriveAccountWrapperIdFrom, generateAuth, withAuth };
+export { accountContract, deriveAccountIdFrom, deriveAccountWrapperId, deriveAccountWrapperIdFrom, generateAuth, withAuth };
 //# sourceMappingURL=common.mjs.map