Clean up documentation and remove script overlaps

- Replace foundry-cast-cheatsheet.md with migration notice
- Remove duplicate Interact.s.sol file
- Remove duplicate ShowKmsInfo from Manage.s.sol
- Streamline README.md, TESTING.md to focus on essentials
- Update script/README.md to remove development notes
- All Cast operations now covered by type-safe Foundry scripts

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

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

Author: h4x3rotab

kms/auth-eth/README.md

@@ -35,48 +35,12 @@ npm run build
 
 ## Testing
 
-The project uses Foundry for testing with proper separation between core functionality and upgrade testing.
-
-### Core Functionality Tests
-
-Test the basic features of the contracts without upgrade-related functionality:
-
-```bash
-# Test DstackApp core functionality (11 tests)
-forge test --ffi --match-path "test/DstackApp.t.sol"
-
-# Test DstackKms core functionality (16 tests)  
-forge test --ffi --match-path "test/DstackKms.t.sol"
-
-# Run both core functionality test suites
-forge test --ffi --match-path "test/DstackApp.t.sol" && forge test --ffi --match-path "test/DstackKms.t.sol"
-```
-
-### Upgrade Tests
-
-Test upgrade functionality and contract migration scenarios using OpenZeppelin Foundry Upgrades plugin:
-
-```bash
-# Test comprehensive upgrade scenarios with plugin
-forge test --ffi --match-path "test/UpgradesWithPlugin.t.sol"
-```
-
 ### Run All Tests
-
 ```bash
-# Run all tests (36 tests total)
 forge test --ffi
-
-# Or run specific test suites
-forge test --ffi --match-path "test/DstackApp.t.sol" && \
-forge test --ffi --match-path "test/DstackKms.t.sol" && \
-forge test --ffi --match-path "test/UpgradesWithPlugin.t.sol"
 ```
 
 ### Local Integration Testing
-
-The project includes automated scripts for testing against a local Anvil blockchain:
-
 ```bash
 # Quick test workflow
 npm run test:all          # Sets up chain, deploys contracts, runs all tests
@@ -86,60 +50,71 @@ npm run test:all:foundry  # Also includes Foundry tests
 npm run test:setup        # Start Anvil and deploy contracts
 npm run test:run          # Run tests against deployed contracts
 npm run test:cleanup      # Stop all test processes
-
-# Available NPM scripts for testing
-npm test                  # Run Jest unit tests
-npm run test:foundry      # Run Foundry tests with FFI
 ```
 
-### Test Coverage Summary
-
-- ✅ **DstackApp.t.sol**: 11/11 tests PASS - Core app functionality
-- ✅ **DstackKms.t.sol**: 16/16 tests PASS - Core KMS functionality  
-- ✅ **UpgradesWithPlugin.t.sol**: 9/9 tests PASS - Comprehensive upgrade scenarios
-
 **Total: 36/36 tests PASSING (100% success rate)**
 
-## Important Notes
-
-- **FFI Flag Required**: Tests use the `--ffi` flag because they rely on the OpenZeppelin Foundry Upgrades plugin
-- **Clean Builds**: If you encounter OpenZeppelin validation errors, run `forge clean && forge build` before testing
-- **Test Organization**: Basic functionality tests use OpenZeppelin plugin for deployment (production-like) but don't test upgrading. All upgrade testing is isolated in dedicated test files.
+## Contract Management
 
-## Contract Deployment
-
-The contracts are designed to be deployed as UUPS proxies. The project includes deployment scripts:
+Use Foundry scripts for all contract operations instead of Cast commands:
 
+### Deployment
 ```bash
-# Deploy to local Anvil
+# Deploy both contracts
 forge script script/Deploy.s.sol:DeployScript --broadcast --rpc-url http://localhost:8545
 
 # Deploy to other networks
 forge script script/Deploy.s.sol:DeployScript --broadcast --rpc-url <RPC_URL> --private-key <PRIVATE_KEY>
 ```
 
-Available deployment scripts:
-- `DeployScript` - Deploys both DstackKms and DstackApp
-- `DeployKmsOnly` - Deploys only DstackKms (requires APP_IMPLEMENTATION env var)
-- `DeployAppOnly` - Deploys only DstackApp implementation
+### Management Operations
+```bash
+# Add KMS aggregated MR
+KMS_CONTRACT_ADDR=0x... MR_AGGREGATED=0x1234... \
+forge script script/Manage.s.sol:AddKmsAggregatedMr --broadcast --rpc-url $RPC_URL
+
+# Deploy new app via factory
+KMS_CONTRACT_ADDR=0x... APP_OWNER=0x... \
+forge script script/Manage.s.sol:DeployApp --broadcast --rpc-url $RPC_URL
+```
+
+### Query Operations
+```bash
+# Get KMS settings
+KMS_CONTRACT_ADDR=0x... \
+forge script script/Query.s.sol:GetKmsSettings --rpc-url $RPC_URL
+
+# Check if device is allowed
+APP_CONTRACT_ADDR=0x... DEVICE_ID=0x1234... \
+forge script script/Query.s.sol:CheckAppDevice --rpc-url $RPC_URL
+```
+
+### Safe Upgrades
+```bash
+# Upgrade KMS to V2
+KMS_CONTRACT_ADDR=0x... \
+forge script script/Upgrade.s.sol:UpgradeKmsToV2 --broadcast --rpc-url $RPC_URL --ffi
+```
+
+See `script/README.md` for complete documentation of all available scripts.
 
 ## BootAuth Server
 
-The project includes a Fastify-based HTTP server that provides TEE boot validation services:
+The project includes a Fastify-based HTTP server for TEE boot validation:
 
-### Server Endpoints:
+### Endpoints
 - **`GET /`** - Health check and contract information
 - **`POST /bootAuth/app`** - Validate application boot information
 - **`POST /bootAuth/kms`** - Validate KMS boot information
 
-### Configuration:
+### Configuration
 Set these environment variables:
 - **`ETH_RPC_URL`** - Ethereum RPC endpoint (default: `http://localhost:8545`)
 - **`KMS_CONTRACT_ADDR`** - Deployed DstackKms contract address
 - **`PORT`** - Server port (default: `8000`)
 - **`HOST`** - Server host (default: `127.0.0.1`)
 
-### Running the Server:
+### Running the Server
 ```bash
 # Development mode
 npm run dev
@@ -151,27 +126,7 @@ npm run build && npm start
 npm test
 ```
 
-## Migration Status
-
-This project has been successfully migrated from Hardhat to Foundry while maintaining:
-- Complete test coverage of core functionality
-- Proper separation between basic functionality and upgrade testing  
-- Production-like deployment patterns using OpenZeppelin upgrades
-- All essential contract features and security properties
-
----
-
-## Foundry Reference
-
-**Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust.**
-
-Foundry consists of:
-- **Forge**: Ethereum testing framework (like Truffle, Hardhat and DappTools).
-- **Cast**: Swiss army knife for interacting with EVM smart contracts, sending transactions and getting chain data.
-- **Anvil**: Local Ethereum node, akin to Ganache, Hardhat Network.
-- **Chisel**: Fast, utilitarian, and verbose solidity REPL.
-
-### Additional Foundry Commands
+## Additional Commands
 
 ```bash
 # Format code
@@ -182,14 +137,6 @@ forge snapshot
 
 # Start local node
 anvil
-
-# Deploy contracts
-forge script script/Deploy.s.sol --rpc-url <your_rpc_url> --private-key <your_private_key>
-
-# Help
-forge --help
-anvil --help
-cast --help
 ```
 
-Documentation: https://book.getfoundry.sh/
+Documentation: https://book.getfoundry.sh/

kms/auth-eth/TESTING.md

@@ -1,25 +1,22 @@
-# Testing Guide for DStack KMS Auth
+# Testing Guide
 
-Complete testing with **Foundry only** - no Hardhat dependencies.
-
-## 🏗️ Smart Contract Testing
+## Smart Contract Testing
 
 ```bash
-npm run test:foundry:all    # All smart contract tests (36 tests)
+# Run all tests (36 tests total)
+forge test --ffi
 ```
 
-Covers: Core logic, upgrades, authorization, gas optimization
-
-## 🌐 API Server Testing
+## API Server Testing
 
-### Unit Tests (Fast)
+### Unit Tests
 ```bash
 npm test                    # Jest with mocked blockchain (4 tests)
 ```
 
-### Integration Tests (Real Blockchain)
+### Integration Tests
 ```bash
-npm run test:full           # Complete: Anvil + Deploy + API tests + Cleanup
+npm run test:all           # Complete: Anvil + Deploy + API tests + Cleanup
 ```
 
 This automatically:
@@ -29,25 +26,23 @@ This automatically:
 4. Tests all endpoints
 5. Cleans up
 
-## 🔧 Manual Testing
+## Manual Testing
 
 ### Start Services
 ```bash
-npm run test:full:keep      # Keep Anvil + API server running
+npm run test:setup         # Start Anvil and deploy contracts
+npm run dev                # Start API server in development mode
 ```
 
 ### Test Endpoints
 ```bash
 curl http://127.0.0.1:8000/                    # Health check
 curl -X POST http://127.0.0.1:8000/bootAuth/app \
   -H "Content-Type: application/json" \
-  -d '{"tcbStatus":"UpToDate","advisoryIds":[],"mrAggregated":"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef","osImageHash":"0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd","mrSystem":"0x9012901290129012901290129012901290129012901290129012901290129012","appId":"0x9012345678901234567890123456789012345678","composeHash":"0xabcdabcdabcdabcdabcdabcdabcdabcdabcdabcdabcdabcdabcdabcdabcdabcd","instanceId":"0x3456789012345678901234567890123456789012","deviceId":"0xef12ef12ef12ef12ef12ef12ef12ef12ef12ef12ef12ef12ef12ef12ef12ef12"}'
+  -d '{"tcbStatus":"UpToDate","advisoryIds":[],"mrAggregated":"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef","osImageHash":"0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd"}'
 ```
 
-## 🚀 CI/CD Pipeline
-
+### Cleanup
 ```bash
-npm test                    # Fast unit tests
-npm run test:foundry:all    # Complete contract tests  
-npm run build               # Build check
+npm run test:cleanup       # Stop all test processes
 ```