Skip to content

A modular Solana transaction indexer and classifier built for tracking, analyzing, and categorizing blockchain transactions with personal finance-like semantics.

License

Notifications You must be signed in to change notification settings

cxalem/tx-indexer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

216 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

itx

A Solana transaction indexer SDK and wallet dashboard with privacy features.


Dashboard

Live Dashboard - Non-custodial Solana wallet with Privacy Hub.

Features: Send/Receive, Trade (Jupiter), Privacy Hub (ZK proofs), Activity Feed, Spam Filtering.

See apps/dashboard for implementation details and privacy flow.


SDK

TypeScript SDK for fetching and classifying Solana transactions.

Installation

npm install tx-indexer

Quick Start

import { createIndexer } from "tx-indexer";

const indexer = createIndexer({
  rpcUrl: "https://api.mainnet-beta.solana.com",
});

// Get wallet balance
const balance = await indexer.getBalance("YourWalletAddress...");
console.log(`SOL: ${balance.sol.ui}`);

// Get classified transactions
const transactions = await indexer.getTransactions("YourWalletAddress...", {
  limit: 10,
  filterSpam: true,
});

for (const { classification } of transactions) {
  console.log(
    `${classification.primaryType}: ${classification.primaryAmount?.amountUi} ${classification.primaryAmount?.token.symbol}`,
  );
}

Transaction Types

Type Description
transfer Wallet-to-wallet transfers
swap Token exchanges (Jupiter, Raydium, Orca)
privacy_deposit / privacy_withdraw Privacy Cash shield/unshield
nft_mint NFT minting
nft_purchase / nft_sale NFT trades
stake_deposit / stake_withdraw SOL staking
bridge_in / bridge_out Cross-chain bridges
airdrop Token distributions

Supported Protocols

Jupiter, Raydium, Orca, Metaplex, Wormhole, deBridge, Pump.fun, Privacy Cash, and more.


Project Structure

tx-indexer/
├── apps/
│   ├── dashboard/        # Wallet dashboard with privacy features
│   └── web/              # Landing page and transaction viewer
└── packages/
    ├── sdk/              # Main SDK (tx-indexer on npm)
    ├── core/             # Types, money handling, token registry
    ├── solana/           # RPC client, transaction fetching
    └── classification/   # Transaction classifier, protocol detection

Development

bun install

Running the Dashboard

cp apps/dashboard/.env.example apps/dashboard/.env
# Add your Helius API key to apps/dashboard/.env

bun run dev --filter=dashboard

Running the web app

cp apps/web/.env.example apps/web/.env
# Add your Helius API key to apps/web/.env

bun run dev --filter=web

Other useful commands

bun run build        # Build all packages
bun run check-types  # Type checking
bun run lint         # Linting
bun run format       # Format code

License

MIT

About

A modular Solana transaction indexer and classifier built for tracking, analyzing, and categorizing blockchain transactions with personal finance-like semantics.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages