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

     1  ## chifra receipts
     2  
     3  `chifra receipts` returns the given transaction's receipt. You may specify multiple transaction identifiers
     4  per invocation.
     5  
     6  The `--articulate` option fetches the ABI from each encountered smart contract (including those
     7  encountered in a trace--if the `--trace` option is enabled) to better describe the reported data.
     8  
     9  Generally speaking, this tool is less useful than others as you may report the same data using
    10  `chifra transactions` and more focused data using `chifra logs`. It is included here for
    11  completeness, as the `receipt` is a fundamental data structure in Ethereum.
    12  
    13  ```[plaintext]
    14  Purpose:
    15    Retrieve receipts for the given transaction(s).
    16  
    17  Usage:
    18    chifra receipts [flags] <tx_id> [tx_id...]
    19  
    20  Arguments:
    21    transactions - a space-separated list of one or more transaction identifiers (required)
    22  
    23  Flags:
    24    -a, --articulate   articulate the retrieved data if ABIs can be found
    25    -o, --cache        force the results of the query into the cache
    26    -D, --decache      removes related items from the cache
    27    -x, --fmt string   export format, one of [none|json*|txt|csv]
    28    -v, --verbose      enable verbose output
    29    -h, --help         display this help screen
    30  
    31  Notes:
    32    - The transactions list may be one or more transaction hashes, blockNumber.transactionID pairs, or a blockHash.transactionID pairs.
    33    - This tool checks for valid input syntax, but does not check that the transaction requested actually exists.
    34    - If the queried node does not store historical state, the results for most older transactions are undefined.
    35  ```
    36  
    37  Data models produced by this tool:
    38  
    39  - [function](/data-model/other/#function)
    40  - [parameter](/data-model/other/#parameter)
    41  - [receipt](/data-model/chaindata/#receipt)
    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.*