feat: horizon support

.gitignore

@@ -120,3 +120,7 @@ yalc.lock
 .idea/
 .envrc
 .vscode
+
+# local-network override mode files
+tap-contracts.json
+config/config.yaml

CLAUDE.md

@@ -8,11 +8,10 @@ This is the Graph Protocol Indexer monorepo containing the indexer agent, CLI, a
 
 ## Repository Structure
 
-- **`/packages/`** - Lerna monorepo with 4 packages:
+- **`/packages/`** - Lerna monorepo with 3 active packages:
   - **`indexer-agent/`** - Main indexer agent that manages allocations and monitors the network
   - **`indexer-cli/`** - CLI for managing indexer operations (plugin for @graphprotocol/graph-cli)
   - **`indexer-common/`** - Shared functionality used by other packages
-  - **`indexer-native/`** - Listed but directory doesn't exist (deprecated)
 - **`/docs/`** - Documentation including network configs and setup guides
 - **`/k8s/`** - Kubernetes deployment configurations
 - **`/terraform/`** - Infrastructure as Code for GKE deployment
@@ -59,9 +58,10 @@ yarn test:debug
 ### Code Quality
 ```bash
 # In any package directory
-yarn lint      # Lint and fix TypeScript files
 yarn format    # Format code with Prettier
+yarn lint      # Lint and fix TypeScript files
 yarn prepare   # Run format, lint, and compile
+yarn clean     # Clean build artifacts and node_modules
 ```
 
 ### Running the Indexer
@@ -113,6 +113,14 @@ The indexer uses PostgreSQL to store:
 - POI dispute data
 - TAP receipts and RAVs (Receipt Aggregate Vouchers)
 
+Database migrations are managed via Umzug. Available migration commands in `indexer-agent`:
+```bash
+yarn migrator:pending   # View pending migrations
+yarn migrator:executed  # View executed migrations
+yarn migrator:up        # Run pending migrations
+yarn migrator:down      # Rollback last migration
+```
+
 ### Integration Points
 - **Graph Node**: Queries subgraph data and manages deployments
 - **Ethereum/Arbitrum**: On-chain transactions for allocations
@@ -123,15 +131,86 @@ The indexer uses PostgreSQL to store:
 ## Testing Requirements
 
 Tests require:
-1. PostgreSQL database (handled by `scripts/run-tests.sh`)
-2. Environment variables in `.env`:
+1. Docker installed and running
+2. PostgreSQL database (handled by `scripts/run-tests.sh`)
+3. Environment variables in `.env` (copy from `.env.example`):
    ```
    INDEXER_TEST_JRPC_PROVIDER_URL=<Arbitrum Sepolia RPC>
    INDEXER_TEST_API_KEY=<Graph API key>
    ```
 
+The `scripts/run-tests.sh` script:
+- Starts a PostgreSQL container with test configuration
+- Loads credentials from `.env`
+- Runs the test suite with proper environment variables
+- Cleans up the PostgreSQL container when done
+
+## Horizon Support
+
+The indexer now supports Graph Horizon, the next-generation architecture for The Graph Protocol:
+
+### Key Changes
+- **Dual Contract System**: Supports both legacy and Horizon contracts simultaneously
+- **New Contracts**: HorizonStaking, SubgraphService, PaymentsEscrow, GraphTallyCollector
+- **Enhanced TAP v2**: Receipt Aggregate Vouchers v2 (RAV v2) with collection-based aggregation
+- **Automatic Detection**: System automatically detects Horizon-enabled networks
+- **Address Books**: Separate configuration for horizon, subgraph-service, and TAP contracts
+
+### Configuration
+```bash
+# New Horizon-specific options
+--horizon-address-book           # Path to Horizon contracts address book
+--subgraph-service-address-book  # Path to SubgraphService contracts address book
+--tap-address-book               # Path to TAP contracts address book
+--max-provision-initial-size    # Initial SubgraphService provision size
+--payments-destination           # Separate payment collection address
+```
+
+### Database Migrations
+- Migration 21: Adds TAP Horizon tables for receipts and RAVs
+- Migration 22: Adds TAP Horizon deny list functionality
+
+## Package Architecture
+
+### indexer-common
+Core shared library providing:
+- **Allocations**: Horizon and legacy allocation management (`allocations/`)
+  - TAP collector for query fee collection
+  - Graph tally collector for aggregating receipts
+  - Escrow account management for both Horizon and legacy
+- **Indexer Management**: GraphQL server and resolvers for managing indexer operations
+  - Action queue management
+  - Allocation lifecycle
+  - Indexing rules
+  - Cost models
+- **Network**: Network subgraph queries and protocol interactions
+- **Graph Node**: Graph Node status and deployment management APIs
+- **Subgraphs**: Subgraph deployment utilities and helpers
+- **Transactions**: Ethereum transaction management with gas optimization
+
+### indexer-agent
+Autonomous agent that:
+- Monitors network for subgraph deployments via network subgraph
+- Manages allocations based on indexing rules (automatic or manual mode)
+- Collects query fees via TAP protocol
+- Submits POIs (Proofs of Indexing) on-chain
+- Handles disputes monitoring
+- Manages Graph Node deployments
+
+### indexer-cli
+Command-line interface providing commands for:
+- Indexing rules management (`graph indexer rules`)
+- Allocation management (`graph indexer allocations`)
+- Action queue operations (`graph indexer actions`)
+- Cost model configuration (`graph indexer cost`)
+- Provision management for Horizon (`graph indexer provision`)
+- Status monitoring (`graph indexer status`)
+- Disputes monitoring (`graph indexer disputes`)
+
 ## Current State
 - Version: v0.24.3
-- Active branch: release-v0.24
+- Node version: >=18.0.0
 - Main branch: main
-- Uncommitted changes in docs/ and config/
+- Package manager: Yarn 1.22.22
+- Beta software status
+- Horizon support: Active on supported networks