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

     1  ## chifra list
     2  
     3  `chifra list` takes one or more addresses, queries the index of appearances, and builds TrueBlocks
     4  monitors. A TrueBlocks monitor is a file that contains blockNumber.transactionIndex pairs (transaction
     5  identifiers) representing the history of the address.
     6  
     7  Because TrueBlocks only extracts data from the Ethereum node when it's requested, the first time
     8  you list an address it takes about a minute. Subsequent queries are much faster because TrueBlocks
     9  caches the results.
    10  
    11  Note that `chifra list` only queries the index, it does not extract the full transactional details.
    12  You may use `chifra export` for that.
    13  
    14  ```[plaintext]
    15  Purpose:
    16    List every appearance of an address anywhere on the chain.
    17  
    18  Usage:
    19    chifra list [flags] <address> [address...]
    20  
    21  Arguments:
    22    addrs - one or more addresses (0x...) to list (required)
    23  
    24  Flags:
    25    -U, --count               display only the count of records for each monitor
    26    -z, --no_zero             for the --count option only, suppress the display of zero appearance accounts
    27    -b, --bounds              report first and last block this address appears
    28    -u, --unripe              list transactions labeled unripe (i.e. less than 28 blocks old)
    29    -s, --silent              freshen the monitor only (no reporting)
    30    -c, --first_record uint   the first record to process
    31    -e, --max_records uint    the maximum number of records to process (default 250)
    32    -E, --reversed            produce results in reverse chronological order
    33    -F, --first_block uint    first block to export (inclusive, ignored when freshening)
    34    -L, --last_block uint     last block to export (inclusive, ignored when freshening)
    35    -x, --fmt string          export format, one of [none|json*|txt|csv]
    36    -v, --verbose             enable verbose output
    37    -h, --help                display this help screen
    38  
    39  Notes:
    40    - An address must be either an ENS name or start with '0x' and be forty-two characters long.
    41    - No other options are permitted when --silent is selected.
    42  ```
    43  
    44  Data models produced by this tool:
    45  
    46  - [appearance](/data-model/accounts/#appearance)
    47  - [bounds](/data-model/accounts/#bounds)
    48  - [monitor](/data-model/accounts/#monitor)
    49  
    50  ### Other Options
    51  
    52  All tools accept the following additional flags, although in some cases, they have no meaning.
    53  
    54  ```[plaintext]
    55    -v, --version         display the current version of the tool
    56        --output string   write the results to file 'fn' and return the filename
    57        --append          for --output command only append to instead of replace contents of file
    58        --file string     specify multiple sets of command line options in a file
    59  ```
    60  
    61  **Note:** For the `--file string` option, you may place a series of valid command lines in a file using any
    62  valid flags. In some cases, this may significantly improve performance. A semi-colon at the start
    63  of any line makes it a comment.
    64  
    65  **Note:** If you use `--output --append` option and at the same time the `--file` option, you may not switch
    66  export formats in the command file. For example, a command file with two different commands, one with `--fmt csv`
    67  and the other with `--fmt json` will produce both invalid CSV and invalid JSON.
    68  
    69  *Copyright (c) 2024, TrueBlocks, LLC. All rights reserved. Generated with goMaker.*