History

W. J. van der Laan 986003aff9 Merge bitcoin/bitcoin#22918: rpc: Add level 3 verbosity to getblock RPC call (#21245 modified) `5c34507ecb` core_write: Rename calculate_fee to have_undo for clarity (fyquah) `8edf6204a8` release-notes: Add release note about getblock verbosity level 3. (fyquah) `459104b2aa` rest: Add test for prevout fields in getblock (fyquah) `4330af6f72` rpc: Add test for level 3 verbosity getblock rpc call. (fyquah) `51dbc167e9` rpc: Add level 3 verbosity to getblock RPC call. (fyquah) `3cc95345ca` rpc: Replace boolean argument for tx details with enum class. (fyquah) Pull request description: Author of #21245 expressed [time issues](https://github.com/bitcoin/bitcoin/pull/21245#issuecomment-902332088) in the original PR. Given that #21245 has received a lot of review, I have decided to open this new pull request with [modifications required to get ACK from luke-jr ](https://github.com/bitcoin/bitcoin/pull/21245#issuecomment-905150806) and a few nits of mine. ### Original PR description > Display the prevout in transaction inputs when calling getblock level 3 verbosity. This PR affects the existing `/rest/block` API by adding a `prevout` fields to tx inputs. This is mentioned in the change to the release notes. > > I added some functional tests that > > checks that the RPC call still works when TxUndo can't be found > > * Doesn't display the "value" or "scriptPubKey" of the previous output when at a lower verbosity level > > > This "completes" the issue #18771 ### Possible improvements * `b0bf4f255f` - I can include even this commit to this PR if deemed useful or I can leave it for a follow-up PR. See https://github.com/bitcoin/bitcoin/pull/21245#issuecomment-894853784 for more context. ### Examples Examples of the `getblock` output with various verbose levels. Note that `000000000000001f682b188971cc1a121546be4e9d5baf22934fdc7f538288d5` contains only 2 transactions. #### Verbose level 0 ```bash ./bitcoin-cli -testnet getblock 000000000000001f682b188971cc1a121546be4e9d5baf22934fdc7f538288d5 0 ``` ##### Verbose level 1 ```bash ./bitcoin-cli -testnet getblock 000000000000001f682b188971cc1a121546be4e9d5baf22934fdc7f538288d5 1 ``` ##### Verbose level 2 ```bash ./bitcoin-cli -testnet getblock 000000000000001f682b188971cc1a121546be4e9d5baf22934fdc7f538288d5 2 ``` ##### Verbose level 3 ```bash ./bitcoin-cli -testnet getblock 000000000000001f682b188971cc1a121546be4e9d5baf22934fdc7f538288d5 3 ``` #### REST ```bash curl -H "content-type:text/plain;" http://127.0.0.1:18332/rest/block/000000000000001f682b188971cc1a121546be4e9d5baf22934fdc7f538288d5.json ``` <sub>* ... and my everyday obsessive checking of my email inbox whether the PR moves forward.</sub> Edit laanwj: Removed at symbol from message, and large example output to prevent it from all ending up in the commit message. ACKs for top commit: 0xB10C: ACK `5c34507ecb` meshcollider: utACK `5c34507ecb` theStack: ACK `5c34507ecb` 👘 promag: Concept ACK `5c34507ecb` Tree-SHA512: bbff120d8fd76e617b723b102b0c606e0d8eb27f21c631d5f4cdab0892137c4bc7c65b1df144993405f942c91be47a26e80480102af55bff22621c19f518aea3		3 years ago
..
man	…
release-notes	doc: Add historical release notes for 22.0	3 years ago
.gitignore	…
Doxyfile.in	Generate doxygen documentation for test sources	4 years ago
JSON-RPC-interface.md	…
README.md	release: remove gitian	3 years ago
README_doxygen.md	…
README_windows.txt	…
REST-interface.md	…
assets-attribution.md	…
benchmarking.md	doc: update doc/benchmarking.md	3 years ago
bips.md	…
bitcoin-conf.md	doc: added info to bitcoin.conf doc	3 years ago
bitcoin_logo_doxygen.png	…
build-android.md	…
build-freebsd.md	docs: improve make with parallel jobs description.	4 years ago
build-netbsd.md	docs: improve make with parallel jobs description.	4 years ago
build-openbsd.md	script, doc: guix touchups	3 years ago
build-osx.md	doc: note that brew installed qt is not supported	4 years ago
build-unix.md	remove --enable-glibc-back-compat from CI and docs	3 years ago
build-windows.md	doc: remove WSL install instructions and point to upstream	3 years ago
dependencies.md	doc: update minimum compiler requirements for std::filesystem	3 years ago
descriptors.md	Merge bitcoin/bitcoin#22067 : Test and document a basic M-of-N multisig using descriptor wallets and PSBTs	3 years ago
developer-notes.md	Merge bitcoin/bitcoin#22409 : configure: keep relative paths in debug info	3 years ago
dnsseed-policy.md	…
external-signer.md	…
files.md	Ignore banlist.dat	3 years ago
fuzzing.md	Merge bitcoin/bitcoin#22585 : fuzz: add guide to fuzzing with Eclipser v1.x	3 years ago
guix.md	…
i2p.md	Improve doc/i2p.md regarding I2P router options/versions	3 years ago
init.md	…
managing-wallets.md	Document about wallet backup and restoration	3 years ago
multiprocess.md	…
productivity.md	…
psbt.md	doc: M-of-N multisig using descriptor wallets and PSBTs, as well as a signing flow	3 years ago
reduce-memory.md	…
reduce-traffic.md	…
release-notes-23093.md	Add release notes for keypool flush changes	3 years ago
release-notes.md	Merge bitcoin/bitcoin#22918: rpc: Add level 3 verbosity to getblock RPC call (#21245 modified)	3 years ago
release-process.md	doc: Update snap release process for new versioning scheme	3 years ago
shared-libraries.md	…
tor.md	Merge bitcoin/bitcoin#22420 : doc: Specifiy how to set the value of TORGROUP	3 years ago
tracing.md	tracing: drop block_connected hash.toString() arg	3 years ago
translation_process.md	doc: Remove unnecessary steps from translations update process	3 years ago
translation_strings_policy.md	…
zmq.md	doc: Add IPv6 address to zmq example	3 years ago

