` objects for bids and asks, as well as some metadata. It is responsible for storing, matching, modifying, and removing `Orders`.
+
+When placing an order, an `OrderInfo` is first created. If applicable, it is first matched against existing maker orders, accumulating `Fill`s in the process. Any remaining quantity will be used to create an `Order` object and injected into the book. By the end of book processing, the `OrderInfo` object has enough information to update all relevant users and the overall state.
+
+### State
+
+`State` stores `Governance`, `History`, and `Account`. It processes all requests, updating at least one of these stored structs.
+
+#### Governance
+
+The `Governance` module stores data related to the pool's trading params. These parameters are the taker fee, maker fee, and the stake required. Stake required represents the amount of DEEP tokens that a user must have staked in this specific pool to be eligible for taker and maker incentives.
+
+Every epoch, users with non zero stake can submit a proposal to change these parameters. The proposed fees are bounded.
+
+| min_value (bps) | max_value (bps) | Pool type | Taker or maker |
+| --- | --- | --- | --- |
+| 5 | 10 | Volatile | Taker |
+| 2 | 5 | Volatile | Maker |
+| 0.5 | 1 | Stable | Taker |
+| 0.2 | 0.5 | Stable | Maker |
+| 0 | 0 | Whitelisted | Taker and maker |
+
+Users can also vote on live proposals. When a proposal exceeds the quorum, the new trade parameters are queued to go live from the following epoch and onwards. Proposals and votes are reset every epoch. Users can start submitting and voting on proposals the epoch following their stake. Quorum is equivalent to half of the total voting power. A user's voting power is calculated with the following formula where ${V}$ is the voting power, ${S}$ is the amount staked, and ${V_c}$ is the voting power cutoff. ${V_c}$ is currently set to 100,000 DEEP.
+
+$\LARGE V=\min\lparen S,V_c \rparen + \max\lparen \sqrt{S} - \sqrt{V_c} ,0 \rparen$
+
+The following diagram helps visualize the governance lifecycle.
+
+![DeepBook Governance Timeline](./images/governance.png)
+
+#### History
+
+The `History` module stores aggregated volumes, trading params, fees collected and fees to burn for the current epoch and previous epochs. During order processing, fills are used to calculate and update the total volume. Additionally, if the maker of the trade has enough stake, the total staked volume is also updated.
+
+The first operation of every epoch will trigger an update, moving the current epoch data into historic data, and resetting the current epoch data.
+
+User rebate calculations are done in this module. During every epoch, a maker is eligible for rebates as long as their DEEP staked is over the stake required and have contributed in maker volume. The following formula is used to calculate maker fees, quoted from the [Whitepaper: DeepBook Token](/doc/deepbook.pdf) document. Details on maker incentives can be found in section 2.2 of the whitepaper.
+
+
+
+The computation of incentives – which happens after an epoch ends and is only given to makers
+who have staked the required number of DEEP tokens in advance – is calculated in Equation (3) for
+a given maker ${i}$. Equation (3) introduces several new variables. First, ${M}$ refers to the set of makers
+who stake a sufficient number of DEEP tokens, and $\bar{M}$ refers to the set of makers who do not fulfill
+this condition. Second, ${F}$ refers to total fees (collected both from takers and the maker) that a
+maker’s volume has generated in a given epoch. Third, ${L}$ refers to the total liquidity provided by
+a maker – and specifically the liquidity traded, not just the liquidity quoted. Finally, the critical
+point ${p}$ is the “phaseout” point, at which – if total liquidity provided by other makers’ crosses this
+point – incentives are zero for the maker in that epoch. This point ${p}$ is constant for all makers in
+a pool and epoch.
+
+$\LARGE \textsf {Incentives } \textsf {for } \textsf {Maker } i = \max\Bigg\lbrack F_i\Bigg\lparen 1 + \large\cfrac{\sum_{j \in \bar{M}} F_j} {\sum_{j \in M} F_j} \Bigg\rparen\Bigg\lparen \LARGE 1 - \large\cfrac{\sum_{j \in M \cup \bar{M}} L_j - L_i}{p}\Bigg\rparen \LARGE ,0 \Bigg\rbrack$ (3)
+
+
+
+In essence, if the total volume during an epoch is greater than the median volume from the last 28 days, then there are no rebates. The lower the volume compared to the median, the more rebates are available. The maximum amount of rebates for an epoch is equivalent to the total amount of DEEP collected during that epoch. Remaining DEEP is burned.
+
+#### Account
+
+`Account` represents a single user and their relevant data. Everything related to volumes, stake, voted proposal, unclaimed rebates, and balances to be transferred. There is a one to one relationship between a `BalanceManager` and an `Account`.
+
+Every epoch, the first action that a user performs will update their account, triggering a calculation of any potential rebates from the previous epoch, as well as resetting their volumes for the current epoch. Any new stakes from the previous epoch become active.
+
+Each account has settled and owed balances. Settled balances are what the pool owes to the user, and owed balances are what the user owes to the pool. For example, when placing an order, the user's owed balances increase, representing the funds that the user has to pay to place that order. Then, if a maker order is taken by another user, the maker's settled balances increase, representing the funds that the maker is owed.
+
+### Vault
+
+Every transaction that a user performs on DeepBook resets their settled and owed balances. The vault then processes these balances for the user, deducting or adding to funds to their `BalanceManager`.
+
+The vault also stores the `DeepPrice` struct. This object holds up to 100 data points representing the conversion rate between the pool's base or quote asset and DEEP. These data points are sourced from a whitelisted pool, DEEP/USDC or DEEP/SUI. This conversion rate is used to determine the quantity of DEEP tokens required to pay for trading fees.
+
+### `BigVector`
+
+`BigVector` is an arbitrary sized vector-like data structure, implemented using an on-chain B+ Tree to support almost constant time (log base max_fan_out) random access, insertion and removal.
+
+Iteration is supported by exposing access to leaf nodes (slices). Finding the initial slice can be done in almost constant time, and subsequently finding the previous or next slice can also be done in constant time.
+
+Nodes in the B+ Tree are stored as individual dynamic fields hanging off the `BigVector`.
+
+## Place limit order flow
+
+The following diagram of the lifecycle of an order placement action helps visualize the book, then state, then vault flow.
+
+![Place limit order flow](./images/placeorder.png)
+
+### Pool
+
+In the `Pool` module, `place_order_int` is called with the user's input parameters. In this function, four things happen in order:
+ 1. An `OrderInfo` is created.
+ 1. The `Book` function `create_order` is called.
+ 1. The `State` function `process_create` is called.
+ 1. The `Vault` function `settle_balance_manager` is called.
+
+### Book
+
+The order creation within the book involves three primary tasks:
+ - Validate inputs.
+ - Match against existing orders.
+ - Inject any remaining quantity into the order book as a limit order.
+
+Validation of inputs ensures that quantity, price, timestamp, and order type are within expected ranges.
+
+To match an `OrderInfo` against the book, the list of `Order`s is iterated in the opposite side of the book. If there is an overlap in price and the existing maker order has not expired, then DeepBook matches their quantities and generates a `Fill`. DeepBook appends that fill to the `OrderInfo` fills, to use later in state. DeepBook updates the existing maker order quantities and status during each match, and removes them from the book if they are completely filled or expired.
+
+Finally, if the `OrderInfo` object has any remaining quantity, DeepBook converts it into a compact `Order` object and injects it into the order book. `Order` has the minimum amount of data necessary for matching, while `OrderInfo` has the maximum amount of data for general processing.
+
+Regardless of direction or order type, all DeepBook matching is processed in a single function.
+
+### State
+
+The `process_create` function in `State` handles the processing of an order creation event within the pool's state: calculating the transaction amounts and fees for the order, and updating the account volumes accordingly.
+
+First, the function processes the list of fills from the `OrderInfo` object, updating volumes tracked and settling funds for the makers involved. Next, the function retrieves the account's total trading volume and active stake. It calculates the taker's fee based on the user's account stake and volume in DEEP tokens, while the maker fee is retrieved from the governance trade parameters. To receive discounted taker fees, the account must have more than the minimum stake for the pool, and the trading volume in DEEP tokens must exceed the same threshold. If any quantity remains in the `OrderInfo` object, it is added to the account's list of orders as an `Order` and is already created in `Book`.
+
+Finally, the function calculates the partial taker fills and maker order quantities, if there are any, with consideration for the taker and maker fees. It adds these to the previously settled and owed balances from the account. Trade history is updated with the total fees collected from the order and two tuples are returned to `Pool`, settled and owed balances, in (base, quote, DEEP) format, ensuring the correct assets are transferred in `Vault`.
+
+### Vault
+
+The `settle_balance_manager` function in `Vault` is responsible for managing the transfer of any settled and owed amounts for the `BalanceManager`. It starts by validating that the trader is authorized to use the `BalanceManager`. For each asset type, if the `balances_out` exceeds the `balances_in`, the difference is split from the vault's balance and deposited into the `BalanceManager`. Conversely, if the `balances_in` exceeds the `balances_out`, the difference is withdrawn from the `BalanceManager` and joined to the vault's balance. This process is repeated for base, quote, and DEEP asset balances, ensuring all asset balances are accurately reflected and settled between the vault and the `BalanceManager`.
\ No newline at end of file
diff --git a/docs/content/standards/deepbookv3/flash-loans.mdx b/docs/content/standards/deepbookv3/flash-loans.mdx
new file mode 100644
index 0000000000000..561785f0a6259
--- /dev/null
+++ b/docs/content/standards/deepbookv3/flash-loans.mdx
@@ -0,0 +1,63 @@
+---
+title: Flash Loans
+description: Use DeepBook to perform flash loans, uncollaterized loans that are borrowed and repaid within the same programmable transaction block.
+---
+
+{@include: ../../snippets/deepbook.mdx}
+
+Flash loans by definition are uncollaterized loans that are borrowed and repaid within the same programmable transaction block. Users can borrow flash loans in the base or quote asset from any DeepBook pool. Flash loans return a `FlashLoan` hot potato (struct with no abilities), which must be returned back to the pool by the end of the call. The transaction is atomic, so the entire transaction fails if the loan is not returned.
+
+The quantity borrowed can be the maximum amount that the pool owns. Borrowing from a pool and trading in the same pool can result in failures because trading requires the movement of funds. If the funds are borrowed, then there are no funds to move.
+
+## API
+
+Following are the endpoints that the `Pool` exposes for flash loans.
+
+### Borrow flash loan base
+
+Borrow base assets from the `Pool`. The function returns a hot potato, forcing the borrower to return the assets within the same transaction.
+
+```move
+public fun borrow_flashloan_base(
+ self: &mut Pool,
+ base_amount: u64,
+ ctx: &mut TxContext,
+): (Coin, FlashLoan)
+```
+
+### Borrow flash loan quote
+
+Borrow quote assets from the `Pool`. The function returns a hot potato, forcing the borrower to return the assets within the same transaction.
+
+```move
+public fun borrow_flashloan_quote(
+ self: &mut Pool,
+ quote_amount: u64,
+ ctx: &mut TxContext,
+): (Coin, FlashLoan)
+```
+
+### Retrieve flash loan base
+
+Return the flash loaned base assets to the `Pool`. `FlashLoan` object is unwrapped only if the assets are returned, otherwise the transaction fails.
+
+```move
+public fun return_flashloan_base(
+ self: &mut Pool,
+ coin: Coin,
+ flash_loan: FlashLoan,
+)
+```
+
+### Retrieve flash loan quote
+
+Return the flash loaned quote assets to the `Pool`. `FlashLoan` object is unwrapped only if the assets are returned,
+otherwise the transaction fails.
+
+```move
+public fun return_flashloan_quote(
+ self: &mut Pool,
+ coin: Coin,
+ flash_loan: FlashLoan,
+)
+```
\ No newline at end of file
diff --git a/docs/content/standards/deepbookv3/images/DBv3Architecture.png b/docs/content/standards/deepbookv3/images/DBv3Architecture.png
new file mode 100644
index 0000000000000000000000000000000000000000..17acf888e21a231cecfa354acf53f4d538e1beea
GIT binary patch
literal 141732
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