@mysten/deepbook-v3 2.1.4 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @mysten/deepbook-v3
 
+## 2.3.0
+
+### Minor Changes
+
+- 7b47a9a: Predict: let `supplyPlp` and `withdrawPlp` set a price floor. Both hard-pinned the
+  request's floor to 0, so the SDK could only ever queue an LP request that accepts whatever mark
+  the next pool flush quotes. They now take an optional third argument — `{ minPlpOut }` (raw
+  `bigint` shares) and `{ minUsdcOut }` (USD decimals) — defaulting to the previous no-floor
+  behaviour.
+- 1e2f728: Add Mainnet deployment ids for Predict, sessions and the account primitive. `getConfig`,
+  `getAccountConfig`, `getSessionsConfig`, `getUnits` and `getDeployment` now resolve `'mainnet'`
+  instead of throwing, and `MAINNET_CONFIG` / `MAINNET_DEPLOYMENT` / `MAINNET_UNITS` are exported
+  alongside their testnet counterparts. `DeployedNetwork` widens to `'testnet' | 'mainnet'`.
+
+  Mainnet settles in Circle's native USDC
+  (`0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC`). The in-repo
+  test currency is never published to Mainnet, so the collateral type resolves to Circle's package
+  there and to the DeepBook test coin on Testnet — read `quoteCoinType` from the config rather than
+  assuming either.
+
+  The ids are generated from the deploy tooling's own Mainnet manifest, like Testnet's, so both
+  networks move together on a redeploy and cannot drift apart across subpaths.
+
+## 2.2.0
+
+### Minor Changes
+
+- e7c8014: Target the `deepbook-predict-testnet` deployment. Every testnet id the SDK ships changes
+  — the Predict, account and sessions packages and their shared objects — so `getConfig('testnet')`,
+  `getAccountConfig('testnet')`, `getSessionsConfig('testnet')` and `TESTNET_CONFIG` all resolve
+  against the new deployment, and `getDeployment('testnet')` reports it by name and source commit.
+  Anything pinned to the previous testnet deployment's ids will not find its accounts, positions or
+  markets there; they are separate deployments, not an upgrade.
+
+  The settlement collateral is renamed upstream from `dusdc::dusdc::DUSDC` to `usdc::usdc::USDC`, so
+  one Move module path resolves on both testnet and mainnet and mainnet can link native USDC by
+  address alone. `quoteCoinType` carries the new type. The testnet coin keeps the `DUSDC` display
+  symbol, which is what distinguishes the mintable test coin from native USDC in wallets and
+  explorers — read `quoteCoinType` rather than assuming a symbol or a type.
+
+  The exported surface is otherwise unchanged: no symbol is added, removed or re-typed, and the
+  renamed Move argument (`min_usdc_out`) is internal to the transaction builders.
+
 ## 2.1.4
 
 ## 2.1.3

package/PREDICT.md

