org.exoplatform.addon.wallet.service

Interface WalletTokenAdminService

public interface WalletTokenAdminService

Communicates with blockchain to send transactions and retrieve information using admin wallet

Method Summary

Modifier and Type	Method and Description
BigInteger	balanceOf(String address) Get token balance of a wallet address (on blockchain)
void	createAdminAccount() Generates admin account wallet and store it internally in eXo Server
void	createAdminAccount(String privateKey, String issuerUsername) Creates admin account wallet using provided private key and store it internally in eXo Server
int	getAdminLevel(String address) Get admin level of a wallet address from token (on blockchain)
Wallet	getAdminWallet()
String	getAdminWalletAddress()
ContractDetail	getContractDetailFromBlockchain(String contractAddress) Retrieves contract details from blockchain, like: - Sell price - Owner - Symbol - Name ...
BigInteger	getEtherBalanceOf(String address) Get ether balance of a wallet address (on blockchain)
TransactionDetail	initialize(TransactionDetail transactionDetail, String issuerUsername) Initializes (on blockchain) a receiver wallet address using 'Admin' wallet by using funds transmitted in transaction detail.
boolean	isAdminAccount(String address) Checks whether a wallet address is an admin on token with at least level 1 (on blockchain)
boolean	isApprovedAccount(String address) Checks if a wallet address is approved on token (on blockchain)
boolean	isInitializedAccount(String address) Checks whether the wallet is initialized or not (on blockchain)
TransactionDetail	reward(TransactionDetail transactionDetail, String issuerUsername) Send rewarded token amounts (on blockchain) to a receiver wallet address using 'Admin' wallet.
TransactionDetail	sendEther(TransactionDetail transactionDetail, String issuerUsername) Send ether (on blockchain) to a receiver wallet address using 'Admin' wallet.

Method Detail

createAdminAccount

void createAdminAccount()

Generates admin account wallet and store it internally in eXo Server

createAdminAccount

void createAdminAccount(String privateKey,
                        String issuerUsername)
                 throws IllegalAccessException

Creates admin account wallet using provided private key and store it internally in eXo Server

Parameters:

privateKey - admin account wallet private key

issuerUsername - current user creating wallet

Throws:

IllegalAccessException - if current user is not allowed to create admin wallet account

getAdminWallet

Wallet getAdminWallet()

Returns:

Admin wallet object

getAdminWalletAddress

String getAdminWalletAddress()

Returns:

Admin wallet address

reward

TransactionDetail reward(TransactionDetail transactionDetail,
                         String issuerUsername)
                  throws Exception

Send rewarded token amounts (on blockchain) to a receiver wallet address using 'Admin' wallet. The amount sent could be different from rewarded amount. A label and a message are associated to the transaction. Those properties aren't sent on blockchain, but stored in database. The transaction issuer will be stored in transaction details stored internally in eXo server.

Parameters:

transactionDetail -

issuerUsername -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain

Throws:

Exception

initialize

TransactionDetail initialize(TransactionDetail transactionDetail,
                             String issuerUsername)
                      throws Exception

Initializes (on blockchain) a receiver wallet address using 'Admin' wallet by using funds transmitted in transaction detail. The transaction issuer, label and message will be stored in transaction details inside eXo server only.

Parameters:

transactionDetail -

issuerUsername -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain

Throws:

Exception

sendEther

TransactionDetail sendEther(TransactionDetail transactionDetail,
                            String issuerUsername)
                     throws Exception

Send ether (on blockchain) to a receiver wallet address using 'Admin' wallet. The transaction issuer, label and message will be stored in transaction details inside eXo server only.

Parameters:

transactionDetail -

issuerUsername -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain

Throws:

Exception

balanceOf

BigInteger balanceOf(String address)
              throws Exception

Get token balance of a wallet address (on blockchain)

Parameters:

address -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain

Throws:

Exception

getEtherBalanceOf

BigInteger getEtherBalanceOf(String address)
                      throws Exception

Get ether balance of a wallet address (on blockchain)

Parameters:

address -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain

Throws:

Exception

isInitializedAccount

boolean isInitializedAccount(String address)
                      throws Exception

Checks whether the wallet is initialized or not (on blockchain)

Parameters:

address -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain

Throws:

Exception

isAdminAccount

boolean isAdminAccount(String address)
                throws Exception

Checks whether a wallet address is an admin on token with at least level 1 (on blockchain)

Parameters:

address -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain

Throws:

Exception

getAdminLevel

int getAdminLevel(String address)
           throws Exception

Get admin level of a wallet address from token (on blockchain)

Parameters:

address -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain

Throws:

Exception

isApprovedAccount

boolean isApprovedAccount(String address)
                   throws Exception

Checks if a wallet address is approved on token (on blockchain)

Parameters:

address -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain

Throws:

Exception

getContractDetailFromBlockchain

ContractDetail getContractDetailFromBlockchain(String contractAddress)

Retrieves contract details from blockchain, like: - Sell price - Owner - Symbol - Name ...

Parameters:

contractAddress -

Returns:

TransactionDetail with the hash of the transaction sent in blockchain