feat: display a warning when gas sponsorship failed #39284

Julink-eth · 2026-01-15T16:17:22Z

Description

Context
Gas sponsorship on certain networks (like Monad) has reserve balance requirements. When a transaction simulation fails due to reserve balance violations, users currently don't receive clear feedback about why sponsorship isn't available.

Problem
Users on networks with gas sponsorship reserve requirements (e.g., Monad requires 10 MON minimum) don't see any warning when their transaction can't be sponsored due to insufficient reserve balance.

Solution
Added a new useGasSponsorshipWarningAlerts hook that:
Checks simulationData.callTraceErrors for known sponsorship failure patterns
Uses a configurable rules system (GAS_SPONSORSHIP_WARNING_RULES) to match chain-specific error patterns
Displays a Severity.Warning alert on the EstimatedFee row when sponsorship fails due to reserve balance violations
Currently configured for Monad (10 MON minimum reserve requirement)

Related Core PR : MetaMask/core#7641

Changelog

CHANGELOG entry: Added a warning message when gas sponsorship is unavailable due to reserve balance requirements.

Related issues

Fixes:

Manual testing steps

Connect to Monad
Ensure account has less than 10 MON balance
Initiate a contract interaction transaction
Observe the warning alert on the confirmation screen stating "Gas sponsorship isn't available for this transaction. You'll need to keep at least 10 MON in your account."

Screenshots/Recordings

Before

After

Pre-merge author checklist

I've followed MetaMask Contributor Docs and MetaMask Extension Coding Standards.
I've completed the PR template to the best of my ability
I’ve included tests if applicable
I’ve documented my code using JSDoc format if applicable
I’ve applied the right labels on the PR (see labeling guidelines). Not required for external contributors.

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.

Note

Adds a new warning surfaced in transaction confirmations when sponsorship is unavailable based on simulation call trace errors.

New hook useGasSponsorshipWarningAlerts checks simulationData.callTraceErrors and networkConfigurationsByChainId to show a Severity.Warning on EstimatedFee (currently for MONAD with 10 nativeCurrency minimum)
Integrated into useConfirmationAlerts so it appears with other transaction alerts
Added i18n key gasSponsorshipReserveBalanceWarning in en and en_GB
Unit tests for useGasSponsorshipWarningAlerts validate no-op cases and the Monad reserve balance warning

^{Written by Cursor Bugbot for commit 513723d. This will update automatically on new commits. Configure here.}

github-actions · 2026-01-15T16:17:39Z

CLA Signature Action: All authors have signed the CLA. You may need to manually re-run the blocking PR check if it doesn't pass in a few minutes.

metamaskbotv2 · 2026-01-15T16:18:17Z

✨ Files requiring CODEOWNER review ✨

✅ @MetaMask/confirmations (3 files, +249 -0)

📁 ui/
- 📁 pages/
  - 📁 confirmations/
    - 📁 hooks/
      - 📁 alerts/
        
        📁 transactions/
        
        📄 useGasSponsorshipWarningAlerts.test.ts +132 -0
        
        📄 useGasSponsorshipWarningAlerts.ts +113 -0
        
        📄 useConfirmationAlerts.ts +4 -0

ui/pages/confirmations/hooks/alerts/transactions/useGasSponsorshipWarningAlerts.test.ts

metamaskbotv2 · 2026-01-15T17:37:16Z

Builds ready [513723d]

builds: chrome, firefox
builds (beta): chrome, firefox
builds (flask): chrome, firefox
builds (test): chrome, firefox
builds (test-flask): chrome, firefox
bundle size: Bundle Size Stats
user-actions-benchmark: User Actions Stats
storybook: Storybook
typescript migration: Dashboard
all artifacts
bundle viz:
- background: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
- common: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
- ui: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18
- content-script: 0
- offscreen: 0

UI Startup Metrics (1269 ± 111 ms)

