doc: assumeutxo prune and index notes #28618

pull Sjors wants to merge 1 commits into bitcoin:master from Sjors:2023/10/assume-prune-index changing 1 files +38 −2
  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: 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: 
    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
  24. Frank-GER referenced this in commit 5c0dc6ab1d on Nov 28, 2023
  25. bitcoin locked this on Oct 24, 2024


Sjors DrahtBot flack pablomartin4btc jamesob vostrnad ryanofsky


jamesob

Labels
Docs

github-metadata-mirror

This is a metadata mirror of the GitHub repository bitcoin/bitcoin. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2024-12-19 03:12 UTC
This site is hosted by @0xB10C
More mirrored repositories can be found on mirror.b10c.me