Operations and Releases
Covers indexer client releases, Graph Node software upgrades, allocation optimization tooling, and operational best practices for network participants including indexers, delegators, and gateway operators. Exchange and wallet teams integrating subgraph data rely on this group to anticipate API deprecations, performance regressions, and indexing behavior changes that could disrupt their services. This group focuses on the software and operational layer rather than protocol rules or governance.
Graph Node Release Notes and Changelog
Chronological index of graph-node releases detailing breaking changes, new features, performance improvements, and bug fixes. Indexers and gateway operators use this as the primary reference for planning upgrades and assessing compatibility risks. Chainscore can provide upgrade readiness reviews for teams managing production indexer infrastructure.
Graph Node Upgrade Guide and Migration Paths
Practical step-by-step guide for indexers upgrading graph-node instances, covering database migrations, configuration file changes, deprecated features, and rollback procedures. Affects all indexers and gateway operators who must minimize indexing downtime. Chainscore can assist with migration planning and pre-upgrade staging validation.
Graph Node Deprecation Schedule and End-of-Life Policy
Timeline and policy document outlining which graph-node versions are deprecated, when support ends, and when they become network-incompatible. Critical for exchange and wallet teams to plan infrastructure maintenance windows and avoid service disruptions. Chainscore can help teams audit their current versions and build upgrade roadmaps.
Graph Node Performance Tuning and Configuration
Deep dive into graph-node configuration options including database connection pooling, JSON-RPC provider settings, block ingestion concurrency, and caching strategies. Helps indexers optimize for high throughput and low latency. Chainscore can conduct performance audits and recommend tuning profiles for specific indexing workloads.
Graph Node Monitoring and Observability
Guide on built-in metrics, logging formats, and health-check endpoints exposed by graph-node, including Prometheus/Grafana dashboard templates and alerting thresholds. Indexers and gateway operators depend on this to detect indexing errors and performance regressions. Chainscore can design monitoring setups and incident response runbooks.
Indexer Agent Release Notes
Versioned history of indexer-agent software detailing changes to allocation management, cost model logic, and protocol interaction behavior. Indexers rely on this to automate economic strategies correctly. Chainscore can review agent configurations for compatibility with new releases and protocol parameter changes.
Indexer Service and CLI Tooling Updates
Tracking the evolution of indexer-service query endpoints and indexer-cli administrative commands, covering query routing, rate-limiting, and operational tooling changes. Gateway operators and indexers use these daily. Chainscore can assess integration impacts for teams running custom query routing or automation.
Indexer Stack Deployment Patterns and Containerization
Canonical reference for deploying the full indexer stack using Docker Compose and Kubernetes, with production-ready templates and resource allocation recommendations. Affects indexers building or scaling infrastructure. Chainscore can review deployment architectures for security, resilience, and upgrade readiness.
Indexer Allocation Optimization Strategies
Technical analysis of the allocation lifecycle including subgraph selection criteria, optimal stake allocation, and gas-efficient batching of allocation transactions. Helps indexers maximize indexing rewards and query fee revenue. Chainscore can model allocation scenarios and review economic strategies.
Cost Model Design and Implementation
Guide on building and tuning the Agora cost model that dictates how indexers price queries, covering market analysis, competitor benchmarking, and automated adjustment strategies. Directly impacts indexer profitability and gateway operator costs. Chainscore can audit cost model configurations for competitiveness and compliance.
Query Fee Collection and Settlement Mechanics
Detailed explanation of how query fees are collected via state channels, settled on-chain, and distributed to indexers and delegators. Essential for gateway operators and indexers to understand cash flow, proof of payment, and dispute resolution. Chainscore can help teams verify settlement implementations and monitor payment channel health.
Delegator Operations and Indexer Selection
Practical guide for delegators on monitoring indexer performance, assessing slashing risk, evaluating query fee rebates, and automating delegation decisions. Bridges protocol rules with day-to-day operational actions. Chainscore can build delegation monitoring dashboards and risk assessment frameworks.
Network Subgraph Query Gateway Operations
Page focused on operating a gateway that routes queries to the decentralized network, covering service discovery, indexer health checking, query planning, and failover strategies. Critical for dApps and services requiring high availability. Chainscore can review gateway architectures and design fallback strategies.
Subgraph Studio API Deprecation and Migration Guide
Resource for development teams tracking API versioning, sunsetting timelines for deprecated endpoints, and migration paths to new GraphQL schemas or authentication methods. Affects all teams migrating from the hosted service. Chainscore can assist with migration planning and integration testing.
GraphQL Query Performance and Optimization for Consumers
Guide for dApp, wallet, and exchange teams on writing efficient GraphQL queries, covering common anti-patterns, pagination best practices, and query trace interpretation. Reduces latency and cost for subgraph consumers. Chainscore can audit query patterns and recommend optimization strategies.
Firehose and Substreams Operational Integration
Page for advanced indexers and data teams on deploying and managing Firehose and Substreams infrastructure, covering gRPC endpoint configuration and data throughput tuning. Enables high-performance extraction before indexing. Chainscore can review Firehose deployments and troubleshoot integration issues.
Indexer Onboarding and Offboarding Procedures
Step-by-step operational checklist for joining the network as an indexer, including wallet setup, staking, initial allocation, and graceful exit without slashing. Essential for new indexers and those winding down operations. Chainscore can guide teams through the full onboarding or offboarding lifecycle.
Gateway Operator Playbook for Service Disruptions
Runbook for gateway operators handling graph-node outages, network forks, or subgraph indexing failures, detailing fallback strategies, caching approaches, and user communication templates. Critical for maintaining dApp reliability. Chainscore can help design and test disruption response procedures.
Exchange and Wallet Subgraph Integration Guide
Focused guide for exchanges and wallets consuming subgraph data for transaction history and balance tracking, covering error handling, RPC verification, stalled subgraph detection, and circuit breakers. Prevents displaying incorrect on-chain data to users. Chainscore can audit integration patterns and recommend safety controls.
Testnet Operations and Staging Environments
Guide on participating in The Graph testnets for validating new software releases, testing subgraph deployments, and simulating economic scenarios before mainnet activation. Crucial for preventing production incidents. Chainscore can help teams establish staging environments and run pre-release validation.
Ethereum Client Compatibility and RPC Requirements
Matrix documenting which Ethereum execution and consensus clients and versions are compatible with each graph-node release. A primary source of indexing failures when mismatched. Chainscore can audit client configurations and recommend compatible RPC provider setups.
Multi-Chain Indexing Configuration and RPC Provider Management
Operational guide for configuring graph-node to index multiple L1s and L2s simultaneously, covering RPC provider endpoint management and chain-specific quirks. Affects indexers scaling across ecosystems. Chainscore can review multi-chain architectures and optimize resource allocation.
Database Backup, Restore, and Disaster Recovery
Comprehensive guide on PostgreSQL backup strategies, point-in-time recovery procedures, and disaster recovery planning for indexer databases containing full indexed state. Critical for business continuity. Chainscore can design and validate backup and recovery procedures.
Indexer Security Hardening Checklist
Security-focused operations guide covering firewall rules, API authentication, secret management for operator wallets, and DDoS protection for query endpoints. Protects indexer revenue and data integrity. Chainscore can conduct security reviews of indexer infrastructure and recommend hardening measures.