Platform	BuildType	Page	Metric	Test Title (ms)	Persona (ms)	Mean (ms)	Min (ms)	Max (ms)	Std Dev (ms)	P 75 (ms)	P 95 (ms)
Chrome	Browserify	Standard Home	0	-	-	-	-	-	-	-	-
			1	-	-	-	-	-	-	-	-
			2	-	-	-	-	-	-	-	-
			3	-	-	-	-	-	-	-	-
			4	-	-	-	-	-	-	-	-
			5	-	-	-	-	-	-	-	-
			6	-	-	-	-	-	-	-	-
			7	-	-	-	-	-	-	-	-
			8	-	-	-	-	-	-	-	-
			9	-	-	-	-	-	-	-	-
			10	-	-	-	-	-	-	-	-
			11	-	-	-	-	-	-	-	-
			12	-	-	-	-	-	-	-	-
			13	-	-	-	-	-	-	-	-
			14	-	-	-	-	-	-	-	-
			15	-	-	-	-	-	-	-	-
			16	-	-	-	-	-	-	-	-
			17	-	-	-	-	-	-	-	-
			18	-	-	-	-	-	-	-	-
			uiStartup	-	-	1269	1033	1620	111	1341	1412
			load	-	-	1059	855	1346	101	1119	1238
			domContentLoaded	-	-	1053	851	1337	101	1115	1232
			domInteractive	-	-	25	15	90	17	21	75
			firstPaint	-	-	170	63	1135	177	190	312
			backgroundConnect	-	-	212	192	249	9	217	228
			firstReactRender	-	-	15	9	42	5	16	24
			getState	-	-	37	19	131	14	41	62
			initialActions	-	-	1	0	9	1	1	2
			loadScripts	-	-	847	654	1138	100	899	1025
			setupStore	-	-	11	7	22	3	13	17
			numNetworkReqs	-	-	17	11	78	17	11	71
			19	-	-	-	-	-	-	-	-
	Browserify	Power User Home	0	-	-	-	-	-	-	-	-
			1	-	-	-	-	-	-	-	-
			2	-	-	-	-	-	-	-	-
			3	-	-	-	-	-	-	-	-
			4	-	-	-	-	-	-	-	-
			5	-	-	-	-	-	-	-	-
			6	-	-	-	-	-	-	-	-
			7	-	-	-	-	-	-	-	-
			8	-	-	-	-	-	-	-	-
			9	-	-	-	-	-	-	-	-
			10	-	-	-	-	-	-	-	-
			11	-	-	-	-	-	-	-	-
			12	-	-	-	-	-	-	-	-
			13	-	-	-	-	-	-	-	-
			14	-	-	-	-	-	-	-	-
			15	-	-	-	-	-	-	-	-
			16	-	-	-	-	-	-	-	-
			17	-	-	-	-	-	-	-	-
			18	-	-	-	-	-	-	-	-
			uiStartup	-	-	1881	1628	2492	197	2004	2327
			load	-	-	1036	898	1496	132	1050	1409
			domContentLoaded	-	-	1023	893	1492	132	1038	1385
			domInteractive	-	-	35	19	138	27	33	115
			firstPaint	-	-	221	71	1453	257	231	368
			backgroundConnect	-	-	262	202	607	104	237	559
			firstReactRender	-	-	22	17	62	6	23	28
			getState	-	-	180	129	714	60	195	230
			initialActions	-	-	1	0	4	1	1	1
			loadScripts	-	-	809	687	1282	130	822	1158
			setupStore	-	-	19	11	49	7	19	38
			numNetworkReqs	-	-	58	38	145	24	61	121
			19	-	-	-	-	-	-	-	-
Webpack	Standard Home	0	-	-	-	-	-	-	-	-
		1	-	-	-	-	-	-	-	-
		2	-	-	-	-	-	-	-	-
		3	-	-	-	-	-	-	-	-
		4	-	-	-	-	-	-	-	-
		5	-	-	-	-	-	-	-	-
		6	-	-	-	-	-	-	-	-
		7	-	-	-	-	-	-	-	-
		8	-	-	-	-	-	-	-	-
		9	-	-	-	-	-	-	-	-
		10	-	-	-	-	-	-	-	-
		11	-	-	-	-	-	-	-	-
		12	-	-	-	-	-	-	-	-
		13	-	-	-	-	-	-	-	-
		14	-	-	-	-	-	-	-	-
		15	-	-	-	-	-	-	-	-
		16	-	-	-	-	-	-	-	-
		17	-	-	-	-	-	-	-	-
		18	-	-	-	-	-	-	-	-
		uiStartup	-	-	801	649	1177	82	833	961
		load	-	-	642	577	947	69	651	789
		domContentLoaded	-	-	636	572	940	68	647	779
		domInteractive	-	-	26	16	107	20	22	78
		firstPaint	-	-	106	60	373	59	139	226
		backgroundConnect	-	-	30	6	110	27	43	95
		firstReactRender	-	-	16	11	36	4	17	25
		getState	-	-	33	14	146	20	42	56
		initialActions	-	-	1	0	5	1	1	1
		loadScripts	-	-	633	569	932	66	645	770
		setupStore	-	-	13	5	46	8	14	33
		numNetworkReqs	-	-	18	11	77	17	11	70
		19	-	-	-	-	-	-	-	-
Webpack	Power User Home	0	-	-	-	-	-	-	-	-
		1	-	-	-	-	-	-	-	-
		2	-	-	-	-	-	-	-	-
		3	-	-	-	-	-	-	-	-
		4	-	-	-	-	-	-	-	-
		5	-	-	-	-	-	-	-	-
		6	-	-	-	-	-	-	-	-
		7	-	-	-	-	-	-	-	-
		8	-	-	-	-	-	-	-	-
		9	-	-	-	-	-	-	-	-
		10	-	-	-	-	-	-	-	-
		11	-	-	-	-	-	-	-	-
		12	-	-	-	-	-	-	-	-
		13	-	-	-	-	-	-	-	-
		14	-	-	-	-	-	-	-	-
		15	-	-	-	-	-	-	-	-
		16	-	-	-	-	-	-	-	-
		17	-	-	-	-	-	-	-	-
		18	-	-	-	-	-	-	-	-
		uiStartup	-	-	1369	994	2076	237	1595	1829
		load	-	-	689	604	1281	94	709	876
		domContentLoaded	-	-	679	598	1274	94	693	865
		domInteractive	-	-	35	17	159	27	32	107
		firstPaint	-	-	142	63	442	71	190	275
		backgroundConnect	-	-	121	7	657	204	89	551
		firstReactRender	-	-	23	16	40	4	25	31
		getState	-	-	153	127	249	20	160	193
		initialActions	-	-	1	0	4	1	1	1
		loadScripts	-	-	675	595	1265	92	690	863
		setupStore	-	-	17	10	44	7	18	35
		numNetworkReqs	-	-	59	37	216	31	57	136
		19	-	-	-	-	-	-	-	-
Firefox	Browserify	Standard Home	0	-	-	-	-	-	-	-	-
			1	-	-	-	-	-	-	-	-
			2	-	-	-	-	-	-	-	-
			3	-	-	-	-	-	-	-	-
			4	-	-	-	-	-	-	-	-
			5	-	-	-	-	-	-	-	-
			6	-	-	-	-	-	-	-	-
			7	-	-	-	-	-	-	-	-
			8	-	-	-	-	-	-	-	-
			9	-	-	-	-	-	-	-	-
			10	-	-	-	-	-	-	-	-
			11	-	-	-	-	-	-	-	-
			12	-	-	-	-	-	-	-	-
			13	-	-	-	-	-	-	-	-
			14	-	-	-	-	-	-	-	-
			15	-	-	-	-	-	-	-	-
			16	-	-	-	-	-	-	-	-
			17	-	-	-	-	-	-	-	-
			18	-	-	-	-	-	-	-	-
			uiStartup	-	-	1418	1107	2007	211	1539	1846
			load	-	-	1120	945	1702	141	1202	1369
			domContentLoaded	-	-	1119	945	1702	141	1202	1369
			domInteractive	-	-	67	33	252	41	88	143
			firstPaint	-	-	-	-	-	-	-	-
			backgroundConnect	-	-	70	19	577	81	82	262
			firstReactRender	-	-	13	10	32	3	13	18
			getState	-	-	14	6	160	19	12	26
			initialActions	-	-	1	1	3	1	2	2
			loadScripts	-	-	1075	931	1620	107	1143	1265
			setupStore	-	-	15	5	95	16	12	55
			numNetworkReqs	-	-	19	9	77	18	13	74
			19	-	-	-	-	-	-	-	-
	Browserify	Power User Home	0	-	-	-	-	-	-	-	-
			1	-	-	-	-	-	-	-	-
			2	-	-	-	-	-	-	-	-
			3	-	-	-	-	-	-	-	-
			4	-	-	-	-	-	-	-	-
			5	-	-	-	-	-	-	-	-
			6	-	-	-	-	-	-	-	-
			7	-	-	-	-	-	-	-	-
			8	-	-	-	-	-	-	-	-
			9	-	-	-	-	-	-	-	-
			10	-	-	-	-	-	-	-	-
			11	-	-	-	-	-	-	-	-
			12	-	-	-	-	-	-	-	-
			13	-	-	-	-	-	-	-	-
			14	-	-	-	-	-	-	-	-
			15	-	-	-	-	-	-	-	-
			16	-	-	-	-	-	-	-	-
			17	-	-	-	-	-	-	-	-
			18	-	-	-	-	-	-	-	-
			uiStartup	-	-	2562	1769	5533	696	2563	4375
			load	-	-	1214	990	2532	243	1197	1656
			domContentLoaded	-	-	1214	990	2532	243	1197	1656
			domInteractive	-	-	117	35	463	90	119	368
			firstPaint	-	-	-	-	-	-	-	-
			backgroundConnect	-	-	126	24	1070	176	113	319
			firstReactRender	-	-	23	15	77	8	24	31
			getState	-	-	269	53	785	213	419	726
			initialActions	-	-	2	0	8	1	2	3
			loadScripts	-	-	1179	969	2427	227	1164	1618
			setupStore	-	-	147	7	804	197	121	671
			numNetworkReqs	-	-	58	29	168	39	80	160
			19	-	-	-	-	-	-	-	-
Webpack	Standard Home	0	-	-	-	-	-	-	-	-
		1	-	-	-	-	-	-	-	-
		2	-	-	-	-	-	-	-	-
		3	-	-	-	-	-	-	-	-
		4	-	-	-	-	-	-	-	-
		5	-	-	-	-	-	-	-	-
		6	-	-	-	-	-	-	-	-
		7	-	-	-	-	-	-	-	-
		8	-	-	-	-	-	-	-	-
		9	-	-	-	-	-	-	-	-
		10	-	-	-	-	-	-	-	-
		11	-	-	-	-	-	-	-	-
		12	-	-	-	-	-	-	-	-
		13	-	-	-	-	-	-	-	-
		14	-	-	-	-	-	-	-	-
		15	-	-	-	-	-	-	-	-
		16	-	-	-	-	-	-	-	-
		17	-	-	-	-	-	-	-	-
		18	-	-	-	-	-	-	-	-
		uiStartup	-	-	1605	1335	2152	153	1719	1859
		load	-	-	1326	1148	1617	102	1402	1503
		domContentLoaded	-	-	1325	1148	1617	102	1402	1503
		domInteractive	-	-	91	29	233	42	126	143
		firstPaint	-	-	-	-	-	-	-	-
		backgroundConnect	-	-	57	22	212	40	64	147
		firstReactRender	-	-	16	11	61	8	18	27
		getState	-	-	22	9	253	35	17	83
		initialActions	-	-	1	0	4	1	2	2
		loadScripts	-	-	1293	1128	1589	92	1342	1457
		setupStore	-	-	21	5	154	29	17	127
		numNetworkReqs	-	-	19	9	82	19	15	76
		19	-	-	-	-	-	-	-	-
Webpack	Power User Home	0	-	-	-	-	-	-	-	-
		1	-	-	-	-	-	-	-	-
		2	-	-	-	-	-	-	-	-
		3	-	-	-	-	-	-	-	-
		4	-	-	-	-	-	-	-	-
		5	-	-	-	-	-	-	-	-
		6	-	-	-	-	-	-	-	-
		7	-	-	-	-	-	-	-	-
		8	-	-	-	-	-	-	-	-
		9	-	-	-	-	-	-	-	-
		10	-	-	-	-	-	-	-	-
		11	-	-	-	-	-	-	-	-
		12	-	-	-	-	-	-	-	-
		13	-	-	-	-	-	-	-	-
		14	-	-	-	-	-	-	-	-
		15	-	-	-	-	-	-	-	-
		16	-	-	-	-	-	-	-	-
		17	-	-	-	-	-	-	-	-
		18	-	-	-	-	-	-	-	-
		uiStartup	-	-	2931	2228	6200	781	2966	4735
		load	-	-	1662	1202	3222	539	1759	2929
		domContentLoaded	-	-	1661	1202	3222	539	1759	2929
		domInteractive	-	-	121	31	676	125	106	486
		firstPaint	-	-	-	-	-	-	-	-
		backgroundConnect	-	-	185	32	1361	290	139	1158
		firstReactRender	-	-	27	17	115	14	30	49
		getState	-	-	314	72	1022	249	465	848
		initialActions	-	-	2	1	4	1	2	3
		loadScripts	-	-	1549	1181	3111	415	1718	2794
		setupStore	-	-	125	8	764	162	129	551
		numNetworkReqs	-	-	60	30	165	40	85	161
		19	-	-	-	-	-	-	-	-

📊 Page Load Benchmark Results

Current Commit: 513723d | Date: 1/15/2026

📄 Localhost MetaMask Test Dapp

Samples: 100

Summary

pageLoadTime-> current mean value: 1.02s (±39ms) 🟡 | historical mean value: 1.04s ⬇️ (historical data)
domContentLoaded-> current mean value: 713ms (±36ms) 🟢 | historical mean value: 723ms ⬇️ (historical data)
firstContentfulPaint-> current mean value: 77ms (±14ms) 🟢 | historical mean value: 78ms ⬇️ (historical data)

📈 Detailed Results

Metric	Mean	Std Dev	Min	Max	P95	P99
pageLoadTime	1.02s	39ms	999ms	1.31s	1.05s	1.31s
domContentLoaded	713ms	36ms	691ms	979ms	736ms	979ms
firstPaint	77ms	14ms	60ms	192ms	88ms	192ms
firstContentfulPaint	77ms	14ms	60ms	192ms	88ms	192ms
largestContentfulPaint	0ms	0ms	0ms	0ms	0ms	0ms

Bundle size diffs [🚨 Warning! Bundle size has increased!]

background: 58 Bytes (0%)
ui: 2.32 KiB (0.03%)
common: 265 Bytes (0%)

feat: display a warning when gas sponsorship failed

422c404

Julink-eth requested a review from a team as a code owner January 15, 2026 16:17

Julink-eth temporarily deployed to pr-comment January 15, 2026 16:17 — with GitHub Actions Inactive

metamaskbot added the team-network-enablement label Jan 15, 2026

github-actions bot added the size-M label Jan 15, 2026

cursor bot reviewed Jan 15, 2026

View reviewed changes

ui/pages/confirmations/hooks/alerts/transactions/useGasSponsorshipWarningAlerts.test.ts Outdated Show resolved Hide resolved

chore: fix message in unit test

c0afb26

Julink-eth had a problem deploying to pr-comment January 15, 2026 16:28 — with GitHub Actions Error

Merge branch 'main' into feat/display-gas-sponsorship-warning

3d24369

Julink-eth temporarily deployed to pr-comment January 15, 2026 16:29 — with GitHub Actions Inactive

cursor bot reviewed Jan 15, 2026

View reviewed changes

ui/pages/confirmations/hooks/alerts/transactions/useGasSponsorshipWarningAlerts.test.ts Show resolved Hide resolved

Julink-eth had a problem deploying to pr-comment January 15, 2026 16:58 — with GitHub Actions Error

chore: add mock for networkConfigurationsByChainId in unit test

513723d

Julink-eth temporarily deployed to pr-comment January 15, 2026 17:04 — with GitHub Actions Inactive

Julink-eth temporarily deployed to pr-comment January 15, 2026 17:32 — with GitHub Actions Inactive

Julink-eth mentioned this pull request Jan 16, 2026

feat: add callTrace errors in the simulation data response MetaMask/core#7641

Open

4 tasks

Julink-eth added this to PR review queue Jan 16, 2026

github-project-automation bot moved this to Needs dev review in PR review queue Jan 16, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: display a warning when gas sponsorship failed #39284

feat: display a warning when gas sponsorship failed #39284

Julink-eth commented Jan 15, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 15, 2026

Uh oh!

metamaskbotv2 bot commented Jan 15, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

metamaskbotv2 bot commented Jan 15, 2026

📄 Localhost MetaMask Test Dapp

Summary

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

feat: display a warning when gas sponsorship failed #39284

Are you sure you want to change the base?

feat: display a warning when gas sponsorship failed #39284

Conversation

Julink-eth commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Changelog

Related issues

Manual testing steps

Screenshots/Recordings

Before

After

Pre-merge author checklist

Pre-merge reviewer checklist

Uh oh!

github-actions bot commented Jan 15, 2026

Uh oh!

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

Uh oh!

✨ Files requiring CODEOWNER review ✨

Uh oh!

Uh oh!

Uh oh!

metamaskbotv2 bot commented Jan 15, 2026

📄 Localhost MetaMask Test Dapp

Summary

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Julink-eth commented Jan 15, 2026 •

edited

Loading

metamaskbotv2 bot commented Jan 15, 2026 •

edited

Loading