pre-requisities for running the build

Author: nidhi-singh02

target_chains/ethereum/contracts/.env.template

@@ -68,23 +68,3 @@ WORMHOLE_CHAIN_NAME=YOUR_CHAIN_NAME_HERE
 # Example: CLUSTER=mainnet
 CLUSTER=YOUR_CLUSTER_HERE
 
-# =============================================================================
-# EXAMPLE VALUES FOR REFERENCE
-# =============================================================================
-# 
-# For local testing (Anvil), you can use:
-#   PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
-#   RPC_URL=http://localhost:8545
-#   INIT_SIGNERS=0x58CC3AE5C097b213cE3c81979e1B9f9570746AA5
-#   INIT_CHAIN_ID=2
-#   INIT_GOV_CHAIN_ID=1
-#   INIT_GOV_CONTRACT=0x0000000000000000000000000000000000000000000000000000000000000004
-#
-# For testnet/mainnet deployment:
-#   - Get your private key from your wallet (never commit this!)
-#   - Use appropriate RPC URL (Alchemy, Infura, QuickNode, etc.)
-#   - Get Etherscan API key from https://etherscan.io/apis
-#   - Use actual guardian addresses from your network
-#   - Set proper chain IDs and governance contracts
-#
-# ⚠️  SECURITY WARNING: Never commit your actual .env file to version control!

target_chains/ethereum/contracts/.env.test

@@ -1,7 +1,6 @@
 # =============================================================================
 # FOUNDRY TEST CONFIGURATION
 # This file contains test values for local development and testing
-# Uses Foundry-native environment variable formats
 # =============================================================================
 
 # Deployment Configuration (Anvil/Local Testing)
@@ -13,7 +12,7 @@ ETHERSCAN_API_KEY=test_api_key_not_needed_for_local
 # WORMHOLE TEST CONFIGURATION  
 # =============================================================================
 
-# Guardian Configuration (comma-separated addresses - Foundry native)
+# Guardian Configuration (comma-separated addresses)
 INIT_SIGNERS=0x58CC3AE5C097b213cE3c81979e1B9f9570746AA5,0x025ceeba2ab2a27d53d963393999eeebe83dc4ae
 INIT_CHAIN_ID=2
 INIT_GOV_CHAIN_ID=1

target_chains/ethereum/contracts/FOUNDRY_ENV_GUIDE.md

@@ -4,7 +4,19 @@ This directory contains The Pyth contract on Ethereum and utilities to deploy it
 
 ## Installation
 
-The contracts are built and tested using Foundry. Follow the [Foundry installation instructions](https://book.getfoundry.sh/getting-started/installation) to install it if you do not already have it.
+The contracts are built and tested using Foundry. You can either:
+
+1. **Use the setup script (recommended)**: 
+Go to the `contracts` directory and Run `npm run setup` to automatically install Foundry v0.3.0 AND all forge dependencies.
+
+2. **Manual installation**: 
+a) Follow the [Foundry installation instructions](https://book.getfoundry.sh/getting-started/installation) and install version v0.3.0.
+
+b) Next, from the `contracts` directory, run the following command to install forge dependencies:
+
+```
+npm run install-forge-deps
+```
 
 Next, run the following command from the repo root to install required dependencies for the contract:
 
@@ -13,11 +25,7 @@ pnpm i
 pnpm turbo build --filter @pythnetwork/pyth-evm-contract
 ```
 
-Next, from the `contracts` directory, run the following command to install forge dependencies:
 
-```
-npm run install-forge-deps
-```
 
 ## Testing
 
@@ -34,7 +42,7 @@ npm run coverage
 
 Open `coverage/index.html` in your web browser to see the results.
 
-## Deployment
+## Deployment and Governance tests
 
 To deploy the contracts, you'll need to set up your environment variables and use the Foundry deployment script.
 
@@ -55,7 +63,13 @@ anvil
 npm run deploy-local
 ```
 
-3. Deploy to a live network:
+3. Run the test suite:
+
+```bash
+npm run test
+```
+
+4. Deploy to a live network:
 
 ```bash
 # Make sure your .env file has the correct RPC_URL and PRIVATE_KEY

target_chains/ethereum/contracts/README.md

@@ -11,9 +11,10 @@
     "prettier-plugin-solidity": "catalog:"
   },
   "scripts": {
+    "setup-foundry": "./setup-foundry.sh",
+    "setup": "npm run setup-foundry && npm run install-forge-deps",
     "build": "forge build",
     "test": "forge test",
-    "test-contract": "forge test",
     "deploy": "forge script script/Deploy.s.sol --rpc-url $RPC_URL --broadcast --verify",
     "deploy-local": "forge script script/Deploy.s.sol --rpc-url http://localhost:8545 --broadcast",
     "sync-guardian-sets": "forge script script/SyncGuardianSets.s.sol --rpc-url $RPC_URL --broadcast",

target_chains/ethereum/contracts/package.json

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Complete Forge setup script - installs Foundry and dependencies
+set -e
+
+FOUNDRY_VERSION="v0.3.0"
+
+echo "Setting up complete Forge environment with Foundry ${FOUNDRY_VERSION}..."
+
+# Check if foundryup is available
+if ! command -v foundryup &> /dev/null; then
+    echo "Installing foundryup..."
+    curl -L https://foundry.paradigm.xyz | bash
+    export PATH="$HOME/.foundry/bin:$PATH"
+fi
+
+# Install the specific version
+echo "Installing Foundry ${FOUNDRY_VERSION}..."
+foundryup --version $FOUNDRY_VERSION
+
+# Verify installation
+echo "Verifying installation..."
+forge --version
+cast --version
+anvil --version
+
+echo "Foundry ${FOUNDRY_VERSION} installed successfully!"
+
+echo "Setup complete! You can now run install-forge-deps."