io.api.etherscan.core

Interface IProxyApi

All Known Implementing Classes:

ProxyApiProvider

public interface IProxyApi

EtherScan - API Descriptions https://etherscan.io/apis#proxy

Since:

30.10.2018

Author:

GoodforGod

Method Summary

Modifier and Type	Method and Description
Optional<BlockProxy>	block(long blockNo) Returns information about a block by block number eth_getBlockByNumber
long	blockNoLast() Returns the number of most recent block eth_blockNumber
Optional<BlockProxy>	blockUncle(long blockNo, long index) Returns information about a uncle by block number eth_getUncleByBlockNumberAndIndex
Optional<String>	call(String address, String data) Executes a new message call immediately without creating a transaction on the block chain eth_call
Optional<String>	code(String address) Returns code at a given address eth_getCode
BigInteger	gasEstimated()
BigInteger	gasEstimated(String hexData) Makes a call or transaction, which won't be added to the blockchain and returns the used gas, which can be used for estimating the used gas eth_estimateGas
BigInteger	gasPrice() Returns the current price per gas in wei eth_gasPrice
Optional<String>	storageAt(String address, long position) (**experimental) Returns the value from a storage position at a given address eth_getStorageAt
Optional<TxProxy>	tx(long blockNo, long index) Returns information about a transaction by block number and transaction index position eth_getTransactionByBlockNumberAndIndex
Optional<TxProxy>	tx(String txhash) Returns the information about a transaction requested by transaction hash eth_getTransactionByHash
int	txCount(long blockNo) Returns the number of transactions in a block from a block matching the given block number eth_getBlockTransactionCountByNumber
Optional<ReceiptProxy>	txReceipt(String txhash) Returns the receipt of a transaction by transaction hash eth_getTransactionReceipt
int	txSendCount(String address) Returns the number of transactions sent from an address eth_getTransactionCount
Optional<String>	txSendRaw(String hexEncodedTx) Creates new message call transaction or a contract creation for signed transactions eth_sendRawTransaction

Method Detail

blockNoLast

long blockNoLast()

Returns the number of most recent block eth_blockNumber

Returns:

last block number

Throws:

ApiException - parent exception class

block

@NotNull
Optional<BlockProxy> block(long blockNo)
                              throws ApiException

Returns information about a block by block number eth_getBlockByNumber

Parameters:

blockNo - block number from 0 to last

Returns:

optional block result

Throws:

ApiException - parent exception class

blockUncle

@NotNull
Optional<BlockProxy> blockUncle(long blockNo,
                                          long index)
                                   throws ApiException

Returns information about a uncle by block number eth_getUncleByBlockNumberAndIndex

Parameters:

blockNo - block number from 0 to last

index - uncle block index

Returns:

optional block result

Throws:

ApiException - parent exception class

tx

@NotNull
Optional<TxProxy> tx(String txhash)
                        throws ApiException

Returns the information about a transaction requested by transaction hash eth_getTransactionByHash

Parameters:

txhash - transaction hash

Returns:

optional tx result

Throws:

ApiException - parent exception class

tx

@NotNull
Optional<TxProxy> tx(long blockNo,
                               long index)
                        throws ApiException

Returns information about a transaction by block number and transaction index position eth_getTransactionByBlockNumberAndIndex

Parameters:

blockNo - block number from 0 to last

index - tx index in block

Returns:

optional tx result

Throws:

ApiException - parent exception class

txCount

int txCount(long blockNo)
     throws ApiException

Returns the number of transactions in a block from a block matching the given block number eth_getBlockTransactionCountByNumber

Parameters:

blockNo - block number from 0 to last

Returns:

transaction amount in block

Throws:

ApiException - parent exception class

txSendCount

int txSendCount(String address)
         throws ApiException

Returns the number of transactions sent from an address eth_getTransactionCount

Parameters:

address - eth address

Returns:

transactions send amount from address

Throws:

ApiException - parent exception class

txSendRaw

@NotNull
Optional<String> txSendRaw(String hexEncodedTx)
                              throws ApiException

Creates new message call transaction or a contract creation for signed transactions eth_sendRawTransaction

Parameters:

hexEncodedTx - encoded hex data to send

Returns:

optional string response

Throws:

ApiException - parent exception class

txReceipt

@NotNull
Optional<ReceiptProxy> txReceipt(String txhash)
                                    throws ApiException

Returns the receipt of a transaction by transaction hash eth_getTransactionReceipt

Parameters:

txhash - transaction hash

Returns:

optional tx receipt

Throws:

ApiException - parent exception class

call

@NotNull
Optional<String> call(String address,
                                String data)
                         throws ApiException

Executes a new message call immediately without creating a transaction on the block chain eth_call

Parameters:

address - to call

data - data to call address

Returns:

optional the return value of executed contract.

Throws:

ApiException - parent exception class

code

@NotNull
Optional<String> code(String address)
                         throws ApiException

Returns code at a given address eth_getCode

Parameters:

address - get code from

Returns:

optional the code from the given address

Throws:

ApiException - parent exception class

storageAt

@NotNull
Optional<String> storageAt(String address,
                                     long position)
                              throws ApiException

(**experimental) Returns the value from a storage position at a given address eth_getStorageAt

Parameters:

address - to get storage

position - storage position

Returns:

optional the value at this storage position

Throws:

ApiException - parent exception class

gasPrice

@NotNull
BigInteger gasPrice()
                       throws ApiException

Returns the current price per gas in wei eth_gasPrice

Returns:

estimated gas price

Throws:

ApiException - parent exception class

gasEstimated

@NotNull
BigInteger gasEstimated(String hexData)
                           throws ApiException

Makes a call or transaction, which won't be added to the blockchain and returns the used gas, which can be used for estimating the used gas eth_estimateGas

Parameters:

hexData - data to calc gas usage for

Returns:

estimated gas usage

Throws:

ApiException - parent exception class

gasEstimated

@NotNull
BigInteger gasEstimated()
                           throws ApiException

Throws:

ApiException