refactor: modularize Anvil testing with separate setup and run scripts

- Create modular test scripts for better flexibility
- Add setup-local-chain.sh to start Anvil and deploy contracts
- Add run-tests.sh to run tests against existing chain
- Add test-all.sh for complete test runs
- Add cleanup.sh to stop all test processes
- Update .gitignore to exclude test logs and env files
- Remove old monolithic test-with-anvil.sh script
- Add comprehensive documentation in scripts/README.md

This allows developers to:
- Set up chain once and run tests multiple times
- Run different test suites independently
- Better integrate with CI/CD pipelines
- Debug issues more easily with separate logs

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: h4x3rotab

kms/auth-eth/.gitignore

@@ -2,3 +2,10 @@
 /cache
 /dist
 /out
+
+# Test logs
+anvil-test.log
+anvil.log
+deploy.log
+server-test.log
+.env.test

kms/auth-eth/package.json

@@ -12,8 +12,12 @@
     "test:coverage": "jest --coverage",
     "test:foundry": "forge test --ffi",
     "test:foundry:all": "forge clean && forge build && forge test --ffi",
-    "test:full": "./scripts/test-with-anvil.sh",
-    "test:full:keep": "./scripts/test-with-anvil.sh --keep-running"
+    "test:setup": "./scripts/setup-local-chain.sh",
+    "test:run": "./scripts/run-tests.sh",
+    "test:run:foundry": "./scripts/run-tests.sh --with-foundry",
+    "test:all": "./scripts/test-all.sh",
+    "test:all:foundry": "./scripts/test-all.sh --with-foundry",
+    "test:cleanup": "./scripts/cleanup.sh"
   },
   "dependencies": {
     "@fastify/swagger": "^8.12.0",

kms/auth-eth/scripts/README.md

@@ -0,0 +1,125 @@
+# Test Scripts
+
+This directory contains automated test scripts for the DStack KMS Ethereum backend.
+
+## Scripts Overview
+
+### 🚀 setup-local-chain.sh
+Sets up a local Anvil blockchain and deploys the DStack contracts.
+- Starts Anvil on port 8545
+- Deploys DstackKms and DstackApp contracts
+- Saves configuration to `.env.test`
+
+```bash
+npm run test:setup
+# or
+./scripts/setup-local-chain.sh
+```
+
+### 🧪 run-tests.sh
+Runs all tests against the deployed contracts on the local chain.
+- Requires local chain to be already set up
+- Runs Jest unit tests
+- Runs integration tests
+- Optionally runs Foundry tests
+
+```bash
+npm run test:run              # Run JS/TS tests only
+npm run test:run:foundry      # Include Foundry tests
+# or
+./scripts/run-tests.sh
+./scripts/run-tests.sh --with-foundry
+```
+
+### 🎯 test-all.sh
+Complete test suite - sets up chain and runs all tests.
+- Combines setup-local-chain.sh and run-tests.sh
+- Perfect for CI/CD or fresh test runs
+
+```bash
+npm run test:all              # Complete test suite
+npm run test:all:foundry      # Include Foundry tests
+# or
+./scripts/test-all.sh
+./scripts/test-all.sh --with-foundry
+```
+
+### 🧹 cleanup.sh
+Cleans up all test processes and temporary files.
+- Stops Anvil and API server
+- Removes temporary files and logs
+
+```bash
+npm run test:cleanup
+# or
+./scripts/cleanup.sh
+```
+
+## Typical Workflows
+
+### One-time Setup, Multiple Test Runs
+```bash
+# Set up once
+npm run test:setup
+
+# Run tests multiple times
+npm run test:run
+npm run test:run
+npm run test:run
+
+# Clean up when done
+npm run test:cleanup
+```
+
+### Complete Test Run
+```bash
+# Run everything in one go
+npm run test:all
+
+# Or with Foundry tests
+npm run test:all:foundry
+```
+
+### Development Workflow
+```bash
+# Set up chain
+npm run test:setup
+
+# Keep chain running, develop and test
+npm run test:run
+# ... make changes ...
+npm run test:run
+# ... make more changes ...
+npm run test:run
+
+# Clean up when done
+npm run test:cleanup
+```
+
+## Environment Variables
+
+After running `setup-local-chain.sh`, the following environment variables are saved to `.env.test`:
+
+- `ANVIL_PID` - Process ID of the Anvil instance
+- `ETH_RPC_URL` - RPC endpoint (http://127.0.0.1:8545)
+- `CHAIN_ID` - Chain ID (31337)
+- `KMS_CONTRACT_ADDR` - Deployed KMS proxy contract address
+- `APP_IMPLEMENTATION` - DstackApp implementation address
+- `KMS_IMPLEMENTATION` - DstackKms implementation address
+- `DEPLOYER_ADDRESS` - Address that deployed the contracts
+- `DEPLOYER_PRIVATE_KEY` - Private key of the deployer
+
+## Logs
+
+The scripts generate the following log files:
+
+- `anvil.log` - Anvil blockchain logs
+- `deploy.log` - Contract deployment logs
+- `server-test.log` - API server logs during tests
+
+## Requirements
+
+- Node.js and npm
+- Foundry (forge, anvil)
+- All npm dependencies installed (`npm install`)
+

kms/auth-eth/scripts/cleanup.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# Cleanup script to stop all test processes
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+ENV_FILE="$PROJECT_ROOT/.env.test"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+echo "🧹 Cleaning up test environment..."
+
+# Kill any running API servers
+echo "Stopping API servers..."
+pkill -f "ts-node src/main.ts" || true
+pkill -f "node dist/main.js" || true
+
+# Load environment if exists
+if [ -f "$ENV_FILE" ]; then
+    source "$ENV_FILE"
+    
+    # Kill Anvil if PID is set
+    if [ ! -z "$ANVIL_PID" ]; then
+        echo "Stopping Anvil (PID: $ANVIL_PID)..."
+        kill $ANVIL_PID 2>/dev/null || true
+    fi
+fi
+
+# Kill any other Anvil processes
+echo "Stopping any other Anvil processes..."
+pkill -f "anvil" || true
+
+# Clean up files
+echo "Removing temporary files..."
+rm -f "$PROJECT_ROOT/.env.test"
+rm -f "$PROJECT_ROOT/anvil.log"
+rm -f "$PROJECT_ROOT/deploy.log"
+rm -f "$PROJECT_ROOT/server-test.log"
+rm -f "$PROJECT_ROOT/integration-test.js"
+
+echo -e "${GREEN}✅ Cleanup complete!${NC}"