mezo-org · vaish-thesis · Jun 17, 2026 · Jun 17, 2026 · Jun 17, 2026 · Jun 17, 2026
diff --git a/astro.config.mjs b/astro.config.mjs
@@ -185,10 +185,11 @@ export default defineConfig({
                         ]
                   },
                   {
-                        label: 'MUSD',
+                        label: 'Borrow',
                         collapsed: true,
                         items: [
                               'docs/users/musd',
+                              'docs/users/musd/how-to-borrow-musdc',
                               'docs/users/musd/mint-musd',
                               'docs/users/musd/fees',
                               'docs/users/musd/architecture-and-terminology',

diff --git a/lunaria.config.json b/lunaria.config.json
@@ -58,7 +58,6 @@
   "files": [
     {
       "location": "src/content/docs/**/*.{md,mdx}",
-      "ignore": ["**/404/**"],
       "pattern": "src/content/docs/@lang/@path",
       "type": "universal"
     }
@@ -72,4 +71,4 @@
       "src/content/docs/"
     ]
   }
-}
+}
diff --git a/package-lock.json b/package-lock.json
diff --git a/src/content/docs/docs/SUMMARY.md b/src/content/docs/docs/SUMMARY.md
@@ -18,13 +18,14 @@ topic: users
     * [Bridges](users/mainnet/bridges.md)
     * [Track Your Native Bitcoin Deposit](users/mainnet/track-your-native-bitcoin-deposit.md)
     * [Enclaves](users/mainnet/enclaves.md)
-  * [musd](users/musd/README.md)
-    * [Overview](users/musd/index.md)
-    * [Borrow and Mint MUSD](users/musd/mint-musd.md)
-    * [Fees](users/musd/fees.md)
-    * [Architecture and Terminology](users/musd/architecture-and-terminology.md)
-    * [MUSD Liquidations & Redemptions](users/musd/liquidation-mechanics.md)
-    * [MUSD Bridge](users/musd/musd-bridge.md)
+  * [Borrow](users/borrow/README.md)
+    * [Overview](users/borrow/index.md)
+    * [How to Borrow mUSDC](users/borrow/how-to-borrow-musdc.md)
+    * [Borrow and Mint MUSD](users/borrow/mint-musd.md)
+    * [Fees](users/borrow/fees.md)
+    * [Architecture and Terminology](users/borrow/architecture-and-terminology.md)
+    * [Liquidations & Redemptions](users/borrow/liquidation-mechanics.md)
+    * [MUSD Bridge](users/borrow/musd-bridge.md)
   * [MEZO](users/mezo/index.md)
     * [MEZO Overview](users/mezo/index.md)
     * [Token Distribution](users/mezo/token-distribution.md)

diff --git a/src/content/docs/docs/de/docs/SUMMARY.md b/src/content/docs/docs/de/docs/SUMMARY.md
@@ -16,13 +16,13 @@ topic: users
   * [Mainnet](users/mainnet/index.md)
     * [Brücken (Bridges)](users/mainnet/bridges.md)
     * [Ihren nativen Bitcoin-Einzahlung verfolgen](users/mainnet/track-your-native-bitcoin-deposit.md)
-  * [musd](users/musd/README.md)
-    * [Übersicht](users/musd/index.md)
-    * [MUSD leihen und prägen](users/musd/mint-musd.md)
-    * [Gebühren](users/musd/fees.md)
-    * [Architektur und Terminologie](users/musd/architecture-and-terminology.md)
-    * [MUSD-Liquidierungen und -Rücknahmen](users/musd/liquidation-mechanics.md)
-    * [MUSD-Brücke](users/musd/musd-bridge.md)
+  * [musd](users/borrow/README.md)
+    * [Übersicht](users/borrow/index.md)
+    * [MUSD leihen und prägen](users/borrow/mint-musd.md)
+    * [Gebühren](users/borrow/fees.md)
+    * [Architektur und Terminologie](users/borrow/architecture-and-terminology.md)
+    * [MUSD-Liquidierungen und -Rücknahmen](users/borrow/liquidation-mechanics.md)
+    * [MUSD-Brücke](users/borrow/musd-bridge.md)
   * [MEZO](users/mezo/index.md)
     * [MEZO-Übersicht](users/mezo/index.md)
     * [Token-Verteilung](users/mezo/token-distribution.md)

