Skip to content

Conversation

harding
Copy link
Contributor

@harding harding commented May 7, 2018

Expounds on two things I've seen confuse inexperienced users:

  • transactions/outputs in gettxoutsetinfo: a user thought this was the total number of transactions or outputs ever seen on the chain, whereas it's only the number in the UTXO.

  • bestblock in gettxout: a user thought this was the block that included the output, not realizing it was the tip of the current best block chain. I also copied this text to gettxoutsetinfo for congruency. I skimmed other uses of "bestblock" in the RPC docs and they seemed clear to me.

@harding harding force-pushed the 2018-05-rpc-help-bestblock branch from 3dec5da to 2fa92ff Compare May 7, 2018 15:43
@practicalswift
Copy link
Contributor

Concept ACK

@harding harding force-pushed the 2018-05-rpc-help-bestblock branch from 2fa92ff to f30e9be Compare May 7, 2018 15:49
@harding
Copy link
Contributor Author

harding commented May 7, 2018

Travis failure seems unrelated.

@maflcko
Copy link
Member

maflcko commented May 7, 2018

utACK f30e9be

1 similar comment
@sipa
Copy link
Member

sipa commented May 7, 2018

utACK f30e9be

@maflcko maflcko added this to the 0.16.1 milestone May 7, 2018
@maflcko maflcko merged commit f30e9be into bitcoin:master May 7, 2018
maflcko pushed a commit that referenced this pull request May 7, 2018
f30e9be RPC Docs: gettxout*: clarify bestblock and unspent counts (David A. Harding)

Pull request description:

  Expounds on two things I've seen confuse inexperienced users:

  - transactions/outputs in `gettxoutsetinfo`: a user thought this was the total number of transactions or outputs ever seen on the chain, whereas it's only the number in the UTXO.

  - bestblock in `gettxout`: a user thought this was the block that included the output, not realizing it was the tip of the current best block chain.  I also copied this text to `gettxoutsetinfo` for congruency.  I skimmed other uses of "bestblock" in the RPC docs and they seemed clear to me.

Tree-SHA512: c2161c497bef5fe15ee9f1e2a4413fa099b5baa36205ba1ba4b3822885b3ccd1badb9c118a0334f47ba6fa7fff5818ac359cfac6a1108c6847a876b1a251bb7c
fanquake pushed a commit to fanquake/bitcoin that referenced this pull request May 17, 2018
laanwj added a commit that referenced this pull request May 24, 2018
acdf433 Hold cs_main while calling UpdatedBlockTip() and ui.NotifyBlockTip (Jesse Cohen)
5ff571e [wallet] [tests] Test disallowed multiwallet params (John Newbery)
4c14e7b [wallet] Fix zapwallettxes/multiwallet interaction. (John Newbery)
4087dd0 RPC Docs: gettxout*: clarify bestblock and unspent counts (David A. Harding)
b8aacd6 [qa] Handle disconnect_node race (Suhas Daftuar)

Pull request description:

  Backports:
  - #13201 [qa] Handle disconnect_node race
  - #13184 RPC Docs: gettxout*: clarify bestblock and unspent counts
  - #13030 [bugfix] [wallet] Fix zapwallettxes/multiwallet interaction.
  - #12988 Hold cs_main while calling UpdatedBlockTip() signal

  to the 0.16 branch.

Tree-SHA512: 8f65002bbafaf9c436f89051b2d79bf6a668fbd07bd317c64af238ed4a7c8efe776864b739a7f2869f1e3daa16f2f4366a85f41b188f9c454879d2c7b309be50
HashUnlimited pushed a commit to chaincoin/chaincoin that referenced this pull request Jun 29, 2018
PastaPastaPasta pushed a commit to PastaPastaPasta/dash that referenced this pull request Apr 3, 2020
…nt counts

f30e9be RPC Docs: gettxout*: clarify bestblock and unspent counts (David A. Harding)

Pull request description:

  Expounds on two things I've seen confuse inexperienced users:

  - transactions/outputs in `gettxoutsetinfo`: a user thought this was the total number of transactions or outputs ever seen on the chain, whereas it's only the number in the UTXO.

  - bestblock in `gettxout`: a user thought this was the block that included the output, not realizing it was the tip of the current best block chain.  I also copied this text to `gettxoutsetinfo` for congruency.  I skimmed other uses of "bestblock" in the RPC docs and they seemed clear to me.

Tree-SHA512: c2161c497bef5fe15ee9f1e2a4413fa099b5baa36205ba1ba4b3822885b3ccd1badb9c118a0334f47ba6fa7fff5818ac359cfac6a1108c6847a876b1a251bb7c
@bitcoin bitcoin locked as resolved and limited conversation to collaborators Feb 15, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants