com.jccdex.rpc

类 JccJingtum

java.lang.Object

com.jccdex.rpc.JccJingtum

public class JccJingtum
extends Object

井通公链、联盟链RPC开发接口

作者:

xdjiang, shuonimei

构造器概要

构造器

构造器和说明
JccJingtum(Boolean guomi, ArrayList<String> rpcNodes)
JccJingtum(Integer fee, String baseToken, Boolean guomi, ArrayList<String> rpcNodes) 井通公链、联盟链RPC服务构造函数
JccJingtum(String alphabet, Integer fee, String baseToken, Boolean guomi, ArrayList<String> rpcNodes) 井通公链、联盟链RPC服务构造函数
JccJingtum(String alphabet, Integer fee, String baseToken, String platform, Boolean guomi, ArrayList<String> rpcNodes) 井通公链、联盟链RPC服务构造函数

方法概要

限定符和类型	方法和说明
String	cancleOrderNoCheck(String secret, long pSequence) 快速撤单
String	cancleOrderWithCheck(String secret, long pSequence) 快速撤单并确认
String	createOrderNoCheck(String secret, String pPayToke, String pPayAmount, String pGetToken, String pGetAmount, String memos) 快速挂单，每笔交易不校验是否成功，适用于批量挂单，优点：挂单效率高，缺点：交易成功率无法保证，需要调用者自己进行校验
String	createOrderNoCheck(String secret, String pPayToke, String pPayAmount, String pPayIssuer, String pGetToken, String pGetAmount, String pGetIssuer, String memos) 快速挂单，每笔交易不校验是否成功，适用于批量挂单，优点：挂单效率高，缺点：交易成功率无法保证，需要调用者自己进行校验
String	createOrderWithCheck(String secret, String pPayToke, String pPayAmount, String pGetToken, String pGetAmount, String memos) 挂单并校验，每笔挂单都会校验是否成功，适合普通调用，优点：每笔交易都进行确认，缺点：效率低下
String	createOrderWithCheck(String secret, String pPayToke, String pPayAmount, String pPayIssuer, String pGetToken, String pGetAmount, String pGetIssuer, String memos) 挂单并校验，每笔挂单都会校验是否成功，适合普通调用，优点：每笔交易都进行确认，缺点：效率低下
String	createWallet() 创建钱包(账号)
String	getAddress(String secret) 通过钱包密钥获取钱包地址
String	getAlphabet() 获取钱包字母表
Integer	getFee() 获取每笔交易燃料费
String	getIssuer() 获取银关地址
String	getMemoData(String hexStrMemData) 16进制备注内容直接转换成为字符串(无需Unicode解码)
String	getPlatform() 获取交易平台账号
long	getSequence(String address) 获取sequence
String	paymentNoCheck(String secret, String receiver, String pToken, String pAmount, String memos) 快速转账，每笔交易不校验是否成功，适用于批量转账，优点：转账效率高，缺点：交易成功率无法保证，需要调用者自己进行校验
String	paymentNoCheck(String secret, String receiver, String pToken, String pAmount, String pIssuer, String memos) 快速转账，每笔交易不校验是否成功，适用于批量转账，优点：转账效率高，缺点：交易成功率无法保证，需要调用者自己进行校验
String	paymentWithCheck(String secret, String receiver, String pToken, String pAmount, String memos) 转账并校验，每笔交易都会校验是否成功，适合普通转账，优点：每笔交易都进行确认，缺点：转账效率低下
String	paymentWithCheck(String secret, String receiver, String pToken, String pAmount, String pIssuer, String memos) 转账并校验，每笔交易都会校验是否成功，适合普通转账，优点：每笔交易都进行确认，缺点：转账效率低下
String	requestTx(String hash) 根据hash获取交易详情
void	setFee(Integer fee) 设置每笔交易燃料费
void	setIssuer(String issuer) 设置银关地址
void	setPlatform(String platform) 设置交易平台账号
void	setSequence(String address, long pSequence) 设置sequence
String	setTokenIssue721(String secret, String receiver, String pToken, String pAmount, String pIssuer, String memos) 转账并校验，每笔交易都会校验是否成功，适合普通转账，优点：每笔交易都进行确认，缺点：转账效率低下
void	setTryTimes(int tryTimes) 设置出错尝试次数
SignedTransaction	signWithCancleOrder(String secret, long pSequence, long sequence) 撤单签名
SignedTransaction	signWithCreateOrder(String secret, String pPayToke, String pPayAmount, String pPayIssuer, String pGetToken, String pGetAmount, String pGetIssuer, long sequence, String memos) 挂单签名
SignedTransaction	signWthPayment(String secret, String receiver, String pToken, String pAmount, String pIssuer, long sequence, String memos) 转账交易签名
String	submitBlob(String txBlob) 向节点发送交易请求，并且根据签名得到的hash进行交易确认
String	submitNoCheck(String txBlob) 向节点发送交易请求，并且根据签名得到的hash进行交易确认
String	submitWithCheck(String txBlob, String hash) 向节点发送交易请求，并且根据签名得到的hash进行交易确认
long	transferTime(Long blockTime) 时间戳转换，区块链账本上的时间戳是相对于2000-01-01 08:00:00的偏移时间，换算成当前时间需要转换

