A powerful platform for indexing Solana blockchain data using Helius API and storing it in your own PostgreSQL database.

Click the image above to watch our walkthrough video

This platform allows developers to easily set up and manage Solana blockchain indexers using the Helius API and their own PostgreSQL database. The system provides a comprehensive set of features for configuring, monitoring, and managing blockchain data indexing in a user-friendly way through Helius API.

• 🔐 User Authentication: Secure registration and login system
• 🗄️ Database Management: Connect and manage your PostgreSQL databases
• ⚙️ Indexer Configuration: Create custom indexers with specific filters and transformations
• 🔗 Helius Integration: Seamless connection to Solana blockchain via Helius API
• ⚡ Real-time Indexing: Process blockchain data as it happens
• 🔄 Customizable Transformations: Define how data should be structured in your database
• 📊 Dashboard & Monitoring: Track performance and troubleshoot issues

• 📦 Node.js (v14 or higher)
• 🐘 PostgreSQL (v12 or higher)
• 🔑 Helius API key (sign up at https://helius.xyz)

1. Clone the repository:

git clone https://github.com/yourusername/blockchain-indexing-platform.git
cd blockchain-indexing-platform/backend

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env

Edit the .env file with your database and Helius API credentials.

4. Run migrations:

npm run migration:run

5. Start the server:

npm run start:dev

1. Navigate to the frontend directory:

cd ../frontend

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env.local

Edit the .env.local file with your backend API URL.

4. Start the development server:

npm run dev

1. 👤 Register an account at {your-domain}/auth/register
2. 🔌 Add a database connection with your PostgreSQL credentials
3. 🛠️ Create an indexer with your desired filters and transformations
4. ▶️ Activate the indexer to start receiving blockchain data
5. 📈 Monitor the dashboard to see your indexed data in action

const response = await fetch('https://your-api.com/database', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify({
    name: 'Production Database',
    host: 'db.example.com',
    port: 5432,
    username: 'dbuser',
    password: 'dbpassword',
    database: 'blockchain_data'
  })
});

const data = await response.json();
console.log('Database connection created:', data);

const response = await fetch('https://your-api.com/indexer', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify({
    name: 'NFT Transactions Indexer',
    description: 'Indexes all NFT transactions on Solana',
    databaseConnectionId: 'db-connection-uuid-1',
    schemaName: 'nft_data',
    filters: {
      programIds: [
        'metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s'
      ],
      transactionTypes: ['NFT_SALE']
    },
    transformations: {
      includeMetadata: true,
      customFields: [
        {
          name: 'seller_address',
          path: 'events[0].source',
          type: 'string'
        },
        {
          name: 'buyer_address',
          path: 'events[0].destination',
          type: 'string'
        },
        {
          name: 'sale_amount',
          path: 'events[0].amount',
          type: 'numeric'
        }
      ]
    }
  })
});

const data = await response.json();
console.log('Indexer created:', data);

blockchain-indexer/
├── backend/
│   ├── src/
│   │   ├── auth/              # Authentication module
│   │   ├── database/          # Database connection management
│   │   ├── helius/            # Helius API integration
│   │   ├── indexer/           # Core indexing logic
│   │   ├── webhook/           # Webhook processing
│   │   └── main.ts            # Application entry point
│   └── ...
├── frontend/
│   ├── src/
│   │   ├── components/        # React components
│   │   ├── pages/             # Next.js page components
│   │   ├── services/          # API service integrations
│   │   └── ...
│   └── ...
└── ...

1. Fork and clone the repository
2. Set up the backend and frontend as described in the installation section
3. Create a new branch for your feature or bug fix
4. Make your changes
5. Run tests to ensure everything works correctly
6. Submit a pull request

# Backend tests
cd backend
npm run test

# Frontend tests
cd frontend
npm run test

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Helius - For their powerful Solana blockchain API
• NestJS - For the backend framework
• Next.js - For the frontend framework
• All contributors who have helped shape this project

For any questions or support, please open an issue or contact the maintainers at Sweta Karar.