DeepBook Margin: Overview, Design & Registry

DeepBook Margin extends the trading capabilities of DeepBook V3 by enabling leveraged trading positions. With margin trading, users can borrow funds from on-chain margin pools to increase their buying power, collateralizing their positions under dynamic risk management parameters.

1. Core Architecture

The margin system coordinates four main objects:

graph TD
    User([Trader/User]) -->|Manages Assets & Debts| MM[MarginManager Shared Object]
    MM -->|Wraps| BM[BalanceManager Shared Object]
    MM -->|Trades on| DBP[DeepBook Pool]
    MM -->|Borrows/Repays| MP[MarginPool Shared Object]
    MR[MarginRegistry Shared Object] -->|Validates Pools & Managers| MM
    MR -->|Registers| MP