test: Initial integration tests setup (#564)

* chore: Add simple storage contract

* chore: Create client for integration tests

* chore: Add registry parsing

* chore: Add registry

* chore: Add mod file

* chore: Add integration mod

* feat: Add network tags and readiness validation

* chore: Apply fmt

* feat: Add network selection utils for integration tests

* chore: Use openzeppelin_relayer package

* feat: Create confirmation receipt helper

* feat: Implement basic transfer

* feat: Implement common api tests

* fix: Resolve relayer test race conditions with cleanup and serialization

* refactor: Clean up integration tests and extract EVM helpers

* feat: Add integration testing Docker setup and reorganize contracts

* chore: clean up broadcast logs and vendor dependencies in test fixtures

* chore: remove git submodules for vendor dependencies

* chore: Add integration test key

* fix: Update .env.integration.example with defaults

* chore: Moving TESTING.md file to README

* fix: Ignoring signer files

* fix: CodeRabbit suggestion

* fix: CodeRabbit suggestion

* fix: Improving logs for test cases

* fix: Docker fixes

* chore: Adding base sepolia

* fix: Fixing CI

* fix: Fixing test case

* fix: Splitting tests in different jobs

* fix: Fixing tests

* fix: Fixing CI report

* fix: Applying review suggestions

* chore: Adding feature flags for running tests

* chore: Adding job for integration tests

* chore: Adding aws kms key logic

* fix: Removing unnecessary test files

* fix: Improvements

* chore: Config files and readme improvements

* chore: Fix integration test workflow

* fix: Removing unused code

* fix: Settings for connecting to aws from actions

* fix: Fixing account id

* fix: Fixing actions

* fix: Fixing GH actions

* fix: Fixing actions

* fix: Fixing secrets

* fix: Fixing GH secrets

* fix: Fixing actions

* fix: Fixing error

* fix: Fixing docker compose

* fix: API_KEY improvements

* chore: Codecov fix

* chore: Fix integratio test yaml file

* fix: Improving registry logic to be branch agnostic

* fix: Creating configs files

* fix: Fixing workflow

* fix: Fixing config example

* fix: Re-organizing folder structure

* fix: Fixing config files

* fix: Removing tags and fixing workflow

* feat: Adding basic tests for apis

* fix: Trigger tests manually

* chore: Renaming file

* fix: Fix CI unit tests

* fix: Fix codecov config

---------

Co-authored-by: Nicolas Molina <[email protected]>

Author: LuisUrrutia

.env.integration.example

@@ -0,0 +1,28 @@
+# Integration Test Environment Variables
+# Copy this file to .env.integration and fill in your values
+
+# ==============================================================================
+# Required Variables
+# ==============================================================================
+
+# API key for the relayer service
+API_KEY=your-api-key-here
+
+# Keystore passphrase for local signer
+KEYSTORE_PASSPHRASE=your-keystore-passphrase-here
+
+# Webhook signing key (can be any UUID)
+WEBHOOK_SIGNING_KEY=your-webhook-signing-key-here
+
+# ==============================================================================
+# Network Selection
+# ==============================================================================
+# Network selection is controlled via tests/integration/registry.json
+# Enable/disable networks by setting "enabled": true/false in registry.json
+
+# ==============================================================================
+# Optional Configuration
+# ==============================================================================
+
+# Relayer API URL (automatically set in docker-compose, override if needed)
+# RELAYER_API_URL=http://relayer:8080/api/v1

.github/actions/oidc/action.yml

@@ -0,0 +1,44 @@
+---
+name: AWS OIDC Credentials via Role Assume Chaining
+description: Retrieve AWS credentials by chaining role assumes
+inputs:
+  role-for-oidc:
+    description: The role that should be used for GitHub OIDC authentication
+    required: true
+  role-to-assume:
+    description: The role that should be finally assumed
+    required: true
+  role-session-name:
+    description: The session name that should be used when assuming roles
+    required: true
+    default: github-actions
+  role-duration-seconds:
+    description: duration of the credentials validity
+    required: true
+    default: 3600
+  aws-region:
+    description: The AWS region
+    required: false
+    default: us-east-1
+runs:
+  using: composite
+  steps:
+    - name: assume oidc role
+      uses: aws-actions/configure-aws-credentials@ececac1a45f3b08a01d2dd070d28d111c5fe6722  # v4.1.0
+      with:
+        aws-region: us-east-1
+        role-to-assume: ${{ inputs.role-for-oidc }}
+        role-session-name: ${{ inputs.role-session-name }}
+        role-duration-seconds: 900
+    - name: assume target role
+      uses: aws-actions/configure-aws-credentials@ececac1a45f3b08a01d2dd070d28d111c5fe6722  # v4.1.0
+      id: assume-target-role
+      with:
+        aws-access-key-id: ${{ env.AWS_ACCESS_KEY_ID }}
+        aws-secret-access-key: ${{ env.AWS_SECRET_ACCESS_KEY }}
+        aws-session-token: ${{ env.AWS_SESSION_TOKEN }}
+        aws-region: ${{ inputs.aws-region }}
+        role-chaining: true
+        role-to-assume: ${{ inputs.role-to-assume }}
+        role-session-name: ${{ inputs.role-session-name }}
+        role-duration-seconds: ${{ inputs.role-duration-seconds }}

.github/codecov.yml

@@ -1,34 +1,38 @@
+---
+codecov:
+  notify:
+    after_n_builds: 3  # Wait for all 3 flag uploads (ai, dev, properties)
+    wait_for_ci: true  # Wait for CI to complete before sending status
 coverage:
   precision: 2
   round: down
   range: 70..100
-
   status:
     project:
       default:
         target: 85%
         threshold: 2%
+        flags:
+          - ai
+          - dev
+          - properties
     patch:
       default:
         target: auto
         threshold: 1%
-
 flags:
   ai:
     paths:
-      - "src/"
+      - src/
     carryforward: true
-
   dev:
     paths:
-      - "src/"
+      - src/
     carryforward: true
-
 comment:
-  layout: "flags, diff, files"
+  layout: flags, diff, files
   require_changes: false
   behavior: default
-
 ignore:
-  - "tests/*"
-  - "target/*"
+  - tests/*
+  - target/*