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

# Getting Started

> Alpha Vault

This guide provides instructions on how to get started with building on Meteora's Alpha Vault program using the Alpha Vault TypeScript SDK.

Before you begin, here are some important resources:

<CardGroup cols={2}>
  <Card title="Typescript SDK" icon="node-js" iconType="solid" href="https://github.com/MeteoraAg/alpha-vault-sdk">
    Meteora Alpha Vault Typescript SDK
  </Card>

  <Card title="Alpha Vault NPM Package" icon="npm" iconType="solid" href="https://www.npmjs.com/package/@meteora-ag/alpha-vault">
    Meteora Alpha Vault NPM Package
  </Card>
</CardGroup>

# Installation

To use the SDK in your project, install it using your preferred package manager:

<Tabs>
  <Tab title="npm">
    ```bash theme={"system"}
    npm install @meteora-ag/alpha-vault @solana/web3.js
    ```
  </Tab>

  <Tab title="pnpm">
    ```bash theme={"system"}
    pnpm install @meteora-ag/alpha-vault @solana/web3.js
    ```
  </Tab>

  <Tab title="yarn">
    ```bash theme={"system"}
    yarn add @meteora-ag/alpha-vault @solana/web3.js
    ```
  </Tab>
</Tabs>

# Initialization

Once installed, you can initialize the SDK in your TypeScript/JavaScript project like this:

```typescript theme={"system"}
import { Connection } from "@solana/web3.js";
import { AlphaVault } from "@meteora-ag/alpha-vault";

// Initialize a connection to the Solana network (e.g., Mainnet)
const connection = new Connection("https://api.mainnet-beta.solana.com");

// Intialize the Alpha Vault address
const vault = new PublicKey("H5g71iFUErXyF5D2NcDxP2bJuhdrPBjnDtrVMuPBtnWz");

// Create a new instance of the AlphaVault
const alphaVault = await AlphaVault.create(connection, vault.publicKey);
```

# Testing the SDK (for contributors)

If you have cloned the SDK repository and want to run the built-in tests:

```bash theme={"system"}
# Install dependencies
cd ts-client
bun install

# Run tests
bun test
```

# Development Resources

## Faucets

<CardGroup cols={1}>
  <Card title="Devnet Faucet" icon="faucet" href="https://faucet.raccoons.dev/">
    <p>When working on devnet, you might need test tokens. Here is a helpful faucet.</p>
  </Card>
</CardGroup>