org.exoplatform.addon.ethereum.wallet.service

Class EthereumClientConnector

java.lang.Object

org.exoplatform.addon.ethereum.wallet.service.EthereumClientConnector

public class EthereumClientConnector
extends Object

A Web3j connector class to interact with Ethereum Blockchain

Constructor Summary

Constructors

Constructor and Description
EthereumClientConnector()

Method Summary

Modifier and Type	Method and Description
void	changeSettings(org.exoplatform.addon.ethereum.wallet.model.GlobalSettings newGlobalSettings) Change currently used globalSettings and re-init
org.web3j.protocol.core.methods.response.EthBlock.Block	getBlock(String blockHash) Get block by hash
int	getConnectionInterruptionCount()
Set<String>	getContractTransactions(String contractsAddress, long fromBlock, long toBlock) Retrieve from blockchain transaction hashes from contract starting from a block number to a block number
long	getLastestBlockNumber()
org.web3j.protocol.core.methods.response.Transaction	getTransaction(String transactionHash) Get transaction by hash
org.web3j.protocol.core.methods.response.TransactionReceipt	getTransactionReceipt(String transactionHash) Get transaction receipt by hash
boolean	isConnected()
void	start(org.exoplatform.addon.ethereum.wallet.model.GlobalSettings storedSettings)
void	stop()

Methods inherited from class java.lang.Object

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

Constructor Detail

EthereumClientConnector

public EthereumClientConnector()

Method Detail

start

public void start(org.exoplatform.addon.ethereum.wallet.model.GlobalSettings storedSettings)

stop

public void stop()

getTransaction

public org.web3j.protocol.core.methods.response.Transaction getTransaction(String transactionHash)
                                                                    throws InterruptedException

Get transaction by hash

Parameters:

transactionHash - transaction hash to retrieve

Returns:

Web3j Transaction object

Throws:

InterruptedException - when Blockchain request is interrupted

getBlock

public org.web3j.protocol.core.methods.response.EthBlock.Block getBlock(String blockHash)
                                                                 throws InterruptedException

Get block by hash

Parameters:

blockHash - block hash to retrieve

Returns:

Web3j Block object

Throws:

InterruptedException - when Blockchain request is interrupted

getTransactionReceipt

public org.web3j.protocol.core.methods.response.TransactionReceipt getTransactionReceipt(String transactionHash)
                                                                                  throws InterruptedException

Get transaction receipt by hash

Parameters:

transactionHash - transaction hash to retrieve

Returns:

Web3j Transaction receipt object

Throws:

InterruptedException - when Blockchain request is interrupted

changeSettings

public void changeSettings(org.exoplatform.addon.ethereum.wallet.model.GlobalSettings newGlobalSettings)

Change currently used globalSettings and re-init

Parameters:

newGlobalSettings - newly saved global settings

isConnected

public boolean isConnected()

Returns:

true if the connection to the blockchain is established

getConnectionInterruptionCount

public int getConnectionInterruptionCount()

Returns:

number of blockchain connection interruption

getLastestBlockNumber

public long getLastestBlockNumber()
                           throws InterruptedException,
                                  IOException

Returns:

last mined block number from blockchain

Throws:

InterruptedException

IOException

getContractTransactions

public Set<String> getContractTransactions(String contractsAddress,
                                           long fromBlock,
                                           long toBlock)
                                    throws IOException,
                                           InterruptedException

Retrieve from blockchain transaction hashes from contract starting from a block number to a block number

Parameters:

contractsAddress - blockchain contract address

fromBlock - search starting from this block number

toBlock - search until this block number

Returns:

a Set of transaction hashes

Throws:

IOException - if an error happens while getting information from blockchain

InterruptedException - if an interruption is made while getting information from blockchain