Add EVM Gateway node ops section and main page

docs/evm/using.mdx

@@ -96,7 +96,7 @@ To use the Flow Wallet Chrome extension:
 | [eth_getBlockByNumber]                    | ✅     |
 | [eth_getBlockTransactionCountByHash]      | ✅     |
 | [eth_getBlockTransactionCountByNumber]    | ✅     |
-| eth_getBlockReceipts                      | ✅     |
+| [eth_getBlockReceipts]                    | ✅     |
 | [eth_getCode]                             | ✅     |
 | [eth_getFilterChanges]                    | ✅     |
 | [eth_getFilterLogs]                       | ✅     |
@@ -121,11 +121,11 @@ To use the Flow Wallet Chrome extension:
 | [eth_signTransaction]                     | 🚧     | Unsupported |
 | [eth_syncing]                             | ✅     |
 | [eth_uninstallFilter]                     | ✅     |
-| eth_maxPriorityFeePerGas                  | ✅     |
-| eth_feeHistory                            | ✅     |
-| debug_traceTransaction                    | ✅     |
-| debug_traceBlockByNumber                  | ✅     |
-| debug_traceBlockByHash                    | ✅     |
+| [eth_maxPriorityFeePerGas]                | ✅     |
+| [eth_feeHistory]                          | ✅     |
+| [debug_traceTransaction]                  | ✅     |
+| [debug_traceBlockByNumber]                | ✅     |
+| [debug_traceBlockByHash]                  | ✅     |
 
 **Legend**: ❌ = not supported. 🚧 = work in progress. ✅ = supported.
 

docs/networks/flow-networks/index.md

@@ -5,6 +5,12 @@ sidebar_position: 1
 
 ## About Flow Networks
 
+:::note
+
+This page provides information on Flow networks RPCs. EVM on Flow network RPCs can be found [here](../evm/networks)
+
+:::
+
 In addition to Mainnet, developers have access to the Testnet environment, which serves as an essential testing ground for applications and smart contracts prior to their deployment on Mainnet. This ensures that any potential issues can be identified and resolved in a controlled setting, mitigating risks associated with live deployment.
 
 Furthermore, during network upgrades, Testnet receives updates ahead of Mainnet. This preemptive update process allows developers to comprehensively test their apps against the latest versions of the nodes, enhancements to the Cadence programming language, and core contract upgrades. This strategy guarantees that when these updates are eventually applied to Mainnet, applications and smart contracts will operate seamlessly, enhancing overall network stability and user experience.

docs/networks/node-ops/access-onchain-data/evm-gateway/_category_.yml

@@ -0,0 +1 @@
+label: EVM Gateway Nodes

docs/networks/node-ops/access-onchain-data/evm-gateway/evm-gateway-setup.md

