@motosan-whale/solana

Layer 1: Solana RPC client for on-chain investigation.

Part of the motosan-whale SDK — agent-first whale tracking tools.

Install

pnpm add @motosan-whale/solana

Usage

import { SolanaClient } from '@motosan-whale/solana'

const solana = new SolanaClient({ rpcUrl: process.env.HELIUS_URL! })

const txs = await solana.getWalletTxs(address, 'solana', { limit: 50 })
const large = await solana.getLargeTxs({ minAmountUsd: 100_000 })
const holders = await solana.getTokenHolders(mintAddress, 'solana')

// Batch balance queries
const accounts = await solana.getAllTokenAccountsForMint(wallet, mint)
const batch = await solana.getMultipleWalletMintBalances([
  { wallet: walletA, mint },
  { wallet: walletB, mint },
])

// Point-in-time snapshot
const snapshot = await solana.takeTargetedSnapshot(targets)

Streaming: Real-time address monitoring (WebSocket) has moved to @motosan-whale/solana-ws. This package is RPC-only.

Config

interface SolanaConfig {
  rpcUrl: string           // Solana JSON-RPC endpoint (e.g. Helius)
  commitment?: Commitment  // "processed" | "confirmed" | "finalized"
  heliusApiKey?: string    // enables Enhanced Transaction API + DAS
}

Breaking: wsUrl has been removed from SolanaConfig. WebSocket configuration now lives in SolanaWsConfig from @motosan-whale/solana-ws.

API

Key exports:

• SolanaClient — Solana RPC client (recommended with Helius)
  • getWalletTxs() — wallet transaction history
  • getLargeTxs() — filter large transactions
  • getTokenHolders() — token holder list
  • getWalletTokenBalances() — all SPL token balances for a wallet
  • getWalletTokenBalance() — single mint balance for a wallet
  • getAllTokenAccountsForMint() — every token account a wallet holds for a mint (including non-ATA)
  • getMultipleWalletMintBalances() — batch query for multiple wallet+mint pairs
  • takeTargetedSnapshot() — point-in-time snapshot of wallet+mint targets
  • getTokenMetadata() — token metadata via Helius DAS
  • getTokenMetadataBatch() — batch token metadata via Helius DAS
  • getTokenPrice() — USD price via Jupiter Price API
  • getTokenPriceBatch() — batch USD prices via Jupiter Price API

License

MIT