org.exoplatform.addon.wallet.service

Interface WalletTransactionService

public interface WalletTransactionService

Manage stored transaction details in eXo internal datasource

Method Summary

Modifier and Type	Method and Description
Set<String>	getPendingTransactionHashes()
long	getPendingTransactionMaxDays()
List<TransactionDetail>	getPendingTransactions()
TransactionDetail	getTransactionByHash(String hash)
TransactionDetail	getTransactionByHash(String hash, String currentUser)
List<TransactionDetail>	getTransactions(String address, String contractAddress, String contractMethodName, String hash, int limit, boolean onlyPending, boolean administration, String currentUser)
TransactionStatistics	getTransactionStatistics(String address, String periodicity, Locale locale) Retrives the Transaction statistics of a user on a designated contract by period of time
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()

Returns:

List of pending TransactionDetail

getPendingTransactionHashes

Set<String> getPendingTransactionHashes()

Returns:

transactions hashes that are marked as pensing in internal database

getTransactions

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

Parameters:

address - wallet address

contractAddress - contract address to use to filter transactions

contractMethodName - the contract method name to use to filter on 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

getTransactionStatistics

TransactionStatistics getTransactionStatistics(String address,
                                               String periodicity,
                                               Locale locale)

Retrives the Transaction statistics of a user on a designated contract by period of time

Parameters:

address -

periodicity -

locale -

Returns:

TransactionStatistics with sent and received amounts and labels

getTransactionByHash

TransactionDetail getTransactionByHash(String hash)

Parameters:

hash - transaction hash

Returns:

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

getTransactionByHash

TransactionDetail getTransactionByHash(String hash,
                                       String currentUser)

Parameters:

hash - transaction hash

currentUser - current username that is getting transaction details

Returns:

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

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