# Guides

These guides show how to use the **Mento SDK v3** for Mento V3: FPMM pools, oracles, route caching, liquidity, and CDP borrowing. The SDK is **service-based**: after `Mento.create(ChainId.CELO)` you use `mento.tokens`, `mento.pools`, `mento.routes`, `mento.quotes`, `mento.swap`, `mento.trading`, `mento.liquidity`, and `mento.borrow`.

***

## Discovery & trading status

| Guide                                                                                                                 | What you’ll do                                                                                                                                        |
| --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Discovering tokens, pools and routes](https://docs.mento.org/mento-v3/build/mento-sdk/guides/getting-exchange-pairs) | Discover tokens, **pools** (with pricing, fees, rebalancing, limits), **routes** (cached or fresh), and **trading status** (circuit breaker, limits). |
| [Getting a quote](https://docs.mento.org/mento-v3/build/mento-sdk/guides/getting-a-quote)                             | Get expected swap output with `mento.quotes.getAmountOut` (or amount in for exact out).                                                               |
| [Initiating a swap](https://docs.mento.org/mento-v3/build/mento-sdk/guides/initiating-a-swap)                         | Build swap and approval transactions with `mento.swap.buildSwapTransaction` and send with a viem wallet.                                              |

***

## Liquidity (FPMM pools)

| Guide                                                                                    | What you’ll do                                                                                                                    |
| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| [Liquidity management](https://docs.mento.org/mento-v3/build/mento-sdk/guides/liquidity) | **Add/remove liquidity** to FPMM pools; **zap in** (single token → LP) and **zap out** (LP → single token); get LP token balance. |

***

## Borrow (CDP)

| Guide                                                                         | What you’ll do                                                                                                                                      |
| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Borrow (CDP)](https://docs.mento.org/mento-v3/build/mento-sdk/guides/borrow) | **Open, adjust, close** troves; read trove data and system params; **predict upfront fee** before opening; build transactions for your viem wallet. |

***

All guides assume you have created a client as in [Installation](https://docs.mento.org/mento-v3/build/mento-sdk/installation). For runnable code, see [mento-sdk-examples](https://github.com/mento-protocol/mento-sdk-examples).