Skip to content

refactor(dash-spv): network manager refactor and sync pipelines optimized - #902

Open
ZocoLini wants to merge 6 commits into
devfrom
refactor/network-mod
Open

refactor(dash-spv): network manager refactor and sync pipelines optimized #902
ZocoLini wants to merge 6 commits into
devfrom
refactor/network-mod

Conversation

@ZocoLini

@ZocoLini ZocoLini commented Jul 16, 2026

Copy link
Copy Markdown
Collaborator
  • Self-coordinating broker. Pipelines declare what they want, not when to send it.
    The manager owns de-duplication, pacing, timeouts, retries and peer hot-swap, so the
    per-pipeline DownloadCoordinator is gone.
  • Request de-duplication by key. Every tracked request (getheaders, getcfheaders,
    getcfilters, getmnlistdiff, block getdata) carries a RequestKey. Re-declaring one
    already queued or on the wire is a no-op, which is what makes it safe for a pipeline to
    re-declare its whole wanted set freely.
  • Strict-priority scheduler. One queue per class, drained in order: control traffic,
    blocks, filters, filter headers, block headers — so a backlog of one type never blocks
    another behind it. Messages popped but not sent go back to the front of their class.
  • Bandwidth-sized in-flight budget. No fixed constants: the global budget hill-climbs on
    measured downlink throughput, and each peer's cap is sized by Little's Law from its own
    completion rate and service time. Fast peers earn a high cap, slow peers a low one.
  • Timeout and retry. A request that goes unanswered is re-queued verbatim and the peer
    that ignored it is dropped; the requester reports success via request_answered, so only
    the caller can retire a request (an unsolicited response can't clear someone else's).
  • Peer supervisor. Fills below capacity, filters on advertised service flags, ranks by
    handshake latency and swaps out a slow peer for a clearly faster one, keeping displaced
    peers alive until their in-flight work drains.
  • Topic-based inbound routing. Managers subscribe by message type; the pump delivers only
    what each asked for, handing over the payload without a copy when it has a single consumer.
  • Testable in isolation. Minimal NetworkManager trait plus an in-memory
    MockNetworkManager; the client is generic over the network (DashSpvClient<W, N, S>).
  • Removed: peer storage, the peer reputation system, and the standalone message
    dispatcher / handshake / pool modules.

Summary by CodeRabbit

Summary by CodeRabbit

  • New Features

    • Added a broker-driven peer network layer with prioritized messaging, request tracking, retries, and adaptive bandwidth management.
    • Improved peer discovery, connection monitoring, latency tracking, and automatic recovery from stalled peers.
    • Added optional Tokio-based network message framing support.
    • Updated synchronization, transaction, filter, block, and masternode operations to use the new network services.
  • Bug Fixes

    • Improved client start/stop coordination during concurrent shutdowns.
    • Preserved synchronization progress across peer disconnects and restarts.
    • Improved transaction detection and network event handling.

@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: a15ab0d3-dd40-46d9-8d09-857a2b115a18

📥 Commits

Reviewing files that changed from the base of the PR and between 5854b15 and 704f1fb.

📒 Files selected for processing (1)
  • dash-spv/src/sync/filters/manager.rs

📝 Walkthrough

Walkthrough

The PR replaces request-sender networking with broker-based routing, rewrites peer and synchronization pipelines, updates client lifecycle coordination, adds Tokio message framing, and adapts FFI, tests, examples, and the seed fetcher.

Changes

SPV network and synchronization

