feat: DHT Provide Sweep Diagnostic Screen #2463

ChayanDass · 2026-01-18T20:22:58Z

Summary

This PR adds a new DHT Provide diagnostics screen to the IPFS WebUI, providing a graphical view of
ipfs provide stat data for the DHT Sweep provider (enabled by default in Kubo v0.39+).

The screen gives node operators a clear overview of:

Reprovide cycle progress
Current batch and queue status
Worker utilization
Network health and throughput
Capacity warnings

This makes it possible to monitor DHT provide health without relying on the CLI.

Key Features

New Diagnostics → DHT Provide screen
Visualize cycle progress with ETA
Current batch and queue metrics
Worker utilization (periodic vs on-demand)
Network connectivity and success rate
Auto-refresh (60s) with manual refresh
Graceful handling of unsupported Kubo versions
UI built using reusable Card components (WebUI style)

Screenshots

Initial DHT Provide Screen

Technical Details

Data Source

RPC endpoint: POST /api/v0/provide/stat
Accessed via ipfs.provide.stat() through context (ProvideProvider)

Architecture

New ProvideStat context for data fetching and refresh lifecycle
UI composed of small, focused components:
- ReprovideCycle
- CurrentBatch
- QueueStatus
- Workers
- Network
Uses local Card primitives

Checklist

UI follows existing WebUI conventions
No breaking changes
Handles unsupported Kubo versions
Screenshots included

Signed-off-by: Chayan Das <01chayandas@gmail.com>

welcome · 2026-01-18T20:23:00Z

Thank you for submitting this PR!
A maintainer will be here shortly to review it.
We are super grateful, but we are also overloaded! Help us by making sure that:

The context for this PR is clear, with relevant discussion, decisions
and stakeholders linked/mentioned.
Your contribution itself is clear (code comments, self-review for the
rest) and in its best form. Follow the code contribution
guidelines
if they apply.

Getting other community members to do a review would be great help too on complex PRs (you can ask in the chats/forums). If you are unsure about something, just leave us a comment.
Next steps:

A maintainer will triage and assign priority to this PR, commenting on
any missing things and potentially assigning a reviewer for high
priority items.
The PR gets reviews, discussed and approvals as needed.
The PR is merged by maintainers when it has been approved and comments addressed.

We currently aim to provide initial feedback/triaging within two business days. Please keep an eye on any labelling actions, as these will indicate priorities and status of your contribution.
We are very grateful for your contribution!

Signed-off-by: Chayan Das <01chayandas@gmail.com>

ChayanDass · 2026-01-20T10:47:08Z

HI @lidel, could you confirm the UI design?

Signed-off-by: Chayan Das <01chayandas@gmail.com>

- use teal uppercase card titles (ttu tracked f6 fw4) - replace help tooltips with muted GlyphInfo icons - add muted opacity to progress bars - hide TourHelper on diagnostics pages - add className prop to IconTooltip component - prevent uppercase text in tooltips with ttn class

reorganize cards to match `ipfs provide stat -a --compact`: - rename cards: Connectivity, Queues, Schedule, Operations, Network, Workers - update labels to match CLI terminology (Peers swept, Avg record holders, etc.) - remove Timings card, redistribute content to Connectivity and Schedule - group Operations by temporal flow (live stats, then cumulative) - add visual separators for logical grouping in Workers and Operations - Schedule: inline last cycle count, add reprovide interval, compact progress - extract shared formatting utilities to format-utils.ts

replace page title with short description explaining this is a visual summary, linking to `ipfs provide stat` command documentation

- add null/undefined checks with optional chaining across all components - extract shared formatting utilities to format-utils.ts with safe defaults - improve Workers tooltip to explain periodic vs burst worker types

…ndicator - rename region_reprovide_duration to reprovide_duration - add Accelerated DHT client (FullRT) indicator to Network card

includes provide API support for DHT provide stats

…c docs

- use i18n.language instead of browser locale for Intl.NumberFormat - add formatInteger helper for thousand separators - update all components to use locale-aware formatting

storybook doesn't resolve the src/ path alias from tsconfig

lidel

Thanks @Chayandas07 for putting this together!

The foundations you built were solid (kubo-rpc-client v6.1 includes support for ipfs.provide.stat) + the GUI here did not require significant changes 👍

I pushed some follow-up commits to adjust the presentation and fix a few papercuts:

Made the page robust to potential breaking API changes (defensive null handling)
Wired up translations and locale-specific number formatting
Aligned labels with ipfs provide stat CLI output
Added links to configuration and metric documentation
Minor UI polish (tooltips, layout tweaks)

This is a great addition to the webui and if there are no concerns during review, we're excited to ship it with Kubo 0.40 in a few weeks!

@guillaumemichel could you do a quick sanity check on the layout and labels? We can always move things around later, but want to catch any awkward phrasing before release.

UI Preview

In the middle of schedule

After reboot

- add e2e tests for the DHT provide diagnostic screen - fix global-setup.js to use page.evaluate instead of addInitScript (addInitScript registers for future page loads, so localStorage values were not captured by storageState before browser closed) - enable DHT in test backend: Routing.Type=autoclient, Provide.Strategy=pinned+mfs - bump kubo dependency to 0.39.0 (required for provide stats API) - add 10 minute timeout to e2e workflow - remove --repeat-each 10 from e2e workflow (no longer needed)

- grid-view: add focusGrid() helper that tries multiple approaches to establish keyboard focus before tests - grid-view: reload page after creating test folder to ensure clean state - grid helper: wait for files view before checking mode in selectViewMode() - files: only verify uploaded files, not all MFS contents (avoids test pollution from parallel runs)

