This feature is only for generating and displaying a simple dust analysis report for a wallet. Assume the dust detection logic already exists.
The user should be able to go to:
Wallet Settings → Dust Report → Run Dust Report
Keeper should then run the dust analysis, show a loading/progress screen, and finally display a clear static report summarising what was found.
Problem
Keeper may detect coins or past transactions that are related to potential dust activity, but the user currently does not have one simple place to review the result.
Users need a clear report that answers:
- Did Keeper find any active dust?
- Did Keeper find any past dust spend?
- Are any current coins marked Do Not Spend because of dust?
- Is there anything the user can do from here?
Scope
This issue covers only the Dust Report UI and flow.
Detection logic is assumed to be already available.
The report should show results based on the output of the existing dust detection logic.
Flow
Entry Point
Add entry point in wallet settings:
Dust Report
Tapping it opens the Dust Report start screen.
Start Screen
Title:
Dust Report
Body:
Keeper can scan this wallet for dust activity and show coins that may reduce privacy if spent.
Primary CTA:
Run Report
Secondary CTA:
Cancel
Running Screen
After tapping Run Report, show a waiting/progress screen.
Title:
Scanning Wallet
Body:
Keeper is checking this wallet for potential dust activity. This may take a few minutes.
Optional progress items:
- Checking wallet coins
- Checking past transactions
- Preparing report
No technical detection rules need to be shown here.
Report Screen
After scan completes, show a simple static report.
Title:
Dust Report
If dust-related items are found, show summary copy:
Keeper found coins or transactions that may reduce wallet privacy.
If nothing is found:
Keeper did not find potential dust activity in this wallet.
Report Content
The report should have a clean summary card and simple sections.
Summary Card
Show:
- Do Not Spend coins
- Amount marked Do Not Spend
- Past dust spends found
- Last scanned time
Example:
Do Not Spend coins: 3
Amount marked Do Not Spend: 12,400 sats
Past dust spends: 1
Last scanned: Today, 14:20
Section: Active Dust
Show current unspent dust coins.
For each item:
- amount
- label: Do Not Spend
- short reason: Potential dust payment
If none:
No active dust found.
Section: Linked Coins
Show current coins marked Do Not Spend because they are linked to past dust activity.
For each item:
- amount
- label: Do Not Spend
- short reason: Linked to potential dust spend
If none:
No linked coins found.
Section: Past Dust Spends
Show historical transactions where dust may already have been spent.
For each item:
- transaction date
- amount, if available
- label: Potential dust spend
If none:
No past dust spends found.
Actions
At the bottom of the report:
Primary CTA:
Done
Optional CTA if Do Not Spend dust coins exist:
Donate Dust
Donate Dust should only appear as an action from the report if eligible Do Not Spend dust coins exist.
No other actions are required in this issue.
Empty State
If no dust activity is found:
Title:
No Dust Found
Body:
Keeper did not find potential dust activity in this wallet.
CTA:
Done
Error State
If report generation fails:
Title:
Report Not Completed
Body:
Keeper could not complete the dust report. Try again.
CTA:
Try Again
Secondary CTA:
Cancel
Design Requirements
- Use existing Keeper settings and report/list components.
- Keep the report visually simple.
- Use cards or grouped sections.
- Use existing warning-style chip for Do Not Spend.
- Do not show long addresses or full txids by default.
- Do not show detection rules or technical logic.
- Do not make the screen look like an emergency.
- Use “potential” and “may” language.
- Keep button labels short.
Notes
- Detection logic is not part of this issue.
- Spending logic is not part of this issue, except showing Donate Dust as an optional CTA if eligible coins exist.
- This report should be wallet-specific, not app-wide.
This feature is only for generating and displaying a simple dust analysis report for a wallet. Assume the dust detection logic already exists.
The user should be able to go to:
Wallet Settings → Dust Report → Run Dust Report
Keeper should then run the dust analysis, show a loading/progress screen, and finally display a clear static report summarising what was found.
Problem
Keeper may detect coins or past transactions that are related to potential dust activity, but the user currently does not have one simple place to review the result.
Users need a clear report that answers:
Scope
This issue covers only the Dust Report UI and flow.
Detection logic is assumed to be already available.
The report should show results based on the output of the existing dust detection logic.
Flow
Entry Point
Add entry point in wallet settings:
Dust Report
Tapping it opens the Dust Report start screen.
Start Screen
Title:
Dust Report
Body:
Keeper can scan this wallet for dust activity and show coins that may reduce privacy if spent.
Primary CTA:
Run Report
Secondary CTA:
Cancel
Running Screen
After tapping Run Report, show a waiting/progress screen.
Title:
Scanning Wallet
Body:
Keeper is checking this wallet for potential dust activity. This may take a few minutes.
Optional progress items:
No technical detection rules need to be shown here.
Report Screen
After scan completes, show a simple static report.
Title:
Dust Report
If dust-related items are found, show summary copy:
Keeper found coins or transactions that may reduce wallet privacy.
If nothing is found:
Keeper did not find potential dust activity in this wallet.
Report Content
The report should have a clean summary card and simple sections.
Summary Card
Show:
Example:
Do Not Spend coins: 3
Amount marked Do Not Spend: 12,400 sats
Past dust spends: 1
Last scanned: Today, 14:20
Section: Active Dust
Show current unspent dust coins.
For each item:
If none:
No active dust found.
Section: Linked Coins
Show current coins marked Do Not Spend because they are linked to past dust activity.
For each item:
If none:
No linked coins found.
Section: Past Dust Spends
Show historical transactions where dust may already have been spent.
For each item:
If none:
No past dust spends found.
Actions
At the bottom of the report:
Primary CTA:
Done
Optional CTA if Do Not Spend dust coins exist:
Donate Dust
Donate Dust should only appear as an action from the report if eligible Do Not Spend dust coins exist.
No other actions are required in this issue.
Empty State
If no dust activity is found:
Title:
No Dust Found
Body:
Keeper did not find potential dust activity in this wallet.
CTA:
Done
Error State
If report generation fails:
Title:
Report Not Completed
Body:
Keeper could not complete the dust report. Try again.
CTA:
Try Again
Secondary CTA:
Cancel
Design Requirements
Notes