Commit b3e7eb8
fix(notifications): suppress duplicate toasts for quickbuy trades (MetaMask#31462)
## **Description**
<!--
Write a short description of the changes included in this pull request,
also include relevant motivation and context. Have in mind the following
questions:
1. What is the reason for the change?
2. What is the improvement/solution?
-->
QuickBuy surfaces its own pending/complete/failed toasts. When a trade
is submitted via an EIP-7702 smart account or a gas-included
(`gasIncluded7702`) quote, `BridgeStatusController.submitTx` wraps the
trade as a `TransactionType.batch` transaction. `batch` is in
`REDESIGNED_TRANSACTION_TYPES`, so `NotificationManager` also fired the
generic "Transaction submitted" and "Transaction #N complete" toasts on
top of QuickBuy's own — the user saw **4 toasts instead of 2**. (This is
why it doesn't reproduce on a plain EOA: those trades are typed
`swap`/`bridge`, which are not redesigned types.)
This PR scopes the suppression strictly to QuickBuy via inversion of
control, so the main Swap/Bridge flows are unaffected:
- New dependency-free module `app/core/notificationSkipPredicates.ts`
holds a registry of "skip predicates".
`NotificationManager.#shouldSkipNotification` consults it (guarded by
try/catch so a throwing predicate can never break notifications).
Keeping it in its own module means feature code can register without
importing the heavy `NotificationManager` graph.
- QuickBuy registers a predicate at the app root
(`useQuickBuyToastRegistrations`) that matches:
- **tracked trade ids** — covers the terminal complete/failed toast, and
- **in-flight submissions** via a pre-submit marker
(`beginQuickBuySubmission`/`endQuickBuySubmission`) — covers the
*pending* toast, which fires mid-`submitTx` before the tx id is known.
## **Changelog**
<!-- mms-check: type=changelog required=true -->
CHANGELOG entry: Fixed QuickBuy showing duplicate transaction toasts for
smart-account and gas-included trades
## **Related issues**
<!-- mms-check: type=issue-link required=true -->
Fixes: https://consensyssoftware.atlassian.net/browse/TSA-627
## **Manual testing steps**
<!-- mms-check: type=manual-testing required=true -->
```gherkin
Feature: QuickBuy transaction toasts
Scenario: User runs a QuickBuy with a smart (EIP-7702) account
Given I have an EIP-7702 smart account enabled on the trade network
And I open a token from the Social Leaderboard trader position view
When I confirm a QuickBuy trade
Then I see exactly one QuickBuy "Buying..." pending toast
And after the trade settles I see exactly one QuickBuy "Bought" (or "Failed") toast
And I do not see the generic "Transaction submitted" or "Transaction complete" toasts
Scenario: User runs a QuickBuy on a plain EOA (regression)
Given I have a standard externally-owned account
When I confirm a QuickBuy trade
Then I still see only the two QuickBuy toasts (pending, then terminal)
Scenario: Main Swap/Bridge flows are unaffected (regression)
Given I start a swap or bridge from the main Swap/Bridge UI
When the transaction is submitted and confirmed
Then the generic transaction toasts still appear as before
```
## **Screenshots/Recordings**
<!-- mms-check: type=screenshot required=true -->
### **Before**
In some rare cases, this happens:
https://github.com/user-attachments/assets/838826be-99a7-4101-873e-88173059fbc1
### **After**
This is what we want in all cases:
https://github.com/user-attachments/assets/b49de0d5-a0e2-47cb-8eef-6b372ad0f79f
## **Pre-merge author checklist**
<!-- mms-check: type=checklist required=true -->
- [x] I've followed [MetaMask Contributor
Docs](https://github.com/MetaMask/contributor-docs) and [MetaMask Mobile
Coding
Standards](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/CODING_GUIDELINES.md).
- [x] I've completed the PR template to the best of my ability
- [x] I've included tests if applicable
- [x] I've documented my code using [JSDoc](https://jsdoc.app/) format
if applicable
- [x] I've applied the right labels on the PR (see [labeling
guidelines](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/LABELING_GUIDELINES.md)).
Not required for external contributors.
#### Performance checks (if applicable)
- [x] I've tested on Android
- Ideally on a mid-range device; emulator is acceptable
- [x] I've tested with a power user scenario
- Use these [power-user
SRPs](https://consensyssoftware.atlassian.net/wiki/spaces/TL1/pages/edit-v2/401401446401?draftShareId=9d77e1e1-4bdc-4be1-9ebb-ccd916988d93)
to import wallets with many accounts and tokens
- [x] I've instrumented key operations with Sentry traces for production
performance metrics
- See [`trace()`](/app/util/trace.ts) for usage and
[`addToken`](/app/components/Views/AddAsset/components/AddCustomToken/AddCustomToken.tsx#L274)
for an example
For performance guidelines and tooling, see the [Performance
Guide](https://consensyssoftware.atlassian.net/wiki/spaces/TL1/pages/400085549067/Performance+Guide+for+Engineers).
## **Pre-merge reviewer checklist**
- [ ] I've manually tested the PR (e.g. pull and build branch, run the
app, test code being changed).
- [ ] I confirm that this PR addresses all acceptance criteria described
in the ticket it closes and includes the necessary testing evidence such
as recordings and or screenshots.
Made with [Cursor](https://cursor.com)
<!-- CURSOR_SUMMARY -->
---
> [!NOTE]
> **Medium Risk**
> Changes global notification gating and briefly suppresses
swap/bridge/batch notifications during QuickBuy submit; predicates are
isolated and errors are caught so unrelated flows should still get
generic toasts.
>
> **Overview**
> Adds a **dependency-free notification skip registry**
(`notificationSkipPredicates`) and wires **`NotificationManager`** to
consult registered predicates (with try/catch) so feature flows can opt
out of generic transaction toasts without core importing UI code.
>
> **QuickBuy** registers `isQuickBuyTransaction` at the app root and
extends the trade tracker with: a **ref-counted in-flight submission
marker** (`begin`/`end` around `submitTx`) for pending notifications
before the tx id exists; **tracked and recently-settled tx ids** so
suppression still applies when `NotificationManager` re-checks ~2s after
confirm/fail; and **type-narrowed matching** (swap/bridge/batch) during
submission so unrelated txs are not hidden. Terminal handling now
**settles** trades via `markQuickBuyTradeSettled` instead of a plain
untrack so duplicate generic success/error toasts do not appear on top
of QuickBuy’s own toasts (notably EIP-7702 `batch` trades).
>
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
270b0ec. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
---------
Co-authored-by: Cursor <cursoragent@cursor.com>1 parent 8f251d4 commit b3e7eb8
11 files changed
Lines changed: 560 additions & 10 deletions
File tree
- app
- components/Views/SocialLeaderboard/TraderPositionView/components/QuickBuy
- hooks
- core
Lines changed: 14 additions & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
95 | 95 | | |
96 | 96 | | |
97 | 97 | | |
98 | | - | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
99 | 103 | | |
100 | 104 | | |
101 | 105 | | |
| |||
1061 | 1065 | | |
1062 | 1066 | | |
1063 | 1067 | | |
| 1068 | + | |
| 1069 | + | |
| 1070 | + | |
| 1071 | + | |
| 1072 | + | |
1064 | 1073 | | |
1065 | 1074 | | |
1066 | 1075 | | |
| |||
1132 | 1141 | | |
1133 | 1142 | | |
1134 | 1143 | | |
| 1144 | + | |
| 1145 | + | |
| 1146 | + | |
| 1147 | + | |
1135 | 1148 | | |
1136 | 1149 | | |
1137 | 1150 | | |
| |||
Lines changed: 27 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
| 11 | + | |
11 | 12 | | |
| 13 | + | |
12 | 14 | | |
13 | 15 | | |
14 | 16 | | |
15 | 17 | | |
| 18 | + | |
16 | 19 | | |
17 | 20 | | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
18 | 26 | | |
19 | 27 | | |
20 | 28 | | |
| |||
101 | 109 | | |
102 | 110 | | |
103 | 111 | | |
| 112 | + | |
104 | 113 | | |
105 | 114 | | |
106 | 115 | | |
107 | 116 | | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
108 | 135 | | |
109 | 136 | | |
110 | 137 | | |
| |||
Lines changed: 11 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | | - | |
| 1 | + | |
2 | 2 | | |
3 | 3 | | |
| 4 | + | |
4 | 5 | | |
5 | | - | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
6 | 10 | | |
7 | 11 | | |
8 | 12 | | |
| |||
19 | 23 | | |
20 | 24 | | |
21 | 25 | | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
22 | 31 | | |
23 | 32 | | |
24 | 33 | | |
| |||
Lines changed: 159 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
2 | 9 | | |
3 | 10 | | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
4 | 14 | | |
5 | 15 | | |
6 | 16 | | |
7 | 17 | | |
8 | 18 | | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
9 | 22 | | |
10 | 23 | | |
11 | 24 | | |
| |||
24 | 37 | | |
25 | 38 | | |
26 | 39 | | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
27 | 44 | | |
28 | 45 | | |
29 | 46 | | |
| |||
84 | 101 | | |
85 | 102 | | |
86 | 103 | | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
| 172 | + | |
| 173 | + | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
| 182 | + | |
| 183 | + | |
| 184 | + | |
| 185 | + | |
| 186 | + | |
| 187 | + | |
| 188 | + | |
| 189 | + | |
| 190 | + | |
| 191 | + | |
| 192 | + | |
| 193 | + | |
| 194 | + | |
| 195 | + | |
| 196 | + | |
| 197 | + | |
| 198 | + | |
| 199 | + | |
| 200 | + | |
| 201 | + | |
| 202 | + | |
| 203 | + | |
| 204 | + | |
| 205 | + | |
| 206 | + | |
| 207 | + | |
| 208 | + | |
| 209 | + | |
| 210 | + | |
| 211 | + | |
| 212 | + | |
| 213 | + | |
| 214 | + | |
| 215 | + | |
| 216 | + | |
| 217 | + | |
| 218 | + | |
| 219 | + | |
| 220 | + | |
| 221 | + | |
| 222 | + | |
| 223 | + | |
| 224 | + | |
| 225 | + | |
| 226 | + | |
| 227 | + | |
| 228 | + | |
| 229 | + | |
| 230 | + | |
| 231 | + | |
| 232 | + | |
| 233 | + | |
| 234 | + | |
| 235 | + | |
| 236 | + | |
| 237 | + | |
| 238 | + | |
| 239 | + | |
| 240 | + | |
| 241 | + | |
| 242 | + | |
| 243 | + | |
| 244 | + | |
| 245 | + | |
87 | 246 | | |
0 commit comments