org.exoplatform.addon.ethereum.wallet.service

Interface WalletTransactionService

public interface WalletTransactionService

Method Summary

Modifier and Type	Method and Description
TransactionDetail	getAddressLastPendingTransactionSent(long networkId, String address, String currentUser)
Set<String>	getPendingTransactionHashes(long networkId)
long	getPendingTransactionMaxDays()
List<TransactionDetail>	getPendingTransactions(long networkId)
TransactionDetail	getTransactionByHash(String hash)
List<TransactionDetail>	getTransactions(long networkId, String address, String contractAddress, String hash, int limit, boolean onlyPending, boolean administration, String currentUser)
long	getWatchedTreatedTransactionsCount()
void	saveTransactionDetail(TransactionDetail transactionDetail, boolean broadcastMinedTransaction) Save transaction details in database
void	saveTransactionDetail(TransactionDetail transactionDetail, String currentUser, boolean broadcastMinedTransaction) Save transaction details in database

Method Detail

getPendingTransactions

List<TransactionDetail> getPendingTransactions(long networkId)

Parameters:

networkId - blockchain network id

Returns:

List of pending TransactionDetail

getPendingTransactionHashes

Set<String> getPendingTransactionHashes(long networkId)

Parameters:

networkId - blockchain network id

Returns:

transactions hashes that are marked as pensing in internal database

getTransactions

List<TransactionDetail> getTransactions(long networkId,
                                        String address,
                                        String contractAddress,
                                        String hash,
                                        int limit,
                                        boolean onlyPending,
                                        boolean administration,
                                        String currentUser)
                                 throws IllegalAccessException

Parameters:

networkId - blockchain network id

address - wallet address

contractAddress - contract address to use to filter transactions

hash - the transaction hash to include in resulted transactions

limit - limit size of returned transactions unless the hash parameter is not null, in that case, continue searching in transactions list until the hash is included in results

onlyPending - whether filtering on pending transactions only or not

administration - include administration transactions or not

currentUser - the user accessing the list of transactions

Returns:

the list of transactions corresponding to filter parameters

Throws:

IllegalAccessException - if the current user isn't allowed to access wallet transactions

getTransactionByHash

TransactionDetail getTransactionByHash(String hash)

Parameters:

hash - transaction hash

Returns:

the transaction detail corresponding to the hash parameter, retrieved from internal database

getAddressLastPendingTransactionSent

TransactionDetail getAddressLastPendingTransactionSent(long networkId,
                                                       String address,
                                                       String currentUser)
                                                throws IllegalAccessException

Parameters:

networkId - blockchain network id

address - wallet address

currentUser - user accessing last pending transaction of wallet

Returns:

last transaction marked as pending in internal database corresponding to the wallet identified by an address

Throws:

IllegalAccessException - if the current user is not an admin and is not the owner of the wallet

saveTransactionDetail

void saveTransactionDetail(TransactionDetail transactionDetail,
                           boolean broadcastMinedTransaction)

Save transaction details in database

Parameters:

transactionDetail - transaction detail to save

broadcastMinedTransaction - whether the transaction has been mined on blockchain or not

saveTransactionDetail

void saveTransactionDetail(TransactionDetail transactionDetail,
                           String currentUser,
                           boolean broadcastMinedTransaction)
                    throws IllegalAccessException

Save transaction details in database

Parameters:

transactionDetail - transaction detail to save

currentUser - current username that is saving transaction

broadcastMinedTransaction - whether the transaction has been mined on blockchain or not

Throws:

IllegalAccessException - if current user is not allowed to save transaction to sender and receiver wallet

getWatchedTreatedTransactionsCount

long getWatchedTreatedTransactionsCount()

Returns:

watched transactions count treated since the server startup

getPendingTransactionMaxDays

long getPendingTransactionMaxDays()

Returns:

max days to wait until marking a non existing transaction on blockchain as failed