@@ -32,10 +32,10 @@ const client = new SuiGrpcClient({
 // One-time: create your Predict account (a shared AccountWrapper).
 const createTx = client.predict.tx.createManager();
 
-// Fund it: pulls DUSDC from your address (coin objects and/or address balance).
+// Fund it: pulls USDC from your address (coin objects and/or address balance).
 const depositTx = client.predict.tx.deposit(myAddress, 250); // $250
 
-// Cash out: lands in your DUSDC address balance by default (no coin-object churn).
+// Cash out: lands in your USDC address balance by default (no coin-object churn).
 // Pass { toCoinObject: true } if you need a discrete Coin<T> instead.
 const withdrawTx = client.predict.tx.withdraw(myAddress, 100); // $100
 
@@ -101,7 +101,7 @@ reads use the primitives layer, which returns raw `bigint`s (`accountBalance`, `
 
 | Concept                                     | You pass / receive                                             | On-chain raw                          |
 | ------------------------------------------- | -------------------------------------------------------------- | ------------------------------------- |
-| Amounts (deposit, spend, maxCost, balances) | USD decimal number or string (`12.5`, `"12.5"`)                | ×1e6 (DUSDC)                          |
+| Amounts (deposit, spend, maxCost, balances) | USD decimal number or string (`12.5`, `"12.5"`)                | ×1e6 (USDC)                           |
 | `quantity`                                  | **max payout** in USD; positions pay $1 per contract at expiry | ×1e6, in $0.01 lots                   |
 | `strike`                                    | USD (`105_000`)                                                | ×1e9, must land on the admission grid |
 | `maxProbability`                            | 0..1 (`0.35` = 35¢ per $1 contract)                            | ×1e9                                  |
@@ -109,6 +109,11 @@ reads use the primitives layer, which returns raw `bigint`s (`accountBalance`, `
 
 `side: "up"` wins if the settlement price is above the strike; `"down"` below.
 
+Trading closes slightly before expiry: the protocol enforces a short pre-expiry no-trade window
+(`no_trade_window_ms` on the live `ProtocolConfig`, 2s on the current testnet deployment), so a mint
+or redeem submitted inside it aborts `ETradeWindowClosed` rather than filling. Treat the last
+seconds of a window as untradeable rather than retrying.
+
 ## Reference-price markets (Polymarket-style windows)
 
 Each market carries an on-chain **reference price** — derived from the exact previous-window oracle
@@ -233,11 +238,18 @@ stop requiring an SDK release for target resolution.
   as the cheap validator.
 - PLP supply/withdraw are queued and fill at the next pool flush; cancels take the queue `index` —
   get it from `decode.plpRequest(result).index`.
+- **Both take an optional price floor**, and default to none:
+  `supplyPlp(owner, amount, { minPlpOut })` (raw `bigint` shares) and
+  `withdrawPlp(owner, shares, { minUsdcOut })` (USD decimals). Each floors the flush's MARK for the
+  whole request rather than naming a quantity — a flush quoting less declines instead of filling
+  smaller. What a miss costs is the deployment's `lp_request_limit_flush_attempts`: at the shipped
+  count of one, the first flush below the floor cancels the request and refunds it, so re-queueing
+  is a fresh transaction. Leave the floor off and the request takes whatever mark the flush quotes.
 - `claimSettled` closes the order in full — the deployed entrypoint takes no quantity.
 - **`withdraw` lands in your address balance by default** (`0x2::coin::send_funds`), not a coin
   object — it merges into the versionless accumulator `deposit` already draws from, so the round
-  trip never accretes stray `Coin<DUSDC>` objects. `read.balance(owner)` reflects the account's
-  internal custody balance; use the client's `getBalance(owner)` for the wallet-side DUSDC total
+  trip never accretes stray `Coin<USDC>` objects. `read.balance(owner)` reflects the account's
+  internal custody balance; use the client's `getBalance(owner)` for the wallet-side USDC total
   (coin objects + address balance). Pass `withdraw(owner, amt, { toCoinObject: true })` for a
   discrete coin (wallets/explorers that only render coin objects, or same-PTB composition).
 

package/dist/account.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"account.d.mts","names":[],"sources":["../src/account.ts"],"mappings":";;;;;;;;;;;;AAoCA;;;;;;;;;AAiBA;;UAjBiB,aAAA,SAAsB,eAAA;EAiB6B;EAfnE,gBAAA;EAegC;EAbhC,eAAA;AAAA;;AAqCD;;;;;;;;;iBAxBgB,gBAAA,CAAiB,OAAA,EAAS,UAAA,GAAa,aAAA;;;;;;;;;;cAwB1C,eAAA;EAAA;EAMQ;;;cAAR,MAAA,EAAQ,aAAA;EA0BpB;;;;;;;EAfA,sBAAA,CAAuB,KAAA;EA0CW;;;;;;EA3BlC,YAAA,CAAA,IACS,EAAA,EAAI,WAAA,KAAc,iBAAA;EAgDJ;;;;;;EAtCvB,aAAA,CAAA,IACS,EAAA,EAAI,WAAA;EA0Db;;;;;;;;;EA3CA,uBAAA,CAAwB,MAAA;IAAU,IAAA,EAAM,yBAAA;IAA2B,QAAA;EAAA,KAC1D,EAAA,EAAI,WAAA;EA8Dc;;;;;;;EAzC3B,YAAA,CAAa,MAAA;IAAU,SAAA;IAAmB,IAAA,EAAM,yBAAA;IAA2B,QAAA;EAAA,KAClE,EAAA,EAAI,WAAA;;;;;;;;;EAoBb,aAAA,CAAc,MAAA;IAAU,SAAA;IAAmB,MAAA;IAAgB,QAAA;EAAA,KAClD,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;EAkB3B,WAAA,CAAY,MAAA;IAAU,SAAA;EAAA,KACb,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;;EAW3B,OAAA,CAAQ,MAAA;IAAU,KAAA;IAAe,QAAA;EAAA,KACxB,EAAA,EAAI,WAAA,KAAc,iBAAA;AAAA"}
+{"version":3,"file":"account.d.mts","names":[],"sources":["../src/account.ts"],"mappings":";;;;;;;;;;;;AAqCA;;;;;;;;;AAiBA;;UAjBiB,aAAA,SAAsB,eAAA;EAiB6B;EAfnE,gBAAA;EAegC;EAbhC,eAAA;AAAA;;AAsCD;;;;;;;;;iBAzBgB,gBAAA,CAAiB,OAAA,EAAS,UAAA,GAAa,aAAA;;;;;;;;;;cAyB1C,eAAA;EAAA;EAMQ;;;cAAR,MAAA,EAAQ,aAAA;EA0BpB;;;;;;;EAfA,sBAAA,CAAuB,KAAA;EA0CW;;;;;;EA3BlC,YAAA,CAAA,IACS,EAAA,EAAI,WAAA,KAAc,iBAAA;EAgDJ;;;;;;EAtCvB,aAAA,CAAA,IACS,EAAA,EAAI,WAAA;EA0Db;;;;;;;;;EA3CA,uBAAA,CAAwB,MAAA;IAAU,IAAA,EAAM,yBAAA;IAA2B,QAAA;EAAA,KAC1D,EAAA,EAAI,WAAA;EA8Dc;;;;;;;EAzC3B,YAAA,CAAa,MAAA;IAAU,SAAA;IAAmB,IAAA,EAAM,yBAAA;IAA2B,QAAA;EAAA,KAClE,EAAA,EAAI,WAAA;;;;;;;;;EAoBb,aAAA,CAAc,MAAA;IAAU,SAAA;IAAmB,MAAA;IAAgB,QAAA;EAAA,KAClD,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;EAkB3B,WAAA,CAAY,MAAA;IAAU,SAAA;EAAA,KACb,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;;EAW3B,OAAA,CAAQ,MAAA;IAAU,KAAA;IAAe,QAAA;EAAA,KACxB,EAAA,EAAI,WAAA,KAAc,iBAAA;AAAA"}

package/dist/account.mjs

@@ -1,5 +1,6 @@
 import { Account, AccountWrapper, account_exports, balance, depositFunds, generateAuth, loadAccount, share, withdrawFunds } from "./contracts/account/account.mjs";
 import { _new, account_registry_exports } from "./contracts/account/account_registry.mjs";
+import { MAINNET_ACCOUNT } from "./deployments/mainnet.mjs";
 import { TESTNET_ACCOUNT, TESTNET_DEPLOYMENT, TESTNET_UNITS } from "./deployments/testnet.mjs";
 import { getDeployment, getUnits } from "./deployments/index.mjs";
 import { account_events_exports } from "./contracts/account/account_events.mjs";
@@ -19,7 +20,8 @@ import { deriveObjectID } from "@mysten/sui/utils";
 */
 function getAccountConfig(network) {
 	if (network === "testnet") return TESTNET_ACCOUNT;
-	throw new Error(`@mysten/deepbook-v3/account: no account deployment recorded for network '${network}'. The account primitive is testnet-only today; for your own deployment pass \`{ accountPackageId, accountRegistry }\` to AccountContract directly.`);
+	if (network === "mainnet") return MAINNET_ACCOUNT;
+	throw new Error(`@mysten/deepbook-v3/account: no account deployment recorded for network '${network}'. The account primitive is recorded for testnet and mainnet; for your own deployment pass \`{ accountPackageId, accountRegistry }\` to AccountContract directly.`);
 }
 const AccountWrapperKey = bcs.struct("AccountWrapperKey", { pos0: bcs.Address });
 /**

package/dist/account.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"account.mjs","names":["#config","account.generateAuth","accountRegistry._new","account.share","account.depositFunds","account.withdrawFunds","account.loadAccount","account.balance"],"sources":["../src/account.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\nimport { bcs } from '@mysten/sui/bcs';\nimport type {\n\tTransaction,\n\tTransactionObjectArgument,\n\tTransactionResult,\n} from '@mysten/sui/transactions';\nimport { deriveObjectID } from '@mysten/sui/utils';\n\nimport * as account from './contracts/account/account.js';\nimport * as accountRegistry from './contracts/account/account_registry.js';\nimport type { AccountConfig as GeneratedAccountConfig } from './contracts/account/config-arguments.js';\nimport { TESTNET_ACCOUNT } from './deployments/testnet.js';\nimport type { NetworkArg } from './deployments/index.js';\n\n// Provenance: which on-chain deployment the ids above came from. Re-exported so a consumer\n// can answer \"which deploy is this build pinned to?\" without reaching for another subpath.\nexport { getDeployment, getUnits, TESTNET_DEPLOYMENT, TESTNET_UNITS } from './deployments/index.js';\nexport type { NetworkArg } from './deployments/index.js';\nexport type { DeployedNetwork } from './deployments/index.js';\n\n/**\n * The deployed ids of the shared `account` package this contract builds against.\n *\n * Kept deliberately minimal — ids only — so any consumer of the shared account primitive\n * (DeepBook core's account wrapper, Predict, …) can drive these builders with its OWN\n * deployment's ids without constructing a full product-SDK config.\n *\n * Extends the codegen-generated config interface so there is exactly one config shape and\n * casing: the generated bindings resolve `options.config` against these same keys, and if\n * codegen adds, drops, or renames a key this file stops compiling instead of silently\n * building a PTB against the wrong object. The ids are narrowed to `string` — codegen types\n * the package id as optional and the registry as the wider `ConfigValue`, but the\n * wrapper-address derivation needs plain ids.\n */\nexport interface AccountConfig extends GeneratedAccountConfig {\n\t/** The `account` Move package id. */\n\taccountPackageId: string;\n\t/** The shared `AccountRegistry` object id. */\n\taccountRegistry: string;\n}\n\n/**\n * @description The deployed `account` ids for `network`, so a caller does not transcribe\n * them. Generated from the deploy manifest — see `src/deployments/`.\n * @throws if the network has no recorded deployment, rather than returning placeholder ids\n * that would fail as a confusing on-chain abort.\n *\n * ```ts\n * const account = new AccountContract(getAccountConfig('testnet'));\n * ```\n */\nexport function getAccountConfig(network: NetworkArg): AccountConfig {\n\tif (network === 'testnet') return TESTNET_ACCOUNT;\n\tthrow new Error(\n\t\t`@mysten/deepbook-v3/account: no account deployment recorded for network '${network}'. ` +\n\t\t\t'The account primitive is testnet-only today; for your own deployment pass ' +\n\t\t\t'`{ accountPackageId, accountRegistry }` to AccountContract directly.',\n\t);\n}\n\n// `AccountWrapperKey(address)` is a one-field positional struct, so its BCS is just the\n// owner's 32-byte address. See `packages/account/sources/account_registry.move`.\nconst AccountWrapperKey = bcs.struct('AccountWrapperKey', {\n\tpos0: bcs.Address,\n});\n\n/**\n * AccountContract — the reusable on-chain account primitive (`packages/account`).\n *\n * An owner has one canonical `AccountWrapper`, a *derived* object of the account registry,\n * so its id is computable off-chain (no read). The wrapper holds an `Account` whose custody\n * balances apps deposit into and withdraw from; app-specific data hangs off it under an\n * app-keyed slot. Authority is a hot-potato `Auth` minted from the tx sender and consumed\n * by the very next account-loading call.\n */\nexport class AccountContract {\n\t#config: AccountConfig;\n\n\t/**\n\t * @param {AccountConfig} config Deployed ids of the shared `account` package\n\t */\n\tconstructor(config: AccountConfig) {\n\t\tthis.#config = config;\n\t}\n\n\t/**\n\t * @description The deterministic id of an owner's canonical account wrapper — no chain\n\t * read needed. The wrapper is a derived object of the account registry, so its id is\n\t * `derive_address(registry, AccountWrapperKey(owner))`.\n\t * @param {string} owner Owner address\n\t * @returns The wrapper object id\n\t */\n\tderiveAccountWrapperId(owner: string): string {\n\t\tconst key = AccountWrapperKey.serialize({ pos0: owner }).toBytes();\n\t\treturn deriveObjectID(\n\t\t\tthis.#config.accountRegistry,\n\t\t\t`${this.#config.accountPackageId}::account_registry::AccountWrapperKey`,\n\t\t\tkey,\n\t\t);\n\t}\n\n\t/**\n\t * @description Mint owner authority for the transaction sender. A hot-potato `Auth`\n\t * consumed by the very next account-loading call (`load_account_mut` inside\n\t * `deposit_funds` / `withdraw_funds` / an app's own entrypoints).\n\t * @returns A function that takes a Transaction object\n\t */\n\tgenerateAuth() {\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(account.generateAuth({ config: this.#config }));\n\t}\n\n\t/**\n\t * @description Create the sender's canonical account wrapper and share it. `new` derives\n\t * the wrapper at its deterministic address (see `deriveAccountWrapperId`) and aborts if\n\t * it already exists; `share` publishes the shared object apps borrow against.\n\t * @returns A function that takes a Transaction object\n\t */\n\tcreateAccount() {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst wrapper = tx.add(accountRegistry._new({ config: this.#config }));\n\t\t\ttx.add(account.share({ config: this.#config, arguments: { self: wrapper } }));\n\t\t};\n\t}\n\n\t/**\n\t * @description First-time funding in ONE PTB: create the sender's wrapper, deposit\n\t * `coin` through the fresh handle, then `share` LAST (once shared, by-value use of the\n\t * handle is over). This cannot be split into `createAccount` + `depositFunds`: an object\n\t * input can only address an object that pre-exists the PTB, so a wrapper created inside\n\t * it is reachable only through `new`'s result handle.\n\t * @param {object} params Coin to deposit and its coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tcreateAccountAndDeposit(params: { coin: TransactionObjectArgument; coinType: string }) {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst wrapper = tx.add(accountRegistry._new({ config: this.#config }));\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\ttx.add(\n\t\t\t\taccount.depositFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper, auth, coin: params.coin },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t\ttx.add(account.share({ config: this.#config, arguments: { self: wrapper } }));\n\t\t};\n\t}\n\n\t/**\n\t * @description Deposit a caller-provided `coin` into the account's stored balance via the\n\t * PTB-callable `deposit_funds` (folds settle → authorize → load → deposit; clock and\n\t * accumulator root auto-injected). The caller owns coin sourcing.\n\t * @param {object} params Wrapper id, coin to deposit, and its coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tdepositFunds(params: { wrapperId: string; coin: TransactionObjectArgument; coinType: string }) {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\ttx.add(\n\t\t\t\taccount.depositFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper: params.wrapperId, auth, coin: params.coin },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n\n\t/**\n\t * @description Withdraw `amount` (raw u64 units) from the account's stored balance via\n\t * the PTB-callable `withdraw_funds` (folds settle → authorize → load → withdraw; clock\n\t * and accumulator root auto-injected), returning the minted `Coin<T>` for the caller to\n\t * transfer or compose.\n\t * @param {object} params Wrapper id, raw amount, and coin type\n\t * @returns A function that takes a Transaction object and returns the `Coin<T>`\n\t */\n\twithdrawFunds(params: { wrapperId: string; amount: bigint; coinType: string }) {\n\t\treturn (tx: Transaction): TransactionResult => {\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\treturn tx.add(\n\t\t\t\taccount.withdrawFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper: params.wrapperId, auth, amount: params.amount },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n\n\t/**\n\t * @description Borrow the `Account` out of its wrapper — the read-side entry point apps\n\t * chain their own getters onto (`account::balance<T>`, an app's own data accessors).\n\t * @param {object} params Wrapper id\n\t * @returns A function that takes a Transaction object and returns the `Account`\n\t */\n\tloadAccount(params: { wrapperId: string }) {\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(account.loadAccount({ config: this.#config, arguments: { self: params.wrapperId } }));\n\t}\n\n\t/**\n\t * @description Read an owner's stored custody balance for a coin type: chains\n\t * `load_account(wrapper)` → `balance<T>(account, root, clock)`. Compose in a\n\t * dev-inspect/simulate PTB and read the u64 return of the LAST command.\n\t * @param {object} params Owner address and coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tbalance(params: { owner: string; coinType: string }) {\n\t\treturn (tx: Transaction): TransactionResult => {\n\t\t\tconst acct = tx.add(\n\t\t\t\tthis.loadAccount({ wrapperId: this.deriveAccountWrapperId(params.owner) }),\n\t\t\t);\n\t\t\treturn tx.add(\n\t\t\t\taccount.balance({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t\targuments: { self: acct },\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n}\n\n// === Generated bindings ===\n// The move-call thunks and BCS structs, for consumers composing their own PTBs or\n// parsing account objects/events (e.g. `AccountWrapper.parse`, the event layouts).\n//\n// NOTE: `Account` here is the shared account primitive's custody account\n// (`account::account::Account`). It is deliberately NOT re-exported from this\n// package's root — the root already exports a different `Account`\n// (`@deepbook/core::account::Account`, the per-pool trading account) and the two\n// have unrelated layouts. Keep them separated by subpath.\nexport * as accountMoveCalls from './contracts/account/account.js';\nexport * as accountRegistryMoveCalls from './contracts/account/account_registry.js';\nexport * as accountEvents from './contracts/account/account_events.js';\nexport { Account, AccountWrapper } from './contracts/account/account.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqDA,SAAgB,iBAAiB,SAAoC;AACpE,KAAI,YAAY,UAAW,QAAO;AAClC,OAAM,IAAI,MACT,4EAA4E,QAAQ,qJAGpF;;AAKF,MAAM,oBAAoB,IAAI,OAAO,qBAAqB,EACzD,MAAM,IAAI,SACV,CAAC;;;;;;;;;;AAWF,IAAa,kBAAb,MAA6B;CAC5B;;;;CAKA,YAAY,QAAuB;AAClC,QAAKA,SAAU;;;;;;;;;CAUhB,uBAAuB,OAAuB;EAC7C,MAAM,MAAM,kBAAkB,UAAU,EAAE,MAAM,OAAO,CAAC,CAAC,SAAS;AAClE,SAAO,eACN,MAAKA,OAAQ,iBACb,GAAG,MAAKA,OAAQ,iBAAiB,wCACjC,IACA;;;;;;;;CASF,eAAe;AACd,UAAQ,OACP,GAAG,IAAIC,aAAqB,EAAE,QAAQ,MAAKD,QAAS,CAAC,CAAC;;;;;;;;CASxD,gBAAgB;AACf,UAAQ,OAA0B;GACjC,MAAM,UAAU,GAAG,IAAIE,KAAqB,EAAE,QAAQ,MAAKF,QAAS,CAAC,CAAC;AACtE,MAAG,IAAIG,MAAc;IAAE,QAAQ,MAAKH;IAAS,WAAW,EAAE,MAAM,SAAS;IAAE,CAAC,CAAC;;;;;;;;;;;;CAa/E,wBAAwB,QAA+D;AACtF,UAAQ,OAA0B;GACjC,MAAM,UAAU,GAAG,IAAIE,KAAqB,EAAE,QAAQ,MAAKF,QAAS,CAAC,CAAC;GACtE,MAAM,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC;AACxC,MAAG,IACFI,aAAqB;IACpB,QAAQ,MAAKJ;IACb,WAAW;KAAE;KAAS;KAAM,MAAM,OAAO;KAAM;IAC/C,eAAe,CAAC,OAAO,SAAS;IAChC,CAAC,CACF;AACD,MAAG,IAAIG,MAAc;IAAE,QAAQ,MAAKH;IAAS,WAAW,EAAE,MAAM,SAAS;IAAE,CAAC,CAAC;;;;;;;;;;CAW/E,aAAa,QAAkF;AAC9F,UAAQ,OAA0B;GACjC,MAAM,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC;AACxC,MAAG,IACFI,aAAqB;IACpB,QAAQ,MAAKJ;IACb,WAAW;KAAE,SAAS,OAAO;KAAW;KAAM,MAAM,OAAO;KAAM;IACjE,eAAe,CAAC,OAAO,SAAS;IAChC,CAAC,CACF;;;;;;;;;;;CAYH,cAAc,QAAiE;AAC9E,UAAQ,OAAuC;GAC9C,MAAM,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC;AACxC,UAAO,GAAG,IACTK,cAAsB;IACrB,QAAQ,MAAKL;IACb,WAAW;KAAE,SAAS,OAAO;KAAW;KAAM,QAAQ,OAAO;KAAQ;IACrE,eAAe,CAAC,OAAO,SAAS;IAChC,CAAC,CACF;;;;;;;;;CAUH,YAAY,QAA+B;AAC1C,UAAQ,OACP,GAAG,IAAIM,YAAoB;GAAE,QAAQ,MAAKN;GAAS,WAAW,EAAE,MAAM,OAAO,WAAW;GAAE,CAAC,CAAC;;;;;;;;;CAU9F,QAAQ,QAA6C;AACpD,UAAQ,OAAuC;GAC9C,MAAM,OAAO,GAAG,IACf,KAAK,YAAY,EAAE,WAAW,KAAK,uBAAuB,OAAO,MAAM,EAAE,CAAC,CAC1E;AACD,UAAO,GAAG,IACTO,QAAgB;IACf,QAAQ,MAAKP;IACb,eAAe,CAAC,OAAO,SAAS;IAChC,WAAW,EAAE,MAAM,MAAM;IACzB,CAAC,CACF"}
+{"version":3,"file":"account.mjs","names":["#config","account.generateAuth","accountRegistry._new","account.share","account.depositFunds","account.withdrawFunds","account.loadAccount","account.balance"],"sources":["../src/account.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\nimport { bcs } from '@mysten/sui/bcs';\nimport type {\n\tTransaction,\n\tTransactionObjectArgument,\n\tTransactionResult,\n} from '@mysten/sui/transactions';\nimport { deriveObjectID } from '@mysten/sui/utils';\n\nimport * as account from './contracts/account/account.js';\nimport * as accountRegistry from './contracts/account/account_registry.js';\nimport type { AccountConfig as GeneratedAccountConfig } from './contracts/account/config-arguments.js';\nimport { MAINNET_ACCOUNT } from './deployments/mainnet.js';\nimport { TESTNET_ACCOUNT } from './deployments/testnet.js';\nimport type { NetworkArg } from './deployments/index.js';\n\n// Provenance: which on-chain deployment the ids above came from. Re-exported so a consumer\n// can answer \"which deploy is this build pinned to?\" without reaching for another subpath.\nexport { getDeployment, getUnits, TESTNET_DEPLOYMENT, TESTNET_UNITS } from './deployments/index.js';\nexport type { NetworkArg } from './deployments/index.js';\nexport type { DeployedNetwork } from './deployments/index.js';\n\n/**\n * The deployed ids of the shared `account` package this contract builds against.\n *\n * Kept deliberately minimal — ids only — so any consumer of the shared account primitive\n * (DeepBook core's account wrapper, Predict, …) can drive these builders with its OWN\n * deployment's ids without constructing a full product-SDK config.\n *\n * Extends the codegen-generated config interface so there is exactly one config shape and\n * casing: the generated bindings resolve `options.config` against these same keys, and if\n * codegen adds, drops, or renames a key this file stops compiling instead of silently\n * building a PTB against the wrong object. The ids are narrowed to `string` — codegen types\n * the package id as optional and the registry as the wider `ConfigValue`, but the\n * wrapper-address derivation needs plain ids.\n */\nexport interface AccountConfig extends GeneratedAccountConfig {\n\t/** The `account` Move package id. */\n\taccountPackageId: string;\n\t/** The shared `AccountRegistry` object id. */\n\taccountRegistry: string;\n}\n\n/**\n * @description The deployed `account` ids for `network`, so a caller does not transcribe\n * them. Generated from the deploy manifest — see `src/deployments/`.\n * @throws if the network has no recorded deployment, rather than returning placeholder ids\n * that would fail as a confusing on-chain abort.\n *\n * ```ts\n * const account = new AccountContract(getAccountConfig('testnet'));\n * ```\n */\nexport function getAccountConfig(network: NetworkArg): AccountConfig {\n\tif (network === 'testnet') return TESTNET_ACCOUNT;\n\tif (network === 'mainnet') return MAINNET_ACCOUNT;\n\tthrow new Error(\n\t\t`@mysten/deepbook-v3/account: no account deployment recorded for network '${network}'. ` +\n\t\t\t'The account primitive is recorded for testnet and mainnet; for your own deployment pass ' +\n\t\t\t'`{ accountPackageId, accountRegistry }` to AccountContract directly.',\n\t);\n}\n\n// `AccountWrapperKey(address)` is a one-field positional struct, so its BCS is just the\n// owner's 32-byte address. See `packages/account/sources/account_registry.move`.\nconst AccountWrapperKey = bcs.struct('AccountWrapperKey', {\n\tpos0: bcs.Address,\n});\n\n/**\n * AccountContract — the reusable on-chain account primitive (`packages/account`).\n *\n * An owner has one canonical `AccountWrapper`, a *derived* object of the account registry,\n * so its id is computable off-chain (no read). The wrapper holds an `Account` whose custody\n * balances apps deposit into and withdraw from; app-specific data hangs off it under an\n * app-keyed slot. Authority is a hot-potato `Auth` minted from the tx sender and consumed\n * by the very next account-loading call.\n */\nexport class AccountContract {\n\t#config: AccountConfig;\n\n\t/**\n\t * @param {AccountConfig} config Deployed ids of the shared `account` package\n\t */\n\tconstructor(config: AccountConfig) {\n\t\tthis.#config = config;\n\t}\n\n\t/**\n\t * @description The deterministic id of an owner's canonical account wrapper — no chain\n\t * read needed. The wrapper is a derived object of the account registry, so its id is\n\t * `derive_address(registry, AccountWrapperKey(owner))`.\n\t * @param {string} owner Owner address\n\t * @returns The wrapper object id\n\t */\n\tderiveAccountWrapperId(owner: string): string {\n\t\tconst key = AccountWrapperKey.serialize({ pos0: owner }).toBytes();\n\t\treturn deriveObjectID(\n\t\t\tthis.#config.accountRegistry,\n\t\t\t`${this.#config.accountPackageId}::account_registry::AccountWrapperKey`,\n\t\t\tkey,\n\t\t);\n\t}\n\n\t/**\n\t * @description Mint owner authority for the transaction sender. A hot-potato `Auth`\n\t * consumed by the very next account-loading call (`load_account_mut` inside\n\t * `deposit_funds` / `withdraw_funds` / an app's own entrypoints).\n\t * @returns A function that takes a Transaction object\n\t */\n\tgenerateAuth() {\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(account.generateAuth({ config: this.#config }));\n\t}\n\n\t/**\n\t * @description Create the sender's canonical account wrapper and share it. `new` derives\n\t * the wrapper at its deterministic address (see `deriveAccountWrapperId`) and aborts if\n\t * it already exists; `share` publishes the shared object apps borrow against.\n\t * @returns A function that takes a Transaction object\n\t */\n\tcreateAccount() {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst wrapper = tx.add(accountRegistry._new({ config: this.#config }));\n\t\t\ttx.add(account.share({ config: this.#config, arguments: { self: wrapper } }));\n\t\t};\n\t}\n\n\t/**\n\t * @description First-time funding in ONE PTB: create the sender's wrapper, deposit\n\t * `coin` through the fresh handle, then `share` LAST (once shared, by-value use of the\n\t * handle is over). This cannot be split into `createAccount` + `depositFunds`: an object\n\t * input can only address an object that pre-exists the PTB, so a wrapper created inside\n\t * it is reachable only through `new`'s result handle.\n\t * @param {object} params Coin to deposit and its coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tcreateAccountAndDeposit(params: { coin: TransactionObjectArgument; coinType: string }) {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst wrapper = tx.add(accountRegistry._new({ config: this.#config }));\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\ttx.add(\n\t\t\t\taccount.depositFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper, auth, coin: params.coin },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t\ttx.add(account.share({ config: this.#config, arguments: { self: wrapper } }));\n\t\t};\n\t}\n\n\t/**\n\t * @description Deposit a caller-provided `coin` into the account's stored balance via the\n\t * PTB-callable `deposit_funds` (folds settle → authorize → load → deposit; clock and\n\t * accumulator root auto-injected). The caller owns coin sourcing.\n\t * @param {object} params Wrapper id, coin to deposit, and its coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tdepositFunds(params: { wrapperId: string; coin: TransactionObjectArgument; coinType: string }) {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\ttx.add(\n\t\t\t\taccount.depositFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper: params.wrapperId, auth, coin: params.coin },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n\n\t/**\n\t * @description Withdraw `amount` (raw u64 units) from the account's stored balance via\n\t * the PTB-callable `withdraw_funds` (folds settle → authorize → load → withdraw; clock\n\t * and accumulator root auto-injected), returning the minted `Coin<T>` for the caller to\n\t * transfer or compose.\n\t * @param {object} params Wrapper id, raw amount, and coin type\n\t * @returns A function that takes a Transaction object and returns the `Coin<T>`\n\t */\n\twithdrawFunds(params: { wrapperId: string; amount: bigint; coinType: string }) {\n\t\treturn (tx: Transaction): TransactionResult => {\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\treturn tx.add(\n\t\t\t\taccount.withdrawFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper: params.wrapperId, auth, amount: params.amount },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n\n\t/**\n\t * @description Borrow the `Account` out of its wrapper — the read-side entry point apps\n\t * chain their own getters onto (`account::balance<T>`, an app's own data accessors).\n\t * @param {object} params Wrapper id\n\t * @returns A function that takes a Transaction object and returns the `Account`\n\t */\n\tloadAccount(params: { wrapperId: string }) {\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(account.loadAccount({ config: this.#config, arguments: { self: params.wrapperId } }));\n\t}\n\n\t/**\n\t * @description Read an owner's stored custody balance for a coin type: chains\n\t * `load_account(wrapper)` → `balance<T>(account, root, clock)`. Compose in a\n\t * dev-inspect/simulate PTB and read the u64 return of the LAST command.\n\t * @param {object} params Owner address and coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tbalance(params: { owner: string; coinType: string }) {\n\t\treturn (tx: Transaction): TransactionResult => {\n\t\t\tconst acct = tx.add(\n\t\t\t\tthis.loadAccount({ wrapperId: this.deriveAccountWrapperId(params.owner) }),\n\t\t\t);\n\t\t\treturn tx.add(\n\t\t\t\taccount.balance({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t\targuments: { self: acct },\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n}\n\n// === Generated bindings ===\n// The move-call thunks and BCS structs, for consumers composing their own PTBs or\n// parsing account objects/events (e.g. `AccountWrapper.parse`, the event layouts).\n//\n// NOTE: `Account` here is the shared account primitive's custody account\n// (`account::account::Account`). It is deliberately NOT re-exported from this\n// package's root — the root already exports a different `Account`\n// (`@deepbook/core::account::Account`, the per-pool trading account) and the two\n// have unrelated layouts. Keep them separated by subpath.\nexport * as accountMoveCalls from './contracts/account/account.js';\nexport * as accountRegistryMoveCalls from './contracts/account/account_registry.js';\nexport * as accountEvents from './contracts/account/account_events.js';\nexport { Account, AccountWrapper } from './contracts/account/account.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAsDA,SAAgB,iBAAiB,SAAoC;AACpE,KAAI,YAAY,UAAW,QAAO;AAClC,KAAI,YAAY,UAAW,QAAO;AAClC,OAAM,IAAI,MACT,4EAA4E,QAAQ,mKAGpF;;AAKF,MAAM,oBAAoB,IAAI,OAAO,qBAAqB,EACzD,MAAM,IAAI,SACV,CAAC;;;;;;;;;;AAWF,IAAa,kBAAb,MAA6B;CAC5B;;;;CAKA,YAAY,QAAuB;AAClC,QAAKA,SAAU;;;;;;;;;CAUhB,uBAAuB,OAAuB;EAC7C,MAAM,MAAM,kBAAkB,UAAU,EAAE,MAAM,OAAO,CAAC,CAAC,SAAS;AAClE,SAAO,eACN,MAAKA,OAAQ,iBACb,GAAG,MAAKA,OAAQ,iBAAiB,wCACjC,IACA;;;;;;;;CASF,eAAe;AACd,UAAQ,OACP,GAAG,IAAIC,aAAqB,EAAE,QAAQ,MAAKD,QAAS,CAAC,CAAC;;;;;;;;CASxD,gBAAgB;AACf,UAAQ,OAA0B;GACjC,MAAM,UAAU,GAAG,IAAIE,KAAqB,EAAE,QAAQ,MAAKF,QAAS,CAAC,CAAC;AACtE,MAAG,IAAIG,MAAc;IAAE,QAAQ,MAAKH;IAAS,WAAW,EAAE,MAAM,SAAS;IAAE,CAAC,CAAC;;;;;;;;;;;;CAa/E,wBAAwB,QAA+D;AACtF,UAAQ,OAA0B;GACjC,MAAM,UAAU,GAAG,IAAIE,KAAqB,EAAE,QAAQ,MAAKF,QAAS,CAAC,CAAC;GACtE,MAAM,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC;AACxC,MAAG,IACFI,aAAqB;IACpB,QAAQ,MAAKJ;IACb,WAAW;KAAE;KAAS;KAAM,MAAM,OAAO;KAAM;IAC/C,eAAe,CAAC,OAAO,SAAS;IAChC,CAAC,CACF;AACD,MAAG,IAAIG,MAAc;IAAE,QAAQ,MAAKH;IAAS,WAAW,EAAE,MAAM,SAAS;IAAE,CAAC,CAAC;;;;;;;;;;CAW/E,aAAa,QAAkF;AAC9F,UAAQ,OAA0B;GACjC,MAAM,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC;AACxC,MAAG,IACFI,aAAqB;IACpB,QAAQ,MAAKJ;IACb,WAAW;KAAE,SAAS,OAAO;KAAW;KAAM,MAAM,OAAO;KAAM;IACjE,eAAe,CAAC,OAAO,SAAS;IAChC,CAAC,CACF;;;;;;;;;;;CAYH,cAAc,QAAiE;AAC9E,UAAQ,OAAuC;GAC9C,MAAM,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC;AACxC,UAAO,GAAG,IACTK,cAAsB;IACrB,QAAQ,MAAKL;IACb,WAAW;KAAE,SAAS,OAAO;KAAW;KAAM,QAAQ,OAAO;KAAQ;IACrE,eAAe,CAAC,OAAO,SAAS;IAChC,CAAC,CACF;;;;;;;;;CAUH,YAAY,QAA+B;AAC1C,UAAQ,OACP,GAAG,IAAIM,YAAoB;GAAE,QAAQ,MAAKN;GAAS,WAAW,EAAE,MAAM,OAAO,WAAW;GAAE,CAAC,CAAC;;;;;;;;;CAU9F,QAAQ,QAA6C;AACpD,UAAQ,OAAuC;GAC9C,MAAM,OAAO,GAAG,IACf,KAAK,YAAY,EAAE,WAAW,KAAK,uBAAuB,OAAO,MAAM,EAAE,CAAC,CAC1E;AACD,UAAO,GAAG,IACTO,QAAgB;IACf,QAAQ,MAAKP;IACb,eAAe,CAAC,OAAO,SAAS;IAChC,WAAW,EAAE,MAAM,MAAM;IACzB,CAAC,CACF"}

package/dist/client.d.mts

@@ -163,7 +163,7 @@ declare class DeepBookClient {
   }[] | null>;
   getLevel2Range(poolKey: string, priceLow: number | bigint, priceHigh: number | bigint, isBid: boolean): Promise<Level2Range>;
   getLevel2TicksFromMid(poolKey: string, ticks: number): Promise<Level2TicksFromMid>;
-  getAccountOrderDetails(poolKey: string, managerKey: string): Promise<[] | {
+  getAccountOrderDetails(poolKey: string, managerKey: string): Promise<{
     balance_manager_id: string;
     order_id: string;
     client_order_id: string;
@@ -177,7 +177,7 @@ declare class DeepBookClient {
     epoch: string;
     status: number;
     expire_timestamp: string;
-  }[]>;
+  }[] | []>;
   account(poolKey: string, managerKey: string): Promise<AccountInfo>;
   lockedBalance(poolKey: string, balanceManagerKey: string): Promise<LockedBalances>;
   getPoolDeepPrice(poolKey: string): Promise<PoolDeepPrice>;

package/dist/contracts/account/account_events.d.mts

@@ -1,40 +1,40 @@
 import { MoveStruct } from "../utils/index.mjs";
-import * as _mysten_sui_bcs2 from "@mysten/sui/bcs";
+import * as _mysten_sui_bcs7 from "@mysten/sui/bcs";
 
 //#region src/contracts/account/account_events.d.ts
 declare namespace account_events_d_exports {
   export { AccountCreated, AppAuthorized, AppDeauthorized, Deposited, FundsSettled, Withdrawn };
 }
 declare const AccountCreated: MoveStruct<{
-  account_id: _mysten_sui_bcs2.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-  wrapper_id: _mysten_sui_bcs2.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-  owner: _mysten_sui_bcs2.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-  self_owned: _mysten_sui_bcs2.BcsType<boolean, boolean, "bool">;
-  referrer_account_id: _mysten_sui_bcs2.BcsType<string | null, string | Uint8Array<ArrayBufferLike> | null | undefined, "Option<bytes[32]>">;
+  account_id: _mysten_sui_bcs7.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+  wrapper_id: _mysten_sui_bcs7.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+  owner: _mysten_sui_bcs7.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+  self_owned: _mysten_sui_bcs7.BcsType<boolean, boolean, "bool">;
+  referrer_account_id: _mysten_sui_bcs7.BcsType<string | null, string | Uint8Array<ArrayBufferLike> | null | undefined, "Option<bytes[32]>">;
 }, "@local-pkg/account::account_events::AccountCreated">;
 declare const AppAuthorized: MoveStruct<{
-  /** Fully-qualified `App` witness type name. */app: _mysten_sui_bcs2.BcsType<string, string, "string">;
+  /** Fully-qualified `App` witness type name. */app: _mysten_sui_bcs7.BcsType<string, string, "string">;
 }, "@local-pkg/account::account_events::AppAuthorized">;
 declare const AppDeauthorized: MoveStruct<{
-  app: _mysten_sui_bcs2.BcsType<string, string, "string">;
+  app: _mysten_sui_bcs7.BcsType<string, string, "string">;
 }, "@local-pkg/account::account_events::AppDeauthorized">;
 declare const Deposited: MoveStruct<{
-  account_id: _mysten_sui_bcs2.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-  coin_type: _mysten_sui_bcs2.BcsType<string, string, "string">;
-  amount: _mysten_sui_bcs2.BcsType<bigint, string | number | bigint, "u64">;
-  new_balance: _mysten_sui_bcs2.BcsType<bigint, string | number | bigint, "u64">;
+  account_id: _mysten_sui_bcs7.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+  coin_type: _mysten_sui_bcs7.BcsType<string, string, "string">;
+  amount: _mysten_sui_bcs7.BcsType<bigint, string | number | bigint, "u64">;
+  new_balance: _mysten_sui_bcs7.BcsType<bigint, string | number | bigint, "u64">;
 }, "@local-pkg/account::account_events::Deposited">;
 declare const Withdrawn: MoveStruct<{
-  account_id: _mysten_sui_bcs2.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-  coin_type: _mysten_sui_bcs2.BcsType<string, string, "string">;
-  amount: _mysten_sui_bcs2.BcsType<bigint, string | number | bigint, "u64">;
-  new_balance: _mysten_sui_bcs2.BcsType<bigint, string | number | bigint, "u64">;
+  account_id: _mysten_sui_bcs7.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+  coin_type: _mysten_sui_bcs7.BcsType<string, string, "string">;
+  amount: _mysten_sui_bcs7.BcsType<bigint, string | number | bigint, "u64">;
+  new_balance: _mysten_sui_bcs7.BcsType<bigint, string | number | bigint, "u64">;
 }, "@local-pkg/account::account_events::Withdrawn">;
 declare const FundsSettled: MoveStruct<{
-  account_id: _mysten_sui_bcs2.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-  coin_type: _mysten_sui_bcs2.BcsType<string, string, "string">;
-  amount: _mysten_sui_bcs2.BcsType<bigint, string | number | bigint, "u64">;
-  new_balance: _mysten_sui_bcs2.BcsType<bigint, string | number | bigint, "u64">;
+  account_id: _mysten_sui_bcs7.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+  coin_type: _mysten_sui_bcs7.BcsType<string, string, "string">;
+  amount: _mysten_sui_bcs7.BcsType<bigint, string | number | bigint, "u64">;
+  new_balance: _mysten_sui_bcs7.BcsType<bigint, string | number | bigint, "u64">;
 }, "@local-pkg/account::account_events::FundsSettled">;
 //#endregion
 export { account_events_d_exports };

package/dist/contracts/deepbook/account.d.mts

@@ -1,35 +1,35 @@
 import { MoveStruct } from "../utils/index.mjs";
-import * as _mysten_sui_bcs79 from "@mysten/sui/bcs";
+import * as _mysten_sui_bcs82 from "@mysten/sui/bcs";
 import { Transaction, TransactionArgument } from "@mysten/sui/transactions";
 
 //#region src/contracts/deepbook/account.d.ts
 declare const Account: MoveStruct<{
-  epoch: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
+  epoch: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
   open_orders: MoveStruct<{
-    contents: _mysten_sui_bcs79.BcsType<string[], Iterable<string | number | bigint> & {
+    contents: _mysten_sui_bcs82.BcsType<string[], Iterable<string | number | bigint> & {
       length: number;
     }, string>;
   }, "0x2::vec_set::VecSet<u128>">;
-  taker_volume: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u128">;
-  maker_volume: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u128">;
-  active_stake: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
-  inactive_stake: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
-  created_proposal: _mysten_sui_bcs79.BcsType<boolean, boolean, "bool">;
-  voted_proposal: _mysten_sui_bcs79.BcsType<string | null, string | Uint8Array<ArrayBufferLike> | null | undefined, "Option<bytes[32]>">;
+  taker_volume: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u128">;
+  maker_volume: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u128">;
+  active_stake: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
+  inactive_stake: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
+  created_proposal: _mysten_sui_bcs82.BcsType<boolean, boolean, "bool">;
+  voted_proposal: _mysten_sui_bcs82.BcsType<string | null, string | Uint8Array<ArrayBufferLike> | null | undefined, "Option<bytes[32]>">;
   unclaimed_rebates: MoveStruct<{
-    base: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
-    quote: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
-    deep: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
+    base: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
+    quote: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
+    deep: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
   }, "@deepbook/core::balances::Balances">;
   settled_balances: MoveStruct<{
-    base: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
-    quote: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
-    deep: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
+    base: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
+    quote: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
+    deep: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
   }, "@deepbook/core::balances::Balances">;
   owed_balances: MoveStruct<{
-    base: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
-    quote: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
-    deep: _mysten_sui_bcs79.BcsType<string, string | number | bigint, "u64">;
+    base: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
+    quote: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
+    deep: _mysten_sui_bcs82.BcsType<string, string | number | bigint, "u64">;
   }, "@deepbook/core::balances::Balances">;
 }, "@deepbook/core::account::Account">;
 //#endregion

package/dist/contracts/deepbook/balances.d.mts

@@ -1,11 +1,11 @@
 import { MoveStruct } from "../utils/index.mjs";
-import * as _mysten_sui_bcs96 from "@mysten/sui/bcs";
+import * as _mysten_sui_bcs47 from "@mysten/sui/bcs";
 
 //#region src/contracts/deepbook/balances.d.ts
 declare const Balances: MoveStruct<{
-  base: _mysten_sui_bcs96.BcsType<string, string | number | bigint, "u64">;
-  quote: _mysten_sui_bcs96.BcsType<string, string | number | bigint, "u64">;
-  deep: _mysten_sui_bcs96.BcsType<string, string | number | bigint, "u64">;
+  base: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u64">;
+  quote: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u64">;
+  deep: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u64">;
 }, "@deepbook/core::balances::Balances">;
 //#endregion
 export { Balances };

package/dist/contracts/deepbook/order.d.mts

@@ -1,22 +1,22 @@
 import { MoveStruct } from "../utils/index.mjs";
-import * as _mysten_sui_bcs47 from "@mysten/sui/bcs";
+import * as _mysten_sui_bcs50 from "@mysten/sui/bcs";
 import { Transaction, TransactionArgument } from "@mysten/sui/transactions";
 
 //#region src/contracts/deepbook/order.d.ts
 declare const Order: MoveStruct<{
-  balance_manager_id: _mysten_sui_bcs47.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-  order_id: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u128">;
-  client_order_id: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u64">;
-  quantity: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u64">;
-  filled_quantity: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u64">;
-  fee_is_deep: _mysten_sui_bcs47.BcsType<boolean, boolean, "bool">;
+  balance_manager_id: _mysten_sui_bcs50.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+  order_id: _mysten_sui_bcs50.BcsType<string, string | number | bigint, "u128">;
+  client_order_id: _mysten_sui_bcs50.BcsType<string, string | number | bigint, "u64">;
+  quantity: _mysten_sui_bcs50.BcsType<string, string | number | bigint, "u64">;
+  filled_quantity: _mysten_sui_bcs50.BcsType<string, string | number | bigint, "u64">;
+  fee_is_deep: _mysten_sui_bcs50.BcsType<boolean, boolean, "bool">;
   order_deep_price: MoveStruct<{
-    asset_is_base: _mysten_sui_bcs47.BcsType<boolean, boolean, "bool">;
-    deep_per_asset: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u64">;
+    asset_is_base: _mysten_sui_bcs50.BcsType<boolean, boolean, "bool">;
+    deep_per_asset: _mysten_sui_bcs50.BcsType<string, string | number | bigint, "u64">;
   }, "@deepbook/core::deep_price::OrderDeepPrice">;
-  epoch: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u64">;
-  status: _mysten_sui_bcs47.BcsType<number, number, "u8">;
-  expire_timestamp: _mysten_sui_bcs47.BcsType<string, string | number | bigint, "u64">;
+  epoch: _mysten_sui_bcs50.BcsType<string, string | number | bigint, "u64">;
+  status: _mysten_sui_bcs50.BcsType<number, number, "u8">;
+  expire_timestamp: _mysten_sui_bcs50.BcsType<string, string | number | bigint, "u64">;
 }, "@deepbook/core::order::Order">;
 //#endregion
 export { Order };

package/dist/contracts/deepbook_predict/deps/sui/vec_map.mjs

@@ -0,0 +1,37 @@
+import { MoveStruct } from "../../../utils/index.mjs";
+import { bcs } from "@mysten/sui/bcs";
+
+//#region src/contracts/deepbook_predict/deps/sui/vec_map.ts
+/**************************************************************
+* THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+**************************************************************/
+const $moduleName = "0x2::vec_map";
+/** An entry in the map */
+function Entry(...typeParameters) {
+	return new MoveStruct({
+		name: `${$moduleName}::Entry<${typeParameters[0].name}, ${typeParameters[1].name}>`,
+		fields: {
+			key: typeParameters[0],
+			value: typeParameters[1]
+		}
+	});
+}
+/**
+* A map data structure backed by a vector. The map is guaranteed not to contain
+* duplicate keys, but entries are _not_ sorted by key--entries are included in
+* insertion order. All operations are O(N) in the size of the map--the intention
+* of this data structure is only to provide the convenience of programming against
+* a map API. Large maps should use handwritten parent/child relationships instead.
+* Maps that need sorted iteration rather than insertion order iteration should
+* also be handwritten.
+*/
+function VecMap(...typeParameters) {
+	return new MoveStruct({
+		name: `${$moduleName}::VecMap<${typeParameters[0].name}, ${typeParameters[1].name}>`,
+		fields: { contents: bcs.vector(Entry(typeParameters[0], typeParameters[1])) }
+	});
+}
+
+//#endregion
+export { VecMap };
+//# sourceMappingURL=vec_map.mjs.map

package/dist/contracts/deepbook_predict/deps/sui/vec_map.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vec_map.mjs","names":[],"sources":["../../../../../src/contracts/deepbook_predict/deps/sui/vec_map.ts"],"sourcesContent":["/**************************************************************\n * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *\n **************************************************************/\nimport { type BcsType, bcs } from '@mysten/sui/bcs';\nimport { MoveStruct } from '../../../utils/index.js';\nconst $moduleName = '0x2::vec_map';\n/** An entry in the map */\nexport function Entry<K extends BcsType<any>, V extends BcsType<any>>(...typeParameters: [K, V]) {\n\treturn new MoveStruct({\n\t\tname: `${$moduleName}::Entry<${typeParameters[0].name as K['name']}, ${typeParameters[1].name as V['name']}>`,\n\t\tfields: {\n\t\t\tkey: typeParameters[0],\n\t\t\tvalue: typeParameters[1],\n\t\t},\n\t});\n}\n/**\n * A map data structure backed by a vector. The map is guaranteed not to contain\n * duplicate keys, but entries are _not_ sorted by key--entries are included in\n * insertion order. All operations are O(N) in the size of the map--the intention\n * of this data structure is only to provide the convenience of programming against\n * a map API. Large maps should use handwritten parent/child relationships instead.\n * Maps that need sorted iteration rather than insertion order iteration should\n * also be handwritten.\n */\nexport function VecMap<K extends BcsType<any>, V extends BcsType<any>>(...typeParameters: [K, V]) {\n\treturn new MoveStruct({\n\t\tname: `${$moduleName}::VecMap<${typeParameters[0].name as K['name']}, ${typeParameters[1].name as V['name']}>`,\n\t\tfields: {\n\t\t\tcontents: bcs.vector(Entry(typeParameters[0], typeParameters[1])),\n\t\t},\n\t});\n}\n"],"mappings":";;;;;;;AAKA,MAAM,cAAc;;AAEpB,SAAgB,MAAsD,GAAG,gBAAwB;AAChG,QAAO,IAAI,WAAW;EACrB,MAAM,GAAG,YAAY,UAAU,eAAe,GAAG,KAAkB,IAAI,eAAe,GAAG,KAAkB;EAC3G,QAAQ;GACP,KAAK,eAAe;GACpB,OAAO,eAAe;GACtB;EACD,CAAC;;;;;;;;;;;AAWH,SAAgB,OAAuD,GAAG,gBAAwB;AACjG,QAAO,IAAI,WAAW;EACrB,MAAM,GAAG,YAAY,WAAW,eAAe,GAAG,KAAkB,IAAI,eAAe,GAAG,KAAkB;EAC5G,QAAQ,EACP,UAAU,IAAI,OAAO,MAAM,eAAe,IAAI,eAAe,GAAG,CAAC,EACjE;EACD,CAAC"}

package/dist/contracts/deepbook_predict/expiry_cash.mjs

@@ -7,7 +7,7 @@ import { Balance } from "./deps/sui/balance.mjs";
 * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
 **************************************************************/
 /**
-* Expiry-local DUSDC custody and isolated reserve accounting.
+* Expiry-local USDC custody and isolated reserve accounting.
 *
 * This leaf owns cash balance arithmetic and the inventory-impact escrow used only
 * for live-close rebates. It does not decide payment eligibility, pool allocation,

package/dist/contracts/deepbook_predict/expiry_cash.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"expiry_cash.mjs","names":["balance.Balance"],"sources":["../../../src/contracts/deepbook_predict/expiry_cash.ts"],"sourcesContent":["/**************************************************************\n * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *\n **************************************************************/\n\n/**\n * Expiry-local DUSDC custody and isolated reserve accounting.\n *\n * This leaf owns cash balance arithmetic and the inventory-impact escrow used only\n * for live-close rebates. It does not decide payment eligibility, pool allocation,\n * or market phase sequencing; `ExpiryMarket` owns those policies.\n */\n\nimport { MoveStruct } from '../utils/index.js';\nimport { U64 } from '../../bcs/integers.js';\nimport * as balance from './deps/sui/balance.js';\nconst $moduleName = '@local-pkg/deepbook_predict::expiry_cash';\nexport const ExpiryCash = new MoveStruct({\n\tname: `${$moduleName}::ExpiryCash`,\n\tfields: {\n\t\tcash_balance: balance.Balance,\n\t\t/** Collected inventory-impact charges still reserved for live-close rebates. */\n\t\tinventory_impact_reserve: U64,\n\t},\n});\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAM,cAAc;AACpB,MAAa,aAAa,IAAI,WAAW;CACxC,MAAM,GAAG,YAAY;CACrB,QAAQ;EACP,cAAcA;EAEd,0BAA0B;EAC1B;CACD,CAAC"}
+{"version":3,"file":"expiry_cash.mjs","names":["balance.Balance"],"sources":["../../../src/contracts/deepbook_predict/expiry_cash.ts"],"sourcesContent":["/**************************************************************\n * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *\n **************************************************************/\n\n/**\n * Expiry-local USDC custody and isolated reserve accounting.\n *\n * This leaf owns cash balance arithmetic and the inventory-impact escrow used only\n * for live-close rebates. It does not decide payment eligibility, pool allocation,\n * or market phase sequencing; `ExpiryMarket` owns those policies.\n */\n\nimport { MoveStruct } from '../utils/index.js';\nimport { U64 } from '../../bcs/integers.js';\nimport * as balance from './deps/sui/balance.js';\nconst $moduleName = '@local-pkg/deepbook_predict::expiry_cash';\nexport const ExpiryCash = new MoveStruct({\n\tname: `${$moduleName}::ExpiryCash`,\n\tfields: {\n\t\tcash_balance: balance.Balance,\n\t\t/** Collected inventory-impact charges still reserved for live-close rebates. */\n\t\tinventory_impact_reserve: U64,\n\t},\n});\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAM,cAAc;AACpB,MAAa,aAAa,IAAI,WAAW;CACxC,MAAM,GAAG,YAAY;CACrB,QAAQ;EACP,cAAcA;EAEd,0BAA0B;EAC1B;CACD,CAAC"}

package/dist/contracts/deepbook_predict/expiry_market.mjs

@@ -21,6 +21,14 @@ import { bcs } from "@mysten/sui/bcs";
 * and profit accounting remain outside this module.
 */
 const $moduleName = "@local-pkg/deepbook_predict::expiry_market";
+const ValuationStamp = new MoveStruct({
+	name: `${$moduleName}::ValuationStamp`,
+	fields: {
+		flush_seq: U64,
+		snapshot_cash: U64,
+		snapshot_impact_reserve: U64
+	}
+});
 const ExpiryMarket = new MoveStruct({
 	name: `${$moduleName}::ExpiryMarket`,
 	fields: {
@@ -31,7 +39,8 @@ const ExpiryMarket = new MoveStruct({
 		fee_incentive_balance: Balance,
 		strike_exposure: StrikeExposure,
 		ewma: EwmaState,
-		mint_paused: bcs.bool()
+		mint_paused: bcs.bool(),
+		valuation_stamp: bcs.option(ValuationStamp)
 	}
 });
 const MintQuote = new MoveStruct({
@@ -180,7 +189,7 @@ function mintPaused(options) {
 * withdraw through the loaded account. The position's strike range is the tick
 * pair `(lower_tick, higher_tick]` (`lower_tick = 0` is `-inf`,
 * `higher_tick = pos_inf_tick` is `+inf`); the SDK converts raw strikes to ticks.
-* `max_cost` caps the all-in DUSDC withdrawal, while `max_probability` caps the
+* `max_cost` caps the all-in USDC withdrawal, while `max_probability` caps the
 * quoted per-contract probability before fees. Callers can pass
 * `std::u64::max_value!()` for either uncapped guard. Returns the minted order ID
 * for future order-scoped flows.
@@ -229,12 +238,12 @@ function mintExactQuantity(options) {
 * must meet `min_quantity`.
 *
 * Fees, builder fees, and EWMA congestion penalties are charged on top of
-* `max_premium`, so `max_cost` — not `max_premium` — bounds the all-in DUSDC
+* `max_premium`, so `max_cost` — not `max_premium` — bounds the all-in USDC
 * withdrawal (`premium + trader-paid fee + builder_fee + EWMA penalty`).
 * `max_cost` is required: unlike `mint_exact_quantity`'s guards there is no value
 * that disables it, because the budget shape exists to bound spend. The sizing
-* budget is first capped to the account's available DUSDC after settlement; fees
-* still require additional available DUSDC at payment time. Any unspent premium
+* budget is first capped to the account's available USDC after settlement; fees
+* still require additional available USDC at payment time. Any unspent premium
 * dust remains in the account because order quantity must be an integer number of
 * `position_lot_size` lots.
 */
@@ -286,7 +295,7 @@ function mintExactAmount(options) {
 * Two close-side slippage floors, the mirror of mint's `max_probability` /
 * `max_cost` pair; pass `0` to disable either. `min_probability` floors the quoted
 * per-contract range probability (same units as mint's `max_probability`).
-* `min_proceeds` floors the all-in net DUSDC credited to the account
+* `min_proceeds` floors the all-in net USDC credited to the account
 * (`redeem_amount` minus trading fee, builder fee, and EWMA penalty), the mirror
 * of mint's all-in `max_cost`.
 */