Skip to content

Conversation

@suchapalaver
Copy link
Contributor

@suchapalaver suchapalaver commented Dec 11, 2025

Updates the GraphTally documentation for the post-Horizon protocol upgrade.

  • Reframe documentation around Graph Horizon integration with link to Horizon overview
  • Update contract addresses table to distinguish V1 and V2 TAP Verifiers
  • Add required receipts_verifier_address_v2 to config example (fixes startup failure when
    horizon.enabled = true)
  • Add note clarifying that escrow data is now included in Network Subgraph with Horizon
  • Add GraphOps gateway aggregator endpoint
  • Add subgraph_service_address and [horizon].enabled = true to config example
  • Document operator_mnemonics for key rotation support
  • Streamline from "Migration Guide" to "Getting Started" for cleaner onboarding

Signed off by Joseph Livesey joseph@semiotic.ai

   - Remove legacy V1 content (contracts,
   separate escrow subgraph)
   - Add Graph Horizon context and link to
   overview
   - Simplify to Horizon-first configuration with
    horizon.enabled = true
   - Add GraphOps gateway aggregator endpoint
   - Document operator_mnemonics for key rotation
   - Streamline architecture overview and getting
    started
   - Remove migration framing in favor of current
    setup guide
   - Add TAP Verifier, Subgraph Service, and
   Escrow contract addresses
   - Update config example to use Horizon V2
   addresses
   - Include both mainnet and testnet addresses
@suchapalaver suchapalaver requested a review from a team as a code owner December 11, 2025 18:30
@benface
Copy link
Contributor

benface commented Dec 11, 2025

Thank you for the PR @suchapalaver! Can you please run pnpm format to satisfy the CI check?

   Add missing receipts_verifier_address_v2
   required when horizon.enabled = true.
   Without this, indexer-service-rs fails at
   startup. Also clarifies V1 vs V2
   verifier distinction in contracts table and
   adds note about escrow subgraph.
   Document the critical requirement that both indexer-service-rs
   and
   indexer-tap-agent must have Horizon enabled for V2 receipts to
   work.
   Includes configuration checklist, log verification examples, and
   troubleshooting for common misconfigurations.
@suchapalaver
Copy link
Contributor Author

This is good to go from our end @benface 🫡

Copy link
Contributor

@benface benface left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🙌

@benface benface merged commit 0b44d80 into graphprotocol:main Dec 12, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants