Package io.goodforgod.api.etherscan

Class AccountAPIProvider

java.lang.Object

io.goodforgod.api.etherscan.BasicProvider

io.goodforgod.api.etherscan.AccountAPIProvider

All Implemented Interfaces:

AccountAPI

public class AccountAPIProvider
extends BasicProvider
implements AccountAPI

Account API Implementation

Since:

28.10.2018

See Also:

• AccountAPI

Constructor Summary

Constructors

Constructor	Description
AccountAPIProvider(RequestQueueManager requestQueueManager, String baseUrl, EthHttpClient executor, Converter converter, int retryCount)

Method Summary

Modifier and Type	Method	Description
@NotNull Balance	balance(@NotNull String address)	Address ETH balance
@NotNull TokenBalance	balance(@NotNull String address, @NotNull String contract)	ERC20 token balance for address
@NotNull List<Balance>	balances(@NotNull List<String> addresses)	Maximum 20 address for single batch request If address MORE THAN 20, then there will be more than 1 request performed
@NotNull List<Block>	blocksMined(@NotNull String address)	All blocks mined by address
@NotNull List<Tx>	txs(@NotNull String address)
@NotNull List<Tx>	txs(@NotNull String address, long startBlock)
@NotNull List<Tx>	txs(@NotNull String address, long startBlock, long endBlock)	All txs for given address
@NotNull List<TxErc1155>	txsErc1155(@NotNull String address)
@NotNull List<TxErc1155>	txsErc1155(@NotNull String address, long startBlock)
@NotNull List<TxErc1155>	txsErc1155(@NotNull String address, long startBlock, long endBlock)	All ERC-721 (NFT) token txs for given address
@NotNull List<TxErc1155>	txsErc1155(@NotNull String address, @NotNull String contractAddress)
@NotNull List<TxErc1155>	txsErc1155(@NotNull String address, @NotNull String contractAddress, long startBlock)
@NotNull List<TxErc1155>	txsErc1155(@NotNull String address, @NotNull String contractAddress, long startBlock, long endBlock)	All ERC-721 (NFT) token txs for given address
@NotNull List<TxErc20>	txsErc20(@NotNull String address)
@NotNull List<TxErc20>	txsErc20(@NotNull String address, long startBlock)
@NotNull List<TxErc20>	txsErc20(@NotNull String address, long startBlock, long endBlock)	All ERC-20 token txs for given address
@NotNull List<TxErc20>	txsErc20(@NotNull String address, @NotNull String contractAddress)
@NotNull List<TxErc20>	txsErc20(@NotNull String address, @NotNull String contractAddress, long startBlock)
@NotNull List<TxErc20>	txsErc20(@NotNull String address, @NotNull String contractAddress, long startBlock, long endBlock)	All ERC-20 token txs for given address and contract address
@NotNull List<TxErc721>	txsErc721(@NotNull String address)
@NotNull List<TxErc721>	txsErc721(@NotNull String address, long startBlock)
@NotNull List<TxErc721>	txsErc721(@NotNull String address, long startBlock, long endBlock)	All ERC-721 (NFT) token txs for given address
@NotNull List<TxErc721>	txsErc721(@NotNull String address, @NotNull String contractAddress)
@NotNull List<TxErc721>	txsErc721(@NotNull String address, @NotNull String contractAddress, long startBlock)
@NotNull List<TxErc721>	txsErc721(@NotNull String address, @NotNull String contractAddress, long startBlock, long endBlock)	All ERC-721 (NFT) token txs for given address
@NotNull List<TxInternal>	txsInternal(@NotNull String address)
@NotNull List<TxInternal>	txsInternal(@NotNull String address, long startBlock)
@NotNull List<TxInternal>	txsInternal(@NotNull String address, long startBlock, long endBlock)	All internal txs for given address
@NotNull List<TxInternal>	txsInternalByHash(@NotNull String txhash)	All internal tx for given transaction hash

Methods inherited from class io.goodforgod.api.etherscan.BasicProvider

convert, getMaximumOffset, getRequestUsingOffset, getResponse, getResponse, getResponse, postRequest, postRequest, postRequest

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

AccountAPIProvider

public AccountAPIProvider(RequestQueueManager requestQueueManager,
 String baseUrl,
 EthHttpClient executor,
 Converter converter,
 int retryCount)

Method Details

balance

@NotNull
public @NotNull Balance balance(@NotNull
 @NotNull String address)
                         throws EtherScanException

Description copied from interface: AccountAPI

Address ETH balance

Specified by:

balance in interface AccountAPI

Parameters:

address - get balance for

Returns:

balance

Throws:

EtherScanException - parent exception class

balance

@NotNull
public @NotNull TokenBalance balance(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contract)
                              throws EtherScanException

Description copied from interface: AccountAPI

ERC20 token balance for address

Specified by:

balance in interface AccountAPI

Parameters:

address - get balance for

contract - token contract

Returns:

token balance for address

Throws:

EtherScanException - parent exception class

balances

@NotNull
public @NotNull List<Balance> balances(@NotNull
 @NotNull List<String> addresses)
                                throws EtherScanException

Description copied from interface: AccountAPI

Maximum 20 address for single batch request If address MORE THAN 20, then there will be more than 1 request performed

Specified by:

balances in interface AccountAPI

Parameters:

addresses - addresses to get balances for

Returns:

list of balances

Throws:

EtherScanException - parent exception class

txs

@NotNull
public @NotNull List<Tx> txs(@NotNull
 @NotNull String address)
                      throws EtherScanException

Specified by:

txs in interface AccountAPI

Throws:

EtherScanException

txs

@NotNull
public @NotNull List<Tx> txs(@NotNull
 @NotNull String address,
 long startBlock)
                      throws EtherScanException

Specified by:

txs in interface AccountAPI

Throws:

EtherScanException

txs

@NotNull
public @NotNull List<Tx> txs(@NotNull
 @NotNull String address,
 long startBlock,
 long endBlock)
                      throws EtherScanException

Description copied from interface: AccountAPI

All txs for given address

Specified by:

txs in interface AccountAPI

Parameters:

address - get txs for

startBlock - tx from this blockNumber

endBlock - tx to this blockNumber

Returns:

txs for address

Throws:

EtherScanException - parent exception class

txsInternal

@NotNull
public @NotNull List<TxInternal> txsInternal(@NotNull
 @NotNull String address)
                                      throws EtherScanException

Specified by:

txsInternal in interface AccountAPI

Throws:

EtherScanException

txsInternal

@NotNull
public @NotNull List<TxInternal> txsInternal(@NotNull
 @NotNull String address,
 long startBlock)
                                      throws EtherScanException

Specified by:

txsInternal in interface AccountAPI

Throws:

EtherScanException

txsInternal

@NotNull
public @NotNull List<TxInternal> txsInternal(@NotNull
 @NotNull String address,
 long startBlock,
 long endBlock)
                                      throws EtherScanException

Description copied from interface: AccountAPI

All internal txs for given address

Specified by:

txsInternal in interface AccountAPI

Parameters:

address - get txs for

startBlock - tx from this blockNumber

endBlock - tx to this blockNumber

Returns:

txs for address

Throws:

EtherScanException - parent exception class

txsInternalByHash

@NotNull
public @NotNull List<TxInternal> txsInternalByHash(@NotNull
 @NotNull String txhash)
                                            throws EtherScanException

Description copied from interface: AccountAPI

All internal tx for given transaction hash

Specified by:

txsInternalByHash in interface AccountAPI

Parameters:

txhash - transaction hash

Returns:

internal txs list

Throws:

EtherScanException - parent exception class

txsErc20

@NotNull
public @NotNull List<TxErc20> txsErc20(@NotNull
 @NotNull String address)
                                throws EtherScanException

Specified by:

txsErc20 in interface AccountAPI

Throws:

EtherScanException

txsErc20

@NotNull
public @NotNull List<TxErc20> txsErc20(@NotNull
 @NotNull String address,
 long startBlock)
                                throws EtherScanException

Specified by:

txsErc20 in interface AccountAPI

Throws:

EtherScanException

txsErc20

@NotNull
public @NotNull List<TxErc20> txsErc20(@NotNull
 @NotNull String address,
 long startBlock,
 long endBlock)
                                throws EtherScanException

Description copied from interface: AccountAPI

All ERC-20 token txs for given address

Specified by:

txsErc20 in interface AccountAPI

Parameters:

address - get txs for

startBlock - tx from this blockNumber

endBlock - tx to this blockNumber

Returns:

txs for address

Throws:

EtherScanException - parent exception class

txsErc20

@NotNull
public @NotNull List<TxErc20> txsErc20(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contractAddress)
                                throws EtherScanException

Specified by:

txsErc20 in interface AccountAPI

Throws:

EtherScanException

txsErc20

@NotNull
public @NotNull List<TxErc20> txsErc20(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contractAddress,
 long startBlock)
                                throws EtherScanException

Specified by:

txsErc20 in interface AccountAPI

Throws:

EtherScanException

txsErc20

@NotNull
public @NotNull List<TxErc20> txsErc20(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contractAddress,
 long startBlock,
 long endBlock)
                                throws EtherScanException

Description copied from interface: AccountAPI

All ERC-20 token txs for given address and contract address

Specified by:

txsErc20 in interface AccountAPI

Parameters:

address - get txs for

contractAddress - contract address to get txs for

startBlock - tx from this blockNumber

endBlock - tx to this blockNumber

Returns:

txs for address

Throws:

EtherScanException - parent exception class

txsErc721

@NotNull
public @NotNull List<TxErc721> txsErc721(@NotNull
 @NotNull String address)
                                  throws EtherScanException

Specified by:

txsErc721 in interface AccountAPI

Throws:

EtherScanException

txsErc721

@NotNull
public @NotNull List<TxErc721> txsErc721(@NotNull
 @NotNull String address,
 long startBlock)
                                  throws EtherScanException

Specified by:

txsErc721 in interface AccountAPI

Throws:

EtherScanException

txsErc721

@NotNull
public @NotNull List<TxErc721> txsErc721(@NotNull
 @NotNull String address,
 long startBlock,
 long endBlock)
                                  throws EtherScanException

Description copied from interface: AccountAPI

All ERC-721 (NFT) token txs for given address

Specified by:

txsErc721 in interface AccountAPI

Parameters:

address - get txs for

startBlock - tx from this blockNumber

endBlock - tx to this blockNumber

Returns:

txs for address

Throws:

EtherScanException - parent exception class

txsErc721

@NotNull
public @NotNull List<TxErc721> txsErc721(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contractAddress,
 long startBlock,
 long endBlock)
                                  throws EtherScanException

Description copied from interface: AccountAPI

All ERC-721 (NFT) token txs for given address

Specified by:

txsErc721 in interface AccountAPI

Parameters:

address - get txs for

startBlock - tx from this blockNumber

endBlock - tx to this blockNumber

Returns:

txs for address

Throws:

EtherScanException - parent exception class

txsErc721

@NotNull
public @NotNull List<TxErc721> txsErc721(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contractAddress,
 long startBlock)
                                  throws EtherScanException

Specified by:

txsErc721 in interface AccountAPI

Throws:

EtherScanException

txsErc721

@NotNull
public @NotNull List<TxErc721> txsErc721(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contractAddress)
                                  throws EtherScanException

Specified by:

txsErc721 in interface AccountAPI

Throws:

EtherScanException

txsErc1155

@NotNull
public @NotNull List<TxErc1155> txsErc1155(@NotNull
 @NotNull String address,
 long startBlock,
 long endBlock)
                                    throws EtherScanException

Description copied from interface: AccountAPI

All ERC-721 (NFT) token txs for given address

Specified by:

txsErc1155 in interface AccountAPI

Parameters:

address - get txs for

startBlock - tx from this blockNumber

endBlock - tx to this blockNumber

Returns:

txs for address

Throws:

EtherScanException - parent exception class

txsErc1155

@NotNull
public @NotNull List<TxErc1155> txsErc1155(@NotNull
 @NotNull String address,
 long startBlock)
                                    throws EtherScanException

Specified by:

txsErc1155 in interface AccountAPI

Throws:

EtherScanException

txsErc1155

@NotNull
public @NotNull List<TxErc1155> txsErc1155(@NotNull
 @NotNull String address)
                                    throws EtherScanException

Specified by:

txsErc1155 in interface AccountAPI

Throws:

EtherScanException

txsErc1155

@NotNull
public @NotNull List<TxErc1155> txsErc1155(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contractAddress,
 long startBlock,
 long endBlock)
                                    throws EtherScanException

Description copied from interface: AccountAPI

All ERC-721 (NFT) token txs for given address

Specified by:

txsErc1155 in interface AccountAPI

Parameters:

address - get txs for

startBlock - tx from this blockNumber

endBlock - tx to this blockNumber

Returns:

txs for address

Throws:

EtherScanException - parent exception class

txsErc1155

@NotNull
public @NotNull List<TxErc1155> txsErc1155(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contractAddress,
 long startBlock)
                                    throws EtherScanException

Specified by:

txsErc1155 in interface AccountAPI

Throws:

EtherScanException

txsErc1155

@NotNull
public @NotNull List<TxErc1155> txsErc1155(@NotNull
 @NotNull String address,
 @NotNull
 @NotNull String contractAddress)
                                    throws EtherScanException

Specified by:

txsErc1155 in interface AccountAPI

Throws:

EtherScanException

blocksMined

@NotNull
public @NotNull List<Block> blocksMined(@NotNull
 @NotNull String address)
                                 throws EtherScanException

Description copied from interface: AccountAPI

All blocks mined by address

Specified by:

blocksMined in interface AccountAPI

Parameters:

address - address to search for

Returns:

blocks mined

Throws:

EtherScanException - parent exception class