feat(consensus): moderator

[Mododo]

Pull Request Checklist

NODE CONFIGURATION MODEL CHANGES

added ban config and journal storage duration (with defaults)

BLOCKCHAIN CONFIGURATION MODEL CHANGES

None

---

COMPATIBILITY

Full. Added a new separate db.

SPECIAL DEPLOYMENT ACTIONS

Not Required

---

PERFORMANCE IMPACT

No impact expected

---

TESTS

Unit Tests

Added some tests for basic units and a single core cross-call test

Network Tests

No coverage

Manual Tests

transfers-30k, simulator

---

Notes/Additional Comments:

moderator core sequence diagram

sequenceDiagram
    participant Moderator
    participant Scheduler as Unban<br/>Scheduler
    box Ban Core State
      participant StateLock as Ban Core<br/>state lock
      participant BanCache as Ban Cache
      participant CurrentBans as Peer Events,<br/>Current Bans
    end
    participant PeerSchedule as Peer Schedule
    participant DBWriter as Delayed<br/>DB Writer
    participant DelayQueue as Unban<br/>Delay Queue

    alt start
        Moderator->>StateLock: init task at node start
        activate StateLock
        StateLock->>BanCache: restore
        BanCache->>CurrentBans: upsert
        BanCache->>Scheduler: banned
        BanCache-->>StateLock: new bans
        StateLock->>PeerSchedule: set_banned
        StateLock->>DBWriter: new bans
        deactivate StateLock

    else report
        Moderator->>Scheduler: event
        Scheduler->>Scheduler: dequeue
        Scheduler->>StateLock: event
        activate StateLock
        StateLock->>BanCache: maybe_ban
        opt if banned
            BanCache->>CurrentBans: upsert
            BanCache->>Scheduler: banned
            StateLock->>PeerSchedule: set_banned
        end
        StateLock->>DBWriter: stored items, no callback
        deactivate StateLock

    else manual ban
        Moderator->>StateLock: manual ban
        activate StateLock
        StateLock->>BanCache: manual_ban
        BanCache->>CurrentBans: upsert
        BanCache->>Scheduler: banned
        StateLock->>PeerSchedule: set_banned
        StateLock->>DBWriter: with callback
        deactivate StateLock
        DBWriter->>Moderator: wait callback

    else schedule unban
        Scheduler->>Scheduler: dequeue
        Scheduler->>StateLock: lock
        activate StateLock
        Scheduler->>DelayQueue: add
        deactivate StateLock

    else manual unban
        Moderator->>Scheduler: manual unban
        Scheduler->>Scheduler: dequeue
        Scheduler->>StateLock: manual unban
        activate StateLock
        Scheduler->>DelayQueue: remove
        StateLock->>BanCache: unban
        BanCache->>CurrentBans: remove
        StateLock->>PeerSchedule: remove_bans
        StateLock->>DBWriter: with callback
        deactivate StateLock
        DBWriter->>Moderator: wait callback

    else auto unban
        DelayQueue->>Scheduler: expire
        Scheduler->>StateLock: current ban
        activate StateLock
        StateLock->>BanCache: unban
        BanCache->>CurrentBans: remove
        StateLock->>PeerSchedule: remove_bans
        StateLock->>DBWriter: no callback
        deactivate StateLock

    end

Loading

[github-actions]

🧪 Network Tests

To run network tests for this PR, use:

gh workflow run network-tests.yml -f pr_number=992

Available test options:

• Run all tests: gh workflow run network-tests.yml -f pr_number=992
• Run specific test: gh workflow run network-tests.yml -f pr_number=992 -f test_selection=ping-pong

Test types: destroyable, ping-pong, one-to-many-internal-messages, fq-deploy, nft-index, persistent-sync

Results will be posted as workflow runs in the Actions tab.

[codecov]

Codecov Report

❌ Patch coverage is 39.48413% with 1525 lines in your changes missing coverage. Please review.
✅ Project coverage is 56.80%. Comparing base (a31514e) to head (c1b1da5).
⚠️ Report is 17 commits behind head on master.

Files with missing lines	Patch %	Lines
consensus/src/moderator/impl_.rs	0.94%	313 Missing ⚠️
consensus/src/moderator/ban/core.rs	0.00%	234 Missing ⚠️
cli/src/cmd/node/control.rs	0.00%	131 Missing ⚠️
cli/src/cmd/node/mempool_control.rs	0.00%	93 Missing ⚠️
control/src/server.rs	0.00%	80 Missing ⚠️
consensus/src/moderator/ban/state.rs	0.00%	75 Missing ⚠️
control/src/client.rs	0.00%	73 Missing ⚠️
consensus/src/moderator/ban/cache.rs	74.52%	52 Missing and 15 partials ⚠️
consensus/src/moderator/storage/store.rs	58.33%	52 Missing and 13 partials ⚠️
consensus/src/moderator/journal/event.rs	63.63%	43 Missing and 1 partial ⚠️
... and 31 more

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #992      +/-   ##
==========================================
- Coverage   57.25%   56.80%   -0.45%     
==========================================
  Files         429      448      +19     
  Lines       71866    74314    +2448     
  Branches    71866    74314    +2448     
==========================================
+ Hits        41147    42217    +1070     
- Misses      28735    30020    +1285     
- Partials     1984     2077      +93     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

❌ CLI reference check failed in CI.

Please run just update_cli_reference, add the updated docs/cli-reference.md, and push the changes.