live.lingting.virtual.currency.core

接口 PlatformService<G>

public interface PlatformService<G>

虚拟货币处理接口类

作者:

lingting 2020-09-01 17:15

方法概要

限定符和类型	方法和说明
BigInteger	getBalanceByAddressAndContract(String address, Contract contract) 查询指定地址, 指定合约余额.
Integer	getDecimalsByContract(Contract contract) 获取合约的精度, 请注意不同平台不同api的返回结果不一致
default BigDecimal	getNumberByAddressAndContract(String address, Contract contract) 获取指定地址, 指定合约余额 (单位: 个)
default BigDecimal	getNumberByBalanceAndContract(BigInteger balance, Contract contract) 通过 getBalanceByAddressAndContract(java.lang.String, Contract) 方法的余额单位不一定是个, 会附带小数, 可执行此方法转换为以个为单位
BigDecimal	getNumberByBalanceAndContract(BigInteger balance, Contract contract, MathContext mathContext) 通过 getBalanceByAddressAndContract(java.lang.String, Contract) 方法的余额单位不一定是个, 会附带小数, 可执行此方法转换为以个为单位
Optional<TransactionInfo>	getTransactionByHash(String hash) 通过交易hash获取交易信息
TransferResult	transactionBroadcast(G generate) 广播交易
G	transactionGenerate(Account from, String to, Contract contract, BigDecimal value, TransferParams params) 转账生成
G	transactionSign(G generate) 对交易进行签名
default TransferResult	transfer(Account from, String to, Contract contract, BigDecimal value) 转账
default TransferResult	transfer(Account from, String to, Contract contract, BigDecimal value, TransferParams params) 转账
boolean	validate(String address) 校验地址是否正确
default BigInteger	valueToBalanceByContract(BigDecimal value, Contract contract) 指定合约金额(单位 个)转为数量

方法详细资料

getTransactionByHash

Optional<TransactionInfo> getTransactionByHash(String hash)
                                        throws Exception

通过交易hash获取交易信息

参数:

hash - 交易hash

返回:

交易信息

抛出:

Exception - 可能抛出的异常

getDecimalsByContract

Integer getDecimalsByContract(Contract contract)
                       throws Exception

获取合约的精度, 请注意不同平台不同api的返回结果不一致

参数:

contract - 合约

返回:

精度

抛出:

Exception - 可能抛出的异常

getBalanceByAddressAndContract

BigInteger getBalanceByAddressAndContract(String address,
                                          Contract contract)
                                   throws Exception

查询指定地址, 指定合约余额. 不同平台请使用不同平台对应的 contract

参数:

address - 账号地址

contract - 合约

返回:

java.math.BigDecimal

抛出:

Exception - 可能抛出的异常

getNumberByAddressAndContract

default BigDecimal getNumberByAddressAndContract(String address,
                                                 Contract contract)
                                          throws Exception

获取指定地址, 指定合约余额 (单位: 个)

参数:

address - 地址

contract - 余额

返回:

java.math.BigDecimal

抛出:

Exception - 可能抛出的异常

getNumberByBalanceAndContract

default BigDecimal getNumberByBalanceAndContract(BigInteger balance,
                                                 Contract contract)
                                          throws Exception

通过 getBalanceByAddressAndContract(java.lang.String, Contract) 方法的余额单位不一定是个, 会附带小数, 可执行此方法转换为以个为单位

参数:

balance - getBalanceByAddressAndContract 方法返回值

contract - 合约地址

返回:

java.math.BigDecimal

抛出:

Exception - 可能抛出的异常

getNumberByBalanceAndContract

BigDecimal getNumberByBalanceAndContract(BigInteger balance,
                                         Contract contract,
                                         MathContext mathContext)
                                  throws Exception

通过 getBalanceByAddressAndContract(java.lang.String, Contract) 方法的余额单位不一定是个, 会附带小数, 可执行此方法转换为以个为单位

参数:

balance - getBalanceByAddressAndContract 方法返回值

contract - 合约地址

mathContext - 精度要求

返回:

java.math.BigDecimal

抛出:

Exception - 可能抛出的异常

valueToBalanceByContract

default BigInteger valueToBalanceByContract(BigDecimal value,
                                            Contract contract)
                                     throws Exception

指定合约金额(单位 个)转为数量

参数:

value - 金额

contract - 合约

返回:

返回数量

抛出:

Exception - 异常

transfer

default TransferResult transfer(Account from,
                                String to,
                                Contract contract,
                                BigDecimal value)
                         throws Exception

转账

参数:

from - 转出账号

to - 转入地址

contract - 合约

value - 转账金额, 单位 个

返回:

boolean

抛出:

Exception - 异常

transactionGenerate

G transactionGenerate(Account from,
                      String to,
                      Contract contract,
                      BigDecimal value,
                      TransferParams params)
               throws Exception

转账生成

参数:

from - 转出账号

to - 转入地址

contract - 合约

value - 转账金额, 单位 个

params - 转账参数

返回:

boolean

抛出:

Exception - 异常

transactionSign

G transactionSign(G generate)
           throws Exception

对交易进行签名

参数:

generate - 通过 transactionGenerate 方法生成的数据

返回:

live.lingting.virtual.currency.core.TransactionGenerate

抛出:

Exception - 异常

transactionBroadcast

TransferResult transactionBroadcast(G generate)
                             throws Exception

广播交易

参数:

generate - 通过 transactionSign 方法生成的数据

返回:

live.lingting.virtual.currency.core.TransferResult

抛出:

Exception - 异常

transfer

default TransferResult transfer(Account from,
                                String to,
                                Contract contract,
                                BigDecimal value,
                                TransferParams params)
                         throws Exception

转账

参数:

from - 转出账号

to - 转入地址

contract - 合约

value - 转账金额, 单位 个

params - 转账参数

返回:

boolean

抛出:

Exception - 异常

validate

boolean validate(String address)

校验地址是否正确

参数:

address - 地址

返回:

boolean true 正确地址