chore: add fallback RPC (#105)

# 🤖 Linear

Closes PAR-946

## Description

## Checklist before requesting a review

-   [x] I have conducted a self-review of my code.
-   [x] I have conducted a QA.
-   [ ] If it is a core feature, I have included comprehensive tests.


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **New Features**
- Enhanced blockchain connectivity with updated endpoints and fallback
options across multiple networks.
- Introduced a sample environment configuration template to simplify
user setup.
- **Chores**
- Improved the container build process by updating package management
support.
- **Documentation**
- Revised user guidance to recommend fallback configurations, helping to
mitigate potential connectivity issues.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: thelostone-mc

Dockerfile

@@ -1,6 +1,7 @@
 FROM node:20-slim AS base
 ENV PNPM_HOME="/pnpm"
 ENV PATH="$PNPM_HOME:$PATH"
+
 RUN npm install -g corepack@latest
 RUN corepack enable
 

apps/indexer/.env.example

@@ -0,0 +1,18 @@
+# Custom RPCs
+ENVIO_SEI_RPC_URL=YOUR_SEI_RPC_URL
+ENVIO_HEDERA_RPC_URL=YOUR_HEDERA_RPC_URL
+
+# Fallback RPCs
+ENVIO_MAINNET_FALLBACK_RPC=YOUR_MAINNET_RPC_URL
+ENVIO_OPTIMISM_FALLBACK_RPC=YOUR_OPTIMISM_RPC_URL
+ENVIO_GNOSIS_FALLBACK_RPC=YOUR_GNOSIS_RPC_URL
+ENVIO_POLYGON_FALLBACK_RPC=YOUR_POLYGON_RPC_URL
+ENVIO_FANTOM_FALLBACK_RPC=YOUR_FANTOM_RPC_URL
+ENVIO_ZKSYNC_FALLBACK_RPC=YOUR_ZKSYNC_RPC_URL
+ENVIO_METIS_FALLBACK_RPC=YOUR_METIS_RPC_URL
+ENVIO_BASE_FALLBACK_RPC=YOUR_BASE_RPC_URL
+ENVIO_ARBITRUM_FALLBACK_RPC=YOUR_ARBITRUM_RPC_URL
+ENVIO_AVALANCHE_FALLBACK_RPC=YOUR_AVALANCHE_RPC_URL
+ENVIO_CELO_FALLBACK_RPC=YOUR_CELO_RPC_URL
+ENVIO_SCROLL_FALLBACK_RPC=YOUR_SCROLL_RPC_URL
+ENVIO_SEPOLIA_FALLBACK_RPC=YOUR_SEPOLIA_RPC_URL

apps/indexer/README.md

@@ -70,6 +70,8 @@ Use your values for the chain and the contracts you want to index.
 
 Ensure each event is properly handled and thoroughly tested before redeploying the environment to prevent issues in the indexing process.
 
+Hypersync can sometimes be unreliable, so it's recommended to provide a fallback RPC. Check the `.env.example` file and ensure the necessary variables are set in the hosted service before deployment.
+
 ## 🧪 Testing
 
 To run tests, use the following command:

apps/indexer/config.yaml

@@ -137,6 +137,7 @@ networks:
     #######################
     - id: 1 # mainnet
       start_block: 18486688
+      rpc: ${ENVIO_MAINNET_FALLBACK_RPC:-https://eth.llamarpc.com}
       contracts:
           - name: Allo
             address:
@@ -147,6 +148,7 @@ networks:
                 - 0x4AAcca72145e1dF2aeC137E1f3C5E3D75DB8b5f3
 
     - id: 10 # optimism
+      rpc: ${ENVIO_OPTIMISM_FALLBACK_RPC:-https://optimism.llamarpc.com}
       start_block: 111678968
       contracts:
           - name: Registry
@@ -157,30 +159,33 @@ networks:
             address:
                 - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
 
-    - id: 137 # polygon
-      start_block: 49466006
+    - id: 42 # lukso-mainnet
+      start_block: 2400000
+      rpc: http://34.91.99.187:854
       contracts:
           - name: Registry
             address:
                 - 0x4AAcca72145e1dF2aeC137E1f3C5E3D75DB8b5f3
           - name: Strategy
           - name: Allo
             address:
-                - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
+                - 0xB087535DB0df98fC4327136e897A5985E5Cfbd66
 
-    - id: 42 # lukso-mainnet
-      start_block: 2400000
+    - id: 100 # gnosis
+      rpc: ${ENVIO_GNOSIS_FALLBACK_RPC:-https://gnosis-rpc.publicnode.com}
+      start_block: 35900000
       contracts:
           - name: Registry
             address:
                 - 0x4AAcca72145e1dF2aeC137E1f3C5E3D75DB8b5f3
           - name: Strategy
           - name: Allo
             address:
-                - 0xB087535DB0df98fC4327136e897A5985E5Cfbd66
+                - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
 
-    - id: 100 # gnosis
-      start_block: 35900000
+    - id: 137 # polygon
+      rpc: ${ENVIO_POLYGON_FALLBACK_RPC:-https://polygon.llamarpc.com}
+      start_block: 49466006
       contracts:
           - name: Registry
             address:
@@ -191,6 +196,7 @@ networks:
                 - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
 
     - id: 250 # fantom
+      rpc: ${ENVIO_FANTOM_FALLBACK_RPC:-https://rpc.ankr.com/fantom}
       start_block: 77624278
       contracts:
           - name: Registry
@@ -202,6 +208,7 @@ networks:
                 - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
 
     - id: 324 # zksync-era-mainnet
+      rpc: ${ENVIO_ZKSYNC_FALLBACK_RPC:-https://1rpc.io/zksync2-era}
       start_block: 31154341
       contracts:
           - name: Registry
@@ -213,6 +220,7 @@ networks:
                 - 0x9D1D1BF2835935C291C0f5228c86d5C4e235A249
 
     - id: 1088 # metis
+      rpc: ${ENVIO_METIS_FALLBACK_RPC:-https://metis-rpc.publicnode.com}
       start_block: 17860000
       contracts:
           - name: Registry
@@ -223,18 +231,8 @@ networks:
             address:
                 - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
 
-    - id: 43114 # avalanche
-      start_block: 34540051
-      contracts:
-          - name: Registry
-            address:
-                - 0x4AAcca72145e1dF2aeC137E1f3C5E3D75DB8b5f3
-          - name: Strategy
-          - name: Allo
-            address:
-                - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
-
     - id: 8453 # base
+      rpc: ${ENVIO_BASE_FALLBACK_RPC:-https://base-rpc.publicnode.com}
       start_block: 6083365
       contracts:
           - name: Registry
@@ -246,6 +244,7 @@ networks:
                 - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
 
     - id: 42161 # arbitrum
+      rpc: ${ENVIO_ARBITRUM_FALLBACK_RPC:-https://arbitrum.llamarpc.com}
       start_block: 146489425
       contracts:
           - name: Registry
@@ -262,7 +261,20 @@ networks:
             address:
                 - 0x2ce7E4cB5Edb140A9327e67De85463186E757C8f
 
+    - id: 43114 # avalanche
+      rpc: ${ENVIO_AVALANCHE_FALLBACK_RPC:-https://avalanche.public-rpc.com}
+      start_block: 34540051
+      contracts:
+          - name: Registry
+            address:
+                - 0x4AAcca72145e1dF2aeC137E1f3C5E3D75DB8b5f3
+          - name: Strategy
+          - name: Allo
+            address:
+                - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
+
     - id: 42220 # celo-mainnet
+      rpc: ${ENVIO_CELO_FALLBACK_RPC:-https://1rpc.io/celo}
       start_block: 22257475
       contracts:
           - name: Registry
@@ -274,6 +286,7 @@ networks:
                 - 0x1133eA7Af70876e64665ecD07C0A0476d09465a1
 
     - id: 534352 # scroll
+      rpc: ${ENVIO_SCROLL_FALLBACK_RPC:-https://1rpc.io/scroll}
       start_block: 2683205
       contracts:
           - name: Registry
@@ -331,6 +344,7 @@ networks:
     #######################
 
     - id: 11155111 # sepolia
+      rpc: ${ENVIO_SEPOLIA_FALLBACK_RPC:-https://1rpc.io/sepolia}
       start_block: 4617051
       contracts:
           - name: Registry