Skip to content

Open-source blockchain indexer for the Blocksquare ecosystem. Tracks BST token activity, property tokenization events, staking pools, governance, and DeFi metrics across multiple chains. Built with Envio for real-time data aggregation, providing comprehensive insights into real estate tokenization, staking rewards, and ecosystem analytics.

License

Notifications You must be signed in to change notification settings

blocksquare/blocksquare-indexer

Repository files navigation

Blocksquare Ecosystem Indexer

A high-performance blockchain indexer for the Blocksquare ecosystem, built with Envio. Tracks and aggregates real-time on-chain data for property tokenization, DeFi operations, and marketplace activities on Ethereum and Sepolia networks.

🎯 What It Does

  • Real Estate Tokenization: Indexes tokenized properties with valuations, ownership, and revenue distribution
  • DeFi Tracking: Monitors BST staking, liquidity pools, and governance participation
  • Marketplace Analytics: Tracks property offerings, certified partners, and secondary market trades
  • Price Aggregation: Real-time BST and asset price feeds from Chainlink and Uniswap

🚀 Quick Start

  1. Clone the repository:
git clone https://github.com/blocksquare/blocksquare-indexer.git
cd blocksquare-indexer
  1. Install dependencies:
pnpm install
  1. Configure environment:
cp .env.example .env
# Defaults to mainnet, change to testnet if needed
  1. Generate configuration:
pnpm run config
  1. Generate types and start indexing:
pnpm run codegen
pnpm run dev

🏃 Running the Indexer

Development Mode

Run the indexer in development mode with hot reload:

pnpm run dev

Production Mode

Build and start the indexer:

pnpm run build
pnpm run start

Testing

Run the test suite:

pnpm run test

📊 GraphQL API

Query indexed data through the GraphQL endpoint:

  • PropertyToken: Token details, valuations, holders, trades
  • PropertyTokenOffering: Investment rounds and claims
  • AssetPair: Real-time BST and asset prices
  • Staking & Revenue: Pool activities, rewards, and distributions
  • CertifiedPartner: Marketplace operators and properties

🔧 Configuration

Networks

  • Mainnet: Full ecosystem with price feeds
  • Sepolia Testnet: Development and testing

Environment Variables

See .env.example for all configuration options including custom RPC endpoints and API keys.

🤝 Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes with tests
  4. Submit a Pull Request

📄 License

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

🔗 Resources

About

Open-source blockchain indexer for the Blocksquare ecosystem. Tracks BST token activity, property tokenization events, staking pools, governance, and DeFi metrics across multiple chains. Built with Envio for real-time data aggregation, providing comprehensive insights into real estate tokenization, staking rewards, and ecosystem analytics.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •