chore: reorganize e2e tests + support preview

docs/docs/development/qa-regression.md

@@ -8,7 +8,7 @@ description: Testing methodology and procedures for releases
 
 The following steps are performed as part of the QA process for new releases:
 
-1. **E2E Testing**: Run the complete end-to-end test flow on preprod network using the [`e2e_tests`](https://github.com/cardano-foundation/cardano-rosetta-java/tree/main/e2e_tests) suite
+1. **E2E Testing**: Run the complete end-to-end test flow on preprod network using the [`e2e`](https://github.com/cardano-foundation/cardano-rosetta-java/tree/main/tests/e2e) suite
 
    - Verify all construction API flows work correctly
 

tests/e2e/.env.example

@@ -0,0 +1,27 @@
+# Rosetta API endpoint
+ROSETTA_ENDPOINT=http://localhost:8082/
+
+# Network to use (mainnet, preprod, preview)
+CARDANO_NETWORK=preview
+
+# Blockfrost project ID for on-chain validation and wallet preparation
+# Get one at https://blockfrost.io — must match CARDANO_NETWORK
+BLOCKFROST_PROJECT_ID=your_blockfrost_project_id
+
+# Test wallet mnemonic - NEVER use a real wallet with funds
+TEST_WALLET_MNEMONIC="test test test test test test test test test test test test"
+
+# Stake pool hash (hex) — must exist on-chain
+# Use `uv run prepare_wallet.py lookup` to find one
+STAKE_POOL_HASH=d9812f8d30b5db4b03e5b76cfd242db9cd2763da4671ed062be808a0
+
+# DRep IDs (hex, without the 22/23 credential type prefix)
+# Blockfrost returns hex with prefix: 22=key hash, 23=script hash — strip it
+# Use `uv run prepare_wallet.py lookup` to find these
+DREP_KEY_HASH_ID=03ccae794affbe27a5f5f74da6266002db11daa6ae446aea783b972d
+DREP_SCRIPT_HASH_ID=2d4cb680b5f400d3521d272b4295d61150e0eff3950ef4285406a953
+
+# Pool scenarios
+POOL_REGISTRATION_CERT=8a03581c2dcfdb151c8f8688359b252034a987adb7ea952eefd1562e0fa3d6bd5820544a0e0979dbdcbbcfe8c2c93cf7c2007de142f25b4e7dc3afb1560410bee7b01a004c4b401a002dc6c0d81e820101581de06bc0fb7bf3fb63213db81655a33d8c4a7c1c7e4bd75fc33ff176784bd9010281581c6bc0fb7bf3fb63213db81655a33d8c4a7c1c7e4bd75fc33ff176784b8184001820445820f5d9505820f5d9ea167fd2e0b19647f18dd1e0826f706f6f6c4d6574616461746155726c58209ac2217288d1ae0b4e15c41b58d3e05a13206fd9ab81cb15943e4174bf30c90b
+POOL_GOVERNANCE_PROPOSAL_ID=c16d3ce65e05d1b439c32c336789565f10d59dbdf20742ac26b3c9cdc791469f00
+POOL_VOTE_CHOICE=yes

e2e_tests/.gitignore → tests/e2e/.gitignore

@@ -97,6 +97,7 @@ celerybeat.pid
 
 # Environments
 .env
+.*.env
 .venv
 env/
 venv/

e2e_tests/README.md → tests/e2e/README.md

@@ -16,7 +16,7 @@ End-to-end testing framework for Cardano's Rosetta API implementation.
 ## Directory Structure
 
 ```
-e2e_tests/
+tests/e2e/
 ├── rosetta_client/          # Rosetta API client
 │   ├── client.py            # API endpoint mapping
 │   ├── exceptions.py        # Custom exceptions
@@ -39,23 +39,16 @@ e2e_tests/
 ### Prerequisites
 
 - Python 3.11+
-- pip
+- [uv](https://docs.astral.sh/uv/)
 - Cardano Rosetta API endpoint
 - Test wallet with funds and at least 11 ada-only UTXOs
 - For native asset tests: at least 1 UTXO containing a token bundle and at least 1 ADA-only UTXO (≥ 5 ADA recommended to cover fee)
 
 ### Quick Start
 
 ```bash
-cd e2e_tests
-# First create a virtual environment
-python3 -m venv .venv
-# Activate the virtual environment
-source .venv/bin/activate  # On Linux/macOS
-# OR
-.\.venv\Scripts\activate   # On Windows
-# Then install dependencies
-pip install -r requirements.txt
+cd tests/e2e
+uv sync
 ```
 
 ### Configuration

tests/e2e/__init__.py

@@ -0,0 +1 @@
+# e2e package