Merge pull request #341 from gnosischain/develop

fix: indexer for receiver address. chore: linter, remove subgraph

Author: ilge-ustun

.devcontainer/devcontainer.json

@@ -0,0 +1,32 @@
+{
+  "name": "Unified Bridge (Node 22 + Claude Code)",
+  "image": "mcr.microsoft.com/devcontainers/javascript-node:1-22-bookworm",
+  "remoteUser": "node",
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {
+      "version": "latest"
+    },
+    "ghcr.io/devcontainers/features/github-cli:1": {
+      "version": "latest"
+    }
+  },
+  "remoteEnv": {
+    "PATH": "/home/node/.local/bin:${containerEnv:PATH}"
+  },
+  "postCreateCommand": "bash .devcontainer/post-create.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "dbaeumer.vscode-eslint",
+        "esbenp.prettier-vscode"
+      ]
+    }
+  },
+  "forwardPorts": [3000],
+  "portsAttributes": {
+    "3000": {
+      "label": "Next.js (pnpm app:dev)",
+      "onAutoForward": "notify"
+    }
+  }
+}

.devcontainer/post-create.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT"
+
+# Claude Code — optional; Docker proxies / offline builds often block claude.ai.
+if curl -fsSL https://claude.ai/install.sh | bash -s stable; then
+  echo "Claude Code installed. Run 'claude' to sign in."
+else
+  echo "Warning: Claude Code install failed (network/proxy). You can install it later inside the container." >&2
+fi
+
+# Avoid `corepack enable` as non-root: it tries to symlink into /usr/local/bin and often exits EACCES.
+corepack prepare pnpm@9.6.0 --activate || npm install -g pnpm@9.6.0
+
+pnpm install --frozen-lockfile
+
+if ! grep -q '\.local/bin' ~/.bashrc 2>/dev/null; then
+  printf '\nexport PATH="$HOME/.local/bin:$PATH"\n' >> ~/.bashrc
+fi
+
+echo "Dev container setup finished."

.github/workflows/bridge-explorer-develop-staging.yml

@@ -112,9 +112,6 @@ jobs:
             "NEXT_PUBLIC_RPC_GNOSIS=${{ secrets.DEV_RPC_GNOSIS }}"
             "NEXT_PUBLIC_WALLET_CONNECT_DAPP_URL=${{ secrets.WALLET_CONNECT_URL }}"
             "NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=${{ secrets.WALLET_CONNECT_PROJECT_ID }}"
-            "NEXT_PUBLIC_SUBGRAPH_ENVIRONMENT=development"
-            "NEXT_PUBLIC_SUBGRAPH_ACCESS_ID=${{ secrets.GRAPH_ORG }}"
-            "NEXT_PUBLIC_SUBGRAPH_CHAINS_RESOURCE_IDS=100:version/latest,1:version/latest"
             "NEXT_PUBLIC_ALCHEMY_API_KEY=${{ secrets.DEV_NEXT_PUBLIC_ALCHEMY_API_KEY }}"
             "NEXT_PUBLIC_ENVIO_INDEXER_URL=${{ secrets.DEV_ENVIO_INDEXER_URL }}"
             "NEXT_PUBLIC_INDEXER_BACKEND=${{ secrets.DEV_INDEXER_BACKEND }}"
@@ -138,9 +135,6 @@ jobs:
             "NEXT_PUBLIC_RPC_GNOSIS=${{ secrets.PROD_RPC_GNOSIS }}"
             "NEXT_PUBLIC_WALLET_CONNECT_DAPP_URL=${{ secrets.WALLET_CONNECT_URL }}"
             "NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=${{ secrets.WALLET_CONNECT_PROJECT_ID }}"
-            "NEXT_PUBLIC_SUBGRAPH_ENVIRONMENT=production"
-            "NEXT_PUBLIC_SUBGRAPH_ACCESS_ID=${{ secrets.THEGRAPH_READ_API_KEY }}"
-            "NEXT_PUBLIC_SUBGRAPH_CHAINS_RESOURCE_IDS=100:2ths6FTZhCBggnyakh7PL5KH91zjRv8xPNfzaCRKogJ,1:9W7Ye5xFfefNYDxXD4StqAuj7TU8eLq5PLmuPUnhFbeQ"
             "NEXT_PUBLIC_ALCHEMY_API_KEY=${{ secrets.PROD_NEXT_PUBLIC_ALCHEMY_API_KEY }}"
             "NEXT_PUBLIC_ENVIO_INDEXER_URL=${{ secrets.PROD_ENVIO_INDEXER_URL }}"
             "NEXT_PUBLIC_INDEXER_BACKEND=${{ secrets.PROD_INDEXER_BACKEND }}"

.github/workflows/publish-ghcr-image-release.yml

@@ -87,9 +87,6 @@ jobs:
             "NEXT_PUBLIC_RPC_GNOSIS=${{ secrets.PROD_RPC_GNOSIS }}"
             "NEXT_PUBLIC_WALLET_CONNECT_DAPP_URL=${{ secrets.WALLET_CONNECT_URL }}"
             "NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=${{ secrets.WALLET_CONNECT_PROJECT_ID }}"