从类继承的方法 java.lang.Object

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

构造器详细资料

JccJingtum

public JccJingtum(Boolean guomi,
                  ArrayList<String> rpcNodes)

参数:

rpcNodes - rpc节点服务器地址列表

guomi - 是否国密链

JccJingtum

public JccJingtum(Integer fee,
                  String baseToken,
                  Boolean guomi,
                  ArrayList<String> rpcNodes)

井通公链、联盟链RPC服务构造函数

参数:

fee - 每笔交易燃料费(fee取值范围为10-1000000000的整数,燃料费计算公式=fee/1000000,)

baseToken - 交易燃料手续费通证,也是公链的本币

guomi - 是否国密链

rpcNodes - rpc节点服务器地址列表

JccJingtum

public JccJingtum(String alphabet,
                  Integer fee,
                  String baseToken,
                  Boolean guomi,
                  ArrayList<String> rpcNodes)

井通公链、联盟链RPC服务构造函数

参数:

alphabet - 字母表，每一条联盟链都可以用不同的或者相同alphabet

fee - 每笔交易燃料费(fee取值范围为10-1000000000的整数,燃料费计算公式=fee/1000000,)

baseToken - 交易燃料手续费通证,也是公链的本币

guomi - 是否国密链

rpcNodes - rpc节点服务器地址列表

JccJingtum

public JccJingtum(String alphabet,
                  Integer fee,
                  String baseToken,
                  String platform,
                  Boolean guomi,
                  ArrayList<String> rpcNodes)

井通公链、联盟链RPC服务构造函数

参数:

alphabet - 字母表，每一条联盟链都可以用不同的或者相同alphabet

fee - 每笔交易燃料费(fee取值范围为10-1000000000的整数,燃料费计算公式=fee/1000000,)

baseToken - 交易燃料手续费通证,也是公链的本币

platform - 交易的平台账号(与手续费有关)

guomi - 是否国密链

rpcNodes - rpc节点服务器地址列表

方法详细资料

setFee

public void setFee(Integer fee)
            throws Exception

设置每笔交易燃料费

参数:

fee - 每笔交易燃料费(fee取值范围为10-1000000000的整数,燃料费计算公式=fee/1000000,)

抛出:

Exception

getFee

public Integer getFee()

获取每笔交易燃料费

返回:

每笔交易燃料费

setPlatform

public void setPlatform(String platform)
                 throws Exception

设置交易平台账号

参数:

platform - 交易平台账号

抛出:

Exception

getPlatform

public String getPlatform()

获取交易平台账号

返回:

交易平台账号

setIssuer

public void setIssuer(String issuer)
               throws Exception

设置银关地址

参数:

issuer - 银关地址

抛出:

Exception

getIssuer

public String getIssuer()

获取银关地址

返回:

银关地址

getAlphabet

public String getAlphabet()

获取钱包字母表

返回:

钱包字母表

createWallet

public String createWallet()
                    throws Exception

创建钱包(账号)

返回:

钱包字符串,json格式 ({"secret":****,"address":****})

抛出:

Exception - 抛出异常

getAddress

public String getAddress(String secret)
                  throws Exception

通过钱包密钥获取钱包地址

参数:

secret - 钱包密钥

返回:

钱包地址

抛出:

Exception - 抛出异常

setTryTimes

public void setTryTimes(int tryTimes)

设置出错尝试次数

参数:

tryTimes - 次数

getSequence

public long getSequence(String address)
                 throws Exception

获取sequence

参数:

address - 钱包地址

返回:

sequence

抛出:

Exception - 抛出异常

setSequence

public void setSequence(String address,
                        long pSequence)
                 throws Exception

设置sequence

参数:

address - 钱包地址

pSequence - 交易序列号

抛出:

Exception - 抛出异常

requestTx

public String requestTx(String hash)
                 throws Exception

根据hash获取交易详情

参数:

hash - 交易hash

返回:

交易详情 json格式

抛出:

Exception - 抛出异常

getMemoData

public String getMemoData(String hexStrMemData)
                   throws Exception

16进制备注内容直接转换成为字符串(无需Unicode解码)

参数:

hexStrMemData - 16进制备注内容

返回:

备注内容

抛出:

Exception - 抛出异常

transferTime

public long transferTime(Long blockTime)

时间戳转换，区块链账本上的时间戳是相对于2000-01-01 08:00:00的偏移时间，换算成当前时间需要转换

参数:

blockTime - 区块链账本上的时间戳

返回:

标准时间戳(秒)

paymentWithCheck

public String paymentWithCheck(String secret,
                               String receiver,
                               String pToken,
                               String pAmount,
                               String memos)
                        throws Exception

转账并校验，每笔交易都会校验是否成功，适合普通转账，优点：每笔交易都进行确认，缺点：转账效率低下

参数:

secret - 发送者钱包密钥

receiver - 接收者钱包地址

pToken - 转账Token

pAmount - 转账数量

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception - 抛出异常

paymentWithCheck

public String paymentWithCheck(String secret,
                               String receiver,
                               String pToken,
                               String pAmount,
                               String pIssuer,
                               String memos)
                        throws Exception

转账并校验，每笔交易都会校验是否成功，适合普通转账，优点：每笔交易都进行确认，缺点：转账效率低下

参数:

secret - 发送者钱包密钥

receiver - 接收者钱包地址

pToken - 转账Token

pAmount - 转账数量

pIssuer - 银关地址

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception - 抛出异常

paymentNoCheck

public String paymentNoCheck(String secret,
                             String receiver,
                             String pToken,
                             String pAmount,
                             String memos)
                      throws Exception

快速转账，每笔交易不校验是否成功，适用于批量转账，优点：转账效率高，缺点：交易成功率无法保证，需要调用者自己进行校验

参数:

secret - 发送者钱包密钥

receiver - 接收者钱包地址

pToken - 转账Token

pAmount - 转账数量

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception - 抛出异常

paymentNoCheck

public String paymentNoCheck(String secret,
                             String receiver,
                             String pToken,
                             String pAmount,
                             String pIssuer,
                             String memos)
                      throws Exception

快速转账，每笔交易不校验是否成功，适用于批量转账，优点：转账效率高，缺点：交易成功率无法保证，需要调用者自己进行校验

参数:

secret - 发送者钱包密钥

receiver - 接收者钱包地址

pToken - 转账Token

pAmount - 转账数量

pIssuer - 银关地址

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception - 抛出异常

createOrderWithCheck

public String createOrderWithCheck(String secret,
                                   String pPayToke,
                                   String pPayAmount,
                                   String pGetToken,
                                   String pGetAmount,
                                   String memos)
                            throws Exception

挂单并校验，每笔挂单都会校验是否成功，适合普通调用，优点：每笔交易都进行确认，缺点：效率低下

参数:

secret - 挂单方钱包密钥

pPayToke - 挂单方支付的Token名称

pPayAmount - 挂单方支付的Token数量

pGetToken - 挂单方期望得到的Token名称

pGetAmount - 挂单方期望得到的Token数量

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception

createOrderWithCheck

public String createOrderWithCheck(String secret,
                                   String pPayToke,
                                   String pPayAmount,
                                   String pPayIssuer,
                                   String pGetToken,
                                   String pGetAmount,
                                   String pGetIssuer,
                                   String memos)
                            throws Exception

挂单并校验，每笔挂单都会校验是否成功，适合普通调用，优点：每笔交易都进行确认，缺点：效率低下

参数:

secret - 挂单方钱包密钥

pPayToke - 挂单方支付的Token名称

pPayAmount - 挂单方支付的Token数量

pPayIssuer - 挂单方支付的Token的银关地址

pGetToken - 挂单方期望得到的Token名称

pGetAmount - 挂单方期望得到的Token数量

pGetIssuer - 挂单方期望得到的Token的银关地址

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception

createOrderNoCheck

public String createOrderNoCheck(String secret,
                                 String pPayToke,
                                 String pPayAmount,
                                 String pGetToken,
                                 String pGetAmount,
                                 String memos)
                          throws Exception

快速挂单，每笔交易不校验是否成功，适用于批量挂单，优点：挂单效率高，缺点：交易成功率无法保证，需要调用者自己进行校验

参数:

secret - 挂单方钱包密钥

