Skip to content

sarmatdev/solana-lut-indexer

Repository files navigation

Solana Address Lookup Table Indexer

A high-performance indexer for Solana Address Lookup Tables (LUTs) created by Jupiter Aggregator. Built with the Carbon indexing framework and Yellowstone gRPC.

Features

  • Real-time indexing via Yellowstone gRPC
  • Historical backfill support
  • Tracks CreateLookupTable and ExtendLookupTable instructions
  • Filters for Jupiter's LUT authority (9RAufBfjGQjDfrwxeyKmZWPADHSb8HcoqCdrmpqvCr1g)
  • PostgreSQL storage with SQLx compile-time checked queries

Quick Start

# Clone and configure
cp .env.example .env
# Edit .env with your YELLOWSTONE_ENDPOINT

# Start with Docker
docker compose up -d

# View logs
docker compose logs -f indexer

Local Development

# Start PostgreSQL
make db-up

# Run migrations and prepare SQLx
export DATABASE_URL=postgres://indexer:indexer@localhost:5432/lut_indexer
make db-migrate
make sqlx-prepare

# Run the indexer
make run-live

Commands

cargo run -- live                                    # Real-time indexing
cargo run -- backfill --start-slot X --end-slot Y   # Historical backfill
cargo run -- stats                                   # Show statistics

Environment Variables

Variable Description
DATABASE_URL PostgreSQL connection string
YELLOWSTONE_ENDPOINT Yellowstone gRPC endpoint
YELLOWSTONE_TOKEN Auth token (optional)
RPC_WS_URL WebSocket RPC for backfill

License

MIT

About

Solana Address Lookup Table Indexer

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors