# Getting started

The full source code of this example is available on Github:\
<https://github.com/mangrovedao/mgv-example>

To interact with Mangrove in JavaScript, we recommend using [viem](https://viem.sh/) with the [@mangrovedao/mgv](https://github.com/mangrovedao/mgv) SDK, which is built on top of it.

## Project Setup

To get started (using [Bun](https://bun.sh)) initialize a new project:

```bash
bun init
```

Then add Viem and mgv as dependencies:

```bash
bun add viem @mangrovedao/mgv
```

## Configuration

Next, define your Mangrove configuration, which includes the contract addresses for your target chain. Below is an example of the config for Mangrove on Base:

{% code title="src/config.ts" lineNumbers="true" %}

```typescript
import type { MangroveActionsDefaultParams } from "@mangrovedao/mgv";

export const mangroveConfig = {
  mgv: "0x22613524f5905Cb17cbD785b956e9238Bf725FAa",
  mgvOrder: "0xA3c363Ca0EA3603faEe9FAcffD65E777122adF36",
  mgvReader: "0xe5B118Ea1ffBC502EA7A666376d448209BFB50d3",
  smartRouter: "0x1424D7428dc11623100df1A3D06088C2d87fBE32",
  routerProxyFactory: "0x2926Cc3977F93a51465f9742c548e67220Af54e9",
} satisfies MangroveActionsDefaultParams;
```

{% endcode %}

> **Note:**\
> You can find the full list of contract addresses in the [Mangrove documentation](/dev/adresses/deployment-addresses.md) or by contacting the Mangrove team.

## The Client

Now set up your client.\
You’ll need:

* A **`PRIVATE_KEY`** environment variable (required)
* An optional **`RPC_URL`** environment variable for your node provider

{% code title="src/client.ts" lineNumbers="true" %}

```typescript
import { mangroveActions } from "@mangrovedao/mgv";
import { createWalletClient, http, publicActions, type Hex } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
import { mangroveConfig } from "./config";

export const client = createWalletClient({
  chain: base,
  transport: http(process.env.RPC_URL),
  account: privateKeyToAccount(process.env.PRIVATE_KEY as Hex),
})
  .extend(publicActions)
  .extend(mangroveActions(mangroveConfig));

```

{% endcode %}

With the configuration and client set up, you’re ready to interact with the Mangrove protocol. Learn how to query Mangrove in the next section.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mangrove.exchange/dev/interacting-with-js/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.