DODO PMM Technical Reference: Pricing Curves and Pool Versions

Authors DODO documentation and code contributors
Document PMM algorithm documentation and implementation reference
Version Snapshot 2026-10-08; V2 pricing library, V3 comparison
Project DODO
License V2 PMMPricing.sol: Apache-2.0; V3 PMMRangeOrder.sol: BUSL-1.1; no blanket documentation license asserted
Official Source PMM in Details

Proactive Market Maker (PMM) is DODO’s inventory-sensitive pricing framework. This reference explains the published mathematics and selected implementation differences, using a documentation snapshot dated 8 October 2026. It does not present the unavailable legacy whitepaper link as a verified standalone 2020 paper. The general DODO glossary entry covers the wider protocol.

Directories Ethereum Whitepapers & Research

Guide Price and Inventory

In the documentation, i is the guide price, k the slippage factor, and B/Q the pool’s base/quote inventories. B0 and Q0 are equilibrium targets, not necessarily the original deposits. The mid-price depends on inventory relative to these targets.

With base inventory below target, the marginal base price in quote units is:

P = i × [1 − k + k × (B0/B)²]

With quote inventory below target, the corresponding branch is:

P = i / [1 − k + k × (Q0/Q)²]

At equilibrium, the price is i. The V2 library’s getMidPrice confirms multiplication on the base-short branch and division on the quote-short branch. The mathematics page contains a stray repeated R in the displayed quote-short definition; the cleaner introductory equation and implementation resolve that ambiguity.

Marginal Price Is Not a Whole-Trade Quote

A finite trade moves inventory along the curve. Its consideration comes from integration, or the corresponding implementation calculation, rather than multiplying the starting price by the entire amount. The V2 library handles trades that return to equilibrium and then cross into the other inventory state. Fees, token units, integer rounding and actual pool settings also matter.

For fixed parameters, k = 0 gives a flat marginal curve; k = 1 gives constant-product-like curvature in the documented model. Neither value guarantees unlimited liquidity or a request-for-quote service. Adjusting targets can realize inventory gains or losses: the documentation explicitly describes this regression effect.

Pool Type Determines Who Sets the Price

Do not assume every PMM pool continuously reads an external market-price oracle. DVM initialization uses configured guide-price and inventory calculations; the guide parameter need not equal the displayed mid-price. A vending-machine pool can start with the sale token alone. Purchases add the other asset to the pool, enabling subsequent sellbacks subject to available reserves. An oracle does not manufacture missing inventory.

A DODO Private Pool (DPP) allows its creator to provide liquidity and adjust curve parameters and fees. Those controls introduce operator assumptions. To assess a particular pool, inspect its contract version, parameters, permissions and available liquidity.

V3 Is a Separate Architecture

V3 adds D3Vault deposits, market-maker borrowing, repayment and liquidation, together with D3MM and D3Maker contracts. Its range-order implementation uses separate token bid/ask settings and capacities, checks available amounts and applies an oracle-based receive-amount guard. These details should not be substituted into every older V2 pool description.

Source availability does not establish which code is deployed at a particular address. The cited V2 pricing file declares Apache-2.0; the cited V3 range-order file declares BUSL-1.1. This is not a blanket license statement for all documentation or contracts.

What This Design Does Not Guarantee

Liquidity efficiency depends on configuration and trading conditions. Flat or tightly positioned quotes can become stale or exhaust inventory. Where an oracle is used, its accuracy and failure behavior matter; manager-controlled prices introduce different dependencies. V3 lending adds repayment and liquidation considerations. This reference makes no universal claim of zero impermanent loss, protected principal or higher returns.

Social Media Sentiment

Not assessed for this technical reference. No dated social-discussion sample was collected; repository activity and protocol marketing are not measurements of public sentiment.

Last updated: 2026-10

Related Terms

See Also

Sources

  1. DODO documentation contributors. PMM in Details. Reviewed 8 October 2026. Guide price, inventory and the two marginal-price branches.
  2. DODO documentation contributors. The Math Behind. Reviewed 8 October 2026. Curve integration, target adjustment and realized inventory gains or losses.
  3. DODO ZOO / DODO Breeder. V2 PMMPricing.sol. Reviewed 8 October 2026. Implementation of R states, equilibrium crossings and mid-price; Apache-2.0 header.
  4. DODO documentation contributors. DODO Vending Machine. Reviewed 8 October 2026. Single-token stocking and retained purchase proceeds.
  5. DODO documentation contributors. DVM Initial Price Formula Explanation. Reviewed 8 October 2026. Initialization and the distinction between guide price and observable mid-price.
  6. DODO documentation contributors. DODO Private Pool. Reviewed 8 October 2026. Creator-only liquidity and adjustable curve/fee parameters.
  7. DODO contributors. DODO V3 repository README. Reviewed 8 October 2026. D3Vault lending, repayment and liquidation; D3MM/D3Maker architecture.
  8. DODO contributors. V3 PMMRangeOrder.sol. Reviewed 8 October 2026. Bid/ask capacities, oracle protection and the BUSL-1.1 file header.