txo_list
adds many new ownership filters such as --is_my_input
, --is_my_output
, etc and some metadata filters such as --channel_id
, --reposted_claim_id
, etc and a new command txo_sum
which takes the same arguments as txo_list
and produces sum of outputs
#2862
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
fixes #2853
fixes #1853
release-text-lines:
This release includes changes to the client side database schema which will trigger a reset of your
blockchain.db
and perform full sync on startup.In this release the
txo_list
command has reached its full potential in being able to filter specific transaction outputs based on who made them and who controls them which allows for differentiating between "supports" and "tips" and many other use cases. This release also introduces a newtxo_sum
command which takes almost all of the same arguments astxo_list
but produces a sum of the outputs thattxo_list
would have returned in full, useful for making reports.Below are some examples and use cases of how to use
txo_list
.Get all of the tips you've received from others on claim "xyz" (assuming "xyz" is your claim):
lbrynet txo list --is_my_output --is_not_my_input --type="support" --claim_id="xyz" --unspent
Sum of all of the tips you've sent to claim "xyz" (assuming "xyz" is not your claim):
lbrynet txo sum --is_my_input --is_not_my_output --type="support" --claim_id="xyz"
Note:
--unspent
is missing above, this is because the local database (at least in desktop app) doesn't know the status of outputs after you've sent them to someone else, therefore filtering by unspent is meaningless here (anytime you pass--is_not_my_output
).Sum of all of the non-tip supports you've sent to claim "xyz" (assuming "xyz" is not your claim):
lbrynet txo sum --is_my_input --is_my_output --type="support" --claim_id="xyz" --unspent
Anything someone just sent me:
lbrynet txo list --is_not_my_input --unspent
Emulate
channel list
:lbrynet txo list --type=channel --unspent
Emulate
support list
:lbrynet txo list --type=support --unspent
Another flag added is
--no_totals
which is useful if you expect a very large result set, want a performant pagination and don't need to know total number of pages. (or, a more clever strategy, is to get total once and cache the size for some period of time and then do subsequent calls with--no_totals
as user paginates)Also,
--order_by
supports a value ofnone
which is useful in certain situations where you don't care about the order and want maximum performance (or, if you just want to see performance impact actually is of sorting the result).