Layer / File(s) Summary
Network manager and peer runtime
dash-spv/src/network/*
Adds broker routing, request tracking, peer supervision, capacity control, framed connections, discovery, and network subscriptions.
Sync orchestration and pipelines
dash-spv/src/sync/*
Replaces RequestSender and DownloadCoordinator flows with NetworkManager, wanted-set tracking, asynchronous requests, and explicit request correlation.
Client and application integration
dash-spv/src/client/*, dash-spv/src/main.rs, dash-spv-ffi/*
Updates client lifecycle handling, event dispatch, transaction broadcasting, initialization, and network type paths.
Codec and seed fetcher
dash/src/network/message.rs, masternode-seeds-fetcher/*
Adds feature-gated raw-message framing and a standalone framed TCP peer implementation.
Validation and test infrastructure
dash-spv/src/test_utils/network.rs, dash-spv/tests/*
Replaces request-channel mocks, adds transaction-specific event waits, updates integration setup, and bounds restart scenarios.

Estimated code review effort: 5 (Critical) | ~120 minutes

Suggested reviewers: xdustinface

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly identifies the main network manager refactor and sync pipeline optimization described in the changeset.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch refactor/network-mod

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

Comment @coderabbitai help to get the list of available commands.

@codecov

codecov Bot commented Jul 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 95.22740% with 85 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.77%. Comparing base (9c87ccb) to head (704f1fb).
⚠️ Report is 1 commits behind head on dev.

Files with missing lines Patch % Lines
dash-spv/src/network/peer.rs 83.27% 47 Missing ⚠️
dash/src/network/message.rs 83.33% 12 Missing ⚠️
dash-spv/src/network/discovery.rs 78.78% 7 Missing ⚠️
dash-spv/src/main.rs 0.00% 3 Missing ⚠️
dash-spv/src/network/mod.rs 90.47% 2 Missing ⚠️
dash-spv/src/sync/block_headers/manager.rs 97.72% 2 Missing ⚠️
dash-spv/src/sync/blocks/pipeline.rs 93.93% 2 Missing ⚠️
dash-spv/src/sync/filters/pipeline.rs 98.00% 2 Missing ⚠️
dash-spv/src/sync/mempool/manager.rs 99.62% 2 Missing ⚠️
dash-spv-ffi/src/client.rs 75.00% 1 Missing ⚠️
... and 5 more
Additional details and impacted files
@@            Coverage Diff             @@
##              dev     #902      +/-   ##
==========================================
+ Coverage   74.67%   74.77%   +0.09%     
==========================================
  Files         328      319       -9     
  Lines       76451    74579    -1872     
==========================================
- Hits        57093    55765    -1328     
+ Misses      19358    18814     -544     
Flag Coverage Δ
core 77.31% <83.33%> (+0.01%) ⬆️
ffi 50.73% <85.71%> (+1.49%) ⬆️
rpc 20.00% <ø> (ø)
spv 92.40% <95.76%> (+1.26%) ⬆️
wallet 75.69% <ø> (+0.23%) ⬆️
Files with missing lines Coverage Δ
dash-spv-ffi/src/callbacks.rs 84.23% <100.00%> (-0.17%) ⬇️
dash-spv/src/client/core.rs 63.04% <100.00%> (+0.82%) ⬆️
dash-spv/src/client/event_handler.rs 93.89% <100.00%> (-0.12%) ⬇️
dash-spv/src/client/events.rs 100.00% <100.00%> (ø)
dash-spv/src/lib.rs 46.66% <ø> (ø)
dash-spv/src/network/manager.rs 84.63% <ø> (+14.11%) ⬆️
dash-spv/src/storage/mod.rs 86.15% <ø> (ø)
dash-spv/src/sync/block_headers/pipeline.rs 93.50% <100.00%> (-0.72%) ⬇️
dash-spv/src/sync/block_headers/segment_state.rs 98.23% <100.00%> (+0.86%) ⬆️
dash-spv/src/sync/block_headers/sync_manager.rs 92.10% <100.00%> (+7.48%) ⬆️
... and 30 more

... and 21 files with indirect coverage changes

@ZocoLini
ZocoLini force-pushed the refactor/network-mod branch from 39b7db2 to fd614fc Compare July 21, 2026 15:07
@github-actions

Copy link
Copy Markdown
Contributor

This PR has merge conflicts with the base branch. Please rebase or merge the base branch into your branch to resolve them.

@github-actions github-actions Bot added the merge-conflict The PR conflicts with the target branch. label Jul 22, 2026
@ZocoLini
ZocoLini force-pushed the refactor/network-mod branch from 726da21 to 0ed48ff Compare July 28, 2026 11:00
@github-actions github-actions Bot removed the merge-conflict The PR conflicts with the target branch. label Jul 28, 2026
@ZocoLini
ZocoLini force-pushed the refactor/network-mod branch 2 times, most recently from 0716325 to 9615c7a Compare July 28, 2026 15:55
@ZocoLini
ZocoLini force-pushed the refactor/network-mod branch from 9615c7a to 5693f59 Compare July 29, 2026 10:16
@ZocoLini
ZocoLini marked this pull request as ready for review July 29, 2026 11:59

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 13

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (5)
dash-spv/src/sync/blocks/manager.rs (1)

66-75: 🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Inflated requested progress counter. BlocksPipeline::send_pending now returns the whole wanted set rather than newly-issued requests, and it is invoked on every tick, so the running add_requested sum grows without bound.

  • dash-spv/src/sync/blocks/manager.rs#L66-L75: stop summing the returned count — either have the pipeline report only newly declared hashes, or expose the wanted-set size and set (not add) the requested metric.
  • dash-spv/src/sync/blocks/sync_manager.rs#L200-L203: keep the tick re-declaration, but ensure it no longer feeds the cumulative counter once the manager side is fixed.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/blocks/manager.rs` around lines 66 - 75, The requested
progress counter is inflated because BlocksPipeline::send_pending returns the
full wanted set on every tick; update dash-spv/src/sync/blocks/manager.rs lines
66-75 to stop adding that returned count, instead reporting newly declared
hashes or setting the requested metric from the wanted-set size. Preserve the
tick re-declaration in dash-spv/src/sync/blocks/sync_manager.rs lines 200-203,
ensuring it no longer contributes repeatedly to the cumulative counter.
dash-spv/src/sync/block_headers/pipeline.rs (1)

143-158: 🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Re-add the pending-locator guard for empty headers responses.

SegmentState::receive_headers(&[]) marks the tip segment complete, and handle_headers_pipeline will still send more requests because the tip is already complete. If an empty response arrives for an older/unsolicited tip locator, the pipeline can stop mid-catch-up after routing only the latest segment request to a lagging peer. Only route [] when the caller can prove it answers the currently active tip locator, and then release that locator/key.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/block_headers/pipeline.rs` around lines 143 - 158, The
empty-headers branch in handle_headers_pipeline must verify that the response
corresponds to the currently active tip locator before routing it. Reintroduce
the pending-locator guard, route and complete only the matching tip request,
then release its locator/key; ignore unsolicited or stale empty responses
without calling SegmentState::receive_headers.
dash-spv/src/sync/chainlock/sync_manager.rs (1)

59-73: 🩺 Stability & Availability | 🟠 Major | ⚡ Quick win

Unchecked send_to result + permanent dedup can silently drop a ChainLock request forever.

chainlocks_to_request is unconditionally added to self.requested_chainlocks after calling network.send_to(...), without checking the returned success bool. requested_chainlocks is only cleared in on_disconnect(), which per the SyncManager trait doc fires only when all peers are lost — not on an individual peer send failure. Unlike MnListDiff, this GetData request isn't registered with the broker via a RequestKey, so there's also no timeout/retry safety net (tick() here does "no periodic work"). If the send fails, or the peer never responds, this specific ChainLock hash can never be re-requested even when other peers re-announce it via Inv, until a full disconnect/reconnect cycle.

🛡️ Only mark as requested on a successful send
                 if !chainlocks_to_request.is_empty() {
                     tracing::info!(
                         "Received {} ChainLock announcements, requesting via getdata",
                         chainlocks_to_request.len()
                     );
-                    network
+                    let sent = network
                         .send_to(peer, NetworkMessage::GetData(chainlocks_to_request.clone()))
                         .await;
-
-                    for item in &chainlocks_to_request {
-                        if let Inventory::ChainLock(hash) = item {
-                            self.requested_chainlocks.insert(*hash);
-                        }
-                    }
+                    if sent {
+                        for item in &chainlocks_to_request {
+                            if let Inventory::ChainLock(hash) = item {
+                                self.requested_chainlocks.insert(*hash);
+                            }
+                        }
+                    }
                 }

Consider also whether ChainLock GetData should go through the broker's tracked-request path (with a RequestKey variant) so a non-responding peer triggers the existing timeout/retry monitor, rather than relying solely on send success.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/chainlock/sync_manager.rs` around lines 59 - 73, Update the
ChainLock request flow around send_to and requested_chainlocks so hashes are
inserted only when the GetData send succeeds; handle the returned success value
and leave failed sends eligible for later requests. Consider registering
ChainLock GetData requests through the broker’s tracked RequestKey path so
non-responsive peers receive existing timeout/retry handling, while preserving
the current deduplication behavior for successful requests.
dash-spv/src/sync/sync_coordinator.rs (1)

191-198: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Stale doc: managers no longer receive a request sender.

Line 196 still advertises "A request sender for outgoing network messages"; the context now carries Arc<dyn NetworkManager>.

📝 Proposed fix
     /// - A message stream filtered by its subscribed types
     /// - An event bus subscription for inter-manager events
-    /// - A request sender for outgoing network messages
+    /// - A handle to the network manager for declaring outgoing requests
     /// - A shutdown token for graceful termination
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/sync_coordinator.rs` around lines 191 - 198, Update the
documentation for SyncCoordinator::start to remove the outdated request-sender
item and describe that each manager receives the network manager context,
matching the Arc<dyn NetworkManager> argument now used.
dash-spv/src/network/discovery.rs (1)

52-73: 🩺 Stability & Availability | 🟡 Minor | ⚡ Quick win

DNS seed resolution has no timeout and runs sequentially, delaying the first fill round.

tokio::net::lookup_host does not time out on its own, so one unresponsive seed blocks get() — and therefore the supervisor's first fill_round — for as long as the resolver takes, even though the compiled-in seeds are already in hand. Resolving concurrently under a timeout keeps discovery bounded.

🛡️ Proposed fix
-        let port = network.default_p2p_port();
-        for seed in network.dns_seeds() {
-            match tokio::net::lookup_host((*seed, port)).await {
-                Ok(iter) => {
-                    let resolved: Vec<SocketAddr> = iter.collect();
-                    tracing::info!("DNS seed {} returned {} addresses", seed, resolved.len());
-                    addresses.extend(resolved);
-                }
-                Err(e) => {
-                    tracing::warn!("Failed to resolve DNS seed {} (backup source): {}", seed, e);
-                }
-            }
-        }
+        const DNS_TIMEOUT: Duration = Duration::from_secs(5);
+        let port = network.default_p2p_port();
+        let lookups = network.dns_seeds().iter().map(|seed| async move {
+            match tokio::time::timeout(DNS_TIMEOUT, tokio::net::lookup_host((*seed, port))).await {
+                Ok(Ok(iter)) => iter.collect::<Vec<SocketAddr>>(),
+                Ok(Err(e)) => {
+                    tracing::warn!("Failed to resolve DNS seed {} (backup source): {}", seed, e);
+                    Vec::new()
+                }
+                Err(_) => {
+                    tracing::warn!("DNS seed {} timed out (backup source)", seed);
+                    Vec::new()
+                }
+            }
+        });
+        for resolved in futures::future::join_all(lookups).await {
+            addresses.extend(resolved);
+        }
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/network/discovery.rs` around lines 52 - 73, Update discover to
resolve all network.dns_seeds() concurrently, applying a bounded timeout to each
tokio::net::lookup_host operation so one unresponsive seed cannot block
discovery indefinitely. Preserve the existing logging for successful resolutions
and failures, then merge all resolved addresses with the compiled-in seeds
before sorting and deduplicating.
🧹 Nitpick comments (13)
dash-spv/src/sync/blocks/pipeline.rs (1)

104-117: 🚀 Performance & Scalability | 🔵 Trivial | ⚡ Quick win

Per-tick re-declaration is O(wanted set) messages.

Every tick (and every BlocksNeeded) re-sends one GetData per wanted hash, so with a large match set this pushes thousands of broker messages per cycle purely to be de-duplicated. Consider tracking declared hashes and only re-declaring on a slower cadence (or in bounded batches).

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/blocks/pipeline.rs` around lines 104 - 117, The
send_pending method re-sends every wanted block hash on each tick, causing
excessive broker traffic. Track which hashes have already been declared and only
send newly wanted hashes, or re-declare existing hashes on a slower cadence or
through bounded batches; keep hash_to_height synchronized so removed or
fulfilled hashes are no longer tracked, and return the number actually sent.
dash-spv/src/client/transactions.rs (1)

33-45: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

dispatch_local runs on the untracked path too.

When enable_mempool_tracking is false the tx is broadcast at Line 39 and also injected locally at Line 45, even though no mempool manager exists to consume it. Making the two paths mutually exclusive matches the doc comment and avoids a pointless dispatch (or a duplicate send if anything else ever subscribes to Tx).

♻️ Make the paths exclusive
         if !self.config.read().await.enable_mempool_tracking {
             // Legacy untracked path: fan out to every peer.
             self.network.broadcast(NetworkMessage::Tx(tx.clone()));
+            return Ok(());
         }
 
         // Inject locally so the mempool manager picks it up through handle_tx.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/client/transactions.rs` around lines 33 - 45, Make the
transaction handling branches in the surrounding submission method mutually
exclusive: retain the direct peer broadcast for disabled
enable_mempool_tracking, and call dispatch_local only when tracking is enabled
so the mempool manager processes it. Preserve the existing not-connected error
behavior and transaction cloning.
dash-spv/src/sync/mempool/manager.rs (1)

804-807: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Reuse the shared test_socket_address helper.

crate::test_utils::test_socket_address already exists and is imported by dash-spv/src/sync/mempool/sync_manager.rs; the local copy duplicates it (and could drift, e.g. differing port/IP encoding).

♻️ Import instead of redefining
-    use crate::test_utils::MockNetworkManager;
-
-    /// Deterministic loopback socket address for peer-keyed test state.
-    fn test_socket_address(id: u8) -> SocketAddr {
-        SocketAddr::from(([127, 0, 0, id], id as u16))
-    }
+    use crate::test_utils::{test_socket_address, MockNetworkManager};
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/mempool/manager.rs` around lines 804 - 807, Remove the
local test_socket_address helper and import and reuse
crate::test_utils::test_socket_address wherever it is needed in the mempool
manager tests, matching the existing usage in sync_manager.rs. Preserve the
current call behavior while eliminating the duplicate implementation.
dash-spv/src/sync/mempool/sync_manager.rs (1)

3-11: 🚀 Performance & Scalability | 🔵 Trivial | ⚡ Quick win

Avoid cloning NetworkMessage::Tx when handling the owned message.

NetworkMessage::Tx holds transaction::Transaction directly, so matching on msg lets the handler receive the transaction by move and removes (*tx).clone().

♻️ Match the owned message
-        match &msg {
-            NetworkMessage::Inv(inv) => self.handle_inv(inv, peer, network).await,
-            NetworkMessage::Tx(tx) => self.handle_tx((*tx).clone(), peer, network).await,
-            _ => Ok(vec![]),
-        }
+        match msg {
+            NetworkMessage::Inv(inv) => self.handle_inv(&inv, peer, network).await,
+            NetworkMessage::Tx(tx) => self.handle_tx(*tx, peer, network).await,
+            _ => Ok(vec![]),
+        }
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/mempool/sync_manager.rs` around lines 3 - 11, Update the
owned-message handling in the sync manager’s message-processing method to match
`NetworkMessage::Tx` by value rather than by reference, moving the contained
transaction into the handler and removing the `(*tx).clone()` call. Preserve the
existing handling for all other `NetworkMessage` variants.
dash-spv/src/sync/filters/manager.rs (1)

1005-1007: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Dangling doc sentence on test_network.

The first doc line is a truncated leftover from the previous helper.

🧹 Proposed cleanup
-    /// A `NetworkManager` that makes no outbound connections and does no
-    /// An in-memory mock network manager: it swallows any messages the manager
+    /// An in-memory mock network manager: it swallows any messages the manager
     /// tries to send, so these tests observe manager state, not sent messages.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/filters/manager.rs` around lines 1005 - 1007, Remove the
truncated first documentation line above the test_network mock helper, leaving
only the complete description that identifies it as an in-memory mock network
manager.
dash-spv/src/sync/filter_headers/sync_manager.rs (1)

125-126: 🚀 Performance & Scalability | 🔵 Trivial | ⚡ Quick win

Re-declaring the full wanted set on every response is avoidable here.

dash-spv/src/sync/filters/sync_manager.rs deliberately drops send_pending from the message path (its comment: re-declaring per response re-scans every wanted batch on the hot path) and relies on tick instead. This path still re-sends one GetCFHeaders per wanted batch for each arriving cfheaders, which is O(batches) sends per response. Since tick (Line 159) already re-declares, consider dropping this call for consistency.

♻️ Proposed change
-        // Declare any remaining wanted batches to the broker
-        self.pipeline.send_pending(network).await?;
-
+        // No `send_pending` here: the wanted set is already declared to the broker,
+        // which paces it out. `tick` re-declares to pick up newly-wanted batches.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/filter_headers/sync_manager.rs` around lines 125 - 126,
Remove the self.pipeline.send_pending(network).await? call from the
response-handling path in sync_manager, matching the filters sync manager; rely
on the existing tick-based declaration to resend pending wanted batches and
avoid scanning and sending the full wanted set for every cfheaders response.
dash-spv/src/sync/masternodes/manager.rs (1)

461-469: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Stale error branch: send_qrinfo_for_tip can no longer fail on dispatch.

network.send is infallible fire-and-forget (see the comment you added at Line 545), so the remaining failure modes of send_qrinfo_for_tip are all Ok early returns. The warn text describing a failed dispatch that leaves current_cycle_attempts at 0 is now misleading. Either reword it to cover the real remaining error sources or collapse the match once the signature stops being fallible.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/masternodes/manager.rs` around lines 461 - 469, Update the
send_qrinfo_for_tip handling in the catch-up path to reflect that network.send
is infallible and dispatch no longer produces errors. Remove the stale
failed-dispatch warning and collapse the match if the method signature is made
non-fallible, while preserving events extension and the existing early-return
behavior.
dash-spv/src/sync/sync_manager.rs (1)

106-117: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Use the event's best_height rather than re-reading network.tip().

PeersUpdated already carries best_height from the same atomic, so destructuring it keeps the handler consistent with the event it is reacting to and avoids a second source of truth.

♻️ Suggested change
-    if let NetworkEvent::PeersUpdated {
-        ..
-    } = event
-    {
+    if let NetworkEvent::PeersUpdated {
+        best_height,
+        ..
+    } = event
+    {
         // Seed every manager's target from the peers' advertised tip so the
         // height shows up right away (matches the pre-network `best_height`).
-        manager.update_target_height(network.tip());
+        manager.update_target_height(*best_height);
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/sync_manager.rs` around lines 106 - 117, Update the
PeersUpdated pattern in the event handler to destructure its best_height field
and pass that value to manager.update_target_height instead of re-reading
network.tip(). Keep the existing WaitingForConnections check and sync startup
flow unchanged.
dash-spv/src/network/discovery.rs (1)

33-49: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Avoid expect() here; the cache read can be expressed without it.

Coding guidelines say to avoid unwrap()/expect() in library code. This one is provably safe, but get_or_insert_with-style construction removes it entirely.

As per coding guidelines: "Avoid unwrap() and expect() in library code; use proper error types (e.g., via thiserror)".

♻️ Suggested rewrite
-            if self.discovered.is_none() {
-                let found = Self::discover(self.network).await;
-                self.discovered = Some(found);
-            }
-            self.discovered.as_ref().expect("just set")
+            match &self.discovered {
+                Some(found) => found,
+                None => {
+                    let found = Self::discover(self.network).await;
+                    self.discovered.insert(found)
+                }
+            }
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/network/discovery.rs` around lines 33 - 49, Update the
discovered-peer cache handling in get to initialize and borrow self.discovered
through a get_or_insert_with-style construction after discovery, eliminating the
expect("just set") call while preserving the existing fixed-pool and
restrict_to_configured_peers behavior.

Source: Coding guidelines

dash-spv/src/network/manager.rs (2)

421-437: 🎯 Functional Correctness | 🔵 Trivial | 💤 Low value

Partial key overlap drops the whole message.

If a getdata names several blocks and only one key is already in play, the entire message — including the blocks not yet requested — is discarded, and re-declaring next tick hits the same overlap until the in-play key resolves. Today the blocks pipeline sends one block per getdata (see the invariant documented in dash-spv/src/network/peer.rs lines 261-265), so this is latent rather than live, but it is worth either splitting the message per-unseen-key or asserting the one-key invariant here.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/network/manager.rs` around lines 421 - 437, Update
NetworkManager::send to handle partial key overlap without dropping unseen
requests: either split the message and enqueue only unseen keys, or enforce the
documented one-key-per-getdata invariant with an assertion. Preserve duplicate
suppression for keys already in flight and ensure every unseen key remains
queued.

1100-1113: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Re-locking between the capacity check and the push.

Lines 1105 and 1107 take connected twice for one decision. It is safe today only because the supervisor is the sole writer that pushes and the other tasks only remove, so the count can only shrink. That invariant is easy to break later; holding one guard across check-and-push documents and enforces it.

♻️ Suggested tightening
-            if acceptable && self.connected.lock().await.len() < self.max_peers {
-                let addr = peer.addr();
-                self.connected.lock().await.push((peer, State {}));
-                let _ = self.events.send(NetworkEvent::PeerConnected(addr));
-                accepted += 1;
-            } else {
-                leftover.push(peer);
-            }
+            let addr = peer.addr();
+            let mut guard = self.connected.lock().await;
+            if acceptable && guard.len() < self.max_peers {
+                guard.push((peer, State {}));
+                drop(guard);
+                let _ = self.events.send(NetworkEvent::PeerConnected(addr));
+                accepted += 1;
+            } else {
+                drop(guard);
+                leftover.push(peer);
+            }
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/network/manager.rs` around lines 1100 - 1113, Update the peer
acceptance loop around connected capacity handling to acquire one
`self.connected` lock guard, perform the max-peer check, and push the accepted
peer while that guard remains held. Reuse the guard for both the capacity
decision and insertion, preserving the existing event emission and leftover
behavior.
dash-spv/src/network/mod.rs (1)

78-121: 🩺 Stability & Availability | 🔵 Trivial | ⚡ Quick win

Self-named delegation is a silent stack-overflow trap; the TODO is worth acting on.

Every body calls a method with the same name as the trait method it implements. This compiles to the inherent method today, but if any inherent method is later renamed or removed, the call resolves to the trait method instead — infinite recursion at runtime rather than a compile error. Either inline the bodies as the TODO says, or make the delegation explicit with PeerNetworkManager::send(self, msg).await so the inherent path is enforced by the compiler.

Want me to open an issue to track inlining these?

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/network/mod.rs` around lines 78 - 121, Replace the self-named
delegations in the NetworkManager implementation for PeerNetworkManager with
explicit PeerNetworkManager::method(self, ...) calls, preserving each method’s
arguments, await behavior, and return values so dispatch remains bound to the
inherent methods and cannot recurse.
dash-spv/src/network/peer.rs (1)

385-407: 🎯 Functional Correctness | 🔵 Trivial | 💤 Low value

Messages received during the lag probe are silently discarded.

The _ => {} arm drops anything that is not pong/ping in this window, and the framed reader is only handed to spawn_reader afterwards. Nothing is requested yet, so only unsolicited announcements (inv, headers, addr) can be lost, but that includes the tip announcement a peer sends right after sendheaders. Buffering these and re-injecting them via inbound after the reader starts would avoid depending on the next announcement.

Also, #[allow(clippy::too_many_arguments)] on line 308 now guards a four-argument function and can go.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/network/peer.rs` around lines 385 - 407, Preserve non-probe
messages received in the post-handshake lag loop instead of discarding them:
buffer unmatched valid payloads, then re-inject them through the existing
inbound channel after spawn_reader starts, while continuing to respond to
NetworkMessage::Ping and match the expected Pong. Also remove the obsolete
#[allow(clippy::too_many_arguments)] attribute from the now four-argument
function.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@dash-spv/src/network/manager.rs`:
- Around line 551-554: Update the routing loop around route_tick to snapshot or
clone the connected peer handles while holding connected, then release the mutex
before awaiting any socket writes. Pass the snapshot to route_tick so peer send,
in_flight, and capacity operations remain available without retaining the global
connected_peers guard.
- Around line 886-896: Clamp cap_ema during the additive-increase branch of the
cap_ema update so CAP_GROW cannot raise it above PEER_CEIL. Keep the existing
FLOOR_PER_PEER minimum and multiplicative backoff behavior intact, and ensure
the stored EMA—not only the later cap_peer value—is bounded.

In `@dash-spv/src/network/peer.rs`:
- Around line 513-516: Update the reader termination flow around
PeerEvent::Disconnected and stash_backups so closures of probe-only peers are
identified and suppressed. Ensure disconnected events are sent only for peers
that entered connected_peers, while preserving disconnection events for
established connections.
- Around line 276-288: Update is_single_response to classify
NetworkMessage::NotFound(_) as a single-message response so the reader releases
the peer’s in-flight unit. Also ensure the reader forwards or surfaces notfound
through the owning request pipeline so RequestKey::Block reaches
request_answered and its OnWire entry is cleared.
- Around line 181-199: Update Peer::send so pipeline requests are accounted for
before awaiting write_all, including the in_flight increment and latency.on_send
call. If serialization or writing fails, roll back the in-flight accounting and
corresponding latency state before returning the existing connection error;
leave non-pipeline requests unchanged.

In `@dash-spv/src/sync/block_headers/sync_manager.rs`:
- Around line 192-201: Update the send flow in the sync manager around
NetworkMessage::GetHeaders to capture the boolean result returned by send_to and
insert the peer address into announced_peers only when that result indicates
success. Leave failed sends unrecorded so subsequent retries remain possible.

In `@dash-spv/src/sync/filters/manager.rs`:
- Around line 686-701: Restore use of monitored_filter_elements_for in the
compact-filter matching paths, including rescan_batch and scan_batch, instead of
always passing an empty extra_elements slice to
check_compact_filters_for_elements. Retrieve each wallet’s monitored filter
elements alongside monitored_script_pubkeys_for and pass them as the third
argument so matches based solely on non-script elements are queued.

In `@dash-spv/src/sync/sync_manager.rs`:
- Around line 54-60: Remove the local Inbound type alias and import or re-export
the existing crate::network::Inbound alias instead. Update
SyncManagerTaskContext to use that shared alias for message_receiver, preserving
compatibility with the receiver returned by network.subscribe().

In `@dash-spv/tests/dashd_sync/helpers.rs`:
- Around line 223-251: Update wait_for_mempool_txid to accept a timeout
parameter instead of hard-coding 30 seconds, and use that parameter when
creating the sleep future. Update every transaction test call to pass the
configured MEMPOOL_TIMEOUT value, preserving existing event matching and timeout
behavior.

In `@dash-spv/tests/dashd_sync/tests_mempool.rs`:
- Around line 413-418: Update the remaining NetworkEvent::PeerConnected pattern
in the affected mempool synchronization test, including the occurrence around
the later connection wait, to use the tuple-variant form consistent with the
migrated NetworkEvent definition. Preserve the existing matching behavior and
predicates.

In `@masternode-seeds-fetcher/src/peer.rs`:
- Around line 37-74: Add Tokio loopback tests for the Peer transport methods
connect, send_message, and receive_message. Use a local listener to verify
successful message framing, rejection of foreign-network magic, returning None
after connection closure, and timeout behavior for stalled writes. Exercise the
real TCP path and assert the expected Result or error for each case.
- Around line 67-72: Update receive_message to validate raw.magic against
self.magic before constructing Message from raw.payload; reject
mismatched-network frames with an error instead of exposing their payload, while
preserving the existing decode-error and end-of-stream behavior.
- Around line 55-63: Update send_message to wrap writer.write_all with the
configured I/O timeout, preserving the existing “send message” context and
propagating timeout or write errors through the Result.

---

Outside diff comments:
In `@dash-spv/src/network/discovery.rs`:
- Around line 52-73: Update discover to resolve all network.dns_seeds()
concurrently, applying a bounded timeout to each tokio::net::lookup_host
operation so one unresponsive seed cannot block discovery indefinitely. Preserve
the existing logging for successful resolutions and failures, then merge all
resolved addresses with the compiled-in seeds before sorting and deduplicating.

In `@dash-spv/src/sync/block_headers/pipeline.rs`:
- Around line 143-158: The empty-headers branch in handle_headers_pipeline must
verify that the response corresponds to the currently active tip locator before
routing it. Reintroduce the pending-locator guard, route and complete only the
matching tip request, then release its locator/key; ignore unsolicited or stale
empty responses without calling SegmentState::receive_headers.

In `@dash-spv/src/sync/blocks/manager.rs`:
- Around line 66-75: The requested progress counter is inflated because
BlocksPipeline::send_pending returns the full wanted set on every tick; update
dash-spv/src/sync/blocks/manager.rs lines 66-75 to stop adding that returned
count, instead reporting newly declared hashes or setting the requested metric
from the wanted-set size. Preserve the tick re-declaration in
dash-spv/src/sync/blocks/sync_manager.rs lines 200-203, ensuring it no longer
contributes repeatedly to the cumulative counter.

In `@dash-spv/src/sync/chainlock/sync_manager.rs`:
- Around line 59-73: Update the ChainLock request flow around send_to and
requested_chainlocks so hashes are inserted only when the GetData send succeeds;
handle the returned success value and leave failed sends eligible for later
requests. Consider registering ChainLock GetData requests through the broker’s
tracked RequestKey path so non-responsive peers receive existing timeout/retry
handling, while preserving the current deduplication behavior for successful
requests.

In `@dash-spv/src/sync/sync_coordinator.rs`:
- Around line 191-198: Update the documentation for SyncCoordinator::start to
remove the outdated request-sender item and describe that each manager receives
the network manager context, matching the Arc<dyn NetworkManager> argument now
used.

---

Nitpick comments:
In `@dash-spv/src/client/transactions.rs`:
- Around line 33-45: Make the transaction handling branches in the surrounding
submission method mutually exclusive: retain the direct peer broadcast for
disabled enable_mempool_tracking, and call dispatch_local only when tracking is
enabled so the mempool manager processes it. Preserve the existing not-connected
error behavior and transaction cloning.

In `@dash-spv/src/network/discovery.rs`:
- Around line 33-49: Update the discovered-peer cache handling in get to
initialize and borrow self.discovered through a get_or_insert_with-style
construction after discovery, eliminating the expect("just set") call while
preserving the existing fixed-pool and restrict_to_configured_peers behavior.

In `@dash-spv/src/network/manager.rs`:
- Around line 421-437: Update NetworkManager::send to handle partial key overlap
without dropping unseen requests: either split the message and enqueue only
unseen keys, or enforce the documented one-key-per-getdata invariant with an
assertion. Preserve duplicate suppression for keys already in flight and ensure
every unseen key remains queued.
- Around line 1100-1113: Update the peer acceptance loop around connected
capacity handling to acquire one `self.connected` lock guard, perform the
max-peer check, and push the accepted peer while that guard remains held. Reuse
the guard for both the capacity decision and insertion, preserving the existing
event emission and leftover behavior.

In `@dash-spv/src/network/mod.rs`:
- Around line 78-121: Replace the self-named delegations in the NetworkManager
implementation for PeerNetworkManager with explicit
PeerNetworkManager::method(self, ...) calls, preserving each method’s arguments,
await behavior, and return values so dispatch remains bound to the inherent
methods and cannot recurse.

In `@dash-spv/src/network/peer.rs`:
- Around line 385-407: Preserve non-probe messages received in the
post-handshake lag loop instead of discarding them: buffer unmatched valid
payloads, then re-inject them through the existing inbound channel after
spawn_reader starts, while continuing to respond to NetworkMessage::Ping and
match the expected Pong. Also remove the obsolete
#[allow(clippy::too_many_arguments)] attribute from the now four-argument
function.

In `@dash-spv/src/sync/blocks/pipeline.rs`:
- Around line 104-117: The send_pending method re-sends every wanted block hash
on each tick, causing excessive broker traffic. Track which hashes have already
been declared and only send newly wanted hashes, or re-declare existing hashes
on a slower cadence or through bounded batches; keep hash_to_height synchronized
so removed or fulfilled hashes are no longer tracked, and return the number
actually sent.

In `@dash-spv/src/sync/filter_headers/sync_manager.rs`:
- Around line 125-126: Remove the self.pipeline.send_pending(network).await?
call from the response-handling path in sync_manager, matching the filters sync
manager; rely on the existing tick-based declaration to resend pending wanted
batches and avoid scanning and sending the full wanted set for every cfheaders
response.

In `@dash-spv/src/sync/filters/manager.rs`:
- Around line 1005-1007: Remove the truncated first documentation line above the
test_network mock helper, leaving only the complete description that identifies
it as an in-memory mock network manager.

In `@dash-spv/src/sync/masternodes/manager.rs`:
- Around line 461-469: Update the send_qrinfo_for_tip handling in the catch-up
path to reflect that network.send is infallible and dispatch no longer produces
errors. Remove the stale failed-dispatch warning and collapse the match if the
method signature is made non-fallible, while preserving events extension and the
existing early-return behavior.

In `@dash-spv/src/sync/mempool/manager.rs`:
- Around line 804-807: Remove the local test_socket_address helper and import
and reuse crate::test_utils::test_socket_address wherever it is needed in the
mempool manager tests, matching the existing usage in sync_manager.rs. Preserve
the current call behavior while eliminating the duplicate implementation.

In `@dash-spv/src/sync/mempool/sync_manager.rs`:
- Around line 3-11: Update the owned-message handling in the sync manager’s
message-processing method to match `NetworkMessage::Tx` by value rather than by
reference, moving the contained transaction into the handler and removing the
`(*tx).clone()` call. Preserve the existing handling for all other
`NetworkMessage` variants.

In `@dash-spv/src/sync/sync_manager.rs`:
- Around line 106-117: Update the PeersUpdated pattern in the event handler to
destructure its best_height field and pass that value to
manager.update_target_height instead of re-reading network.tip(). Keep the
existing WaitingForConnections check and sync startup flow unchanged.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 0b41ee2a-b2f3-4d01-98d2-79dfc157ed95

📥 Commits

Reviewing files that changed from the base of the PR and between 9c87ccb and 8d253b2.

📒 Files selected for processing (73)
  • dash-spv-bench/src/main.rs
  • dash-spv-ffi/src/callbacks.rs
  • dash-spv-ffi/src/client.rs
  • dash-spv/Cargo.toml
  • dash-spv/examples/filter_sync.rs
  • dash-spv/examples/simple_sync.rs
  • dash-spv/examples/spv_with_wallet.rs
  • dash-spv/src/client/core.rs
  • dash-spv/src/client/event_handler.rs
  • dash-spv/src/client/events.rs
  • dash-spv/src/client/lifecycle.rs
  • dash-spv/src/client/queries.rs
  • dash-spv/src/client/transactions.rs
  • dash-spv/src/lib.rs
  • dash-spv/src/main.rs
  • dash-spv/src/network/addrv2.rs
  • dash-spv/src/network/constants.rs
  • dash-spv/src/network/discovery.rs
  • dash-spv/src/network/event.rs
  • dash-spv/src/network/handshake.rs
  • dash-spv/src/network/manager.rs
  • dash-spv/src/network/message_dispatcher.rs
  • dash-spv/src/network/message_type.rs
  • dash-spv/src/network/mod.rs
  • dash-spv/src/network/peer.rs
  • dash-spv/src/network/pool.rs
  • dash-spv/src/network/reputation.rs
  • dash-spv/src/network/reputation_tests.rs
  • dash-spv/src/network/tests.rs
  • dash-spv/src/storage/mod.rs
  • dash-spv/src/storage/peers.rs
  • dash-spv/src/sync/block_headers/manager.rs
  • dash-spv/src/sync/block_headers/pipeline.rs
  • dash-spv/src/sync/block_headers/segment_state.rs
  • dash-spv/src/sync/block_headers/sync_manager.rs
  • dash-spv/src/sync/blocks/manager.rs
  • dash-spv/src/sync/blocks/pipeline.rs
  • dash-spv/src/sync/blocks/sync_manager.rs
  • dash-spv/src/sync/chainlock/manager.rs
  • dash-spv/src/sync/chainlock/sync_manager.rs
  • dash-spv/src/sync/download_coordinator.rs
  • dash-spv/src/sync/filter_headers/manager.rs
  • dash-spv/src/sync/filter_headers/pipeline.rs
  • dash-spv/src/sync/filter_headers/sync_manager.rs
  • dash-spv/src/sync/filters/manager.rs
  • dash-spv/src/sync/filters/pipeline.rs
  • dash-spv/src/sync/filters/sync_manager.rs
  • dash-spv/src/sync/instantsend/manager.rs
  • dash-spv/src/sync/instantsend/sync_manager.rs
  • dash-spv/src/sync/masternodes/manager.rs
  • dash-spv/src/sync/masternodes/pipeline.rs
  • dash-spv/src/sync/masternodes/sync_manager.rs
  • dash-spv/src/sync/mempool/manager.rs
  • dash-spv/src/sync/mempool/sync_manager.rs
  • dash-spv/src/sync/mod.rs
  • dash-spv/src/sync/sync_coordinator.rs
  • dash-spv/src/sync/sync_manager.rs
  • dash-spv/src/test_utils/network.rs
  • dash-spv/tests/dashd_masternode/setup.rs
  • dash-spv/tests/dashd_sync/helpers.rs
  • dash-spv/tests/dashd_sync/setup.rs
  • dash-spv/tests/dashd_sync/tests_mempool.rs
  • dash-spv/tests/dashd_sync/tests_restart.rs
  • dash-spv/tests/dashd_sync/tests_transaction.rs
  • dash-spv/tests/peer_test.rs
  • dash-spv/tests/test_handshake_logic.rs
  • dash-spv/tests/wallet_integration_test.rs
  • dash/Cargo.toml
  • dash/src/network/message.rs
  • masternode-seeds-fetcher/Cargo.toml
  • masternode-seeds-fetcher/src/main.rs
  • masternode-seeds-fetcher/src/peer.rs
  • masternode-seeds-fetcher/src/probe.rs
💤 Files with no reviewable changes (16)
  • dash-spv/src/network/pool.rs
  • dash-spv/src/network/tests.rs
  • dash-spv/src/sync/mod.rs
  • dash-spv/src/network/reputation_tests.rs
  • dash-spv/tests/test_handshake_logic.rs
  • dash-spv/src/network/message_type.rs
  • dash-spv/src/network/event.rs
  • dash-spv/src/network/constants.rs
  • dash-spv/src/storage/peers.rs
  • dash-spv/tests/peer_test.rs
  • dash-spv/src/storage/mod.rs
  • dash-spv/src/network/reputation.rs
  • dash-spv/src/network/addrv2.rs
  • dash-spv/src/network/message_dispatcher.rs
  • dash-spv/src/network/handshake.rs
  • dash-spv/src/sync/download_coordinator.rs

Comment thread dash-spv/src/network/manager.rs
Comment thread dash-spv/src/network/manager.rs
Comment thread dash-spv/src/network/peer.rs
Comment thread dash-spv/src/network/peer.rs
Comment thread dash-spv/src/network/peer.rs
Comment thread dash-spv/tests/dashd_sync/helpers.rs
Comment thread dash-spv/tests/dashd_sync/tests_mempool.rs
Comment thread masternode-seeds-fetcher/src/peer.rs
Comment thread masternode-seeds-fetcher/src/peer.rs
Comment thread masternode-seeds-fetcher/src/peer.rs

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (3)
dash-spv/src/network/discovery.rs (1)

34-51: 🚀 Performance & Scalability | 🟠 Major | ⚡ Quick win

Don’t cache DNS discovery until start() succeeds

PeerNetworkManager owns one PeerDiscoverer through the client/network lifecycle, and the supervisor only refreshes candidates via discoverer.get(). If the first DNS discovery call fails, later get() calls reuse that failed cache, leaving start() with only the fixed seed list for the whole manager. Clear the DNS cache on start() failure or retry fresh discovery when the cached result is not usable.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/network/discovery.rs` around lines 34 - 51, Update the
PeerDiscoverer lifecycle around get() and the PeerNetworkManager start path so
failed DNS discovery is not retained across start attempts. Clear
self.discovered when start() fails, or make get() retry discovery when the
cached result is unusable, while preserving fixed-peer and
restrict_to_configured_peers behavior.
dash-spv/src/sync/sync_manager.rs (1)

268-277: 🩺 Stability & Availability | 🟡 Minor | ⚡ Quick win

Add closed-channel handling when receiving manager messages.

If context.message_receiver closes, recv() resolves to None and this branch does not complete, so tokio::select! continues the same iteration and can re-enter select! without waiting unless another branch becomes ready. Break from the task when the message receiver closes, matching the existing closed sync_event_receiver and network_event_receiver paths.

🐛 Proposed fix
-                Some((peer, message)) = context.message_receiver.recv() => {
+                msg = context.message_receiver.recv() => {
+                    let Some((peer, message)) = msg else {
+                        tracing::warn!("{} message channel closed, exiting", identifier);
+                        break;
+                    };
                     tracing::trace!("{} received message: {}", identifier, message.cmd());
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/sync_manager.rs` around lines 268 - 277, Update the
`context.message_receiver` branch in the manager task’s `tokio::select!` to
handle `recv()` returning `None` by breaking the task loop immediately. Preserve
the existing message-processing flow for `Some((peer, message))`, matching the
closed-channel handling used by `sync_event_receiver` and
`network_event_receiver`.
dash-spv/src/sync/blocks/sync_manager.rs (1)

81-109: 🗄️ Data Integrity & Integration | 🟠 Major | 🏗️ Heavy lift

Make block acceptance recoverable on storage errors.

BlocksPipeline::receive_block removes the wanted hash before the manager calls request_answered, get_header_height_by_hash, or store_block. A failed header lookup or persistence path then leaves the block only in memory, with no broker retry, because the request is already marked answered and the wanted entry is gone. Resolve the height and persist the block before removing the wanted entry/correlating the request, or add rollback and requeue handling for these failures.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/blocks/sync_manager.rs` around lines 81 - 109, Make block
handling recoverable by completing header lookup and block persistence before
`BlocksPipeline::receive_block` removes the wanted hash and before
`network.request_answered` marks the request complete. Alternatively, add
rollback and requeue handling so failures from `get_header_height_by_hash` or
`store_block` restore the wanted entry and leave the request eligible for retry;
preserve the unrequested-block early return.
🧹 Nitpick comments (3)
dash-spv/src/network/discovery.rs (1)

53-84: 🚀 Performance & Scalability | 🔵 Trivial | ⚡ Quick win

Resolve DNS seeds concurrently instead of sequentially.

Each seed in network.dns_seeds() is resolved one after another, each with its own DNS_LOOKUP_TIMEOUT of 5 seconds. If several seeds are slow or unreachable, worst-case discovery latency grows linearly with the seed count (up to N × 5s). Run the lookups concurrently, for example with futures::future::join_all, so the total wait is bounded by the single slowest lookup.

♻️ Proposed refactor to resolve DNS seeds concurrently
-        let port = network.default_p2p_port();
-        for seed in network.dns_seeds() {
-            match tokio::time::timeout(DNS_LOOKUP_TIMEOUT, tokio::net::lookup_host((*seed, port)))
-                .await
-            {
-                Ok(Ok(iter)) => {
-                    let resolved: Vec<SocketAddr> = iter.collect();
-                    tracing::info!("DNS seed {} returned {} addresses", seed, resolved.len());
-                    addresses.extend(resolved);
-                }
-                Ok(Err(e)) => {
-                    tracing::warn!("Failed to resolve DNS seed {} (backup source): {}", seed, e);
-                }
-                Err(_) => {
-                    tracing::warn!(
-                        "DNS seed {} did not resolve within {:?} (backup source)",
-                        seed,
-                        DNS_LOOKUP_TIMEOUT
-                    );
-                }
-            }
-        }
+        let port = network.default_p2p_port();
+        let lookups = network.dns_seeds().iter().map(|seed| async move {
+            let result =
+                tokio::time::timeout(DNS_LOOKUP_TIMEOUT, tokio::net::lookup_host((*seed, port)))
+                    .await;
+            (seed, result)
+        });
+        for (seed, result) in futures::future::join_all(lookups).await {
+            match result {
+                Ok(Ok(iter)) => {
+                    let resolved: Vec<SocketAddr> = iter.collect();
+                    tracing::info!("DNS seed {} returned {} addresses", seed, resolved.len());
+                    addresses.extend(resolved);
+                }
+                Ok(Err(e)) => {
+                    tracing::warn!("Failed to resolve DNS seed {} (backup source): {}", seed, e);
+                }
+                Err(_) => {
+                    tracing::warn!(
+                        "DNS seed {} did not resolve within {:?} (backup source)",
+                        seed,
+                        DNS_LOOKUP_TIMEOUT
+                    );
+                }
+            }
+        }
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/network/discovery.rs` around lines 53 - 84, Update discover to
resolve all entries from network.dns_seeds() concurrently, using join_all or an
equivalent futures combinator, while retaining the per-seed DNS_LOOKUP_TIMEOUT
and existing success, warning, address aggregation, sorting, and deduplication
behavior. Ensure discovery waits only for the slowest lookup rather than
processing seeds sequentially.
dash-spv/src/sync/blocks/sync_manager.rs (1)

112-115: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Align retry comments with the actual tick behavior.

Line 201 passes a network handle, but Lines 202-203 only process buffered blocks. Lines 112-115 claim that pending work is “topped up on tick”. dash-spv/src/sync/blocks/pipeline.rs Lines 104-108 make the same claim.

The network manager already requeues work on timeout and peer disconnect. Remove the obsolete tick claims, or restore the tick declaration. Keep retry ownership explicit.

This finding is based on the supplied NetworkManager timeout and disconnect handling.

Also applies to: 201-203

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/blocks/sync_manager.rs` around lines 112 - 115, Update the
comments around sync_manager’s process_buffered_blocks call and the
corresponding pipeline.rs comments to match the actual tick behavior: remove
claims that pending work is declared or topped up on tick unless the
implementation is changed to do so. Keep retry ownership explicit by documenting
that NetworkManager handles timeout and peer-disconnect requeueing, and ensure
the comments accurately describe the network handle passed at the tick path.
dash-spv/src/sync/blocks/pipeline.rs (1)

102-123: 🗄️ Data Integrity & Integration | 🔵 Trivial | ⚡ Quick win

Add broker request-correlation tests.

Lines 111-123 replace coordinator-managed request tracking with repeated one-block GetData declarations. The changed test in dash-spv/src/sync/blocks/manager.rs checks sent_messages(), but the new contract also requires the matching RequestKey::Block to be answered and duplicate declarations to remain de-duplicated.

Add an in-module asynchronous unit test and an integration test for response handling, duplicate responses, timeout retries, and peer-disconnect retries.

As per path instructions, new functionality in dash-spv requires comprehensive in-module unit tests and integration tests.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@dash-spv/src/sync/blocks/pipeline.rs` around lines 102 - 123, Add
comprehensive asynchronous unit and integration coverage for the broker contract
exercised by send_pending: verify each block declaration is correlated with
RequestKey::Block, duplicate declarations remain de-duplicated, and valid
responses complete requests without duplicate-response effects. Also cover
timeout retries and peer-disconnect retries, asserting re-declarations and
resulting sent messages through the existing test helpers.

Source: Path instructions

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@dash-spv/src/sync/chainlock/sync_manager.rs`:
- Around line 64-71: Update the ChainLock request tracking around the successful
GetData send in the sync manager so entries in requested_chainlocks cannot
remain indefinitely when no CLSig arrives. Add expiry and retry handling for
tracked hashes, or route these requests through the existing request broker
using RequestKey::ChainLock and clear the entry from process_chainlock when the
response is processed.

In `@dash-spv/src/sync/filters/sync_manager.rs`:
- Around line 225-246: Add focused in-module tests for the rescan decision
around the logic in the sync manager’s restart path, covering restart_at equal
to committed, greater than committed, and scan_floor overriding stale_min_synced
+ 1; assert that only eligible cases reset active filter batches. Add an
integration test that drives the complete rescan flow through start_download and
verifies the resulting reset and scan behavior.

---

Outside diff comments:
In `@dash-spv/src/network/discovery.rs`:
- Around line 34-51: Update the PeerDiscoverer lifecycle around get() and the
PeerNetworkManager start path so failed DNS discovery is not retained across
start attempts. Clear self.discovered when start() fails, or make get() retry
discovery when the cached result is unusable, while preserving fixed-peer and
restrict_to_configured_peers behavior.

In `@dash-spv/src/sync/blocks/sync_manager.rs`:
- Around line 81-109: Make block handling recoverable by completing header
lookup and block persistence before `BlocksPipeline::receive_block` removes the
wanted hash and before `network.request_answered` marks the request complete.
Alternatively, add rollback and requeue handling so failures from
`get_header_height_by_hash` or `store_block` restore the wanted entry and leave
the request eligible for retry; preserve the unrequested-block early return.

In `@dash-spv/src/sync/sync_manager.rs`:
- Around line 268-277: Update the `context.message_receiver` branch in the
manager task’s `tokio::select!` to handle `recv()` returning `None` by breaking
the task loop immediately. Preserve the existing message-processing flow for
`Some((peer, message))`, matching the closed-channel handling used by
`sync_event_receiver` and `network_event_receiver`.

---

Nitpick comments:
In `@dash-spv/src/network/discovery.rs`:
- Around line 53-84: Update discover to resolve all entries from
network.dns_seeds() concurrently, using join_all or an equivalent futures
combinator, while retaining the per-seed DNS_LOOKUP_TIMEOUT and existing
success, warning, address aggregation, sorting, and deduplication behavior.
Ensure discovery waits only for the slowest lookup rather than processing seeds
sequentially.

In `@dash-spv/src/sync/blocks/pipeline.rs`:
- Around line 102-123: Add comprehensive asynchronous unit and integration
coverage for the broker contract exercised by send_pending: verify each block
declaration is correlated with RequestKey::Block, duplicate declarations remain
de-duplicated, and valid responses complete requests without duplicate-response
effects. Also cover timeout retries and peer-disconnect retries, asserting
re-declarations and resulting sent messages through the existing test helpers.

In `@dash-spv/src/sync/blocks/sync_manager.rs`:
- Around line 112-115: Update the comments around sync_manager’s
process_buffered_blocks call and the corresponding pipeline.rs comments to match
the actual tick behavior: remove claims that pending work is declared or topped
up on tick unless the implementation is changed to do so. Keep retry ownership
explicit by documenting that NetworkManager handles timeout and peer-disconnect
requeueing, and ensure the comments accurately describe the network handle
passed at the tick path.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: d80f18c0-f92b-4cb7-ad93-f8a2fe9394dd

📥 Commits

Reviewing files that changed from the base of the PR and between 8d253b2 and 5854b15.

📒 Files selected for processing (16)
  • dash-spv/src/network/discovery.rs
  • dash-spv/src/network/manager.rs
  • dash-spv/src/network/peer.rs
  • dash-spv/src/sync/block_headers/sync_manager.rs
  • dash-spv/src/sync/blocks/manager.rs
  • dash-spv/src/sync/blocks/pipeline.rs
  • dash-spv/src/sync/blocks/sync_manager.rs
  • dash-spv/src/sync/chainlock/sync_manager.rs
  • dash-spv/src/sync/filter_headers/sync_manager.rs
  • dash-spv/src/sync/filters/manager.rs
  • dash-spv/src/sync/filters/sync_manager.rs
  • dash-spv/src/sync/masternodes/sync_manager.rs
  • dash-spv/src/sync/mempool/manager.rs
  • dash-spv/src/sync/mempool/sync_manager.rs
  • dash-spv/src/sync/sync_coordinator.rs
  • dash-spv/src/sync/sync_manager.rs
💤 Files with no reviewable changes (4)
  • dash-spv/src/sync/block_headers/sync_manager.rs
  • dash-spv/src/sync/filter_headers/sync_manager.rs
  • dash-spv/src/sync/masternodes/sync_manager.rs
  • dash-spv/src/sync/filters/manager.rs
🚧 Files skipped from review as they are similar to previous changes (4)
  • dash-spv/src/sync/sync_coordinator.rs
  • dash-spv/src/network/manager.rs
  • dash-spv/src/sync/mempool/sync_manager.rs
  • dash-spv/src/sync/mempool/manager.rs

Comment thread dash-spv/src/sync/chainlock/sync_manager.rs
Comment thread dash-spv/src/sync/filters/sync_manager.rs
@github-actions github-actions Bot added the ready-for-review CodeRabbit has approved this PR label Aug 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-review CodeRabbit has approved this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant