github.com/TrueBlocks/trueblocks-core/src/apps/chifra@v0.0.0-20241022031540-b362680128f7/internal/logs/README.md (about)

     1  ## chifra logs
     2  
     3  `chifra logs` returns the given transaction's logs. You may specify multiple transaction identifiers
     4  per invocation.
     5  
     6  The `--articulate` option fetches the ABI from each encountered smart contract to better describe
     7  the reported data. The `--topic` and `--source` options allow you to filter your results.
     8  
     9  ```[plaintext]
    10  Purpose:
    11    Retrieve logs for the given transaction(s).
    12  
    13  Usage:
    14    chifra logs [flags] <tx_id> [tx_id...]
    15  
    16  Arguments:
    17    transactions - a space-separated list of one or more transaction identifiers (required)
    18  
    19  Flags:
    20    -m, --emitter strings   filter logs to show only those logs emitted by the given address(es)
    21    -B, --topic strings     filter logs to show only those with this topic(s)
    22    -a, --articulate        articulate the retrieved data if ABIs can be found
    23    -o, --cache             force the results of the query into the cache
    24    -D, --decache           removes related items from the cache
    25    -x, --fmt string        export format, one of [none|json*|txt|csv]
    26    -v, --verbose           enable verbose output
    27    -h, --help              display this help screen
    28  
    29  Notes:
    30    - The transactions list may be one or more transaction hashes, blockNumber.transactionID pairs, or a blockHash.transactionID pairs.
    31    - This tool checks for valid input syntax, but does not check that the transaction requested actually exists.
    32    - If the queried node does not store historical state, the results for most older transactions are undefined.
    33    - If you specify a 32-byte hash, it will be assumed to be a transaction hash, if it is not, the hash will be used as a topic.
    34  ```
    35  
    36  Data models produced by this tool:
    37  
    38  - [function](/data-model/other/#function)
    39  - [log](/data-model/chaindata/#log)
    40  - [message](/data-model/other/#message)
    41  - [parameter](/data-model/other/#parameter)
    42  
    43  ### Other Options
    44  
    45  All tools accept the following additional flags, although in some cases, they have no meaning.
    46  
    47  ```[plaintext]
    48    -v, --version         display the current version of the tool
    49        --output string   write the results to file 'fn' and return the filename
    50        --append          for --output command only append to instead of replace contents of file
    51        --file string     specify multiple sets of command line options in a file
    52  ```
    53  
    54  **Note:** For the `--file string` option, you may place a series of valid command lines in a file using any
    55  valid flags. In some cases, this may significantly improve performance. A semi-colon at the start
    56  of any line makes it a comment.
    57  
    58  **Note:** If you use `--output --append` option and at the same time the `--file` option, you may not switch
    59  export formats in the command file. For example, a command file with two different commands, one with `--fmt csv`
    60  and the other with `--fmt json` will produce both invalid CSV and invalid JSON.
    61  
    62  *Copyright (c) 2024, TrueBlocks, LLC. All rights reserved. Generated with goMaker.*