README.md

Bitcoin Core

Setup

Bitcoin Core is the original Bitcoin client and it builds the backbone of the network. It downloads and, by default, stores the entire history of Bitcoin transactions, which requires a few hundred gigabytes of disk space. Depending on the speed of your computer and network connection, the synchronization process can take anywhere from a few hours to a day or more.

To download Bitcoin Core, visit bitcoincore.org.

Running

The following are some helpful notes on how to run Bitcoin Core on your native platform.

Unix

Unpack the files into a directory and run:

bin/bitcoin-qt (GUI) or
bin/bitcoind (headless)

Windows

Unpack the files into a directory, and then run bitcoin-qt.exe.

macOS

Drag Bitcoin Core to your applications folder, and then run Bitcoin Core.

Need Help?

See the documentation at the Bitcoin Wiki for help and more information.
Ask for help on Bitcoin StackExchange.
Ask for help on #bitcoin on Libera Chat. If you don't have an IRC client, you can use web.libera.chat.
Ask for help on the BitcoinTalk forums, in the Technical Support board.

Building

The following are developer notes on how to build Bitcoin Core on your native platform. They are not complete guides, but include notes on the necessary libraries, compile flags, etc.

Development

The Bitcoin repo's root README contains relevant information on the development process and automated testing.

Resources

Discuss on the BitcoinTalk forums, in the Development & Technical Discussion board.
Discuss project-specific development on #bitcoin-core-dev on Libera Chat. If you don't have an IRC client, you can use web.libera.chat.

Miscellaneous

License

Distributed under the MIT software license.