diff --git a/docs/networks.md b/docs/networks.md index 47cdd8583..55e79382f 100644 --- a/docs/networks.md +++ b/docs/networks.md @@ -1,11 +1,7 @@ # Mainnet and Testnet Configuration -[Ethereum Mainnet configuration](./networks/ethereum-mainnet.md) - [Arbitrum One configuration](./networks/arbitrum-one.md) -[Ethereum Sepolia configuration](./networks/ethereum-sepolia.md) - [Arbitrum Sepolia configuration](./networks/arbitrum-sepolia.md) [Testnet setup instructions](./testnet-setup.md) diff --git a/docs/networks/arbitrum-one.md b/docs/networks/arbitrum-one.md index 45a7a4eac..11e1ed9b3 100644 --- a/docs/networks/arbitrum-one.md +++ b/docs/networks/arbitrum-one.md @@ -7,10 +7,10 @@ Network information can be found at https://thegraph.com/explorer?chain=arbitrum | Component | Release | | --------------- | ---------------------------------------------------------------------------- | | contracts | [1.11.1](https://github.com/graphprotocol/contracts/releases/tag/v1.11.1) | -| indexer-agent | [0.21.3](https://github.com/graphprotocol/indexer/releases/tag/v0.21.3) | -| indexer-cli | [0.21.3](https://github.com/graphprotocol/indexer/releases/tag/v0.21.3) | -| indexer-service | [0.21.3](https://github.com/graphprotocol/indexer/releases/tag/v0.21.3) | -| graph-node | [0.34.0](https://github.com/graphprotocol/graph-node/releases/tag/v0.34.0) | +| indexer-agent | [0.21.4](https://github.com/graphprotocol/indexer/releases/tag/v0.21.4) | +| indexer-cli | [0.21.4](https://github.com/graphprotocol/indexer/releases/tag/v0.21.4) | +| indexer-service | [0.21.4](https://github.com/graphprotocol/indexer/releases/tag/v0.21.4) | +| graph-node | [0.35.1](https://github.com/graphprotocol/graph-node/releases/tag/v0.35.1) | ## Network Parameters diff --git a/docs/networks/arbitrum-sepolia.md b/docs/networks/arbitrum-sepolia.md index 76e7853af..cffdb9d45 100644 --- a/docs/networks/arbitrum-sepolia.md +++ b/docs/networks/arbitrum-sepolia.md @@ -7,10 +7,10 @@ The Graph Network's testnet is on Arbitrum Sepolia (eip155:421614). Sepolia netw | Component | Release | | --------------- | ------------------------------------------------------------------------------------ | | contracts | [5.3.3](https://github.com/graphprotocol/contracts/releases/tag/v5.3.3) | -| indexer-agent | [0.21.4-rc](https://github.com/graphprotocol/indexer/releases/tag/v0.21.4-rc) | -| indexer-cli | [0.21.4-rc](https://github.com/graphprotocol/indexer/releases/tag/v0.21.4-rc) | -| indexer-service | [0.21.4-rc](https://github.com/graphprotocol/indexer/releases/tag/v0.21.4-rc) | -| graph-node | [0.35.0-rc.0](https://github.com/graphprotocol/graph-node/releases/tag/v0.35.0-rc.0) | +| indexer-agent | [0.21.4](https://github.com/graphprotocol/indexer/releases/tag/v0.21.4) | +| indexer-cli | [0.21.4](https://github.com/graphprotocol/indexer/releases/tag/v0.21.4) | +| indexer-service | [0.21.4](https://github.com/graphprotocol/indexer/releases/tag/v0.21.4) | +| graph-node | [0.35.1](https://github.com/graphprotocol/graph-node/releases/tag/v0.35.1) | ## Network Parameters diff --git a/docs/networks/ethereum-mainnet.md b/docs/networks/ethereum-mainnet.md deleted file mode 100644 index 9c441ae87..000000000 --- a/docs/networks/ethereum-mainnet.md +++ /dev/null @@ -1,77 +0,0 @@ -# Mainnet Configuration - -Network information can be found at https://thegraph.com/explorer?chain=mainnet. The Graph Network mainnet is open for everyone to participate in as an indexer. The only requirement is a minimum stake of 100k GRT. - -## Latest Releases - -| Component | Release | -| --------------- | ---------------------------------------------------------------------------- | -| contracts | [1.11.1](https://github.com/graphprotocol/contracts/releases/tag/v1.11.1) | -| indexer-agent | [0.21.3](https://github.com/graphprotocol/indexer/releases/tag/v0.21.3) | -| indexer-cli | [0.21.3](https://github.com/graphprotocol/indexer/releases/tag/v0.21.3) | -| indexer-service | [0.21.3](https://github.com/graphprotocol/indexer/releases/tag/v0.21.3) | -| graph-node | [0.34.0](https://github.com/graphprotocol/graph-node/releases/tag/v0.34.0) | - -## Network Parameters - -| Parameter | Value | -| --------------------------- | -------------------- | -| Epoch length | ~ 24h (6646 blocks) | -| Maximum allocation lifetime | ~28 days (28 epochs) | - -## Contracts & accounts - -| Name | Address | -| ------------------ | ----------------------------------------------------------------------------------------------------------------------- | -| Graph Token (GRT) | [`0xc944E90C64B2c07662A292be6244BDf05Cda44a7`](https://etherscan.io/address/0xc944e90c64b2c07662a292be6244bdf05cda44a7) | -| Staking | [`0xF55041E37E12cD407ad00CE2910B8269B01263b9`](https://etherscan.io/address/0xF55041E37E12cD407ad00CE2910B8269B01263b9) | -| Data Edge | [`0xADE906194C923b28F03F48BC5D9D987AAE21fFab`](https://etherscan.io/address/0xADE906194C923b28F03F48BC5D9D987AAE21fFab) | -| Block Oracle Owner | [`0xeb4ad97a099defc85c900a60adfd2405c455b2c0`](https://etherscan.io/address/0xeb4ad97a099defc85c900a60adfd2405c455b2c0) | - -Other network contracts can be found in [graphprotocol/contracts](https://github.com/graphprotocol/contracts/blob/dev/addresses.json). - -## Configuration - -### Indexer Agent - -| Environment Variable | CLI Argument | Value | -| ------------------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | -| `INDEXER_AGENT_ETHEREUM` | `--ethereum` | An Ethereum mainnet node/provider | -| `INDEXER_AGENT_INDEXER_ADDRESS` | `--indexer-address` | Ethereum address of mainnet indexer | -| `INDEXER_AGENT_INDEXER_GEO_COORDINATES` | `--indexer-geo-coordinates` | Geo coordinates of mainnet indexer infrastructure | -| `INDEXER_AGENT_MNEMONIC` | `--mnemonic` | Ethereum mnemonic for mainnet operator | -| `INDEXER_AGENT_NETWORK_SUBGRAPH_DEPLOYMENT` | `--network-subgraph-deployment` | `QmWaCrvdyepm1Pe6RPkJFT3u8KmaZahAvJEFCt27HRWyK4` | -| `INDEXER_AGENT_NETWORK_SUBGRAPH_ENDPOINT` | `--network-subgraph-endpoint` | `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/9Co7EQe5PgW3ugCUJrJgRv4u9zdEuDJf8NvMWftNsBH8` | -| `INDEXER_AGENT_DAI_CONTRACT` | `--dai-contract` | `0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48` (USDC) | -| `INDEXER_AGENT_GATEWAY_ENDPOINT` | `--gateway-endpoint` | `https://gateway.network.thegraph.com/` | -| `INDEXER_AGENT_GAS_PRICE_MAX` | `--gas-price-max` | `50` | -| `INDEXER_AGENT_EPOCH_SUBGRAPH_ENDPOINT` | `--epoch-subgraph-endpoint` | `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/Fg36gCZE7pXEuZ3p8sxYzFE5UbgHtk7kcJiC5HBbfgmY` | - -In order to avoid collecting or claiming query fees below a certain threshold -(e.g. below the cost of the two transactions), the following configuration -option can be used. - -| Environment Variable | CLI Argument | Value | -| -------------------------------------------- | --------------------------------- | ----------------------------------------------------------------------------------------- | -| `INDEXER_AGENT_REBATE_CLAIM_THRESHOLD` | `--rebate-claim-threshold` | Minimum rebate (in GRT) received for an allocation to claim (Default: 1) | -| `INDEXER_AGENT_REBATE_CLAIM_BATCH_THRESHOLD` | `--rebate-claim-batch-threshold` | Minimum total rebates (in GRT) before a batched claim is processed (Default: 5) | -| `INDEXER_AGENT_VOUCHER_EXPIRATION` | `--voucher-expiration` | Time (in seconds) to permanently delete vouchers with too few query fees (Default: 2160) | - -### Indexer Service - -| Environment Variable | CLI Argument | Value | -| --------------------------------------------- | ------------------------------- | ------------------------------------------------ | -| `INDEXER_SERVICE_ETHEREUM` | `--ethereum` | An Ethereum mainnet node/provider | -| `INDEXER_SERVICE_INDEXER_ADDRESS` | `--indexer-address` | Ethereum address of mainnet indexer | -| `INDEXER_SERVICE_MNEMONIC` | `--mnemonic` | Ethereum mnemonic for mainnet operator | -| `INDEXER_SERVICE_NETWORK_SUBGRAPH_DEPLOYMENT` | `--network-subgraph-deployment` | `QmWaCrvdyepm1Pe6RPkJFT3u8KmaZahAvJEFCt27HRWyK4` | -| `INDEXER_SERVICE_NETWORK_SUBGRAPH_ENDPOINT` | `--network-subgraph-endpoint` | `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/9Co7EQe5PgW3ugCUJrJgRv4u9zdEuDJf8NvMWftNsBH8` | -| `INDEXER_SERVICE_CLIENT_SIGNER_ADDRESS` | `--client-signer-address` | `0x982D10c56b8BBbD6e09048F5c5f01b43C65D5aE0` | - -### Graph Node - -| Environment Variable | CLI Argument | Value | -| -------------------- | ---------------- | ----------------------------------- | -| `ethereum` | `--ethereum-rpc` | `mainnet:` | -| `ipfs` | `--ipfs` | `https://ipfs.network.thegraph.com` | - diff --git a/docs/networks/ethereum-sepolia.md b/docs/networks/ethereum-sepolia.md deleted file mode 100644 index 531f8e304..000000000 --- a/docs/networks/ethereum-sepolia.md +++ /dev/null @@ -1,108 +0,0 @@ -# Testnet Configuration - -The Graph Network's testnet is on Sepolia (eip155:11155111). Sepolia network information can be found at https://testnet.thegraph.com/explorer?chain=sepolia. - -## Latest Releases - -| Component | Release | -| --------------- | ------------------------------------------------------------------------------------ | -| contracts | [5.3.3](https://github.com/graphprotocol/contracts/releases/tag/v5.3.3) | -| indexer-agent | [0.21.3](https://github.com/graphprotocol/indexer/releases/tag/v0.21.3) | -| indexer-cli | [0.21.3](https://github.com/graphprotocol/indexer/releases/tag/v0.21.3) | -| indexer-service | [0.21.3](https://github.com/graphprotocol/indexer/releases/tag/v0.21.3) | -| graph-node | [0.35.0-rc.0](https://github.com/graphprotocol/graph-node/releases/tag/v0.35.0-rc.0) | - -## Network Parameters - -| Parameter | Value | -| --------------------------- | ----------------- | -| Epoch length | ~ 2h (554 blocks) | -| Maximum allocation lifetime | ~ 9h (4 epochs) | - -## Contracts & accounts - -| Name | Address | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------------- | -| Graph Token (GRT ) | [`0xCA59cCeb39bE1808d7aA607153f4A5062daF3a83`](https://sepolia.etherscan.io/address/0xCA59cCeb39bE1808d7aA607153f4A5062daF3a83) | -| Staking | [`0x14e9B07Dc56A0B03ac8A58453B5cCCB289d6ec90`](https://sepolia.etherscan.io/address/0x14e9B07Dc56A0B03ac8A58453B5cCCB289d6ec90) | -| Data Edge | [`0xEFC8D47673777b899f2FB597C6FC0E87ecce98Cb`](https://sepolia.etherscan.io/address/0xEFC8D47673777b899f2FB597C6FC0E87ecce98Cb) | -| Block Oracle Owner | [`0xC9d59d6D2D43105357a1D9C15244751A4517f42C`](https://sepolia.etherscan.io/address/0xfA711DA0f9336f27E7B7483398cbd8F0880f259a) | - -Other network contracts can be found in [graphprotocol/contracts](https://github.com/graphprotocol/contracts/blob/main/addresses.json#L1426-L1645). - -## Configuration - -The Graph testnet contracts live on Sepolia, but many of the subgraphs used in the -testnet (for now) are Mainnet subgraphs. This means: - -- Indexer Agent and Indexer Service must connect to Sepolia -- Graph Node must connect to at least one Mainnet Ethereum node/provider - -### Indexer Agent - -| Environment Variable | CLI Argument | Value | -| ------------------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -| `INDEXER_AGENT_ETHEREUM` | `--ethereum` | An Ethereum Sepolia node/provider | -| `INDEXER_AGENT_INDEXER_ADDRESS` | `--indexer-address` | Ethereum address of testnet indexer | -| `INDEXER_AGENT_INDEXER_GEO_COORDINATES` | `--indexer-geo-coordinates` | Geo coordinates of testnet indexer infrastructure | -| `INDEXER_AGENT_MNEMONIC` | `--mnemonic` | Ethereum mnemonic for testnet operator | -| `INDEXER_AGENT_NETWORK_SUBGRAPH_DEPLOYMENT` | `--network-subgraph-deployment` | `QmP3Vf8hp3FDHhmZ2JvZd1NbDC27CTkp2uK1TQcCYB8GCo` | -| `INDEXER_AGENT_NETWORK_SUBGRAPH_ENDPOINT` | `--network-subgraph-endpoint` | `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/8pVKDwHniAz87CHEQsiz2wgFXGZXrbMDkrxgauVVfMJC` | -| `INDEXER_AGENT_DAI_CONTRACT` | `--dai-contract` | `0x9e7e607afd22906f7da6f1ec8f432d6f244278be` (GDAI) | -| `INDEXER_AGENT_GATEWAY_ENDPOINT` | `--gatweay-endpoint` | `https://gateway.testnet.thegraph.com/` | -| `INDEXER_AGENT_EPOCH_SUBGRAPH_ENDPOINT` | `--epoch-subgraph-endpoint` | `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/3nEnuQEQd1aP6wksKvRUnuwLQcQy1zD3HPFaHZ8cMVqM` | - -In order to avoid collecting or claiming query fees below a certain threshold -(e.g. below the cost of the two transactions), the following configuration -option can be used. - -| Environment Variable | CLI Argument | Value | -| -------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- | -| `INDEXER_AGENT_REBATE_CLAIM_THRESHOLD` | `--rebate-claim-threshold` | Minimum rebate (in GRT) received for an allocation to claim (Default: 1) | -| `INDEXER_AGENT_REBATE_CLAIM_BATCH_THRESHOLD` | `--rebate-claim-batch-threshold` | Minimum total rebates (in GRT) before a batched claim is processed (Default: 5) | -| `INDEXER_AGENT_VOUCHER_EXPIRATION` | `--voucher-expiration` | Time (in seconds) to permanently delete vouchers with too few query fees (Default: 2160) | - -### Indexer Service - -| Environment Variable | CLI Argument | Value | -| --------------------------------------------- | ------------------------------- | ----------------------------------------------------------------------------- | -| `INDEXER_SERVICE_ETHEREUM` | `--ethereum` | An Ethereum Sepolia node/provider | -| `INDEXER_SERVICE_INDEXER_ADDRESS` | `--indexer-address` | Ethereum address of testnet indexer | -| `INDEXER_SERVICE_MNEMONIC` | `--mnemonic` | Ethereum mnemonic for testnet operator | -| `INDEXER_SERVICE_NETWORK_SUBGRAPH_DEPLOYMENT` | `--network-subgraph-deployment` | `QmP3Vf8hp3FDHhmZ2JvZd1NbDC27CTkp2uK1TQcCYB8GCo` | -| `INDEXER_SERVICE_NETWORK_SUBGRAPH_ENDPOINT` | `--network-subgraph-endpoint` | `https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-sepolia` | -| `INDEXER_SERVICE_CLIENT_SIGNER_ADDRESS` | `--client-signer-address` | `0xe1EC4339019eC9628438F8755f847e3023e4ff9c` | - -### Graph Node - -| Environment Variable | CLI Argument | Value | -| -------------------- | ---------------- | ----------------------------------- | -| `ethereum` | `--ethereum-rpc` | `sepolia:...` | -| `ipfs` | `--ipfs` | `https://ipfs.network.thegraph.com` | - -## Feature support - -> This defines indexing & querying features which are experimental or not fully supported for indexing & query rewards and arbitration ([read more](../feature-support-matrix.md)). - -| Subgraph Feature | Aliases | Implemented | Experimental | Query Arbitration | Indexing Arbitration | Indexing Rewards | -| ------------------------ | ---------------- | ----------- | ------------ | ----------------- | -------------------- | ---------------- | -| **Core Features** | | | | | | | -| Full-text Search | | Yes | No | No | Yes | Yes | -| Non-Fatal Errors | | Yes | Yes | Yes | Yes | Yes | -| Grafting | | Yes | Yes | Yes | Yes | Yes | -| **Data Source Types** | | | | | | | -| eip155:\* | \* | Yes | No | No | No | No | -| eip155:1 | mainnet | Yes | No | Yes | Yes | Yes | -| eip155:100 | gnosis | Yes | No | Yes | Yes | Yes | -| near:\* | \* | Yes | Yes | No | No | No | -| cosmos:\* | \* | Yes | Yes | No | No | No | -| arweave:\* | \* | Yes | Yes | No | No | No | -| eip155:42161 | arbitrum-one | Yes | Yes | Yes | Yes | Yes | -| eip155:42220 | celo | Yes | Yes | Yes | Yes | Yes | -| eip155:43114 | avalanche | Yes | Yes | Yes | Yes | Yes | -| **Data Source Features** | | | | | | | -| ipfs.cat in mappings | | Yes | Yes | No | No | No | -| ENS | | Yes | Yes | No | No | No | -| File data sources: IPFS | | Yes | Yes | No | Yes | Yes | -| eip155:11155111 | sepolia | Yes | Yes | No | Yes | Yes | -| eip155:421614 | arbitrum-sepolia | Yes | Yes | No | Yes | Yes |