Development v2

.github/workflows/publish_npm_x402.yml

@@ -32,7 +32,7 @@ jobs:
           pnpm -r --filter=x402 run build
       
       - name: Publish x402 package
-        working-directory: ./typescript/packages/x402
+        working-directory: ./typescript/packages/legacy/x402
         run: |
           # Get package information directly
           PACKAGE_NAME=$(node -p "require('./package.json').name")

.github/workflows/publish_npm_x402_axios.yml

@@ -32,7 +32,7 @@ jobs:
           pnpm -r --filter=x402 --filter=x402-axios run build
 
       - name: Publish x402-axios package
-        working-directory: ./typescript/packages/x402-axios
+        working-directory: ./typescript/packages/legacy/x402-axios
         run: |
           # Get package information directly
           PACKAGE_NAME=$(node -p "require('./package.json').name")

.github/workflows/publish_npm_x402_express.yml

@@ -32,7 +32,7 @@ jobs:
           pnpm -r --filter=x402 --filter=x402-express run build
 
       - name: Publish x402-express package
-        working-directory: ./typescript/packages/x402-express
+        working-directory: ./typescript/packages/legacy/x402-express
         run: |
           # Get package information directly
           PACKAGE_NAME=$(node -p "require('./package.json').name")

.github/workflows/publish_npm_x402_fetch.yml

@@ -32,7 +32,7 @@ jobs:
           pnpm -r --filter=x402 --filter=x402-fetch run build
 
       - name: Publish x402-fetch package
-        working-directory: ./typescript/packages/x402-fetch
+        working-directory: ./typescript/packages/legacy/x402-fetch
         run: |
           # Get package information directly
           PACKAGE_NAME=$(node -p "require('./package.json').name")

.github/workflows/publish_npm_x402_hono.yml

@@ -26,7 +26,7 @@ jobs:
           pnpm -r --filter=x402 --filter=x402-hono run build
 
       - name: Publish x402-hono package
-        working-directory: ./typescript/packages/x402-hono
+        working-directory: ./typescript/packages/legacy/x402-hono
         run: |
           # Get package information directly
           PACKAGE_NAME=$(node -p "require('./package.json').name")

.github/workflows/publish_npm_x402_next.yml

@@ -26,7 +26,7 @@ jobs:
           pnpm -r --filter=x402 --filter=x402-next run build
           
       - name: Publish x402-next package
-        working-directory: ./typescript/packages/x402-next
+        working-directory: ./typescript/packages/legacy/x402-next
         run: |
           # Get package information directly
           PACKAGE_NAME=$(node -p "require('./package.json').name")

.gitignore

@@ -7,3 +7,5 @@ proxy
 .env
 __pycache__/
 **/.DS_Store
