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

# TypeScript / JavaScript

> Build gasless Solana applications with the Altude TypeScript SDK.

The [Altude TypeScript SDK](https://github.com/AltudePlatform/altude-js) provides typed clients for building, signing, and relaying sponsored Solana transactions from Node.js, browser, and React Native applications.

## Published packages

| Package              | Purpose                                                                           |
| -------------------- | --------------------------------------------------------------------------------- |
| `@altude/gasstation` | High-level Gas Station client for sponsored transactions and account queries      |
| `@altude/core`       | Shared errors, mnemonic utilities, types, and authenticated Gill RPC construction |

The SDK keeps user keys in your application. Your signer signs locally, while Altude supplies the fee payer and relays the transaction.

## Quick start

```bash theme={null}
npm install @altude/gasstation @altude/core
```

```typescript theme={null}
import { AltudeGasStation } from '@altude/gasstation'

const gasStation = new AltudeGasStation({
  apiKey: process.env.ALTUDE_API_KEY!,
  network: 'devnet',
})

const config = await gasStation.init()
console.log('Cluster:', config.RpcEnvironment)
console.log('Fee payer:', config.FeePayer)

const balance = await gasStation.getBalance({
  account: 'YOUR_WALLET_ADDRESS',
})

console.log('Balance:', balance.uiAmount)
```

<Note>
  `init()` retrieves the RPC URL, short-lived RPC JWT, fee payer, and cluster selected by your API key. The SDK does not fall back to a public Solana RPC endpoint.
</Note>

## Choose a guide

Start with installation and client setup, then continue to the guide for the
operation you want to add.

<CardGroup cols={2}>
  <Card title="Install the SDK" icon="download" href="./installation">
    Add the published packages to a Node.js, browser, or React Native project.
  </Card>

  <Card title="Configure the client" icon="key" href="./setup">
    Initialize the Gas Station with an API key and API-scoped RPC configuration.
  </Card>

  <Card title="Send SOL or tokens" icon="paper-plane" href="./send-token">
    Build, partially sign, sponsor, and relay a transfer.
  </Card>

  <Card title="React Native" icon="mobile" href="./react-native">
    Use the dedicated React Native and Hermes-compatible package entrypoints.
  </Card>
</CardGroup>

## Requirements

* Node.js 18 or newer for server-side projects
* An Altude API key for live RPC and relay operations
* A local signer when the SDK builds a transaction on the user's behalf
* Amounts expressed in base units: lamports for SOL and the smallest unit for SPL tokens

<Warning>
  Do not commit API keys, wallet secrets, mnemonics, or private keys to source control.
</Warning>