@@ -0,0 +1,274 @@
+---
+title: Setting up an EVM Gateway node
+sidebar_label: EVM Gateway Setup
+sidebar_position: 2
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+This guide is for running the [EVM Gateway](https://github.com/onflow/flow-evm-gateway) node on Flow. The EVM Gateway implements the
+[Ethereum JSON-RPC specification](https://ethereum.org/en/developers/docs/apis/json-rpc/) and is the only node type which accepts EVM 
+client connections. 
+
+The EVM Gateway is an unstaked, non-participating edge node which consumes Flow protocol state from the configured Flow Access Node 
+and persists the indexed EVM state locally to service EVM client requests. It submits EVM transactions it receives into the Flow 
+network, wrapped using a Cadence transaction, and mutating EVM state when executed. Non-mutating RPC methods only query the local state 
+index of the gateway and are never forwarded to Access Nodes.
+
+## Who Should Run an EVM Gateway
+
+The EVM Gateway can serve as both a dedicated private RPC endpoint and a performance scaling solution, offering similar capabilities 
+to centralized middleware providers like Infura, Alchemy, etc at a fraction of the cost. This is because EVM Gateway nodes connect 
+directly to the Flow network with no middle layer in between.
+
+Applications which generate high call volumes to the JSON-RPC and which may have hit rate limits can benefit from running their 
+own gateway. Self-hosted gateways are dedicated to the operator, enabling the removal of rate limits. Self-hosted gateways 
+connect directly to your chosen Access Node, which you can also run if desired. 
+
+## Hardware specifications
+
+TBD
+
+# How To Run EVM Gateway
+
+## Step 1 - Account Creation
+
+The EVM Gateway's role in mediating EVM transactions over to Cadence is how it accrues fees from handling client transactions. Since
+the gateway submits Cadence transactions wrapping EVM transaction payloads to the Flow Access Node the transaction fee for that must
+be paid by the EVM Gateway.
+
+The account used for funding gateway Cadence transactions must be a COA, not an EOA. `--coa-address` is configured with the Cadence address
+of the COA account and the `--coa-key` must belong to the same account. The `--coinbase` account accrues EVM Gateway fees from EVM client
+transactions and can be either an EVM EOA or COA address.
+
+It is acceptable to create a single Cadence account for the COA and use the EVM address associated with that for the COINBASE address.
+
+### Create Flow account to use for COA
+
+If you don't already have a Flow account you will need to create one. 
+
+<Tabs>
+<TabItem value="mainnet" label="Mainnet">
+
+   1. Install [Flow Wallet](https://wallet.flow.com/)
+   2. Once installed you will be able to copy the wallet address, similar to _0x1844efeb3fef2242_
+   3. Obtain account private key from
+   <pre>Settings -> Account List -> Choose Main account -> Private Key -> [Password prompt]</pre>
+   4. Ensure the wallet is funded from a CEX or other wallet
+
+</TabItem>
+<TabItem value="testnet" label="Testnet">
+
+```bash
+flow keys generate
+```
+
+This will output something similar to:
+
+```bash
+🔴️ Store private key safely and don't share with anyone!
+Private Key 		 3cf8334d.....95c3c54a28e4ad1
+Public Key 		 33a13ade6....85f1b49a197747
+Mnemonic 		 often scare peanut ... boil corn change
+Derivation Path 	 m/44'/539'/0'/0/0
+Signature Algorithm 	 ECDSA_P256
+```
+
+Visit https://faucet.flow.com/, and use the generated `Public Key`, to create and fund your Flow testnet account.
+
+</TabItem>
+</Tabs>
+
+## Step 2 - Build the gateway
+
+To run EVM Gateway on bare metal or in a VM without the use of docker, select the '_Build from source_' tab otherwise refer to the 
+'_Build using Docker_' tab. 
+
+<Tabs>
+<TabItem value="source-build" label="Build from source">
+
+This will build the EVM gateway binary from source. 
+
+For live networks we recommend using the [latest release](https://github.com/onflow/flow-evm-gateway/releases/latest) tag.
+```bash
+git clone https://github.com/onflow/flow-evm-gateway.git
+
+cd flow-evm-gateway
+git checkout $(curl -s https://api.github.com/repos/onflow/flow-evm-gateway/releases/latest | jq -r .tag_name)
+CGO_ENABLED=1 go build -o evm-gateway cmd/main/main.go
+```
+
+</TabItem>
+<TabItem value="docker-build" label="Build using Docker">
+
+```bash
+git clone https://github.com/onflow/flow-evm-gateway.git
+
+cd flow-evm-gateway
+git checkout $(curl -s https://api.github.com/repos/onflow/flow-evm-gateway/releases/latest | jq -r .tag_name)
+make docker-build
+```
+
+</TabItem>
+</Tabs>
+
+## Step 3 - Start Your Node
+
+Operators will need to refer to the gateway [configuration flags](https://github.com/onflow/flow-evm-gateway?tab=readme-ov-file#configuration-flags) and make 
+adjustments that align with the desired deployment topology. 
+
+### EVM Coinbase address
+
+If this is your first time setting up the gateway we need to ensure that an EVM COA or EOA address is available to configure the `COINBASE`. This account
+can be an account created using Metamask or other web3.js wallet, or otherwise can be the EVM address corresponding to the Flow Wallet COA account created above. 
+
+If you haven't already got an EVM address and you have the COA account created by Flow Wallet above then follow the steps below:
+
+* Click top left burger icon to show current profile
+* Click 'Enable the path to EVM on Flow' button
+* Your EVM account will now be available to use in the left nav account view
+* When you switch to that account you can obtain its EVM address
+
+COA address and private key is configured for `--coa-address` & `--coa-key` configuration flags. If running multiple EVM Gateway hosts it is standard to 
+share the same COA address and key across _n_ hosts.
+
+## Run the gateway
+
+Ensure that the following ENV variables have been set. Add/update as required if your configuration differs from those listed.
+
+```bash
+# Set required environment variables
+export ACCESS_NODE_GRPC_HOST="access.mainnet.nodes.onflow.org:9000"
+export FLOW_NETWORK_ID="flow-mainnet" # or flow-testnet
+export INIT_CADENCE_HEIGHT="88226267" # 211176670 for testnet
+export COINBASE="${EVM_ADDRESS_WITHOUT_0x}"
+export COA_ADDRESS="${CADENCE_ACCOUNT_ADDRESS_WITHOUT_0x}"
+export COA_KEY="${CADENCE_ACCOUNT_PRIVATE_KEY_WITHOUT_0x}"
+export GAS_PRICE="100"
+```
+
+<Tabs>
+<TabItem value="source-build" label="Source build">
+
+Create EVM Gateway service
+
+```bash
+sudo tee <<EOF >/dev/null /etc/systemd/system/gateway.service
+[Unit]
+Description=Gateway daemon
+After=network-online.target
+
+[Service]
+User=$USER
+ExecStart=/usr/bin/evm-gateway \
+--access-node-grpc-host=$ACCESS_NODE_GRPC_HOST \
+--flow-network-id=$FLOW_NETWORK_ID \
+--init-cadence-height=$INIT_CADENCE_HEIGHT \
+--ws-enabled=true \
+--coinbase=$COINBASE \
+--coa-address=$COA_ADDRESS \
+--coa-key=$COA_KEY \
+--rate-limit=9999999 \
+--rpc-host=0.0.0.0 \
+--gas-price=$GAS_PRICE
+Restart=always
+RestartSec=3
+LimitNOFILE=4096
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+cat /etc/systemd/system/gateway.service
+sudo systemctl enable gateway
+```
+
+</TabItem>
+<TabItem value="docker-build" label="Docker build">
+
+It may be necessary to make local changes to the `docker-run` target to add params which are needed for your requirements. 
+
+```bash
+cd flow-evm-gateway
+make docker-run
+```
+Additional options are available as follows
+
+```bash
+DOCKER_RUN_DETACHED=true 
+DOCKER_HOST_MOUNT=[host mount directory] 
+DOCKER_HOST_PORT=[desired port to expose on host]
+
+# Example usage
+
+make DOCKER_RUN_DETACHED=true DOCKER_HOST_PORT=1234 DOCKER_HOST_MOUNT=/my/host/dir docker-run
+```
+
+</TabItem>
+</Tabs>
+
+## Startup bootstrap indexing
+
+Once your EVM Gateway is up and running you will see it indexing the EVM on Flow network which was configured. At the present time
+this is a lengthy process (possible 1-3 days, depending on CPU core count) during which time the gateway will not respond to queries. 
+Once the data is fully indexed the gateway can serve requests to clients.
+
+To speed up gateway setup we recommend backing up the /flow-evm-gateway/data directory to use when creating additional nodes 
+using the same release version. We are currently working on an export/import feature that will enable gateway operators to 
+store state snapshots which can be used to bootstrap the creation of new nodes and mitigate the slow startup time.
+
+## Account and Key Management
+
+EVM Gateway allows for Google and AWS Key Management Service (KMS) setup, which is the recommended way of setting up the gateway 
+for live networks. We recommend creating multiple KMS keys for the same Flow account (ideally 10 or more), how many depends on 
+the desired transaction throughput, since the keys are used in rotation when submitting the transactions. If too few keys 
+are configured it may result in sequence number collisions if the same key is used concurrently by multiple EVM client requests. 
+
+### KMS Configuration
+```
+--coa-cloud-kms-project-id=your-project-kms-id \
+--coa-cloud-kms-location-id=global \
+--coa-cloud-kms-key-ring-id=your-project-kms-key-ring-id \
+--coa-cloud-kms-keys=example-gcp-kms1@1,example-gcp-kms2@1 \
+```
+
+## Monitoring and Metrics
+
+The EVM Gateway reports Prometheus metrics which are a way to monitor the gateway's availability and progress. The database folder 
+size may also need to be monitored to prevent disk full issues. 
+
+**Metric labels**
+```bash
+evm_gateway_api_errors_total # Total count of API errors for period
+evm_gateway_api_request_duration_seconds_bucket # Histogram metric buckets for API request durations
+evm_gateway_api_request_duration_seconds_count # Histogram metric API request count for period
+evm_gateway_api_request_duration_seconds_sum # Histogram metric API request sum of values for period
+evm_gateway_api_server_panics_total # Total count of server panics for period
+evm_gateway_blocks_indexed_total  # Total count of EVM blocks indexed 
+evm_gateway_cadence_block_height  # Cadence block height 
+evm_gateway_evm_account_interactions_total # Count of unique accounts observed for period
+evm_gateway_evm_block_height # EVM block height 
+evm_gateway_operator_balance # Gateway node COA operator account balance
+evm_gateway_trace_download_errors_total # Total count of trace download errors
+evm_gateway_txs_indexed_total # Total count of indexed transactions
+```
+
+Alerts are recommended to be configured on server panics, low operator balance, and disk usage metrics.
+
+### Configuration
+```
+--metrics-port 8080 \
+```
+### Node Status
+
+For basic node status or keepalive monitoring we recommend automated checks on the following monotonically increasing counter:
+```
+curl -s -XPOST 'your-evm-gw-host:8545' --header 'Content-Type: application/json' --data-raw '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' | jq -r '.result' | xargs printf "%d\n"
+10020239
+```
+
+## Troubleshooting
+
+## FAQs
+