+e2e/facilitators/external-proxies/*
+!e2e/facilitators/external-proxies/README.md

e2e/.env-local

@@ -0,0 +1,7 @@
+# E2E Test Configuration
+SERVER_EVM_ADDRESS=
+SERVER_SVM_ADDRESS=
+CLIENT_EVM_PRIVATE_KEY=
+CLIENT_SVM_PRIVATE_KEY=
+FACILITATOR_EVM_PRIVATE_KEY=
+FACILITATOR_SVM_PRIVATE_KEY=

e2e/README.md

@@ -2,87 +2,125 @@
 
 End-to-end test suite for validating client-server-facilitator communication across languages and frameworks.
 
-## Environment Variables
+## Setup
 
-Required:
-- `ADDRESS`: Server wallet address
-- `PRIVATE_KEY`: Client private key (when running single client)
+### First Time Setup
 
-## Quick Start
+Install all dependencies (TypeScript via pnpm, Go, Python):
 
 ```bash
-# Full suite
-pnpm test                     # Run all tests
+pnpm install:all
+```
 
-# Development mode (recommended)
-pnpm test -d                  # Test on testnet
-pnpm test -d -v               # Test with verbose logging
+This will:
+1. Install TypeScript dependencies via `pnpm install`
+2. Run `install.sh` and `build.sh` for all clients, servers, and facilitators
+3. Handle nested directories (like `external-proxies/` and `local/`)
 
-# Language filters
-pnpm test -d -ts              # Test TypeScript implementations
-pnpm test -d -py              # Test Python implementations
-pnpm test -d -go              # Test Go implementations
+For legacy (v1) implementations as well:
+
+```bash
+pnpm install:all:legacy
 ```
 
-## Filtering Tests
+### Individual Setup
+
+If you only want to set up v2 implementations:
 
-### Implementation Filters
 ```bash
---client=<name>               # Test specific client
---server=<name>              # Test specific server
+pnpm setup
+```
 
-# Available implementations
-Clients: httpx, axios, fetch, requests
-Servers: express, fastapi, flask, gin, hono, next
+Or manually for a specific component:
 
-# Examples
-pnpm test -d -ts --client=axios     # Test TypeScript axios client
-pnpm test -d -py --server=fastapi   # Test Python FastAPI server
+```bash
+cd facilitators/go
+bash install.sh
+bash build.sh
 ```
 
-### Language Flags (can combine)
-```bash
--ts, --typescript              # TypeScript implementations
--py, --python                  # Python implementations
--go, --go                      # Go implementations
+## Usage
+
+### Interactive Test Mode
 
-# Examples
-pnpm test -ts -py             # Test TypeScript and Python together
-pnpm test -py -go             # Test Python and Go together
+```bash
+pnpm test
 ```
 
-### Environment Filters
+Launches an interactive CLI where you can select:
+- **Facilitators** - Payment verification/settlement services (Go, TypeScript)
+- **Servers** - Protected endpoints requiring payment (Express, Gin, Hono, Next.js, FastAPI, Flask, etc.)
+- **Clients** - Payment-capable HTTP clients (axios, fetch, httpx, requests, etc.)
+- **Extensions** - Additional features like Bazaar discovery
+- **Protocols** - EVM and/or SVM networks
+
+Every valid combination of your selections will be tested. For example, selecting 2 facilitators, 3 servers, and 2 clients will generate and run all compatible test scenarios.
+
+### Minimized Test Mode
+
 ```bash
---network=<name>              # base or base-sepolia
---prod=<true|false>          # true=CDP facilitator, false=no CDP
+pnpm test --min
+```
 
-# Examples
-pnpm test --prod=true        # Test production scenarios
-pnpm test --network=base     # Test on base network
+Same interactive CLI, but with intelligent test minimization:
+- **90% fewer tests** compared to full mode
+- Each selected component is tested at least once across all variations
+- Skips redundant combinations that provide no additional coverage
+- Example: `legacy-hono` (v1 only) tests once, while `express` (v1+v2, EVM+SVM) tests all 4 combinations
+
+Perfect for rapid iteration during development while maintaining comprehensive coverage.
+
+### Verbose Logging
+
+```bash
+pnpm test -v
+pnpm test --min -v
 ```
 
-### Common Workflows
+Add the `-v` flag to any command for verbose output:
+- Prints all facilitator logs
+- Prints all server logs  
+- Prints all client logs
+- Shows detailed information after each test scenario
+
+Useful for debugging test failures or understanding the payment flow.
+
+## Environment Variables
+
+Required environment variables (set in `.env` file):
 
 ```bash
-# Local Development
-pnpm test -d -ts                     # TypeScript development
-pnpm test -d -py                     # Python development
-pnpm test -d -ts --server=next       # Next.js middleware development
-pnpm test -d -py --client=httpx      # Python httpx client development
-
-# Cross-Language Testing
-pnpm test -ts -py                    # Test TypeScript/Python compatibility
-pnpm test -d -py -go                 # Test Python/Go on testnet
-
-# Production Testing
-pnpm test --prod=true -ts            # Test TypeScript in production
-pnpm test --network=base -py         # Test Python on base network
+# Client wallets
+CLIENT_EVM_PRIVATE_KEY=0x...        # EVM private key for client payments
+CLIENT_SVM_PRIVATE_KEY=...          # Solana private key for client payments
+
+# Server payment addresses
+SERVER_EVM_ADDRESS=0x...            # Where servers receive EVM payments
+SERVER_SVM_ADDRESS=...              # Where servers receive Solana payments
+
+# Facilitator wallets (for payment verification/settlement)
+FACILITATOR_EVM_PRIVATE_KEY=0x...   # EVM private key for facilitator
+FACILITATOR_SVM_PRIVATE_KEY=...     # Solana private key for facilitator
 ```
 
-### Environment Options
+## Example Session
 
 ```bash
--d, --dev                  # Development mode (testnet, no CDP)
--v, --verbose              # Detailed logging
---log-file=<path>          # Save output to file
+$ pnpm test --min
+
+🎯 Interactive Mode
+==================
+
+✔ Select facilitators › go, typescript
+✔ Select servers › express, hono, legacy-express
+✔ Select clients › axios, fetch, httpx
+✔ Select extensions › bazaar
+✔ Select protocol families › EVM, SVM
+
+📊 Coverage-Based Minimization
+Total scenarios: 156
+Selected scenarios: 18 (88.5% reduction)
+
+✅ Passed: 18
+❌ Failed: 0
 ```