<!-- Canonical: https://docs.linea.build/network/build/tools/node-providers/erpc -->

> For the complete Linea documentation index, see [llms.txt](/llms.txt).
> Agents can fetch this page as Markdown at [https://docs.linea.build/network/build/tools/node-providers/erpc.md](https://docs.linea.build/network/build/tools/node-providers/erpc.md).

[eRPC](https://erpc.cloud/) is a fault-tolerant EVM RPC proxy and re-org aware permanent caching solution. It is built with read-heavy use-cases in mind such as data indexing and high-load frontend usage.

-   [GitHub](https://github.com/erpc/erpc)
-   [Docs](https://docs.erpc.cloud/)
-   [Telegram](https://t.me/erpc_cloud)

![architecture diagram](https://github.com/erpc/erpc/raw/main/assets/hla-diagram.svg)

# Quickstart

1.  Create your [`erpc.yaml`](https://docs.erpc.cloud/config/example) configuration file:

```yaml
filename="erpc.yaml"
logLevel: debug
projects:
  - id: main
    upstreams:
      # You don't need to define architecture (e.g. evm) or chain id (e.g. 59144)
      # as they will be detected automatically by eRPC.
      - endpoint: https://rpc.linea.build
      - endpoint: evm+alchemy://xxxx-my-alchemy-api-key-xxxx
```

View [the complete config example](https://docs.erpc.cloud/config/example) for inspiration.

2.  Use the Docker image:

```bash
docker run -v $(pwd)/erpc.yaml:/root/erpc.yaml -p 4000:4000 -p 4001:4001 ghcr.io/erpc/erpc:latest
```

3.  Send your first request:

```bash
curl --location 'http://localhost:4000/main/evm/59144' \
--header 'Content-Type: application/json' \
--data '{
    "method": "eth_getBlockByNumber",
    "params": [
        "0x7340c3",
        false
    ],
    "id": 9199,
    "jsonrpc": "2.0"
}'
```

4.  Bring up the monitoring stack (Prometheus, Grafana) using `docker-compose`:

```bash
# clone the repo if you haven't
git clone https://github.com/erpc/erpc.git
cd erpc

# bring up the monitoring stack
docker-compose up -d
```

5.  Open Grafana at [http://localhost:3000](http://localhost:3000) and log in with the following credentials:

-   username: `admin`
-   password: `admin`

6.  Send more requests and watch the metrics being collected and visualized in Grafana.
