By default, the Sui repo includes DeepBook V2 (crates/sui-framework/packages/deepbook). To upgrade to DeepBook V3, follow these steps:

[dependencies]
DeepBook = { 
  git = "https://github.com/MystenLabs/deepbookv3.git", 
  subdir = "packages/deepbook", 
  rev = "main" 
}

This points directly to the official DeepBook V3 repo.

⸻

2. ⚠️ Note on VS Code compatibility

This fix works, but Sui Move Analyzer in VS Code may break because it expects dependencies from the main Sui repo. There’s no official workaround yet — you can ignore analyzer errors temporarily or suppress them.

Replace deprecated function calls

Functions like:

deepbook::clob::place_limit_order

are deprecated in V2. You’ll need to replace them with their updated V3 versions, such as:

deepbook::v3_module::place_limit_order_v3

Check the DeepBook V3 GitHub for exact names and parameter changes.

You’re using an outdated DeepBook function: deepbook::clob::place_limit_order, which belongs to an older version. To upgrade to DeepBook V3, Update your Move.toml dependency

Either point directly to the DeepBook V3 repo:

[dependencies]
DeepBook = { git = "https://github.com/MystenLabs/deepbook-v3.git", rev = "main" }

Or, if V3 is already merged into the main Sui repo:

[dependencies]
DeepBook = { git = "https://github.com/MystenLabs/sui.git", subdir = "crates/sui-framework/packages/deepbook", rev = "framework/mainnet" }

Then run:

sui move build