pPayToke - 挂单方支付的Token名称

pPayAmount - 挂单方支付的Token数量

pGetToken - 挂单方期望得到的Token名称

pGetAmount - 挂单方期望得到的Token数量

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception

createOrderNoCheck

public String createOrderNoCheck(String secret,
                                 String pPayToke,
                                 String pPayAmount,
                                 String pPayIssuer,
                                 String pGetToken,
                                 String pGetAmount,
                                 String pGetIssuer,
                                 String memos)
                          throws Exception

快速挂单，每笔交易不校验是否成功，适用于批量挂单，优点：挂单效率高，缺点：交易成功率无法保证，需要调用者自己进行校验

参数:

secret - 挂单方钱包密钥

pPayToke - 挂单方支付的Token名称

pPayAmount - 挂单方支付的Token数量

pPayIssuer - 挂单方支付的Token的银关地址

pGetToken - 挂单方期望得到的Token名称

pGetAmount - 挂单方期望得到的Token数量

pGetIssuer - 挂单方期望得到的Token的银关地址

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception

cancleOrderNoCheck

public String cancleOrderNoCheck(String secret,
                                 long pSequence)
                          throws Exception

快速撤单

参数:

secret - 钱包密钥

pSequence - 挂单序列号

返回:

交易详情 json格式

抛出:

Exception

cancleOrderWithCheck

public String cancleOrderWithCheck(String secret,
                                   long pSequence)
                            throws Exception

快速撤单并确认

参数:

secret - 钱包密钥

pSequence - 挂单序列号

返回:

交易详情 json格式

抛出:

Exception

setTokenIssue721

public String setTokenIssue721(String secret,
                               String receiver,
                               String pToken,
                               String pAmount,
                               String pIssuer,
                               String memos)
                        throws Exception

转账并校验，每笔交易都会校验是否成功，适合普通转账，优点：每笔交易都进行确认，缺点：转账效率低下

参数:

secret - 发送者钱包密钥

receiver - 接收者钱包地址

pToken - 转账Token

pAmount - 转账数量

pIssuer - 银关地址

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception - 抛出异常

submitWithCheck

public String submitWithCheck(String txBlob,
                              String hash)
                       throws Exception

向节点发送交易请求，并且根据签名得到的hash进行交易确认

参数:

txBlob - 交易信息

hash - hash

返回:

交易信息

抛出:

Exception - 抛出异常

submitNoCheck

public String submitNoCheck(String txBlob)
                     throws Exception

向节点发送交易请求，并且根据签名得到的hash进行交易确认

参数:

txBlob - 交易信息

返回:

交易信息

抛出:

Exception - 抛出异常

submitBlob

public String submitBlob(String txBlob)
                  throws Exception

向节点发送交易请求，并且根据签名得到的hash进行交易确认

参数:

txBlob - 交易信息

返回:

交易信息

抛出:

Exception - 抛出异常

signWthPayment

public SignedTransaction signWthPayment(String secret,
                                        String receiver,
                                        String pToken,
                                        String pAmount,
                                        String pIssuer,
                                        long sequence,
                                        String memos)
                                 throws Exception

转账交易签名

参数:

secret - 发送者钱包密钥

receiver - 接收者钱包地址

pToken - 转账Token

pAmount - 转账数量

pIssuer - 银关地址

sequence - 交易序列号

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception - 抛出异常

signWithCreateOrder

public SignedTransaction signWithCreateOrder(String secret,
                                             String pPayToke,
                                             String pPayAmount,
                                             String pPayIssuer,
                                             String pGetToken,
                                             String pGetAmount,
                                             String pGetIssuer,
                                             long sequence,
                                             String memos)
                                      throws Exception

挂单签名

参数:

secret - 挂单方钱包密钥

pPayToke - 挂单方支付的Token名称

pPayAmount - 挂单方支付的Token数量

pPayIssuer - 挂单方支付的Token的银关地址

pGetToken - 挂单方期望得到的Token名称

pGetAmount - 挂单方期望得到的Token数量

pGetIssuer - 挂单方期望得到的Token的银关地址

sequence - 交易序列号

memos - 交易备注(无就传"")

返回:

交易详情 json格式

抛出:

Exception

signWithCancleOrder

public SignedTransaction signWithCancleOrder(String secret,
                                             long pSequence,
                                             long sequence)
                                      throws Exception

撤单签名

参数:

secret - 钱包密钥

pSequence - 挂单序列号

sequence - 交易序列号

返回:

交易详情 json格式

抛出:

Exception