chainlib-eth

Ethereum implementation of the chainlib interface
Info | Log | Files | Refs | README | LICENSE

eth-get.1 (4333B)


      1 .TH eth-get 1
      2 
      3 .SH NAME
      4 eth-get \- Retrieve transaction and transaction state from network
      5 
      6 .SH SYNOPSIS
      7 .PP
      8 \fBeth-get\fP [ -p \fIrpc_provider\fP] \fItx_hash\fP
      9 .PP
     10 \fBeth-get\fP [ -p \fIrpc_provider\fP] \fIaddress\fP
     11 
     12 .SH DESCRIPTION
     13 .P
     14 Retrieve a transaction by its transaction hash, or contract code by its address.
     15 .P
     16 In the context of transaction, \fBeth-get\fP retrieves the state of the transaction (the "receipt") and applies it to the output. It also re-serializes the transaction wire format for reference. 
     17 
     18 
     19 .SS OPTIONS
     20 
     21 .TP
     22 \fB-0\fP
     23 Omit newline to output
     24 
     25 .TP
     26 \fB-c \fI\fIconfig_dir\fP\fP, \fB--config \fI\fIconfig_dir\fP\fP
     27 Load configuration files from given directory. All files with an .ini extension will be loaded, of which all must contain valid ini file data.
     28 
     29 .TP
     30 \fB--dumpconfig \fI\fIformat\fP\fP
     31 Output configuration settings rendered from environment and inputs. Valid arguments are \fIini\fP for ini file output, and \fIenv\fP for environment variable output. See \fBCONFIGURATION\fP.
     32 
     33 .TP
     34 \fB--env-prefix\fP
     35 Environment prefix for variables to overwrite configuration. Example: If \fB--env-prefix\fP is set to \fBFOO\fP then configuration variable \fBBAR_BAZ\fP would be set by environment variable \fBFOO_BAZ_BAR\fP. Also see \fBENVIRONMENT\fP.
     36 
     37 .TP
     38 \fB--height\fP
     39 Block height at which to query state for. Does not apply to transactions.
     40 
     41 .TP
     42 \fB-n \fI\fInamespace\fP\fP, \fB--namespace \fI\fInamespace\fP\fP
     43 Load given configuration namespace. Configuration will be loaded from the immediate configuration subdirectory with the same name.
     44 
     45 .TP
     46 \fB--no-logs\fP
     47 Turn of logging completely. Negates \fB-v\fP and \fB-vv\fP
     48 
     49 .TP
     50 \fB-o\fP, \fB--output-key\fP
     51 Include output by key name
     52 
     53 .TP
     54 \fB-p\fP, \fB--rpc-provider\fP
     55 Fully-qualified URL of RPC provider. Overrides the \fIRPC_PROVIDER\fP configuration setting.
     56 
     57 .TP
     58 \fB--raw\fP
     59 Produce output most optimized for machines.
     60 
     61 .TP
     62 \fB--rpc-dialect\fP
     63 RPC backend dialect. If specified it \fImay\fP help with encoding and decoding issues. Overrides the \fIRPC_DIALECT\fP configuration setting.
     64 
     65 .TP
     66 \fB--seq\fP
     67 Use numeric sequencial jsonrpc query ids. Useful for buggy server implementations who expects such.
     68 
     69 .TP
     70 \fB-u\fP, \fB--unsafe\fP
     71 Allow addresses that do not pass checksum.
     72 
     73 .TP
     74 \fB-v\fP
     75 Verbose. Show logs for important state changes.
     76 
     77 .TP
     78 \fB-vv\fP
     79 Very verbose. Show logs with debugging information.
     80 
     81 .SH CONFIGURATION
     82 
     83 All configuration settings may be overriden both by environment variables, or by overriding settings with the contents of ini-files in the directory defined by the \fB-c\fP option.
     84 
     85 The active configuration, with values assigned from environment and arguments, can be output using the \fB--dumpconfig\fP \fIformat\fP option. Note that entries having keys prefixed with underscore (e.g. _SEQ) are not actual configuration settings, and thus cannot be overridden with environment variables.
     86 
     87 To refer to a configuration setting by environment variables, the \fIsection\fP and \fIkey\fP are concatenated together with an underscore, and transformed to upper-case. For example, the configuration variable \fIFOO_BAZ_BAR\fP refers to an ini-file entry as follows:
     88 
     89 .EX
     90 [foo]
     91 bar_baz = xyzzy
     92 .EE
     93 
     94 In the \fBENVIRONMENT\fP section below, the relevant configuration settings for this tool is listed along with a short description of its meaning.
     95 
     96 Some configuration settings may also be overriden by command line options. Also note that the use of the \fB-n\fP and \fB--env-prefix\fP options affect how environment and configuration is read. The effects of options on how configuration settings are affective is described in the respective \fBOPTIONS\fP section.
     97 
     98 .SH ENVIRONMENT
     99 
    100 
    101 .TP
    102 \fIRPC_DIALECT\fP
    103 Enables translations of EVM node specific formatting and response codes.
    104 
    105 .TP
    106 \fIRPC_PROVIDER\fP
    107 Fully-qualified URL to the RPC endpoint of the blockchain node.
    108 
    109 .SH LICENSE
    110 
    111 This documentation and its source is licensed under the Creative Commons Attribution-Sharealike 4.0 International license.
    112 
    113 The source code of the tool this documentation describes is licensed under the GNU General Public License 3.0.
    114 
    115 .SH COPYRIGHT
    116 
    117 Louis Holbrook <dev@holbrook.no> (https://holbrook.no)
    118 PGP: 59A844A484AC11253D3A3E9DCDCBD24DD1D0E001
    119 
    120 
    121 
    122 .SH SOURCE CODE
    123 
    124 https://git.defalsify.org
    125 
    126 
    127 .SH SEE ALSO
    128 
    129 .BP
    130 confini-dump(1), eth-keyfile(1)
    131