doc: assumeutxo prune and index notes #28618

1. 
   Sjors commented at 12:55 pm on October 9, 2023: member

   Based on recent comments on #27596.
2. 
   DrahtBot commented at 12:55 pm on October 9, 2023: contributor

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

   Code Coverage

   For detailed information about the code coverage, see the test coverage report.

   Reviews

   See the guideline for information on the review process.

   Type	Reviewers
   ACK	pablomartin4btc, ryanofsky
   Concept ACK	jamesob

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

3. DrahtBot added the label Docs on Oct 9, 2023
4. Sjors force-pushed on Oct 9, 2023
5. in doc/design/assumeutxo.md:32 in 89db87eb3d outdated

   29+
   30+Indexes work but don't take advantage of this feature. They always start building
   31+from the genesis block. Once the background validation reaches the snapshot block,
   32+indexes will continue to build all the way to the tip.
   33+
   34+For indexes that support pruning, not that no pruning will take place between
   

   ---

   ---

   

   flack commented at 9:36 pm on October 9, 2023:

   0For indexes that support pruning, note that no pruning will take place between
   

6. in doc/design/assumeutxo.md:40 in 89db87eb3d outdated

   37+use a significant amount of disk space.
   38+
   39+## Generating a snapshot
   40+
   41+The RPC command `dumptxoutset` can be used to generate a snapshot. This can be used
   42+on one node to create a snapshot on one node that you wish to load on another node.
   

   ---

   ---

   

   flack commented at 9:36 pm on October 9, 2023:

   0to create a snapshot on one node that you wish to load on another node.
   

7. in doc/design/assumeutxo.md:22 in 89db87eb3d outdated

   19+snapshot `.dat` file as soon as `loadtxoutset` finishes.
   20+
   21+The minimum `-dbcache` setting is 550 MiB, but this functionality ignores that
   22+minimum and uses at least 1100 MiB.
   23+
   24+As the background sync continues there will temporarily be two chainstate
   

   ---

   ---

   

   pablomartin4btc commented at 4:08 am on October 10, 2023:

   0As the background sync continues there will be temporarily two chainstate
   

8. 
   pablomartin4btc commented at 4:08 am on October 10, 2023: member

   ACK
9. in doc/design/assumeutxo.md:17 in 89db87eb3d outdated

   14+load it.
   15+
   16+### Pruning
   17+
   18+A pruned node can load a snapshot. To save space, it's possible to delete the
   19+snapshot `.dat` file as soon as `loadtxoutset` finishes.
   

   ---

   ---

   

   jamesob commented at 5:04 pm on October 10, 2023:

   I don’t think snapshot files necessarily have .dat extensions.
10. in doc/design/assumeutxo.md:24 in 89db87eb3d outdated

    21+The minimum `-dbcache` setting is 550 MiB, but this functionality ignores that
    22+minimum and uses at least 1100 MiB.
    23+
    24+As the background sync continues there will temporarily be two chainstate
    25+directories, each multiple gigabytes in size (growing to roughly the size of
    26+the downloaded snapshot).
    

    ---

    ---

    

    jamesob commented at 5:05 pm on October 10, 2023:

    Almost certainly exceeding the size of the serialized snapshot.
11. 
    jamesob commented at 5:07 pm on October 10, 2023: member

    ACK modulo outstanding comments
12. doc: assumeutxo prune and index notes 03f82087f6
13. 
    Sjors commented at 7:21 am on October 11, 2023: member

    Addressed the above comments.
14. Sjors force-pushed on Oct 11, 2023
15. pablomartin4btc approved
16. 
    pablomartin4btc commented at 12:26 pm on October 11, 2023: member

    re ACK 03f82087f6ce1c29327f34d12945200494e6956d
17. DrahtBot requested review from jamesob on Oct 11, 2023
18. in doc/design/assumeutxo.md:33 in 03f82087f6

    30+Indexes work but don't take advantage of this feature. They always start building
    31+from the genesis block. Once the background validation reaches the snapshot block,
    32+indexes will continue to build all the way to the tip.
    33+
    34+For indexes that support pruning, note that no pruning will take place between
    35+the snapshot and the tip, until the background sync has completed - after which
    

    ---

    ---

    

    vostrnad commented at 4:14 am on October 14, 2023:

    0the snapshot and the tip until the background sync has completed, after which
    

19. ryanofsky approved
20. 
    ryanofsky commented at 4:39 pm on October 23, 2023: contributor

    ACK 03f82087f6ce1c29327f34d12945200494e6956d. Nice changes, these seem like very helpful notes
21. ryanofsky merged this on Oct 23, 2023
22. ryanofsky closed this on Oct 23, 2023

    ---

23. Sjors deleted the branch on Oct 25, 2023

Contributors
Sjors DrahtBot flack pablomartin4btc jamesob vostrnad ryanofsky

Review Requested
jamesob

Labels
Docs