[DRAFT] Expose AssumeUTXO Load Snapshot Functionality To The GUI #870

D33r-Gee · 2025-04-30T15:19:08Z

based on the QML PR 424. For evaluation purposes only!

GUI Integration for UTXO Snapshot Loading

Overview

This PR adds initial GUI support for loading a UTXO snapshot, building on Bitcoin Core's assumeutxo infrastructure.

What This PR Does

Adds a basic GUI interface for loading UTXO snapshots via the Options Dialog panel
Provides visual confirmation of snapshot activation
Adds a snapshot progress notification bar accessible via a handler

Implementation Details

Core Components Modified

Node Interface (src/node/interfaces.cpp)

Implements snapshotLoad() based on the loadtxoutset RPC

QT Integration (src/qt/optionsdialog.cpp)

Manages snapshot loading state and progress
makes use of a worker class to manage snapshot metadata (src/qt/snapshotmodel.cpp)
Provides progress updates via a progress bar

Key Design Decisions

Extensibility

Interface designed to accommodate future assumeutxo changes
Error handling framework in place

Testing Instructions

Build
Launch Bitcoin Core GUI (bitcoin-qt)
Navigate to Settings -> Options
Click Load Snapshot button
Follow pop-up instructions
Test with sample snapshot:

https://bitcoin-snapshots.jaonoctus.dev/ (No affiliation with the maintainer of this site. As always "Don't trust! Verify!")

POC Ubuntu Screenshots `signet`

Launch bitcoin-qt on signet

Navigate to Settings -> Options

Click the "Load Snapshot..." button

Navigate to where your snapshot file is. The snapshot was downloaded from here

Click "Yes"

Wait for the snapshot to load and for this pop-up to appear and click "Ok"

Verify the "chain_snapshot" directory is present in your datadir

Expected Behavior

File selection dialog works
Success/failure state properly displayed
Node becomes usable while background validation continues

Notes for Reviewers

This is a POC so all feedback is welcomed
I am not a designer so please feel free to chime in if there's a more elegant way to achieve this

This is a work in progress - feedback welcome on the approach and implementation details.

DrahtBot · 2025-04-30T15:19:18Z

The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

Reviews

See the guideline for information on the review process.

Type	Reviewers
Concept ACK	Sjors

If your review is incorrectly listed, please react with 👎 to this comment and the bot will ignore it on the next update.

Conflicts

Reviewers, this pull request conflicts with the following ones:

#bitcoin/bitcoin/33117 (Interfaces: Expose UTXO Snapshot Loading and Add Progress Notifications by D33r-Gee)

If you consider this pull request important, please also help to review the conflicting pull requests. Ideally, start with the one that should be merged first.

D33r-Gee · 2025-04-30T15:51:01Z

friendly ping @Sjors

Sjors · 2025-05-01T10:05:08Z

Concept ACK

Although I'm not sure how much effort we should put into maintaining the current GUI codebase (if it's going to be replaced with QML eventually), this particular feature is high on my wish list. And the code changes here seem very simple. So I'm happy to test and review it.

The first commit which touches the node interface should eventually be PR'd to bitcoin/bitcoin. But let's wait with that until this PR has enough concept ACK and some initial review.

luke-jr · 2025-05-14T12:34:17Z

Seems like this would be more appropriate for the first-run intro page?

D33r-Gee · 2025-05-14T22:35:22Z

Seems like this would be more appropriate for the first-run intro page?

yep that's a great idea! I will update soon.

Sjors · 2025-09-08T07:10:21Z

I'm a bit confused about the relation between this and bitcoin/bitcoin#33117. I would suggest rebasing 60f676a on that branch for clarity.

Managed to load the most recent testnet4 snapshot at height 90,000! (after I rebased)

The file dialog was a bit unresponsive, but that's fine since this is just PoC. I like the progress bar.

D33r-Gee · 2025-09-08T16:38:31Z

I'm a bit confused about the relation between this and bitcoin/bitcoin#33117. I would suggest rebasing 60f676a on that branch for clarity.

Will rebase shortly with the changes from bitcoin/bitcoin#33117

Managed to load the most recent testnet4 snapshot at height 90,000! (after I rebased)

WooHoo!

The file dialog was a bit unresponsive, but that's fine since this is just PoC. I like the progress bar.

Hmmm... will look into that... does the dialog hang?

Sjors · 2025-09-09T07:19:35Z

The dialog wouldn't respond to me clicking on a file or folder. But then after a minute or so it worked again.

- Added a new virtual method `snapshot` to the node interface for loading UTXO snapshots. - Updated the implementation in `interfaces.cpp` to activate the snapshot using a path. - Added `snapshot.h` to src/interfaces to process the path and extract the metada - Added `getMetadata` and `getActivationResults` methods for use by GUI and/or RPC - Added error handling method and member variable This change enhances the user ability to load utxo snapshots through the GUI

