> For the complete documentation index, see [llms.txt](https://docs.moonwell.fi/moonwell/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moonwell.fi/moonwell/developers/guides.md).

# Guides

Moonwell's lending markets are composable primitives. Any smart contract can supply, borrow, liquidate, or build yield products on top of them without permission.

These guides walk through the most common integration patterns.

Choose the integration surface that matches what you are building. Each path has different prerequisites and a different first step.

### Core Markets

Use this path when you want to interact directly with Moonwell lending markets programmatically.

**What it is for:** Supplying assets, borrowing, enabling collateral, repaying, and claiming rewards through the mToken and Comptroller contracts.

**Prerequisites:** Contract addresses for the mToken and Comptroller on your target network.

**First step:** Approve the mToken contract to pull the underlying asset, then call `mint` to supply.

{% content-ref url="/pages/33sNxXLD9f6hRHk1GXGA" %}
[Core Market Integration](/moonwell/developers/guides/core-market-integration.md)
{% endcontent-ref %}

### Vaults

Use this path when you want to deposit into a managed yield vault that allocates across Morpho markets.

**What it is for:** Earning yield through ERC-4626 vaults with single-asset deposits and automated allocation.

**Prerequisites:** The vault deployment address for Base or OP Mainnet.

**First step:** Deposit underlying tokens into the vault to receive ERC-4626 shares.

{% content-ref url="/pages/bulhOQhnxmFbFiSFKeqI" %}
[Vault Integration](/moonwell/developers/guides/vault-integration.md)
{% endcontent-ref %}

### Moonwell SDK

Use this path when you want a TypeScript library to read market data, user positions, rewards, and governance information.

**What it is for:** Building frontends, dashboards, or analytics tools without writing low-level contract calls.

**Prerequisites:** A TypeScript project. The SDK supports Base, OP Mainnet, Moonbeam, and Moonriver.

**First step:** Install the SDK and initialize it for your target network. See the [Moonwell SDK documentation](internal://art_01KWANYWYNWMFBFRAVHSG2YX87).

### OEV Liquidations

Use this path when building a liquidation bot that uses Moonwell's OEV (Oracle Extractable Value) system to capture liquidation profit.

{% content-ref url="/pages/UgHj3m2c09ME75LAxFhj" %}
[OEV Liquidator Bot](/moonwell/developers/guides/oev-liquidator.md)
{% endcontent-ref %}