Quickstart - Altude

Prerequisites

An Altude API key — sign up at altude.so to get one.
Node.js 18 or newer.

Install the SDK

npm install @altude/gasstation

Initialize the client

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)

init() calls GET /api/transaction/config with your API key. The response provides the RPC endpoint, short-lived JWT, fee payer address, and selected cluster. The SDK uses only these values — it never falls back to a public Solana RPC.

Check a balance

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

console.log('SOL (lamports):', balance.lamports)
console.log('Display amount:', balance.uiAmount)

For an SPL token balance, pass the mint address:

const usdcBalance = await gasStation.getBalance({
  account: 'YOUR_WALLET_ADDRESS',
  token: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
})

Send a sponsored transaction

Provide a local signer and call send(). Altude attaches the fee payer and relays the transaction — your user’s wallet is never charged for gas.

import type { GaslessTransactionSigner } from '@altude/gasstation'

const signer: GaslessTransactionSigner = {
  address: wallet.publicKey,
  async signTransactionMessage(messageBytes) {
    return wallet.signTransactionMessage(messageBytes)
  },
}

const result = await gasStation.send({
  sourceSigner: signer,
  toAddress: 'RECIPIENT_ADDRESS',
  amount: 1_000_000, // lamports
  commitment: 'finalized',
})

console.log('Signature:', result.Signature)

Do not commit API keys, wallet secrets, mnemonics, or private keys to source control. Use environment variables or a secrets manager.

Next steps

TypeScript SDK overview

Full guide: installation, client setup, and all available operations.

API reference

Direct REST API documentation for all Gas Station endpoints.