Implement Ethereum DEX Trade Mirroring Detection Linked to Stellar Wallet Behaviour

[Inkman007]

Description

Cross-chain wash trading — where the same actor runs coordinated manipulation across Stellar DEX and Ethereum DEX (Uniswap, Curve) — is a known evasion tactic. The existing detection/cross_chain/ module has a resolver and identity graph but does not yet pull Ethereum DEX trade data or correlate it with Stellar activity. This issue asks you to implement Ethereum DEX trade mirroring detection: identifying Stellar wallets whose trading patterns are statistically mirrored on Ethereum within a short time window.

What needs to be built

• Add detection/cross_chain/ethereum_dex_loader.py that queries Ethereum DEX trade history from The Graph protocol (subgraph queries for Uniswap v3 and Curve) via GraphQL.
• Implement detect_mirrored_trades(stellar_wallet, eth_address, window_seconds=300) in detection/cross_chain/behavioral_matcher.py that computes a mirroring score: fraction of trades on Stellar with a matching trade (same asset pair, opposite direction, similar amount) on Ethereum within the time window.
• Add the mirroring score as a new feature (eth_mirror_score) in detection/feature_engineering.py.
• Resolve Stellar ↔ Ethereum address linkages from the existing detection/cross_chain/identity_graph.py.

Requirements

Functional

• Ethereum data fetcher must respect rate limits of The Graph hosted service (max 1000 queries/day on free tier); cache responses in the existing feature cache with a 1-hour TTL.
• The mirroring score must gracefully return 0.0 when no Ethereum address is linked to the Stellar wallet (not an error).

Testing

• Unit test: construct two synthetic trade sequences (one Stellar, one Ethereum) with 80% mirror overlap; assert mirroring score > 0.7.
• Test: no linked Ethereum address; assert mirroring score = 0.0 and no exception.

Security

• GraphQL queries to The Graph must be sanitised; wallet addresses must be validated as checksummed Ethereum addresses before insertion into queries.

Documentation

• Add a section to docs/cross_venue_detection.md explaining the Ethereum mirroring detection approach and its limitations (requires prior cross-chain identity resolution).

Contributor guidance

Area of specialty: Cross-chain blockchain analytics, GraphQL, Python, Ethereum/Stellar.

How to contribute:

1. Comment describing your experience querying The Graph or Ethereum on-chain data.
2. Describe how you would handle the address resolution uncertainty (Stellar ↔ Ethereum links are probabilistic, not definitive).
3. PR must include the GraphQL query, the mirroring score calculation, and both unit tests.

[neyij]

@neyij has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

hi, i would like to work on this.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @neyij to this issue.

[lawrettaumebe710-maker]

@lawrettaumebe710-maker has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello please can I help you fix this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @lawrettaumebe710-maker to this issue.

[chiemezie1]

@chiemezie1 has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello, I have reviewed the issue and understand what needs to be done.

I would appreciate being assigned to it.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @chiemezie1 to this issue.

[soyaya]

@soyaya has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Can i be assigned to this task ? i will be done at record time.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @soyaya to this issue.

[grantfox-oss]

🦊 GrantFox — @soyaya has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #210)
2. Your PR will be reviewed by the Ledger-Lenz maintainers

Good luck! Track your progress on GrantFox.

[drips-wave]

Congratulations, @soyaya! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @soyaya: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