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

   <!--e57a25ab6845829454e8d69fc972939a-->

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

   <!--006a51241073e994b41acfe9ec718e94-->

   Code Coverage

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

   <!--021abf342d371248e50ceaed478a90ca-->

   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:

   For 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:

   to 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:

   As 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: contributor

    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:

    the 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
24. Frank-GER referenced this in commit 5c0dc6ab1d on Nov 28, 2023
25. bitcoin locked this on Oct 24, 2024

Review Requested
jamesob