Lux Graph Node - Blockchain Data Indexing via GraphQL

[workspace]
members = [
    "core",               # Core implementations
    "core/graphman",      # Graph manager CLI
    "core/graphman_store",# Graph manager store
    "chain/*",            # Chain adapters
    "graphql",            # GraphQL implementation
    "node",               # Local graph node binary
    "runtime/*",          # WASM mapping runtime
    "server/*",           # HTTP/WS/admin servers
    "store/*",            # PostgreSQL store
    "substreams/*",       # Substreams integration
    "graph",              # Core library (traits, types)
    "tests",              # Integration tests
    "graph/derive",       # Derive macros
]

git clone https://github.com/luxfi/graph-node.git
cd graph-node
cargo build --release

# Prerequisites: PostgreSQL running, IPFS daemon running

# Create database
createdb graph-node

# Required PostgreSQL extensions (as superuser)
psql -U postgres graph-node <<EOF
CREATE EXTENSION pg_trgm;
CREATE EXTENSION pg_stat_statements;
CREATE EXTENSION btree_gist;
CREATE EXTENSION postgres_fdw;
GRANT USAGE ON FOREIGN DATA WRAPPER postgres_fdw TO your_user;
EOF

# Run graph-node pointing at Lux C-Chain
cargo run -p graph-node --release -- \
  --postgres-url postgresql://user:pass@localhost:5432/graph-node \
  --ethereum-rpc lux:https://api.lux.network/ext/bc/C/rpc \
  --ipfs 127.0.0.1:5001

cd docker
# Follow instructions in docker/README.md
# Starts PostgreSQL, IPFS, and graph-node
docker-compose up -d

graph-node
├── node/       — Local graph node binary
├── graph/      — Core library: traits, types, shared abstractions
├── core/       — Core component implementations
├── chain/      — Chain-specific adapters (ethereum, near, cosmos, etc.)
├── graphql/    — GraphQL implementation (schema gen, introspection, queries)
├── runtime/    — WASM mapping execution (AssemblyScript subgraph handlers)
├── server/     — HTTP, WebSocket, and admin JSON-RPC servers
├── store/      — PostgreSQL store with GraphQL-friendly interface
├── substreams/ — Substreams-powered indexing
├── docker/     — Docker Compose setup
├── docs/       — Documentation
├── resources/  — Static resources
└── tests/      — Integration tests

graph-node [FLAGS] [OPTIONS]
  --postgres-url <URL>           PostgreSQL connection string
  --ethereum-rpc <NAME:[CAPS]:URL>  Ethereum/EVM RPC endpoint
  --ethereum-ws <NAME:[CAPS]:URL>   Ethereum/EVM WebSocket endpoint
  --ethereum-ipc <NAME:[CAPS]:FILE> Ethereum/EVM IPC pipe
  --ipfs <HOST:PORT>             IPFS node address
  --http-port <PORT>             GraphQL HTTP port [default: 8000]
  --ws-port <PORT>               GraphQL WebSocket port [default: 8001]
  --admin-port <PORT>            Admin JSON-RPC port [default: 8020]
  --node-id <NODE_ID>            Unique node identifier [default: default]
  --debug                        Enable debug logging

--ethereum-rpc NETWORK_NAME:[CAPABILITIES]:URL

# Examples:
--ethereum-rpc lux:full,archive:https://api.lux.network/ext/bc/C/rpc
--ethereum-rpc mainnet:https://eth-mainnet.g.alchemy.com/v2/KEY

# In subgraph project directory
yarn codegen          # Generate types from ABIs
yarn create-local     # Register subgraph
yarn deploy-local     # Build and deploy