D33r-Gee · 2025-09-25T20:51:08Z

With 82a3969 it updates the interface methods to match bitcoin/bitcoin#33117
It also adds a load snapshot button during the intro and seamless loading if a proper path has been selected (from @luke-jr suggestion)
Also adds the use of threads to make sure there's no hanging or UI blocking when the load snapshot button is used in the options dialog (hopefully addressing @Sjors experience).
looking for any feedback on the approach and code implementation.

- Added a new signal `snapshotLoadProgress` to the notifications interface for tracking snapshot loading progress. - Introduced a `SnapshotLoadWorker` class to handle snapshot loading in a separate thread, emitting progress updates. - Updated `ClientModel` to manage snapshot loading, including methods for setting verification progress and loading snapshots based on that progress. - Enhanced the GUI to allow users to select a snapshot file and display loading progress through a dialog. - Integrated snapshot path handling in the application initialization process. This change improves user experience by providing real-time feedback during snapshot loading operations.

D33r-Gee mentioned this pull request Apr 30, 2025

interface: Expose load utxo snapshot functionality #869

Closed

D33r-Gee mentioned this pull request May 2, 2025

QML Load Snapshot Signet (160,000 height) bitcoin-core/gui-qml#424

Closed

DrahtBot mentioned this pull request May 19, 2025

doc: remove // for ... comments bitcoin/bitcoin#32562

Merged

DrahtBot added the Needs rebase label May 20, 2025

D33r-Gee force-pushed the 2025_gui_interfaces_loadsnapshot_poc branch from fe687b3 to 25bfc72 Compare May 20, 2025 17:37

DrahtBot removed the Needs rebase label May 20, 2025

DrahtBot mentioned this pull request May 20, 2025

rpc: Round verificationprogress to 1 for a recent tip bitcoin/bitcoin#32528

Merged

DrahtBot added the Needs rebase label May 27, 2025

D33r-Gee force-pushed the 2025_gui_interfaces_loadsnapshot_poc branch from 25bfc72 to 60f676a Compare August 1, 2025 15:28

D33r-Gee mentioned this pull request Aug 1, 2025

Interfaces: Expose UTXO Snapshot Loading and Add Progress Notifications bitcoin/bitcoin#33117

Open

DrahtBot removed the Needs rebase label Aug 1, 2025

D33r-Gee force-pushed the 2025_gui_interfaces_loadsnapshot_poc branch from 60f676a to 82a3969 Compare September 25, 2025 20:44

D33r-Gee force-pushed the 2025_gui_interfaces_loadsnapshot_poc branch from 82a3969 to 482e80b Compare September 26, 2025 16:38

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[DRAFT] Expose AssumeUTXO Load Snapshot Functionality To The GUI #870

[DRAFT] Expose AssumeUTXO Load Snapshot Functionality To The GUI #870

D33r-Gee commented Apr 30, 2025 •

edited

Loading

Uh oh!

DrahtBot commented Apr 30, 2025 •

edited

Loading

Uh oh!

D33r-Gee commented Apr 30, 2025

Uh oh!

Sjors commented May 1, 2025 •

edited

Loading

Uh oh!

luke-jr commented May 14, 2025

Uh oh!

D33r-Gee commented May 14, 2025

Uh oh!

Sjors commented Sep 8, 2025 •

edited

Loading

Uh oh!

D33r-Gee commented Sep 8, 2025

Uh oh!

Sjors commented Sep 9, 2025

Uh oh!

D33r-Gee commented Sep 25, 2025

Uh oh!

Uh oh!

[DRAFT] Expose AssumeUTXO Load Snapshot Functionality To The GUI #870

Are you sure you want to change the base?

[DRAFT] Expose AssumeUTXO Load Snapshot Functionality To The GUI #870

Conversation

D33r-Gee commented Apr 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

GUI Integration for UTXO Snapshot Loading

Overview

What This PR Does

Implementation Details

Core Components Modified

Key Design Decisions

Testing Instructions

Expected Behavior

Notes for Reviewers

Uh oh!

DrahtBot commented Apr 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews

Conflicts

Uh oh!

D33r-Gee commented Apr 30, 2025

Uh oh!

Sjors commented May 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

luke-jr commented May 14, 2025

Uh oh!

D33r-Gee commented May 14, 2025

Uh oh!

Sjors commented Sep 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

D33r-Gee commented Sep 8, 2025

Uh oh!

Sjors commented Sep 9, 2025

Uh oh!

D33r-Gee commented Sep 25, 2025

Uh oh!

Uh oh!

D33r-Gee commented Apr 30, 2025 •

edited

Loading

DrahtBot commented Apr 30, 2025 •

edited

Loading

Sjors commented May 1, 2025 •

edited

Loading

Sjors commented Sep 8, 2025 •

edited

Loading