> ## Documentation Index
> Fetch the complete documentation index at: https://docs.walletsuite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> This page explains how to install the WalletSuite SDK using your preferred package manager.

## Prerequisites

Before installing, make sure you have:

* Node.js 18 or later recommended
* A package manager: npm, Yarn, or pnpm
* WalletSuite API key — see [Credentials & Authentication](/getting-started/prerequisites/credentials-and-authentication)
* GitHub personal access token with `read:packages` scope — the SDK is published to GitHub Packages, not the public npm registry

## Configure the registry

The SDK is hosted on **GitHub Packages**, so npm needs to be told where to find it before `install` will work.

Create or update `.npmrc` in your project root:

```ini .npmrc theme={null}
@walletsuite:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
```

Then export your token in the shell that runs `install`:

```bash theme={null}
export GITHUB_TOKEN=<your-personal-access-token>
```

<Tip>
  Keep `.npmrc` out of version control if it contains a literal token. Prefer the `${GITHUB_TOKEN}` form above so the token stays in your shell or CI secret store.
</Tip>

## Install

<Tabs>
  <Tab title="npm">
    ```bash Install with npm theme={null}
    npm install @walletsuite/wallet-sdk
    ```
  </Tab>

  <Tab title="Yarn">
    ```bash Install with Yarn theme={null}
    yarn add @walletsuite/wallet-sdk
    ```
  </Tab>

  <Tab title="pnpm">
    ```bash Install with pnpm theme={null}
    pnpm add @walletsuite/wallet-sdk
    ```
  </Tab>
</Tabs>

## Verify Installation

After installing, you should be able to import the SDK in your project.

```ts example.ts theme={null}
import { WalletSuiteSDK } from "@walletsuite/wallet-sdk";
```

If your build system uses ESM or TypeScript, this should work out of the box.

## Next Step

Continue to the [SDK Quick Start](/sdk/quick-start) to make your first authenticated request.