without this, Kubo tries to connect to bootstrap peers which hangs on CI where network access may be restricted

- add timeout wrappers to kubo spawn (30s) and setup (60s) - add logging to global-setup and ipfs-backend for debugging - remove all process.env.CI checks from playwright config - add globalTimeout (5min) to catch runaway test suites - use --reporter=list in CI for better output

lidel · 2026-01-24T21:05:07Z

CI is broken for reasons unrelated to this PR.
I'm fixing that in #2466, will rebase this PR once that one is done.

feat(provide_stat): add new page for provide stat

24aef6e

Signed-off-by: Chayan Das <01chayandas@gmail.com>

ChayanDass requested a review from a team as a code owner January 18, 2026 20:22

ChayanDass marked this pull request as draft January 18, 2026 20:23

feat(provide_stat):add tooltip to dht provide page

64f5631

Signed-off-by: Chayan Das <01chayandas@gmail.com>

feat(provide_stat):fix the ui and make the ui responsive

94c662b

Signed-off-by: Chayan Das <01chayandas@gmail.com>

lidel mentioned this pull request Jan 23, 2026

Release 0.40 ipfs/kubo#11008

Open

56 tasks

lidel added 10 commits January 23, 2026 20:04

style(dht-provide): replace title with description and docs link

cc8ff61

replace page title with short description explaining this is a visual summary, linking to `ipfs provide stat` command documentation

feat(dht-provide): update types for kubo API changes and add FullRT i…

dce9698

…ndicator - rename region_reprovide_duration to reprovide_duration - add Accelerated DHT client (FullRT) indicator to Network card

chore(deps): upgrade kubo-rpc-client to 6.1.0

b0279e2

includes provide API support for DHT provide stats

docs(dht-provide): improve description with links to config and metri…

26185b8

…c docs

fix(i18n): improve schedule tooltip wording

9e9870d

fix(i18n): use app locale for number formatting

4c30fd4

- use i18n.language instead of browser locale for Intl.NumberFormat - add formatInteger helper for thousand separators - update all components to use locale-aware formatting

Merge remote-tracking branch 'origin/main' into feat/provide-stat

6259828

lidel marked this pull request as ready for review January 23, 2026 23:36

lidel temporarily deployed to Deploy January 23, 2026 23:38 — with GitHub Actions Inactive

fix(imports): use relative paths for storybook compatibility

466f732

storybook doesn't resolve the src/ path alias from tsconfig

lidel approved these changes Jan 23, 2026

View reviewed changes

lidel changed the title ~~feat(provide_stat): add new page for provide stat~~ feat: DHT Provide Sweep Diagnostic Screen Jan 23, 2026

lidel temporarily deployed to Deploy January 23, 2026 23:56 — with GitHub Actions Inactive

lidel mentioned this pull request Jan 24, 2026

fix the file not found page #2455

Open

lidel had a problem deploying to Deploy January 24, 2026 05:22 — with GitHub Actions Error

lidel force-pushed the feat/provide-stat branch from 67297f8 to c54aaab Compare January 24, 2026 05:23

lidel temporarily deployed to Deploy January 24, 2026 05:24 — with GitHub Actions Inactive

lidel force-pushed the feat/provide-stat branch from c54aaab to 511ec39 Compare January 24, 2026 05:55

lidel temporarily deployed to Deploy January 24, 2026 05:56 — with GitHub Actions Inactive

lidel temporarily deployed to Deploy January 24, 2026 06:16 — with GitHub Actions Inactive

test(e2e): disable DHT bootstrapping for faster CI startup

b2148f9

without this, Kubo tries to connect to bootstrap peers which hangs on CI where network access may be restricted

lidel temporarily deployed to Deploy January 24, 2026 06:32 — with GitHub Actions Inactive

lidel temporarily deployed to Deploy January 24, 2026 06:42 — with GitHub Actions Inactive

lidel force-pushed the feat/provide-stat branch from adfb890 to 1ea2cd8 Compare January 24, 2026 06:49

lidel temporarily deployed to Deploy January 24, 2026 06:50 — with GitHub Actions Inactive

lidel force-pushed the feat/provide-stat branch from 1ea2cd8 to b0c7c6d Compare January 24, 2026 07:18

lidel temporarily deployed to Deploy January 24, 2026 07:19 — with GitHub Actions Inactive

lidel force-pushed the feat/provide-stat branch from b0c7c6d to e4f7abe Compare January 24, 2026 15:32

lidel temporarily deployed to Deploy January 24, 2026 15:32 — with GitHub Actions Inactive

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: DHT Provide Sweep Diagnostic Screen #2463

feat: DHT Provide Sweep Diagnostic Screen #2463

ChayanDass commented Jan 18, 2026 •

edited

Loading

Uh oh!

welcome bot commented Jan 18, 2026

Uh oh!

ChayanDass commented Jan 20, 2026

Uh oh!

lidel left a comment •

edited

Loading

Uh oh!

lidel commented Jan 24, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

feat: DHT Provide Sweep Diagnostic Screen #2463

Are you sure you want to change the base?

feat: DHT Provide Sweep Diagnostic Screen #2463

Conversation

ChayanDass commented Jan 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Key Features

Screenshots

Initial DHT Provide Screen

Technical Details

Data Source

Architecture

next

Checklist

Uh oh!

welcome bot commented Jan 18, 2026

Uh oh!

ChayanDass commented Jan 20, 2026

Uh oh!

lidel left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

UI Preview

In the middle of schedule

After reboot

Uh oh!

lidel commented Jan 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ChayanDass commented Jan 18, 2026 •

edited

Loading

lidel left a comment •

edited

Loading

lidel commented Jan 24, 2026 •

edited

Loading