datahaven/test/cli/handlers/deploy/kurtosis.ts
Facundo Farall 9b311e00ef
test: 🏗️ Setup e2e testing framework (#104)
## Implement E2E Testing Framework with Isolated Networks

### Summary
Refactors the existing E2E testing infrastructure to provide isolated
test environments with parallel execution support. Each test suite now
runs in its own network namespace, preventing resource conflicts.

### Key Changes
- **New Testing Framework** (`test/framework/`): Base classes for test
lifecycle management with automatic setup/teardown
- **Launcher Module** (`test/launcher/`): Extracted network
orchestration logic from CLI handlers for reusability
- **Parallel Execution**: Added `test-parallel.ts` script with
concurrency limits to prevent resource exhaustion
- **Test Isolation**: Each suite gets unique network IDs (format:
`suiteName-timestamp`) and Docker networks
- **Improved Test Organization**: Migrated tests to new framework,
deprecated old test structure

### Test Improvements
- Added 4 new test suites demonstrating framework usage. :
  - `contracts.test.ts` - Smart contract deployment/interaction
  - `datahaven-substrate.test.ts` - Substrate API operations  
  - `cross-chain.test.ts` - Snowbridge cross-chain messaging
  - `ethereum-basic.test.ts` - Ethereum network operations

> [!WARNING]
The test suites themselves are bad and shouldn't be consider examples of
good tests. They were AI generated just to test the concurrency of test
runners

### Documentation
- Added comprehensive framework overview (`E2E_FRAMEWORK_OVERVIEW.md`)
- Updated README with parallel testing commands
- Added test patterns and best practices

### Breaking Changes
- Old test suites moved to `e2e - DEPRECATED/` directory
- Test execution now requires extending `BaseTestSuite` class

### Testing
Run tests with: `bun test:e2e` or `bun test:e2e:parallel` (with
concurrency limits)

### TODO
- [ ] Implement good test examples.
- [ ] Implement useful test utils (like waiting for an event to show up
in DataHaven or Ethereum).
- [ ] Enforce tests with CI (currently cannot be done due to
intermittent error when sending a transaction with PAPI).

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: undercover-cactus <lola@moonsonglabs.com>
2025-07-16 18:51:07 +02:00

37 lines
1.2 KiB
TypeScript

import type { DeployOptions } from "cli/handlers";
import invariant from "tiny-invariant";
import { logger, printDivider, printHeader } from "utils";
import { registerServices, runKurtosisEnclave } from "../../../launcher/kurtosis";
import type { LaunchedNetwork } from "../../../launcher/types/launchedNetwork";
/**
* Deploys a Kurtosis Ethereum network enclave for stagenet environment.
*
* @param options - Configuration options
* @param launchedNetwork - The LaunchedNetwork instance to store network details
*/
export const deployKurtosis = async (
options: DeployOptions,
launchedNetwork: LaunchedNetwork
): Promise<void> => {
if (options.skipKurtosis) {
logger.info("🏳️ Skipping Kurtosis deployment");
await registerServices(launchedNetwork, options.kurtosisEnclaveName);
printDivider();
return;
}
printHeader("Deploying Kurtosis Ethereum Network");
invariant(
options.isPrivateNetwork,
"❌ Kurtosis should only be used in private networks (local and stagenet)"
);
await runKurtosisEnclave(options, "configs/kurtosis/minimal.yaml");
await registerServices(launchedNetwork, options.kurtosisEnclaveName);
logger.success("Kurtosis network operations completed successfully.");
printDivider();
};