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

pull D33r-Gee wants to merge 2 commits into bitcoin-core:master from D33r-Gee:2025_gui_interfaces_loadsnapshot_poc changing 13 files +172 −0
  1. D33r-Gee commented at 3:19 pm on April 30, 2025: none

    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

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

    Implementation Details

    Core Components Modified

    1. Node Interface (src/node/interfaces.cpp)
    1. 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

    1. Extensibility
    • Interface designed to accommodate future assumeutxo changes
    • Error handling framework in place

    Testing Instructions

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

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

    Screenshot 2025-04-28 100528 Launch bitcoin-qt on signet Screenshot 2025-04-28 100541 Navigate to Settings -> Options Screenshot 2025-04-28 100559 Click the “Load Snapshot…” button Select_file Navigate to where your snapshot file is. The snapshot was downloaded from here Screenshot 2025-04-28 100735 Click “Yes” Screenshot 2025-04-28 100950 Wait for the snapshot to load and for this pop-up to appear and click “Ok” Screenshot 2025-04-28 101743 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.

  2. DrahtBot commented at 3:19 pm on April 30, 2025: contributor

    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.

  3. D33r-Gee commented at 3:51 pm on April 30, 2025: none
    friendly ping @Sjors
  4. Sjors commented at 10:05 am on May 1, 2025: member

    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.

  5. luke-jr commented at 12:34 pm on May 14, 2025: member
    Seems like this would be more appropriate for the first-run intro page?
  6. D33r-Gee commented at 10:35 pm on May 14, 2025: none

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

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

  7. DrahtBot added the label Needs rebase on May 20, 2025
  8. D33r-Gee force-pushed on May 20, 2025
  9. DrahtBot removed the label Needs rebase on May 20, 2025
  10. DrahtBot added the label Needs rebase on May 27, 2025
  11. interfaces: Implement snapshot loading functionality in node interface
    - Added a new virtual method `loadSnapshot` to the node interface for loading UTXO snapshots.
    - Introduced a handler for tracking snapshot load progress with `handleSnapshotLoadProgress`.
    - Updated the implementation in `interfaces.cpp` to activate the snapshot using the provided file and metadata.
    
    This enhancement exposes UTXO snapshots loading functionaility to the GUI.
    03c76f5ad6
  12. poc: Load snapshot through the options dialog
    This is a quick and dirty POC to showcase and test the load snapshot functionality. This is by no means meant to be a robust approach...
    60f676abf5
  13. D33r-Gee force-pushed on Aug 1, 2025
  14. DrahtBot removed the label Needs rebase on Aug 1, 2025

github-metadata-mirror

This is a metadata mirror of the GitHub repository bitcoin-core/gui. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2025-08-31 12:20 UTC

This site is hosted by @0xB10C
More mirrored repositories can be found on mirror.b10c.me