chore: add local testing script

Author: pcarranzav

.env.example

@@ -0,0 +1,5 @@
+# Arbitrum Sepolia testnet JSON-RPC provider URL for testing (e.g., Infura, Alchemy, etc.)
+INDEXER_TEST_JRPC_PROVIDER_URL=https://arbitrum-sepolia.infura.io/v3/your-project-id
+
+# The Graph API key for querying subgraphs (from The Graph Studio)
+INDEXER_TEST_API_KEY=your-graph-api-key-here

README.md

@@ -308,6 +308,41 @@ Creating a new release involves the following steps:
    yarn release <version>
    ```
 
+## Running tests locally
+
+To run the tests locally, you'll need:
+1. Docker installed and running
+2. Node.js and Yarn
+3. An Arbitrum Sepolia testnet RPC provider (e.g., Infura, Alchemy)
+4. An API key from The Graph Studio for querying subgraphs
+
+### Setup
+
+1. Create a `.env` file in the root directory with your credentials. You can copy the example file as a template:
+```sh
+cp .env.example .env
+```
+
+Then edit `.env` with your credentials:
+```plaintext
+# Your Arbitrum Sepolia testnet RPC endpoint
+INDEXER_TEST_JRPC_PROVIDER_URL=https://sepolia.infura.io/v3/your-project-id
+
+# Your API key from The Graph Studio (https://thegraph.com/studio/)
+INDEXER_TEST_API_KEY=your-graph-api-key-here
+```
+
+2. Run the tests:
+```sh
+bash scripts/run-tests.sh
+```
+
+The script will:
+- Start a PostgreSQL container with the required test configuration
+- Load your credentials from the `.env` file
+- Run the test suite
+- Clean up the PostgreSQL container when done
+
 # Copyright
 
 Copyright &copy; 2020-2021 The Graph Foundation

scripts/run-tests.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+# Cleanup function to stop and remove the container
+cleanup() {
+    echo "Cleaning up..."
+    docker stop indexer-test-db >/dev/null 2>&1
+    docker rm indexer-test-db >/dev/null 2>&1
+}
+
+# Register the cleanup function to run on script exit
+trap cleanup EXIT
+
+# Start PostgreSQL container with the same configuration as CI
+docker run -d \
+    --name indexer-test-db \
+    -e POSTGRES_DB=indexer_tests \
+    -e POSTGRES_USER=testuser \
+    -e POSTGRES_PASSWORD=testpass \
+    -p 5432:5432 \
+    postgres:13
+
+# Wait for PostgreSQL to be ready
+echo "Waiting for PostgreSQL to be ready..."
+until docker exec indexer-test-db pg_isready > /dev/null 2>&1; do
+    sleep 1
+done
+echo "PostgreSQL is ready!"
+
+# Load environment variables from .env file
+if [ -f .env ]; then
+    echo "Loading .env file..."
+    source .env
+else
+    echo "Warning: .env file not found"
+fi
+
+# Run the tests
+echo "Running tests..."
+POSTGRES_TEST_HOST=localhost \
+POSTGRES_TEST_DATABASE=indexer_tests \
+POSTGRES_TEST_USERNAME=testuser \
+POSTGRES_TEST_PASSWORD=testpass \
+NODE_OPTIONS="--dns-result-order=ipv4first" \
+yarn test:ci