Skip to content

TESTING.md

Latest commit

 

History

History
72 lines (56 loc) · 2.12 KB

TESTING.md

File metadata and controls

72 lines (56 loc) · 2.12 KB
Raw

Testing

This repository uses Chrome-based Flutter tests because parts of the app depend on browser-only libraries and wallet interop code.

Default Verify Path

Run the same command expected from contributors:

./scripts/verify.sh

That runs:

flutter pub get
flutter analyze
flutter test -r expanded --platform chrome

If this command passes, the open-source contributor baseline is green.

Running Checks Individually

flutter pub get
flutter analyze
flutter test --platform chrome
flutter test --platform chrome test/widget_test.dart
flutter test --platform chrome test/runtime_config_test.dart

What The Automated Suite Covers

  • runtime configuration defaults
  • app shell bootstrapping
  • provider logic for batches and transfer-related state
  • DTO serialization and deserialization
  • local storage persistence
  • utility and formatting helpers
  • selected Ledger helper code

Manual Browser And Wallet Checklist

Use this before publishing or after touching wallet integrations.

  1. Start the backend on http://localhost:6060
  2. Optionally export GRAVITY_WEBGRPC_URL if you want live transaction history and progress data
  3. Optionally export GRAVITY_INFO_URL to point at a trusted GravityInfo API
  4. Run ./scripts/run-local.sh
  5. Open the local app in Chrome
  6. Confirm the landing shell renders without missing assets or console errors
  7. Connect MetaMask
  8. Connect Keplr or Leap
  9. Open token selection and transfer dialogs
  10. Verify bridge data, fee panels, and route selection load correctly
  11. Trigger a transfer flow far enough to validate dialog state and wallet handoff behavior

Troubleshooting

  • flutter test --platform chrome requires Chrome to be installed locally
  • if transaction history looks empty in local runs, set GRAVITY_WEBGRPC_URL to a working grpc-web endpoint
  • if GravityInfo requests fail locally, set GRAVITY_INFO_URL to a reachable GravityInfo-compatible API
  • analytics stays disabled unless ENABLE_ANALYTICS=true and the required Firebase values are provided
  • wallet-extension issues are usually easiest to reproduce with a clean Chrome profile