@mysten/deepbook-v3 2.9.1 → 2.10.0

package/dist/contracts/deepbook_sessions/sessions.mjs

@@ -12,19 +12,36 @@ import { bcs } from "@mysten/sui/bcs";
 * Owns time-limited trading session grants attached to canonical Accounts. Account
 * owners grant and revoke sessions; an active session can only generate app auth
 * inside the Predict and DeepBook spot wrappers exposed here.
+*
+* A session-key trade that names a Predict builder code pays that builder a fee
+* the session holder picks, so the owner approves one code and a maximum fee per
+* session (`approve_session_builder`), and the `_with_builder` wrappers accept
+* only that code at or below that fee.
 */
 var sessions_exports = /* @__PURE__ */ __exportAll({
 	SessionAuthorized: () => SessionAuthorized,
+	SessionBuilder: () => SessionBuilder,
+	SessionBuilderApproved: () => SessionBuilderApproved,
+	SessionBuilderCleared: () => SessionBuilderCleared,
+	SessionBuilders: () => SessionBuilders,
+	SessionBuildersApp: () => SessionBuildersApp,
 	SessionRevoked: () => SessionRevoked,
 	SessionsApp: () => SessionsApp,
 	SessionsData: () => SessionsData,
+	approveSessionBuilder: () => approveSessionBuilder,
+	approvedCodeId: () => approvedCodeId,
+	approvedMaxFeePerContract: () => approvedMaxFeePerContract,
 	authorizeSession: () => authorizeSession,
 	cancelLiveOrder: () => cancelLiveOrder,
 	cancelLiveOrders: () => cancelLiveOrders,
 	enqueueExactAmount: () => enqueueExactAmount,
+	enqueueExactAmountWithBuilder: () => enqueueExactAmountWithBuilder,
 	enqueueExactCost: () => enqueueExactCost,
+	enqueueExactCostWithBuilder: () => enqueueExactCostWithBuilder,
 	enqueueExactQuantity: () => enqueueExactQuantity,
+	enqueueExactQuantityWithBuilder: () => enqueueExactQuantityWithBuilder,
 	enqueueRedeemOpen: () => enqueueRedeemOpen,
+	enqueueRedeemOpenWithBuilder: () => enqueueRedeemOpenWithBuilder,
 	mintExactAmount: () => mintExactAmount,
 	mintExactCost: () => mintExactCost,
 	mintExactQuantity: () => mintExactQuantity,
@@ -33,6 +50,7 @@ var sessions_exports = /* @__PURE__ */ __exportAll({
 	redeemLive: () => redeemLive,
 	redeemSettled: () => redeemSettled,
 	revokeSession: () => revokeSession,
+	sessionBuilder: () => sessionBuilder,
 	sessionExpirationMs: () => sessionExpirationMs,
 	withdrawSettledAmounts: () => withdrawSettledAmounts
 });
@@ -61,6 +79,37 @@ const SessionRevoked = new MoveStruct({
 		expires_at_ms: U64
 	}
 });
+const SessionBuildersApp = new MoveStruct({
+	name: `${$moduleName}::SessionBuildersApp`,
+	fields: { dummy_field: bcs.bool() }
+});
+const SessionBuilder = new MoveStruct({
+	name: `${$moduleName}::SessionBuilder`,
+	fields: {
+		code_id: bcs.Address,
+		max_fee_per_contract: U64
+	}
+});
+const SessionBuilders = new MoveStruct({
+	name: `${$moduleName}::SessionBuilders`,
+	fields: { approvals: VecMap(bcs.Address, SessionBuilder) }
+});
+const SessionBuilderApproved = new MoveStruct({
+	name: `${$moduleName}::SessionBuilderApproved`,
+	fields: {
+		account_id: bcs.Address,
+		session: bcs.Address,
+		code_id: bcs.Address,
+		max_fee_per_contract: U64
+	}
+});
+const SessionBuilderCleared = new MoveStruct({
+	name: `${$moduleName}::SessionBuilderCleared`,
+	fields: {
+		account_id: bcs.Address,
+		session: bcs.Address
+	}
+});
 /** Return a known session's expiration timestamp for SDK and devInspect reads. */
 function sessionExpirationMs(options) {
 	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
@@ -73,9 +122,48 @@ function sessionExpirationMs(options) {
 		arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames)
 	});
 }
