Maintain derived trades during sync

[findolor]

Chained PRs

Depends on #2587. Stack order: #2587 -> #2588 -> #2589 -> #2590

Motivation

derived_trades must be maintained by the same local DB sync pipeline that writes source events and state, otherwise producer bootstrap DBs and client incremental syncs can diverge from read-path expectations.

Solution

• Add upsert_derived_trades SQL and builder utilities.
• Delete and rebuild derived rows whose trade event block is inside the sync window.
• Allow the rebuild query to read older order_events so trade rows can resolve the latest active AddOrderV3 even when the order add predates the window.
• Wire derived-trade maintenance into the apply transaction before the target watermark update.

Checks

• COMMIT_SHA=local nix develop -c cargo test -p raindex_common local_db::query --lib
• COMMIT_SHA=local nix develop -c cargo test -p raindex_common local_db::pipeline::adapters::apply --lib
• COMMIT_SHA=local nix develop -c cargo test -p raindex_common local_db::export --lib
• COMMIT_SHA=local nix develop -c cargo test -p raindex_common raindex_client::trades --lib

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 0a65eb33-6372-434c-8d24-dc5ac0d14efa

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch arda/derived-trades-maintenance

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[findolor]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Superseded: Materialize vault deltas for balance sync #2591
• Test derived trades integration #2590
• Read trades from derived table #2589
• Maintain derived trades during sync #2588 👈 (View in Graphite)
• Add derived trades local DB read model #2587
• main

---

How to use the Graphite Merge Queue

Add the label Raindex-queue to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[findolor]

Folded into #2587 so the derived-trades local DB schema generation lands atomically.