diff --git a/src/content/docs/docs/de/docs/developers/bridge/wormhole-musd-bridge.md b/src/content/docs/docs/de/docs/developers/bridge/wormhole-musd-bridge.md
@@ -3,4 +3,4 @@ title: Wormhole MUSD Bridge
 topic: developers
 ---
 
-Die MUSD-Brücke wird vom Wormhole Native Token Transfer (NTT)-Protokoll betrieben, das sichere Cross-Chain-Transfers bei gleichzeitiger Wahrung der Token-Fungibilität ermöglicht. Weitere Informationen zur MUSD-Brücke finden Sie auf der Seite [MUSD-Brücke](/docs/de/docs/users/musd/musd-bridge).
+Die MUSD-Brücke wird vom Wormhole Native Token Transfer (NTT)-Protokoll betrieben, das sichere Cross-Chain-Transfers bei gleichzeitiger Wahrung der Token-Fungibilität ermöglicht. Weitere Informationen zur MUSD-Brücke finden Sie auf der Seite [MUSD-Brücke](/docs/de/docs/users/borrow/musd-bridge).
diff --git a/src/content/docs/docs/de/docs/users/index.mdx b/src/content/docs/docs/de/docs/users/index.mdx
@@ -48,7 +48,7 @@ Erfahren Sie mehr über das Mezo-Netzwerk, MUSD und wie sie Zugang zu Bitcoin-Ei
   />
   <LinkCard
     title="Was ist MUSD?"
-    href="/docs/de/docs/users/musd"
+    href="/docs/de/docs/users/borrow"
     description="Erfahren Sie mehr über Mezos nativen Bitcoin-besicherten Stablecoin."
   />
 </CardGrid>
@@ -60,7 +60,7 @@ Nutzen Sie Ihre Vermögenswerte, um die Kaufkraft Ihres Bitcoin freizusetzen.
 <CardGrid>
   <LinkCard
     title="MUSD leihen und prägen"
-    href="/docs/de/docs/users/musd/mint-musd"
+    href="/docs/de/docs/users/borrow/mint-musd"
     description="Nutzen Sie Ihre Vermögenswerte, um die Kaufkraft Ihres Bitcoin freizusetzen."
   />
 </CardGrid>

diff --git a/src/content/docs/docs/developers/bridge/wormhole-musd-bridge.md b/src/content/docs/docs/developers/bridge/wormhole-musd-bridge.md
@@ -3,4 +3,4 @@ title: Wormhole MUSD Bridge
 topic: developers
 ---
 
-The MUSD bridge is powered by Wormhole's Native Token Transfer (NTT) protocol, which enables secure cross-chain transfers while maintaining token fungibility. For more information about MUSD bridge, see the [MUSD Bridge](/docs/users/musd/musd-bridge) page.
+The MUSD bridge is powered by Wormhole's Native Token Transfer (NTT) protocol, which enables secure cross-chain transfers while maintaining token fungibility. For more information about MUSD bridge, see the [MUSD Bridge](/docs/users/borrow/musd-bridge) page.
diff --git a/src/content/docs/docs/developers/getting-started/musd-payments-x402/index.mdx b/src/content/docs/docs/developers/getting-started/musd-payments-x402/index.mdx
@@ -134,5 +134,5 @@ wallet, run a programmatic `@x402/fetch` client), see the
   Mezo RPC endpoints and network parameters.
 - [Network & RPC](/docs/developers/chains/). Chain configuration
   details.
