Spent state audit tool
A double-spend occurs when a state that the notary has marked as spent is used as input to a new transaction. Notaries will reject transactions that attempt double-spends. The Spent State Audit Tool can be used to retrieve the history of states involved in double-spend attempts.
Using the Spent State Audit Tool
![Click to copy the section link. heading-link-icon](/icons/chain-icon.png)
The Spent State Audit Tool is distributed with Corda Enterprise as a JAR file that must be run from the command line using the following command:
java -jar corda-tools-notary-utilities-4.12.jar spent-state-audit <options> <state_reference>
The tool connects to the notary via RPC, and so must specify a valid RPC username and password, using the -u
and -p
options, unless an RPC username and password are specified in the notary worker’s node.conf
configuration file.
When running the tool, you must specify a state reference. The tool will return all requests for notarisation for that state reference including timestamps, transaction IDs, transaction result, requesting party, and notary worker.
Command-line options
![Click to copy the section link. heading-link-icon](/icons/chain-icon.png)
You can use the following parameters and options when running the Spent State Audit Tool:
Parameters:
<state_reference>
: A state reference in the formtxId:outputIndex
.
Options:
-v
,--verbose
,--log-to-console
: If set, prints logging to the console as well as to a file. Not set by default.--logging-level=LOGGING_LEVEL
: Use this option to enable logging at this level and higher. Possible values:ERROR
,WARN
,INFO
(default),DEBUG
,TRACE
.-b
,--base-directory=FOLDER
: The node working directory. Defaults to the current directory.-c
,--config-file=FILE
: The path to thenode.conf
configuration file. Defaults tonode.conf
in the current directory.-u
,--user-name=USER_NAME
: RPC username. Defaults to the first RPC username defined in the node configuration file.-p
,--password=PASSWORD
: RPC password. Defaults to the first RPC password defined in the node configuration file.--max-results=LIMIT
: The maximum number of spend events to return, beginning with the most recent. If--format
is not set, the user is prompted to get the next batch. Setting this value too high may result in the query timing out. The default value is 10.--only-successful
: If set, the tool returns only successful spend events. By default, this option is not set.--timezone=ZONE_ID
: Sets the time zone the returned events are returned in. If a--start-time
or--end-time
are set, this option also sets the time zone for those options. This option must be a valid JavaZoneId
orLOCAL
. Setting this option toLOCAL
uses the server’s timezone. The default value isLOCAL
.--start-time=LOCAL_DT
: Specifies a start time to search for results from, inclusively. Must be a valid JavaLocalDateTime
, the value of which is assumed to be in the--timezone
zone.--end-time=LOCAL_DT
: Specifies a time to search for results until, inclusively. Must be a valid JavaLocalDateTime
, the value of which is assumed to be in the--timezone
zone.--format=OUTPUT_FORMAT
: Defines the output format of the returned events. The only supported value isCSV
. By default, this option is not set the output is printed in human readable text.-h
,--help
: Displays the help message.-V
,--version
: Displays version information and exit.
Was this page helpful?
Thanks for your feedback!
Chat with us
Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.
Propose documentation improvements directly
Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.
We're sorry this page wasn't helpful. Let us know how we can make it better!
Chat with us
Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.
Create an issue
Create a new GitHub issue in this repository - submit technical feedback, draw attention to a potential documentation bug, or share ideas for improvement and general feedback.
Propose documentation improvements directly
Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.