NPM

npm install -g @graphprotocol/indexer-agent@0.17.0
npm install -g @graphprotocol/indexer-cli@0.17.0
npm install -g @graphprotocol/indexer-service@0.17.0

Note: Installing these packages requires Rust and it's package manager cargo to be installed so that the cost model module can be built. If you already have Rust installed, make sure you're on the latest stable release. Installing the above packages may also require passing --unsafe-perm=true to the above install commands.

Docker

docker pull ghcr.io/graphprotocol/indexer-agent:v0.17.0
docker pull ghcr.io/graphprotocol/indexer-service:v0.17.0

Changes (Overview)

This release primarily contains updates to the indexer agent to improve efficiency. The process of reallocating towards a subgraph deployment has been updated to use closeAndAllocate(), so it requires one transaction instead of two (close then allocate). Handling of high gas price scenarios has also been improved; when estimated gas prices exceed the threshold the agent will now enter a holding pattern where it waits for gas prices to return to below the gas-price-max before continuing with transaction execution. Along with the updated behavior, the gas-price-max startup argument has been updated for ease of use to be denominated in gwei rather than wei.

There were a few additional minor improvements to indexer agent:

• improved handling of empty auth fields for the Ethereum endpoint,
• more clear log messages from subgraph query errors.

Some networking optimizations have been included for both the indexer service and indexer agent:

• both recommended k8s setups have both been updated to use a ClusterIP service instead of LoadBalancer since the LoadBalancer services have been shown to introduce more latency and their extra features aren't required here,
• /network execution has been optimized by switching to a simpler HTTP client (doesn't need to be GraphQL aware).

As promised in the last release, this release includes an update to make the /network endpoint optional and introduces a dedicated (optional) auth token for /network requests.

New configuration options with this release (all optional):

Changes (Per Component)

Indexer Agent

Added

• Reallocate to subgraph deployment in one transaction using closeAndAllocate.
• Wait for gas prices below the gas-price-max (gwei) before proceeding with transaction execution.
• Add --voucher-expiration to configure the time (in seconds) after which a voucher with too few query fees is permanently deleted. Until then, keep retrying to redeem it to give the indexer a chance to adjust their --allocation-claim-threshold.

Changed

• Show subgraph query error reason in logs.
• Use ClusterIP in the k8s indexer agent service rather than a LoadBalalancer since LoadBalancer services have been
  shown to introduce extra latency.
• Use undefined for auth user and password if none specified.
• Update gas-price-max units to be gwei instead of wei for improved human readability.
• Default gas-price-max changed from 20 gwei to 50 gwei.

Fixed

• Improve robustness of subgraph deployments query by querying batches of only 10 deployments at a time.

Indexer Service

Changed

• Make the /network endpoint optional by default and introduce a dedicated (optional) auth token for /network requests.
• Optimize /network execution by switching to a simpler HTTP client (doesn't need to be GraphQL aware).
• Use ClusterIP in the k8s indexer service service rather than a LoadBalalancer since LoadBalancer services have been
  shown to introduce extra latency.

Indexer CLI

Fixed

• Remove vestigial check for channel-messages-inbox endpoint.

Indexer Common

Changed

• Optimize /network execution by switching to a simpler HTTP client (doesn't need to be GraphQL aware).

Indexer Native

Fixed

• Fix build for Node v16 by upgrading neon-sys dependency.