+/** Return a session's approved builder, or `none`, for SDK and devInspect reads. */
+function sessionBuilder(options) {
+	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
+	const argumentsTypes = [null, "address"];
+	const parameterNames = ["wrapper", "session"];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "sessions",
+		function: "session_builder",
+		arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames)
+	});
+}
+/** Return the builder code an approval allows, for SDK and devInspect reads. */
+function approvedCodeId(options) {
+	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
+	const argumentsTypes = [null];
+	const parameterNames = ["builder"];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "sessions",
+		function: "approved_code_id",
+		arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames)
+	});
+}
+/** Return the most an approval allows per contract, for SDK and devInspect reads. */
+function approvedMaxFeePerContract(options) {
+	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
+	const argumentsTypes = [null];
+	const parameterNames = ["builder"];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "sessions",
+		function: "approved_max_fee_per_contract",
+		arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames)
+	});
+}
 /**
 * Authorize `session` from execution time for at most 30 days. Accounts may store
-* at most 20 addresses; reauthorization replaces in place.
+* at most 20 addresses; reauthorization replaces in place and keeps the session's
+* builder approval, while a new grant starts without one. A session that expired
+* but was never revoked is still stored, so granting it again is a reauthorization
+* and keeps its approval.
 */
 function authorizeSession(options) {
 	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
@@ -103,8 +191,44 @@ function authorizeSession(options) {
 	});
 }
 /**
-* Revoke `session` if it is present. Only the Account owner may call this
-* function.
+* Approve the builder code `session`'s trades may name, and the most they may
+* charge per contract (`max_fee_per_contract`, in FLOAT_SCALING of the $1 payout),
+* replacing any earlier approval. Only the Account owner may call this, and only
+* for a session already authorized (`ESessionNotAuthorized`), so an app calls it
+* right after `authorize_session` in the same transaction. The approval lasts
+* until `revoke_session`; re-authorizing the session keeps it. Aborts
+* `EBuilderApprovalsNotEnabled` until the `SessionsConfig` watermark reaches the
+* first version that clears stale approvals.
+*/
+function approveSessionBuilder(options) {
+	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
+	const argumentsTypes = [
+		null,
+		null,
+		"address",
+		"0x2::object::ID",
+		"u64"
+	];
+	const parameterNames = [
+		"wrapper",
+		"sessionsConfig",
+		"session",
+		"codeId",
+		"maxFeePerContract"
+	];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "sessions",
+		function: "approve_session_builder",
+		arguments: normalizeMoveArguments({
+			...options.arguments,
+			sessionsConfig: options.arguments?.sessionsConfig ?? options.config?.sessionsConfig
+		}, argumentsTypes, parameterNames)
+	});
+}
+/**
+* Revoke `session` and its builder approval if present. Only the Account owner may
+* call this function.
 */
 function revokeSession(options) {
 	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
@@ -552,6 +676,66 @@ function enqueueExactQuantity(options) {
 	});
 }
 /**
+* `enqueue_exact_quantity` for a session-key mint that names a builder: `code` and
+* `builder_fee_per_contract` must be the session's approved code and at most its
+* approved fee (`EBuilderNotApproved`, `EBuilderFeeAboveApproved`), after the
+* session checks. Returns the new queue record ID.
+*/
+function enqueueExactQuantityWithBuilder(options) {
+	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
+	const argumentsTypes = [
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"0x2::accumulator::AccumulatorRoot",
+		"0x2::clock::Clock"
+	];
+	const parameterNames = [
+		"queue",
+		"market",
+		"accountRegistry",
+		"wrapper",
+		"sessionsConfig",
+		"desk",
+		"config",
+		"propbookRegistry",
+		"pyth",
+		"bsValues",
+		"bsSvi",
+		"code",
+		"builderFeePerContract",
+		"lowerTick",
+		"higherTick",
+		"quantity",
+		"maxCost",
+		"maxProbability"
+	];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "sessions",
+		function: "enqueue_exact_quantity_with_builder",
+		arguments: normalizeMoveArguments({
+			...options.arguments,
+			sessionsConfig: options.arguments?.sessionsConfig ?? options.config?.sessionsConfig
+		}, argumentsTypes, parameterNames)
+	});
+}
+/**
 * Queue a premium-budget Predict mint in `market`'s order-flow queue for an
 * Account with an active session. Returns the queue record ID.
 */
@@ -606,6 +790,66 @@ function enqueueExactAmount(options) {
 	});
 }
 /**
+* `enqueue_exact_amount` for a session-key mint that names a builder: `code` and
+* `builder_fee_per_contract` must be the session's approved code and at most its
+* approved fee (`EBuilderNotApproved`, `EBuilderFeeAboveApproved`), after the
+* session checks. Returns the new queue record ID.
+*/
+function enqueueExactAmountWithBuilder(options) {
+	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
+	const argumentsTypes = [
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"0x2::accumulator::AccumulatorRoot",
+		"0x2::clock::Clock"
+	];
+	const parameterNames = [
+		"queue",
+		"market",
+		"accountRegistry",
+		"wrapper",
+		"sessionsConfig",
+		"desk",
+		"config",
+		"propbookRegistry",
+		"pyth",
+		"bsValues",
+		"bsSvi",
+		"code",
+		"builderFeePerContract",
+		"lowerTick",
+		"higherTick",
+		"maxPremium",
+		"minQuantity",
+		"maxCost"
+	];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "sessions",
+		function: "enqueue_exact_amount_with_builder",
+		arguments: normalizeMoveArguments({
+			...options.arguments,
+			sessionsConfig: options.arguments?.sessionsConfig ?? options.config?.sessionsConfig
+		}, argumentsTypes, parameterNames)
+	});
+}
+/**
 * Queue an all-in-budget Predict mint in `market`'s order-flow queue for an
 * Account with an active session. Returns the queue record ID.
 */
@@ -658,6 +902,64 @@ function enqueueExactCost(options) {
 	});
 }
 /**
+* `enqueue_exact_cost` for a session-key mint that names a builder: `code` and
+* `builder_fee_per_contract` must be the session's approved code and at most its
+* approved fee (`EBuilderNotApproved`, `EBuilderFeeAboveApproved`), after the
+* session checks. Returns the new queue record ID.
+*/
+function enqueueExactCostWithBuilder(options) {
+	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
+	const argumentsTypes = [
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"0x2::accumulator::AccumulatorRoot",
+		"0x2::clock::Clock"
+	];
+	const parameterNames = [
+		"queue",
+		"market",
+		"accountRegistry",
+		"wrapper",
+		"sessionsConfig",
+		"desk",
+		"config",
+		"propbookRegistry",
+		"pyth",
+		"bsValues",
+		"bsSvi",
+		"code",
+		"builderFeePerContract",
+		"lowerTick",
+		"higherTick",
+		"maxCost",
+		"minQuantity"
+	];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "sessions",
+		function: "enqueue_exact_cost_with_builder",
+		arguments: normalizeMoveArguments({
+			...options.arguments,
+			sessionsConfig: options.arguments?.sessionsConfig ?? options.config?.sessionsConfig
+		}, argumentsTypes, parameterNames)
+	});
+}
+/**
 * Queue an early sell of an Open order-flow queue record for an Account with an
 * active session. Returns the new queue record ID.
 */
@@ -709,6 +1011,64 @@ function enqueueRedeemOpen(options) {
 		}, argumentsTypes, parameterNames)
 	});
 }
+/**
+* `enqueue_redeem_open` for a session-key sell that names a builder: `code` and
+* `builder_fee_per_contract` must be the session's approved code and at most its
+* approved fee (`EBuilderNotApproved`, `EBuilderFeeAboveApproved`), after the
+* session checks. Returns the new queue record ID.
+*/
+function enqueueRedeemOpenWithBuilder(options) {
+	const packageAddress = options.package ?? options.config?.sessionsPackageId ?? "@local-pkg/deepbook_sessions";
+	const argumentsTypes = [
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		null,
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"u64",
+		"0x2::accumulator::AccumulatorRoot",
+		"0x2::clock::Clock"
+	];
+	const parameterNames = [
+		"queue",
+		"market",
+		"accountRegistry",
+		"wrapper",
+		"sessionsConfig",
+		"desk",
+		"config",
+		"propbookRegistry",
+		"pyth",
+		"bsValues",
+		"bsSvi",
+		"code",
+		"builderFeePerContract",
+		"recordId",
+		"closeQuantity",
+		"minProbability",
+		"minProceeds"
+	];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "sessions",
+		function: "enqueue_redeem_open_with_builder",
+		arguments: normalizeMoveArguments({
+			...options.arguments,
+			sessionsConfig: options.arguments?.sessionsConfig ?? options.config?.sessionsConfig
+		}, argumentsTypes, parameterNames)
+	});
+}
 
 //#endregion
 export { SessionAuthorized, SessionRevoked, SessionsApp, SessionsData, authorizeSession, enqueueExactAmount, enqueueExactCost, enqueueExactQuantity, enqueueRedeemOpen, mintExactAmount, mintExactCost, mintExactQuantity, redeemLive, redeemSettled, revokeSession, sessionExpirationMs, sessions_exports };