-- <a href="/docs/users/musd/mint-musd/" target="_blank" rel="noopener noreferrer">Borrow and Mint MUSD ↗</a>. User-side flow for acquiring MUSD (opens in new tab).
+- <a href="/docs/users/borrow/mint-musd/" target="_blank" rel="noopener noreferrer">Borrow and Mint MUSD ↗</a>. User-side flow for acquiring MUSD (opens in new tab).
 - [x402.org](https://x402.org). Canonical x402 protocol documentation.
diff --git a/...ent/docs/docs/developers/getting-started/musd-payments-x402/x402-quickstart.mdx b/...ent/docs/docs/developers/getting-started/musd-payments-x402/x402-quickstart.mdx
@@ -102,7 +102,7 @@ Step 2 funds going to Account A. Account B (Merchant) stays empty throughout.
 
 2. Borrow MUSD at [mezo.org/feature/borrow](https://mezo.org/feature/borrow)
    with Account A connected on Mezo Testnet. Full walkthrough with
-   screenshots: [Borrow and Mint MUSD](/docs/users/musd/mint-musd/).
+   screenshots: [Borrow and Mint MUSD](/docs/users/borrow/mint-musd/).
 
 3. Confirm Account A's MUSD balance. The testnet MUSD token contract
    is [`0x1189…Ac503`](https://explorer.test.mezo.org/token/0x118917a40FAF1CD7a13dB0Ef56C86De7973Ac503).
@@ -417,7 +417,7 @@ in Account B on chain.
   at `0.001 MUSD`, points at `facilitator.vativ.io`, README walks
   through wallet funding + running the demo end-to-end. Clone and
   adapt.
-- <a href="/docs/users/musd/mint-musd/" target="_blank" rel="noopener noreferrer">Borrow and Mint MUSD ↗</a>. User-side flow for acquiring MUSD (opens in new tab).
+- <a href="/docs/users/borrow/mint-musd/" target="_blank" rel="noopener noreferrer">Borrow and Mint MUSD ↗</a>. User-side flow for acquiring MUSD (opens in new tab).
 - [Mezo Faucet](https://faucet.test.mezo.org). Testnet BTC.
 
 {/* Screenshot placeholder template — replicate this block for each screenshot you insert throughout the quickstart. The `paywall-local-initial.png` below is the one remaining reference image; treat it as the example pattern and add more `import` + `<Image>` pairs as needed. */}

diff --git a/src/content/docs/docs/developers/musd/index.md b/src/content/docs/docs/developers/musd/index.md
@@ -250,4 +250,4 @@ pnpm coverage
 
 -   **[MUSD Main README](https://github.com/mezo-org/musd/blob/main/README.md)** - Comprehensive architectural overview.
 -   **[Demo Test Suite](https://github.com/mezo-org/musd/blob/main/test/integration/Demo.test.ts)** - Working code examples.
--   **[MUSD User Guide](/docs/users/musd/)** - End-user documentation.
+-   **[MUSD User Guide](/docs/users/borrow/)** - End-user documentation.
diff --git a/src/content/docs/docs/es/docs/SUMMARY.md b/src/content/docs/docs/es/docs/SUMMARY.md
@@ -16,13 +16,13 @@ topic: users
   * [mainnet](users/mainnet/index.md)
     * [Puentes (Bridges)](users/mainnet/bridges.md)
     * [Rastrear tu Depósito Nativo de Bitcoin](users/mainnet/track-your-native-bitcoin-deposit.md)
-  * [musd](users/musd/README.md)
-    * [Descripción General](users/musd/index.md)
-    * [Pedir Prestado y Acuñar MUSD](users/musd/mint-musd.md)
-    * [Comisiones](users/musd/fees.md)
-    * [Arquitectura y Terminología](users/musd/architecture-and-terminology.md)
-    * [Liquidaciones y Redenciones de MUSD](users/musd/liquidation-mechanics.md)
-    * [MUSD Bridge](users/musd/musd-bridge.md)
+  * [musd](users/borrow/README.md)
+    * [Descripción General](users/borrow/index.md)
+    * [Pedir Prestado y Acuñar MUSD](users/borrow/mint-musd.md)
+    * [Comisiones](users/borrow/fees.md)
+    * [Arquitectura y Terminología](users/borrow/architecture-and-terminology.md)
+    * [Liquidaciones y Redenciones de MUSD](users/borrow/liquidation-mechanics.md)
+    * [MUSD Bridge](users/borrow/musd-bridge.md)
   * [MEZO](users/mezo/index.md)
     * [Descripción General de MEZO](users/mezo/index.md)
     * [Distribución de Tokens](users/mezo/token-distribution.md)

diff --git a/src/content/docs/docs/es/docs/developers/bridge/wormhole-musd-bridge.md b/src/content/docs/docs/es/docs/developers/bridge/wormhole-musd-bridge.md
@@ -3,4 +3,4 @@ title: Wormhole MUSD Bridge
 topic: developers
 ---
 
-El MUSD Bridge está impulsado por el protocolo Native Token Transfer (NTT) de Wormhole, que permite transferencias cross-chain seguras manteniendo la fungibilidad del token. Para más información sobre el MUSD Bridge, consulta la página [MUSD Bridge](/docs/es/docs/users/musd/musd-bridge).
+El MUSD Bridge está impulsado por el protocolo Native Token Transfer (NTT) de Wormhole, que permite transferencias cross-chain seguras manteniendo la fungibilidad del token. Para más información sobre el MUSD Bridge, consulta la página [MUSD Bridge](/docs/es/docs/users/borrow/musd-bridge).
diff --git a/src/content/docs/docs/es/docs/users/index.mdx b/src/content/docs/docs/es/docs/users/index.mdx
@@ -48,7 +48,7 @@ Aprende sobre la red Mezo, MUSD, y cómo proporcionan acceso al capital de Bitco
   />
   <LinkCard
     title="¿Qué es MUSD?"
-    href="/docs/es/docs/users/musd"
+    href="/docs/es/docs/users/borrow"
     description="Aprende sobre la stablecoin nativa de Mezo respaldada por Bitcoin."
   />
 </CardGrid>
@@ -60,7 +60,7 @@ Usa tus activos para desbloquear el poder de gasto de tu Bitcoin.
 <CardGrid>
   <LinkCard
     title="Pedir prestado y acuñar MUSD"
-    href="/docs/es/docs/users/musd/mint-musd"
+    href="/docs/es/docs/users/borrow/mint-musd"
     description="Usa tus activos para desbloquear el poder de gasto de tu Bitcoin."
   />
 </CardGrid>

diff --git a/src/content/docs/docs/fr/docs/SUMMARY.md b/src/content/docs/docs/fr/docs/SUMMARY.md
@@ -16,13 +16,13 @@ topic: users
   * [mainnet](users/mainnet/index.md)
     * [Ponts (Bridges)](users/mainnet/bridges.md)
     * [Suivre votre dépôt Bitcoin natif](users/mainnet/track-your-native-bitcoin-deposit.md)
-  * [musd](users/musd/README.md)
-    * [Aperçu](users/musd/index.md)
-    * [Emprunter et créer des MUSD](users/musd/mint-musd.md)
-    * [Frais](users/musd/fees.md)
-    * [Architecture et terminologie](users/musd/architecture-and-terminology.md)
-    * [Liquidations et rachats MUSD](users/musd/liquidation-mechanics.md)
-    * [MUSD Bridge](users/musd/musd-bridge.md)
+  * [musd](users/borrow/README.md)
+    * [Aperçu](users/borrow/index.md)
+    * [Emprunter et créer des MUSD](users/borrow/mint-musd.md)
+    * [Frais](users/borrow/fees.md)
+    * [Architecture et terminologie](users/borrow/architecture-and-terminology.md)
+    * [Liquidations et rachats MUSD](users/borrow/liquidation-mechanics.md)
+    * [MUSD Bridge](users/borrow/musd-bridge.md)
   * [MEZO](users/mezo/index.md)
     * [Aperçu de MEZO](users/mezo/index.md)
     * [Distribution des tokens](users/mezo/token-distribution.md)

diff --git a/src/content/docs/docs/fr/docs/developers/bridge/wormhole-musd-bridge.md b/src/content/docs/docs/fr/docs/developers/bridge/wormhole-musd-bridge.md
@@ -3,4 +3,4 @@ title: Wormhole MUSD Bridge
 topic: developers
 ---
 
-Le pont MUSD est alimenté par le protocole Native Token Transfer (NTT) de Wormhole, qui permet des transferts inter-chaînes sécurisés tout en maintenant la fongibilité des tokens. Pour plus d'informations sur le pont MUSD, consultez la page [Pont MUSD](/docs/fr/docs/users/musd/musd-bridge).
+Le pont MUSD est alimenté par le protocole Native Token Transfer (NTT) de Wormhole, qui permet des transferts inter-chaînes sécurisés tout en maintenant la fongibilité des tokens. Pour plus d'informations sur le pont MUSD, consultez la page [Pont MUSD](/docs/fr/docs/users/borrow/musd-bridge).
diff --git a/src/content/docs/docs/fr/docs/users/index.mdx b/src/content/docs/docs/fr/docs/users/index.mdx
@@ -48,7 +48,7 @@ Découvrez le réseau Mezo, MUSD, et comment ils donnent accès au capital Bitco
   />
   <LinkCard
     title="Qu'est-ce que MUSD ?"
-    href="/docs/fr/docs/users/musd"
+    href="/docs/fr/docs/users/borrow"
     description="Découvrez la stablecoin native de Mezo adossée au Bitcoin."
   />
 </CardGrid>
@@ -60,7 +60,7 @@ Utilisez vos actifs pour libérer le pouvoir d'achat de votre Bitcoin.
 <CardGrid>
   <LinkCard
     title="Emprunter et créer des MUSD"
-    href="/docs/fr/docs/users/musd/mint-musd"
+    href="/docs/fr/docs/users/borrow/mint-musd"
     description="Utilisez vos actifs pour libérer le pouvoir d'achat de votre Bitcoin."
   />
 </CardGrid>

diff --git a/src/content/docs/docs/in/docs/SUMMARY.md b/src/content/docs/docs/in/docs/SUMMARY.md
@@ -16,13 +16,13 @@ topic: users
   * [मेननेट](users/mainnet/index.md)
     * [ब्रिज](users/mainnet/bridges.md)
     * [अपनी नेटिव बिटकॉइन जमा को ट्रैक करें](users/mainnet/track-your-native-bitcoin-deposit.md)
-  * [musd](users/musd/README.md)
-    * [अवलोकन](users/musd/index.md)
-    * [MUSD उधार लें और मिंट करें](users/musd/mint-musd.md)
-    * [शुल्क](users/musd/fees.md)
-    * [आर्किटेक्चर और शब्दावली](users/musd/architecture-and-terminology.md)
-    * [MUSD परिसमापन और मोचन](users/musd/liquidation-mechanics.md)
-    * [MUSD ब्रिज](users/musd/musd-bridge.md)
+  * [musd](users/borrow/README.md)
+    * [अवलोकन](users/borrow/index.md)
+    * [MUSD उधार लें और मिंट करें](users/borrow/mint-musd.md)
+    * [शुल्क](users/borrow/fees.md)
+    * [आर्किटेक्चर और शब्दावली](users/borrow/architecture-and-terminology.md)
+    * [MUSD परिसमापन और मोचन](users/borrow/liquidation-mechanics.md)
+    * [MUSD ब्रिज](users/borrow/musd-bridge.md)
   * [MEZO](users/mezo/index.md)
     * [MEZO अवलोकन](users/mezo/index.md)
     * [टोकन वितरण](users/mezo/token-distribution.md)

diff --git a/src/content/docs/docs/in/docs/developers/bridge/wormhole-musd-bridge.md b/src/content/docs/docs/in/docs/developers/bridge/wormhole-musd-bridge.md
@@ -3,4 +3,4 @@ title: Wormhole MUSD Bridge
 topic: developers
 ---
 
-MUSD ब्रिज Wormhole के नेटिव टोकन ट्रांसफर (NTT) प्रोटोकॉल द्वारा संचालित है, जो टोकन की विनिमेयता बनाए रखते हुए सुरक्षित क्रॉस-चेन ट्रांसफर को सक्षम करता है। MUSD ब्रिज के बारे में अधिक जानकारी के लिए, [MUSD ब्रिज](/docs/in/docs/users/musd/musd-bridge) पृष्ठ देखें।
+MUSD ब्रिज Wormhole के नेटिव टोकन ट्रांसफर (NTT) प्रोटोकॉल द्वारा संचालित है, जो टोकन की विनिमेयता बनाए रखते हुए सुरक्षित क्रॉस-चेन ट्रांसफर को सक्षम करता है। MUSD ब्रिज के बारे में अधिक जानकारी के लिए, [MUSD ब्रिज](/docs/in/docs/users/borrow/musd-bridge) पृष्ठ देखें।
diff --git a/src/content/docs/docs/in/docs/users/index.mdx b/src/content/docs/docs/in/docs/users/index.mdx
@@ -47,7 +47,7 @@ Mezo नेटवर्क, MUSD, और वे बिटकॉइन इक्
   />
   <LinkCard
     title="MUSD क्या है?"
-    href="/docs/in/docs/users/musd"
+    href="/docs/in/docs/users/borrow"
     description="Mezo के मूल बिटकॉइन-समर्थित स्टेबलकॉइन के बारे में जानें।"
   />
 </CardGrid>
@@ -59,7 +59,7 @@ Mezo नेटवर्क, MUSD, और वे बिटकॉइन इक्
 <CardGrid>
   <LinkCard
     title="MUSD उधार लें और मिंट करें"
-    href="/docs/in/docs/users/musd/mint-musd"
+    href="/docs/in/docs/users/borrow/mint-musd"
     description="अपने बिटकॉइन की खर्च करने की शक्ति को अनलॉक करने के लिए अपने एसेट का उपयोग करें।"
   />
 </CardGrid>

diff --git a/src/content/docs/docs/kr/docs/SUMMARY.md b/src/content/docs/docs/kr/docs/SUMMARY.md
@@ -16,13 +16,13 @@ topic: users
   * [메인넷](users/mainnet/index.md)
     * [브리지](users/mainnet/bridges.md)
     * [네이티브 비트코인 입금 추적](users/mainnet/track-your-native-bitcoin-deposit.md)
-  * [musd](users/musd/README.md)
-    * [개요](users/musd/index.md)
-    * [MUSD 대출 및 발행](users/musd/mint-musd.md)
-    * [수수료](users/musd/fees.md)
-    * [아키텍처 및 용어](users/musd/architecture-and-terminology.md)
-    * [MUSD 청산 및 상환](users/musd/liquidation-mechanics.md)
-    * [MUSD 브리지](users/musd/musd-bridge.md)
+  * [musd](users/borrow/README.md)
+    * [개요](users/borrow/index.md)
+    * [MUSD 대출 및 발행](users/borrow/mint-musd.md)
+    * [수수료](users/borrow/fees.md)
+    * [아키텍처 및 용어](users/borrow/architecture-and-terminology.md)
+    * [MUSD 청산 및 상환](users/borrow/liquidation-mechanics.md)
+    * [MUSD 브리지](users/borrow/musd-bridge.md)
   * [MEZO](users/mezo/index.md)
     * [MEZO 개요](users/mezo/index.md)
     * [토큰 배분](users/mezo/token-distribution.md)