-            "NEXT_PUBLIC_SUBGRAPH_ENVIRONMENT=production"
-            "NEXT_PUBLIC_SUBGRAPH_ACCESS_ID=${{ secrets.THEGRAPH_READ_API_KEY }}"
-            "NEXT_PUBLIC_SUBGRAPH_CHAINS_RESOURCE_IDS=100:2ths6FTZhCBggnyakh7PL5KH91zjRv8xPNfzaCRKogJ,1:9W7Ye5xFfefNYDxXD4StqAuj7TU8eLq5PLmuPUnhFbeQ"
             "NEXT_PUBLIC_ALCHEMY_API_KEY=${{ secrets.PROD_NEXT_PUBLIC_ALCHEMY_API_KEY }}"
             "NEXT_PUBLIC_ENVIO_INDEXER_URL=${{ secrets.PROD_ENVIO_INDEXER_URL }}"
             "NEXT_PUBLIC_INDEXER_BACKEND=${{ secrets.PROD_INDEXER_BACKEND }}"

.github/workflows/thegraph_dev_deploy.yml

@@ -1,4 +1,6 @@
 .local
 .env
 .env.local
-node_modules
+node_modules
+settings.local.json
+.pnpm-store

.github/workflows/thegraph_prod_deploy.yml

@@ -0,0 +1,88 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This is a monorepo for the **Gnosis Bridge Monitor** — a real-time bridge transaction explorer for Gnosis Chain. It includes:
+- `/app` — Next.js frontend (bridge explorer UI)
+- `/envio-indexer` — Envio blockchain indexer (real-time event indexing via GraphQL)
+- `/alerts` — Slack alert system for validator balances and bridge limits
+- `/tests` — Test plans and records
+
+## Common Commands
+
+All commands run from the repo root using pnpm workspaces, or from within the package directory.
+
+### Frontend (`/app`)
+```bash
+pnpm app:dev          # Start Next.js dev server
+pnpm app:build        # Production build
+pnpm app:lint         # Lint (ESLint + Prettier)
+pnpm app:lint:fix     # Auto-fix lint issues
+cd app && pnpm typechain   # Regenerate TypeChain types from ABIs
+```
+
+### Indexer (`/envio-indexer`)
+```bash
+pnpm indexer:dev      # Start indexer in dev mode
+pnpm indexer:codegen  # Regenerate types from config.yaml
+cd envio-indexer && pnpm mocha   # Run indexer tests
+```
+
+### Alerts (`/alerts`)
+```bash
+cd alerts && pnpm dev   # Run alerts service with ts-node
+cd alerts && pnpm build # Compile TypeScript
+```
+
+## Architecture
+
+### Frontend (`/app/src/`)
+
+**Tech stack:** Next.js 15 + React 18, Ethers.js v5 (legacy) + Viem v2 (modern), Web3Onboard v2 (wallet), Styled Components, SWR (data fetching), TypeChain (contract types).
+
+**Key structural patterns:**
+- Pages in `/app/pages/bridge-explorer/` — each route has a corresponding `pagePartials/` folder for page-specific components
+- `NextPageWithLayout` pattern for per-page layouts; `SingleColumnLayout` is the default
+- Provider tree in `_app.tsx`: `Web3ConnectionProvider` (dynamic/no-SSR) → `ThemeProvider` → `TransactionNotificationProvider` → `TokenListProvider` → `ValidatorsProvider`
+- Contract ABIs live in `src/abis/` and generate TypeChain types via `pnpm typechain`
+- Bridge and chain configuration is centralized in `src/constants/` (bridges, validators, chains, contracts)
+
+**Bridge types supported:**
+- XDAI Bridge: native token bridge (DAI/USDS)
+- OmniBridge (AMB): multi-token bridge (USDC, USDT, ERC-20s)
+- USDC Transmuter: handles USDC variant bridging
+
+### Indexer (`/envio-indexer/`)
+
+**Tech stack:** Envio v2, Viem, TypeScript, Mocha/Chai for tests.
+
+The indexer tracks bridge transaction lifecycle via on-chain events:
+1. `UserRequestForSignature` — bridge initiated
+2. `SignedForUserRequest` — validator signed
+3. `CollectedSignatures` — threshold reached
+4. `AffirmationCompleted` — executed on destination
+
+Configuration is in `config.yaml` (networks, contract addresses, event signatures, start blocks). The `schema.graphql` defines the GraphQL API consumed by the frontend. Run `pnpm indexer:codegen` after changing either file.
+
+Generated code lives in `generated/` — do not edit manually.
+
+### Data Flow
+
+Frontend (`SWR` hooks) → Envio GraphQL API (`NEXT_PUBLIC_ENVIO_INDEXER_URL`) → Indexed on-chain events → Bridge contracts on Ethereum (chain 1) and Gnosis Chain (chain 100).
+
+## Environment Setup
+
+Copy and fill `.env.example` files:
+- `app/.env.local` — requires RPC URLs, WalletConnect project ID, Envio indexer GraphQL URL
+- `alerts/.env` — requires Slack token/channel, RPC URLs, subgraph URLs
+
+Node version is pinned in `.nvmrc` (v22.11.0). Use `nvm use` before installing.
+
+## Git Workflow
+
+- Feature branches are created from `develop`
+- PRs target `develop` → promoted to `staging` → `main` (production)
+- Conventional Commits are enforced via commitlint (pre-commit hook)
+- Pre-commit hooks (Husky + lint-staged) run ESLint fix, Prettier, and `tsc` on staged files