feat: erpc

Author: kasrakhosravi

docs/tools/rpc-proxy-caching/erpc.md

@@ -0,0 +1,73 @@
+# Polygon RPC Proxy and Caching
+
+[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)<br/>
+- [docs](https://docs.erpc.cloud/)<br/>
+- [telegram](https://t.me/erpc_cloud)<br/>
+
+![Architecture](https://github.com/erpc/erpc/raw/main/assets/hla-diagram.svg)
+
+<br />
+
+# Features
+
+✅ **Fault-tolerant Proxy**: Retries, circuit-breakers, failovers and hedged requests make sure fastest most-reliable upstream is used. <br/><br/>
+✅ **Flexible Rate-limiters**: Define hourly, daily rate limits for each upstream provider, to control usage, costs and high-scale usage.<br/><br/>
+✅ **Permanent Caching**: Avoid redundant upstream costs by locally caching RPC responses, with reorg-aware caching layer.<br/><br/>
+✅ **Request Auto-routing**: You don't need to think about which upstream supports which eth\_\* method; eRPC automatically does that.<br/><br/>
+✅ **Normalized Errors**: Receive consistent error codes with details across 5+ third-party providers. With useful reporting of occurred errors.<br/><br/>
+✅ **RPC Metrics & Observability**: Single dashboard to observe rps throughput, errors, and avg. latency of all your RPC providers.<br/><br/>
+
+# Quick start
+
+1. Create your [`erpc.yaml`](https://docs.erpc.cloud/config/example) configuration file based on the [`erpc.yaml.dist`](https://github.com/erpc/erpc/blob/main/erpc.yaml.dist) file:
+
+```bash
+cp erpc.yaml.dist erpc.yaml
+code erpc.yaml
+```
+
+See [a 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/137' \
+--header 'Content-Type: application/json' \
+--data '{
+    "method": "eth_getBlockByNumber",
+    "params": [
+        "0x3948796",
+        false
+    ],
+    "id": 9199,
+    "jsonrpc": "2.0"
+}'
+```
+
+4. Bring up 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 login with the following credentials:
+
+- username: `admin`
+- password: `admin`
+
+6. Send more requests and watch the metrics being collected and visualized in Grafana.
+
+![eRPC Grafana Dashboard](https://docs.erpc.cloud/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Fmonitoring-example-erpc.2cb040a1.png&w=3840&q=75)