> For the complete documentation index, see [llms.txt](https://docs.haven1.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.haven1.org/build/developer-tools/haven1-sdk.md).

# Haven1 SDK

## Features

**Easy Integration**: Seamlessly integrate with the Haven1 blockchain using our comprehensive SDK.

**TypeScript Support**: Enjoy full TypeScript support for type safety and better development experience.

## Haven1 SDK Packages

This guide will help you quickly get started with each of the Haven1 SDK packages, including Blockchain, React, Wagmi, and API Client.

### Blockchain SDK

**Installation**

{% tabs %}
{% tab title="npm" %}

```sh
npm install @haven1/blockchain-sdk
```

{% endtab %}

{% tab title="yarn" %}

```sh
yarn add @haven1/blockchain-sdk
```

{% endtab %}

{% tab title="pnpm" %}

```sh
pnpm add @haven1/blockchain-sdk
```

{% endtab %}
{% endtabs %}

**Usage**: If your project is based on ethers, this package provides essential configurations and utilities for interacting with the Haven1 blockchain, including chain configurations, contract addresses, ABI definitions, and utility functions. 

**Dependencies**: `ethers`, `axios` 

**Peer Dependencies**: `react`, `react-dom`

### Wagmi SDK

**Installation** 

{% tabs %}
{% tab title="npm" %}

```sh
npm install @haven1/wagmi-sdk
```

{% endtab %}

{% tab title="yarn" %}

```sh
yarn add @haven1/wagmi-sdk
```

{% endtab %}

{% tab title="pnpm" %}

```sh
pnpm add @haven1/wagmi-sdk
```

{% endtab %}
{% endtabs %}

**Usage**: If your project is based on wagmi, this package provides hooks and utilities for managing blockchain interactions, including wallet connections and contract calls. 

**Dependencies**: `wagmi`, `ethers` 

**Peer Dependencies**: `@tanstack/react-query`, `react`, `viem`, `wagmi`, `@haven1/sdk-api-client`, `@haven1/react-sdk`, `@haven1/blockchain-sdk`

### React SDK

**Installation**

{% tabs %}
{% tab title="npm" %}

```sh
npm install @haven1/react-sdk
```

{% endtab %}

{% tab title="yarn" %}

```sh
yarn add @haven1/react-sdk
```

{% endtab %}

{% tab title="pnpm" %}

```sh
pnpm add @haven1/react-sdk
```

{% endtab %}
{% endtabs %}

**Usage**: This package includes Haven1 design system React components and hooks for building user interfaces that interact with the Haven1. 

**Dependencies**: `react`, `react-dom`, `@haven1/blockchain-sdk` 

**Peer Dependencies**: `react-router-dom`

### API Client SDK

**Installation**

{% tabs %}
{% tab title="npm" %}

```sh
npm install @haven1/sdk-api-client
```

{% endtab %}

{% tab title="yarn" %}

```sh
yarn add @haven1/sdk-api-client
```

{% endtab %}

{% tab title="pnpm" %}

```sh
pnpm add @haven1/sdk-api-client
```

{% endtab %}
{% endtabs %}

**Usage**: This package provides a Open API standard client for interacting with the Haven1 API. It handles authentication and SDK API requests.

**Dependencies**: `axios` 

**Peer Dependencies**: `react`, `react-dom`

Each package comes with detailed documentation to help you explore more advanced features and configurations. 

Ensure you have the necessary peer dependencies installed in your project to avoid any issues during development.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.haven1.org/build/developer-tools/haven1-sdk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.