Merge pull request #22 from drift-labs/evan/isolated-pools-doc

add isolated pools docs page

Author: evanpipta

README.md

@@ -11,3 +11,7 @@ Then, run `pnpm dev` to start the development server and visit localhost:3000.
 ## License
 
 This project is licensed under the MIT License.
+
+## Deployment
+
+Before deploying to vercel, run yarn and commit the package-lock.json file. This is necessary for new navigation routes to show up in the build output.

package-lock.json

@@ -0,0 +1,61 @@
+import { Callout } from "nextra-theme-docs";
+
+# Isolated Pools
+
+Drift's isolated pools allow users to trade or provide liquidity with specific risks confined to a particular pool. Each isolated pool is segregated, meaning that the risks associated with one pool do not impact other pools on Drift.
+
+### What's the difference between Isolated and Cross-collateral pools?
+
+Cross collateral (default accounts for Drift) shares a single collateral pool across multiple positions, allowing all assets in the account to back each other. This method spreads risk and increases margin efficiency but exposes the entire account to liquidation if risks are not managed. Isolated pools, however, keep collateral and risk confined to a single pool or position. Losses or liquidation in one pool do not impact the rest of the platform or the user's other positions.
+
+| **Feature** | **Cross Collateral** | **Isolated Pools** |
+| --- | --- | --- |
+| **Risk Sharing** | Shared across all positions | Confined to a single pool |
+| **Account Health** | Determined by total account collateral | Customized per pool |
+| **Liquidation Impact** | All positions at risk if account health fails | Only the affected pool is liquidated |
+| **Margin Efficiency** | High (collateral supports all positions) | Low (collateral is pool-specific) |
+| **Use Case** | Suitable for traders/stakers managing multiple positions and want to optimise capital efficiency | Ideal for stakers/traders who are only focused on one position and containing risk to a limited set of tokens |
+
+### Example - Cross Collateral Pool
+
+1. **Deposit Collateral**: Deposit 1000 JLP into your account.
+2. **Open a BTC Long Position**: Use some of the JLP as collateral to open a leveraged SOL long position.
+3. **Open a USDC Borrow Position**: Simultaneously borrow USDC using the same JLP collateral.
+4. **Risk Management**:
+    - Both positions rely on the same JLP collateral.
+    - If JLP's value drops significantly, both the SOL and USDC positions may face liquidation.
+
+### Example - Isolated Pool
+
+1. **Choose an Isolated Pool**: Select a JLP/USDC pool 
+2. **Deposit Collateral**: Deposit 1000 JLP into the pool.
+3. **Open a Leveraged Position**: Borrow USDC and swap into JLP. Borrow more USDC based on the new deposit of JLP and swap into JLP, creating a leveraged exposure to JLP. You can now earn higher yield on your initial deposit of 1000 JLP
+4. **Risk Management**:
+    - If JLP’s price drops, only this pool’s position is at risk of liquidation.
+    - Other pools or positions you hold remain unaffected. At the same time, you’ll not be able to use the token deposited in isolated pool for other positions.
+    - Isolated pools can potentially offer higher LTV as the risk exposure is contained
+
+### Supported Pools
+
+| **Pool** | **Assets** |
+| --- | --- |
+| JLP Isolated Pool | JLP, USDC |
+
+### How to deposit into an isolated pool
+
+**Step 1:** Find the isolated pool markets at the bottom of the [borrow/lend page](https://app.drift.trade/earn/borrow-lend)
+
+![Isolated Pool](public/assets/isolated-pool.png)
+
+**Step 2:** Select Deposit into the isolated pool
+
+![Select Isolated Pool](public/assets/isolated-pool-select.png)
+
+**Step 3:** Enter the amount and select deposit and create account
+
+![Deposit Into Isolated Pool](public/assets/deposit-isolated-pool.png)
+
+You have now created an Isolated pool account, and can borrow and lend within the isolated pool
+
+*Reminder: Please take note of account health and risk of liquidation while exposed to isolated pools*
+