Prasanna/surfpool poc

[prasanna-anchorage]

Summary

This PoC adds comprehensive testing infrastructure and deployment capabilities for Jupiter swap visualization on Solana, building on the foundation of improved token mapping.

Work Done

New: Solana Test Utils Crate (src/solana_test_utils/)

Complete testing framework including:

• Fixture System: Transaction builder and manager for creating realistic test scenarios
• Nightly Testing: Automated daily Jupiter trading pairs validation
  • Fetches live trading data from Jupiter API via Helius
  • Tests parser against real-world routes
  • Generates detailed reports and metrics
• Surfpool Integration: Advanced transaction simulation capabilities
• Validation Framework: Comprehensive assertion system for transaction parsing
• Configuration: Pairs configuration for flexible test scenarios

CI/CD Enhancement

• Nightly Jupiter Workflow (.github/workflows/nightly-jupiter.yml)
  • Runs daily at 2 AM UTC (configurable via secrets)
  • Caches cargo artifacts for performance
  • Supports optional Surfpool installation
  • Generates test reports and uploads artifacts
  • Optional Slack notifications

Deployment Artifacts

• Docker container images (parser_app.tar, parser_host.tar)
• Docker manifest.json for image registry
• Parser startup script (scripts/start-parser.sh)

Minor Improvements

• Solana core instruction parsing refinement
• Jupiter swap preset minor adjustment

Testing

Running Tests Locally

Basic fixture and validation tests (no external dependencies):

cd src
cargo test -p solana_test_utils --lib

Transaction validation tests:

cd src
cargo test -p solana_test_utils --test surfpool_tests -- --nocapture

Nightly Jupiter trading pairs test (requires Helius API key):

export HELIUS_API_KEY=your_helius_api_key_here
cd src
cargo test -p solana_test_utils --test nightly_jupiter -- --ignored --nocapture

Surfpool Integration (Optional)

Surfpool is installed and available for advanced transaction simulation:

# Verify Surfpool is installed
surfpool -V

# Run tests that require Surfpool (currently have compatibility issues with latest Surfpool CLI)
# These are marked with #[ignore] and require Surfpool to be running separately
cd src
cargo test -p solana_test_utils --test surfpool_tests -- --ignored --nocapture

Note: Surfpool integration tests require the Surfpool binary and may need CLI updates for compatibility with the latest Surfpool version.

Configuration

Edit src/solana_test_utils/config/pairs_config.toml to customize trading pairs tested:

[[pairs]]
name = "SOL-USDC"
input_mint = "So11111111111111111111111111111111111111112"
output_mint = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
enabled = true
min_transactions = 5

Test Reports

Reports are generated in src/solana_test_utils/reports/nightly/:

• latest.md - Human-readable report
• latest.json - Structured report data
• Timestamped archives for historical tracking

Next Steps: Multichain Testing

To make testing truly multichain, the next step is to implement the external integration testing proposal:

→ External Integration Testing Proposal

This will enable comprehensive cross-chain testing and validation across Solana, Ethereum, and other supported chains.