[Tracking] Deployed preview state — split-source, do not merge

[alastairong1]

Purpose

This is a tracking PR, not for merge. It captures the full state currently deployed to https://api.preview.st0x.io so the per-topic PRs below can be reviewed against a single source of truth.

Once the per-topic PRs land in dependency order, this branch becomes redundant and the PR can be closed.

---

What's in the deployed branch

Built on top of b1ebea3 (the now-reverted direct push). Includes:

Already committed (4 commits ahead of pre-revert main):

• 37596c4 — order_bytes in OrderSummary → covered by Add order_bytes to OrderSummary API response #92 ✓ (force-pushed clean onto current main)
• 99cd19a — GET /v1/trades/token/{addr} endpoint → blocked, see below
• b3dba2f — simulated maxOutput from quote in OrderSummary → blocked, see below
• 7a279a9 — detailed health endpoint → covered by Add detailed health endpoint with raindex sync status #95 ✓ (clean cherry-pick)

Snapshot commit on top (e77b2a1):

• cache_warmer background task + supporting caches (block_number, limit_ratio, stale_price_skip, swap_quote)
• market_calendar for NYSE-hours awareness
• Ops tooling: docs/ops.md, scripts/smoke.sh, scripts/uptimerobot-setup.sh → covered by Add ops cheat sheet and smoke/uptime monitoring scripts #96 ✓
• RPC override config (config/rest-api.toml, flake.nix, os.nix)
• direct_trades_fetcher extensions (~339 more lines)
• Health endpoint additions for cache_warmer status
• DB pool tweaks, route adjustments

---

Per-topic split — status

✅ Landed PRs (single-topic, clean against current main)

• Add order_bytes to OrderSummary API response #92 — Add order_bytes to OrderSummary API response (force-pushed to a single commit)
• Add detailed health endpoint with raindex sync status #95 — Add detailed health endpoint with raindex sync status
• Add ops cheat sheet and smoke/uptime monitoring scripts #96 — Add ops cheat sheet and smoke/uptime monitoring scripts

🟡 Already-open, in-flight PRs that need to land first (the reverted direct-push work)

• Neutralize metaboards (~5s per request saved) #86 — neutralize metaboards (@findolor tagged)
• Nginx hardening + infra updates #87 — nginx hardening (depends on Neutralize metaboards (~5s per request saved) #86) (@findolor tagged)
• Order perf: SDK output-vault filter + quote timing #88 — order perf: chunk_size + zero-balance + timing (depends on Nginx hardening + infra updates #87) (@findolor tagged)
• Order endpoint caching (depends on #54) #89 — order endpoint caching (depends on Add in-process endpoint caching with moka #54) (@findolor tagged, draft)
• Taker + batch trade endpoints (depends on D, #50, #51) #90 — taker + batch trade endpoints (depends on DirectTradesFetcher module (depends on #50, #51) #91, Implement GET /v1/trades/tx/{tx_hash} endpoint #50, Implement GET /v1/trades/{address} endpoint #51) (@findolor tagged, draft)
• DirectTradesFetcher module (depends on #50, #51) #91 — DirectTradesFetcher (depends on Implement GET /v1/trades/tx/{tx_hash} endpoint #50, Implement GET /v1/trades/{address} endpoint #51) (@findolor tagged, draft)

Plus the upstream foundation already in flight by @findolor:

• Implement GET /v1/trades/tx/{tx_hash} endpoint #50 — GET /v1/trades/tx/{tx_hash} endpoint
• Implement GET /v1/trades/{address} endpoint #51 — GET /v1/trades/{address} endpoint (depends on Implement GET /v1/trades/tx/{tx_hash} endpoint #50)
• Add in-process endpoint caching with moka #54 — in-process endpoint caching with moka

🔴 Blocked work — needs the chain above to land before clean cherry-pick is possible

These commits exist on the deployed branch but cannot be cleanly cherry-picked onto current main because they depend on hundreds of lines of structural changes (caching foundation, trades module restructure, order endpoint refactors) carried by the in-flight PRs. Attempting cherry-pick produces large multi-file conflicts.

• 99cd19a → GET /v1/trades/token/{addr} — needs Implement GET /v1/trades/tx/{tx_hash} endpoint #50, Implement GET /v1/trades/{address} endpoint #51, Add in-process endpoint caching with moka #54, DirectTradesFetcher module (depends on #50, #51) #91, then trivial cherry-pick
• b3dba2f → simulated maxOutput in OrderSummary — needs Order perf: SDK output-vault filter + quote timing #88, Order endpoint caching (depends on #54) #89, then trivial cherry-pick
• cache-warmer system (cache_warmer.rs + block_cache.rs + limit_cache.rs + stale_price_skip.rs + market_calendar.rs + integrations into orders/mod.rs/get_by_owner.rs/get_by_token.rs/main.rs/health.rs/types/health.rs) — needs Order perf: SDK output-vault filter + quote timing #88, Order endpoint caching (depends on #54) #89, Add in-process endpoint caching with moka #54, then split into ~3 PRs (cache-warmer-core, market-calendar, health-cache-status)
• swap-quote cache (routes/swap/quote.rs cache integration + routes/swap/mod.rs) — needs Add in-process endpoint caching with moka #54
• RPC override config (config.rs, raindex/config.rs, config/rest-api.toml, flake.nix plumbing) — likely standalone, can be PR'd once a quiet moment exists
• direct_trades.rs extensions (~339 additional lines beyond DirectTradesFetcher module (depends on #50, #51) #91) — needs DirectTradesFetcher module (depends on #50, #51) #91
• misc route tweaks (tokens.rs, admin.rs, db/pool.rs, test_helpers.rs) — small, can ride along with other PRs

⚠️ Submodule warning

lib/rain.orderbook has local modifications not committed inside the submodule itself (~13 files modified, see snapshot commit message). The submodule pointer in this snapshot is unchanged at 57253129e, so any per-topic PR depending on those upstream changes will fail to build until the submodule changes are landed (likely via a fork branch + pointer bump in this repo).

---

Recommended merge order

1. Land foundation: Implement GET /v1/trades/tx/{tx_hash} endpoint #50 → Implement GET /v1/trades/{address} endpoint #51 → Add in-process endpoint caching with moka #54 (@findolor's stack)
2. Land alastair's PR stack: Neutralize metaboards (~5s per request saved) #86 → Nginx hardening + infra updates #87 → Order perf: SDK output-vault filter + quote timing #88 → Order endpoint caching (depends on #54) #89 → DirectTradesFetcher module (depends on #50, #51) #91 → Taker + batch trade endpoints (depends on D, #50, #51) #90
3. Cherry-pick blocked commits onto fresh main as separate single-topic PRs
4. Push submodule changes as a fork branch + pointer-bump PR
5. Open per-topic PRs for cache-warmer system, swap-quote cache, RPC override, direct-trades extensions
6. Close this tracking PR

cc @findolor for visibility and review.

[coderabbitai]

Important

Review skipped

Draft detected.

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: defaults

Review profile: CHILL

Plan: Pro

Run ID: 34055f7f-d3fc-4090-b199-34a7abcb51f8

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 alastair/comprehensive-health-endpoint

---

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.}