wallet/

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/lianxiangcloud/linkchain

Links

Open Source Insights

README ¶

隐私链钱包客户端

隐私链钱包客户端

编译

make

依赖

依赖 libxcrypto.a 库文件

启动钱包客户端

cd sbin && ./wallet.sh start

停止钱包客户端

./wallet.sh stop

测试账户

当钱包连接到测试网络对应的peer节点时（peer test模式运行），可以使用测试账户0xa73810e519e1075010678d706533486d8ecc8000,然后执行personal_unlockAccount命令进行解锁账户

cp ../tests/UTC--2019-07-08T10-03-04.871669363Z--a73810e519e1075010678d706533486d8ecc8000 ./testdata/keystore/

RPC接口

钱包默认RPC端口为 18082，也可自己修改启动参数指定

ltk_blockHeight

功能：获取钱包当前同步的区块高度
参数：
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
remote_height 字符串，十六进制，链节点高度
local_height 字符串，十六进制，钱包处理区块高度
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_blockHeight","params":["0xa73810e519e1075010678d706533486d8ecc8000"]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "id" : "0",
   "result" : {
      "local_height" : "0x1",
      "remote_height" : "0x1"
   }
}

ltk_createSubAccount

功能：按指定最大子地址数，创建子账户
参数：
maxSubIdx 字符串，十六进制最大子账户数
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
bool 执行是否成功示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_createSubAccount","params":["0x2"]}' -H 'Content-Type: application/json'|json_pp
{
   "id" : "0",
   "jsonrpc" : "2.0",
   "result" : true
}

ltk_balance

功能：查询余额
参数： index 字符串，十六进制，子账户序号
token 字符串，十六进制，资产token标识，默认为"0x0000000000000000000000000000000000000000" 链克
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
balance 字符串，十六进制，账户余额
address 账户地址，可以作为签交易的to地址
token 字符串，十六进制，资产token标识
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_balance","params":[{"index":"0x0","token":"0x0000000000000000000000000000000000000000"}]}' -H 'Content-Type: application/json'|json_pp
{
   "id" : "0",
   "result" : {
      "balance" : "0x3fe0b6f90fc000",
      "token" : "0x0000000000000000000000000000000000000000",
      "address" : "bwcJ9V3z7uW1fbYm2L6HuCGiuaTSVr5dq7ir49ViFBNeYYQqMuUM6S16aWKz4HmGRFGDb5RnfVBv7uGeySjkzUkmEbGKRN"
   },
   "jsonrpc" : "2.0"
}

ltk_getAccountInfo

功能：查询所有子账户信息
参数：
token 字符串，十六进制，资产token标识，默认为"0x0000000000000000000000000000000000000000" 链克
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
total_balance 账户总余额 token 字符串，十六进制，资产token标识，默认为"0x0000000000000000000000000000000000000000" 链克
eth_account 以太坊账户列表
address 账户地址
balance 账户余额 wei
nonce 账户nonce值

utxo_accounts账户信息列表
index 子账户序号
balance 账户余额
address 账户地址，可以作为签交易的to地址
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getAccountInfo","params":["0x0000000000000000000000000000000000000000"]}' -H 'Content-Type: application/json'|json_pp
{
   "result" : {
      "token" : "0x0000000000000000000000000000000000000000",
      "total_balance" : "0x1ed09bead87bfe65a1de98e51aa8b",
      "eth_account" : {
         "address" : "0xa73810e519e1075010678d706533486d8ecc8000",
         "balance" : "0x1ed09bead87bfd9c0bffaf7d85243",
         "nonce" : "0x75"
      },
      "utxo_accounts" : [
         {
            "balance" : "0x1f78f21ce1c600",
            "address" : "bwcJ9V3z7uW1fbYm2L6HuCGiuaTSVr5dq7ir49ViFBNeYYQqMuUM6S16aWKz4HmGRFGDb5RnfVBv7uGeySjkzUkmEbGKRN",
            "index" : "0x0"
         },
         {
            "address" : "oRWauC7hnjcupPN2UMzT3fTVpv99jv2ZEmr4QV6kYjG8XaeWHTNBRXeQq2yeEHgbm85Zqu6DBjTLYZxPEJUwRugrgeUkyY",
            "index" : "0x1",
            "balance" : "0x1ff05b7c87e000"
         }
      ]
   }
   "id" : "0",
   "jsonrpc" : "2.0"
}

ltk_selectAddress

功能：设置当前钱包默认账户地址
参数：
address 十六进制字符串，账户地址
返回：
true 设置成功，false 设置失败
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"ltk_selectAddress","params":["0xa73810e519e1075010678d706533486d8ecc8000"],"id":67}' -H 'Content-Type:application/json' |json_pp
{
   "id" : 67,
   "jsonrpc" : "2.0",
   "result" : true
}

ltk_setRefreshBlockInterval

功能：设置钱包获取新区块高度的间隔参数：
interval 正整数，十进制，区块刷新间隔，单位：秒
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
true 设置成功，false 设置失败
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"ltk_setRefreshBlockInterval","params":[15],"id":0}' -H 'Content-Type:application/json' |json_pp
{
   "id" : 0,
   "result" : true,
   "jsonrpc" : "2.0"
}

ltk_autoRefreshBlockchain

功能：设置钱包自动刷新区块数据属性
参数：
true 允许自动刷新，false 禁止自动刷新
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
true 设置成功，false 设置失败
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"ltk_autoRefreshBlockchain","params":[true],"id":67}' -H 'Content-Type:application/json' |json_pp
{
   "result" : true,
   "id" : 67,
   "jsonrpc" : "2.0"
}

ltk_rescanBlockchain

功能：重新扫描区块(对当前选中的账户生效)
参数：
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
true 设置成功，false 设置失败
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_rescanBlockchain","params":[]}' -H 'Content-Type: application/json'|json_pp
{
   "id" : "0",
   "jsonrpc" : "2.0",
   "result" : true
}

ltk_status

功能：获取钱包当前状态
参数：
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
local_height 字符串，十六进制，钱包同步的区块高度
remote_height 字符串，十六进制，连接的peer节点高度
init_block_height 字符串，十六进制，peer初始化高度
eth_address 当前解锁的钱包地址
auto_refresh 是否自动刷新区块数据
wallet_open 钱包是否解锁了账户
wallet_version 钱包当前版本号
chain_version 链节点版本号
refresh_block_interval 账户刷新区块间隔秒数
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_status","params":[]}' -H 'Content-Type: application/json'|json_pp
{
   "result" : {
      "local_height" : "0x2f6",
      "refresh_block_interval" : 5,
      "wallet_version" : "0.1.0",
      "chain_version" : "0.1.0",
      "auto_refresh" : false,
      "eth_address" : "0xa73810e519e1075010678d706533486d8ecc8000",
      "remote_height" : "0x2f8",
      "init_block_height" : "0x109295",
      "wallet_open" : true
   },
   "jsonrpc" : "2.0",
   "id" : "0"
}

ltk_signUTXOTransaction

功能：生成交易签名，可以使用隐私链节点的 send_raw_transaction 接口发送交易
参数：
from 字符串以太坊from地址(使用以太坊账户转账必填,from字段不填，默认使用utxo账户签交易)
nonce 字符串，十六进制以太坊账户nonce序号 (使用以太坊账户转账必填)
token 字符串，十六进制，资产token标识，默认为"0x0000000000000000000000000000000000000000" 链克
subaddrs 可以作为input的子账户序号数组(使用utxo账户转账,选填,默认可以使用所有子账户余额)
dests 转账目标用户，to地址与金额，可以是数组(如果是调用以太坊合约，可以带data字段)
dest结构示例：

//转账目标为utxo
{
	"addr": "bwcJ9V3z7uW1fbYm2L6HuCGiuaTSVr5dq7ir49ViFBNeYYQqMuUM6S16aWKz4HmGRFGDb5RnfVBv7uGeySjkzUkmEbGKRN",
	"amount": "0x56bc75e2d63100000", //十六进制字符串
	"remark": "0x9900000009" //附加交易留言，可选，最多32字节有效
},
//转账目标为以太坊账户或者合约
{
	"addr": "0xe50ab035b1cc691b84e415ff0931867f6a71b091",
	"amount": "0x56bc75e2d63100000", //十六进制字符串
	"data": "0x123344"//合约参数，可选
}

返回：txs 数组
raw 交易raw
hash 交易hash
gas 本次交易花费的gas值 err_msg 交易错误信息 err_code 交易错误码，0表示没有错误示例：

#account 转 单utxo
curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_signUTXOTransaction","params":[{"from":"0xa73810e519e1075010678d706533486d8ecc8000","nonce":"0x0","dests":[{"addr":"bwcJ9V3z7uW1fbYm2L6HuCGiuaTSVr5dq7ir49ViFBNeYYQqMuUM6S16aWKz4HmGRFGDb5RnfVBv7uGeySjkzUkmEbGKRN","amount":"0x21e19e0c9bab2400000","remark":"0xa73810e519e1075010678d706533486d8ecc8000"}]}]}' -H 'Content-Type: application/json'|json_pp

{
   "jsonrpc" : "2.0",
   "id" : "0",
   "result" : {
      "txs" : [
         {
            "hash" : "0x4a45b985a6948b8ef46b6d0521d8cdd8bf28fbd9511f9204027a62002854bab9",
            "raw" : "0xf904ccf857cf4852c16c32...",
            "gas" : "0x1dcd6500"
         }
      ]
   }
}

#account 转 多utxo
curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_signUTXOTransaction","params":[{"from":"0xa73810e519e1075010678d706533486d8ecc8000","nonce":"0x1","dests":[{"addr":"bwcJ9V3z7uW1fbYm2L6HuCGiuaTSVr5dq7ir49ViFBNeYYQqMuUM6S16aWKz4HmGRFGDb5RnfVBv7uGeySjkzUkmEbGKRN","amount":"0x21e19e0c9bab2400000"},{"addr":"oRWauC7hnjcupPN2UMzT3fTVpv99jv2ZEmr4QV6kYjG8XaeWHTNBRXeQq2yeEHgbm85Zqu6DBjTLYZxPEJUwRugrgeUkyY","amount":"0x21e19e0c9bab2400000","remark":"0x9900000009"}]}]}' -H 'Content-Type: application/json'|json_pp

#utxo账户转单utxo账户
curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_signUTXOTransaction","params":[{"subaddrs":[0],"dests":[{"addr":"oRWauC7hnjcupPN2UMzT3fTVpv99jv2ZEmr4QV6kYjG8XaeWHTNBRXeQq2yeEHgbm85Zqu6DBjTLYZxPEJUwRugrgeUkyY","amount":"0x4563918244f40000"}]}]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "id" : "0",
   "result" : {
      "tx" : [
         {
            "hash" : "0x00b42cd0f53c32098e74b0170460130ebe291b4497c8dbf4bbd2f9741039e0a4",
            "raw" : "0xf9063deb10c698b1d373...",
            "gas" : "0x7a120",
            "err_msg" : "",
            "err_code" : 0
         }
      ]
   }
}

#utxo 转 utxo
curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_signUTXOTransaction","params":[{"subaddrs":[0],"dests":[{"addr":"oRWauC7hnjcupPN2UMzT3fTVpv99jv2ZEmr4QV6kYjG8XaeWHTNBRXeQq2yeEHgbm85Zqu6DBjTLYZxPEJUwRugrgeUkyY","amount":"0x4563918244f40000"}]}]}' -H 'Content-Type: application/json'|json_pp

#utxo 转 单account
curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_signUTXOTransaction","params":[{"subaddrs":[0],"dests":[{"addr":"0xe50ab035b1cc691b84e415ff0931867f6a71b091","amount":"0x4563918244f40000","data":"0x123344"}]}]}' -H 'Content-Type: application/json'|json_pp

#utxo 转 单account+utxo
curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_signUTXOTransaction","params":[{"subaddrs":[0],"dests":[{"addr":"oRWauC7hnjcupPN2UMzT3fTVpv99jv2ZEmr4QV6kYjG8XaeWHTNBRXeQq2yeEHgbm85Zqu6DBjTLYZxPEJUwRugrgeUkyY","amount":"0x4563918244f40000"},{"addr":"0xe50ab035b1cc691b84e415ff0931867f6a71b091","amount":"0x4563918244f40000","data":"0x123344"}]}]}' -H 'Content-Type: application/json'|json_pp

#utxo 转 多utxo
curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_signUTXOTransaction","params":[{"subaddrs":[0],"dests":[{"addr":"oRWauC7hnjcupPN2UMzT3fTVpv99jv2ZEmr4QV6kYjG8XaeWHTNBRXeQq2yeEHgbm85Zqu6DBjTLYZxPEJUwRugrgeUkyY","amount":"0x4563918244f40000"},{"addr":"bwcJ9V3z7uW1fbYm2L6HuCGiuaTSVr5dq7ir49ViFBNeYYQqMuUM6S16aWKz4HmGRFGDb5RnfVBv7uGeySjkzUkmEbGKRN","amount":"0x4563918244f40000"}]}]}' -H 'Content-Type: application/json'|json_pp

ltk_signHash

功能：通过钱包对hash值进行签名参数： address 解锁的钱包账户 hash hash数据返回：签名后的signature 示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"ltk_signHash","params":["0xa73810e519e1075010678d706533486d8ecc8000","0xb7804371ebae4e9dc99e306e835f96f7056f87c0178730bbdb86e7b0a1ea6717"],"id":67}' -H 'Content-Type:application/json' |json_pp
{
	"id" : 67,
	"jsonrpc" : "2.0",
	"result" : "0xe3f70a209f0b38c06d26333915acc705561e1fc0a7b088e22470ff134fe61a312a6f594a320bd15c355bcae57fd9892cad04eeba2b51d09646daab5596d1465700"
}

ltk_sendUTXOTransaction

功能：直接通过钱包发送交易，返还交易hash与交易数据（ltk_sendUTXOTransaction接口，只能发送一笔交易，如果一次转账被拆分成多个子交易，需要使用ltk_sendUTXOTransactionSplit接口）
参数：同 ltk_signUTXOTransaction
返回： raw 交易raw数组
hash 对应的交易hash数组
err_code 错误码 0 没有错误
err_msg 错误信息
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_sendUTXOTransaction","params":[{"subaddrs":[0],"dests":[{"addr":"bwcJ9V3z7uW1fbYm2L6HuCGiuaTSVr5dq7ir49ViFBNeYYQqMuUM6S16aWKz4HmGRFGDb5RnfVBv7uGeySjkzUkmEbGKRN","amount":"0x9900000009"}]}]}' -H 'Content-Type: application/json'|json_pp
{
   "id" : "0",
   "jsonrpc" : "2.0",
   "result" : {
      "tx" : [
         {
            "hash" : "0x821c89178db0dc87d96f6bd1cdd71552660b7b8d1b3d24e19894cf8209a14b44",
            "err_code" : 0,
            "err_msg" : "",
            "raw" : "f90c0c80f..."
         }
      ]
   }
}

ltk_sendUTXOTransactionSplit

功能：直接通过钱包发送交易，返还交易hash与交易数据（如果一次转账被拆分成多个子交易，需要使用ltk_sendUTXOTransactionSplit接口）
参数：同 eth_signUTXOTransaction
返回： raw 交易raw数组
hash 对应的交易hash数组
err_code 错误码 0 没有错误
err_msg 错误信息
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_sendUTXOTransactionSplit","params":[{"subaddrs":[0],"dests":[{"addr":"bwcJ9V3z7uW1fbYm2L6HuCGiuaTSVr5dq7ir49ViFBNeYYQqMuUM6S16aWKz4HmGRFGDb5RnfVBv7uGeySjkzUkmEbGKRN","amount":"0x9900000009"}]}]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "result" : {
      "tx" : [
         {
            "err_code" : -1,
            "raw" : "f90c0c80f...",
            "err_msg" : "double spend",
            "hash" : "0x0000000000000000000000000000000000000000000000000000000000000000"
         }
      ]
   },
   "id" : "0"
}

ltk_getTxKey

功能：获取交易私钥
参数：
交易hash
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
交易私钥字符串
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"ltk_getTxKey","params":["0xbd7c414769329e6c7511ffcba8567349310da0db8ff4703ed35a8cd471fd2a68"],"id":67}' -H 'Content-Type:application/json' |json_pp
{
   "jsonrpc" : "2.0",
   "id" : 67,
   "result" : "0xe1793e7859af982be02ba0fe288ac2a9a881c0c179833015c68951fe3e00dc0c"
}

ltk_getMaxOutput

功能：获取交易私钥
参数：
tokenID string，0x0000000000000000000000000000000000000000 表示链克
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
maxOutput 字符串,十六进制。该token对应的output个数。
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"ltk_getMaxOutput","params":["0x0000000000000000000000000000000000000000"],"id":67}' -H 'Content-Type:application/json' |json_pp
{
   "jsonrpc" : "2.0",
   "result" : "0x35",
   "id" : 67
}

personal_newAccount

功能：创建一个钱包账户
参数： password 钱包密码
返回：以太坊格式钱包地址，钱包文件保持在keystore目录下
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"personal_newAccount","params":["1234","my name is lihua"],"id":67}' -H 'Content-Type:application/json' |json_pp
{
   "id" : 67,
   "result" : "0xe2c3f791a6fbc16252333fa5c89b5bcff9cf27ea",
   "jsonrpc" : "2.0"
}

personal_getCue

功能：获取钱包密钥线索
参数： address 钱包账户地址
返回：创建钱包账户时的密码提示信息
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"personal_getCue","params":["0xe2c3f791a6fbc16252333fa5c89b5bcff9cf27ea"],"id":1}' -H 'Content-Type:application/json' |json_pp
{
   "id" : 1,
   "result" : "my name is lihua",
   "jsonrpc" : "2.0"
}

personal_listAccounts

功能：查看钱包列表
参数：
返回：
保持在keystore目录下的以太坊格式钱包地址列表
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"personal_listAccounts","params":[],"id":67}' -H 'Content-Type:application/json' |json_pp
{
   "id" : 67,
   "jsonrpc" : "2.0",
   "result" : [
      "0xad2f67755eca0a24e7c587a2f494652bafe82c89",
      "0x67fa55ace3288da59d4e57c70ed97f04500d8000",
      "0x177a2ab1ffb9b6ba2b2de14abcc7e47d67d94c60"
   ]
}

personal_unlockAccount

功能：解锁一个钱包账户
参数：
address 以太坊钱包地址
password 钱包密码
duration 解锁时间，单位秒
返回：
true 解锁成功
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","method":"personal_unlockAccount","params":["0xa73810e519e1075010678d706533486d8ecc8000","1234",3600],"id":67}' -H 'Content-Type:application/json' |json_pp
{
   "result" : true,
   "id" : 67,
   "jsonrpc" : "2.0"
}

personal_lockAccount

功能：锁定一个钱包账户
参数：
address 以太坊钱包地址
返回：
true 锁定成功
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"personal_lockAccount","params":["0xa73810e519e1075010678d706533486d8ecc8000"]}' -H 'Content-Type: application/json'|json_pp
{
   "result" : true,
   "jsonrpc" : "2.0",
   "id" : "0"
}

ltk_getProofKey

功能：获取交易验证私钥参数：
hash 交易hash
addr utxo地址 eth_addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
proof_key 字符串示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getProofKey","params":[{"addr":"oRTryuuZqwvd7kyWX8vPjKYyUD7M2Vmt82gvgqb5DzHme1tWSpwdenqoV9X72ExsSRAYfr1k471tmUWG9cFPRbDiZcQHmr","hash":"0x5ceeeab09fa5fabd52fc2f4c966b75c7ed2cf41e64f51057d8f22a553363ba12"}]}' -H 'Content-Type: application/json'|json_reformat
{
    "jsonrpc": "2.0",
    "id": "0",
    "result": {
        "proof_key": "086465f04dc90d5aaae3099e1f740431706c04cd6479d61f2d205c76a7177736"
    }
}

ltk_checkProofKey

功能：验证交易是否包含转账参数：
hash 交易hash
addr utxo地址
key 验证私钥
eth_addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：
hash 交易hash addr 收款utxo地址 amount 金额示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_checkProofKey","params":[{"addr":"oRTryuuZqwvd7kyWX8vPjKYyUD7M2Vmt82gvgqb5DzHme1tWSpwdenqoV9X72ExsSRAYfr1k471tmUWG9cFPRbDiZcQHmr","hash":"0x5ceeeab09fa5fabd52fc2f4c966b75c7ed2cf41e64f51057d8f22a553363ba12","key":"086465f04dc90d5aaae3099e1f740431706c04cd6479d61f2d205c76a7177736"}]}' -H 'Content-Type: application/json'|json_reformat
{
    "jsonrpc": "2.0",
    "id": "0",
    "result": {
        "records": [
            {
                "hash": "0x5ceeeab09fa5fabd52fc2f4c966b75c7ed2cf41e64f51057d8f22a553363ba12",
                "addr": "9tCfNdQ4VKsFN8f2fKioqhHVQCjF2UREfUsxWZd8tmS96MBRt6qho4xRpvS2fGd8yQUZ9CTEQVeQcczyzSu53fHQKZLUARs",
                "amount": "0x635c9adc5dea00000"
            }
        ]
    }
}

ltk_getBlockTransactionCountByNumber

功能：查询区块中交易数
参数：
blockNumber 字符串，十六进制区块高度
返回：
txCount 字符串，十六进制区块中包含的交易数
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getBlockTransactionCountByNumber","params":["0x2"]}' -H 'Content-Type: application/json'|json_pp  
{
   "id" : "0",
   "jsonrpc" : "2.0",
   "result" : "0x1"
}

ltk_getBlockTransactionCountByHash

功能：查询区块中交易数
参数：
blockHash 字符串，十六进制区块哈希
返回：
txCount 字符串，十六进制区块中包含的交易数
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getBlockTransactionCountByHash","params":["0x93de14f0a3ecc931f508bd155d67d79c59146c18caf48573cfa45dbc8b7556d8"]}' -H 'Content-Type: application/json'|json_pp  
{
   "id" : "0",
   "jsonrpc" : "2.0",
   "result" : "0x1"
}

ltk_getTransactionByBlockNumberAndIndex

功能：查询区块中交易数
参数：
blockHash 字符串，十六进制区块哈希
返回：
txCount 字符串，十六进制区块中包含的交易数
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getTransactionByBlockNumberAndIndex","params":["0x1","0x0"]}' -H 'Content-Type: application/json'|json_pp  
{
   "jsonrpc" : "2.0",
   "id" : "0",
   "result" : {
      "txEntry" : {
         "txIndex" : "0",
         "blockHeight" : "1",
         "blockHash" : "0x93de14f0a3ecc931f508bd155d67d79c59146c18caf48573cfa45dbc8b7556d8"
      },
      "txType" : "utx",
      "txHash" : "0x2f9c05caefe4372118d951a58e5f6992c597d0bb063b63d3aa0399c0f1e520d6",
      "tx" : {
         "type" : "utx",
         "value" : {
            "extra" : null,
            "outputs" : [
               {
                  "value" : {
                     "otaddr" : "hRR7vvCs/ZZ2abg10OHQzFPMpKVFm44OFF9J9jugYXo=",
                     "amount" : 0,
                     "remark" : "0Eo0CGfbfd2z8CHVbsFIJqACxHA+mClvWVV2E/VCHxY="
                  },
                  "type" : "UTXOOutput"
               }
            ],
            "r_key" : "YX5tj5ADji5N+pN1GHEQi6wKMg+hJFJU84TLmSIXyxI=",
            "rct_signature" : {
               "P" : {
                  "RangeSigs" : null,
                  "MGs" : null,
                  "PseudoOuts" : null,
                  "Ss" : null,
                  "Bulletproofs" : [
                     {
                        "Aa" : "z0GgaCbTDtZLVIRxBVsKwov0bYai8NBMv7Iv52XjCwU=",
                        "T1" : "92cTIcIZfw/tBb/rX3t806gXV1t/2Ntfg3lK2P9M5ck=",
                        "A" : "NGwZhk7+TT2ie/ZiLNgV3OJ4sP9I1oEv5a2dNF3Mpzo=",
                        "Taux" : "v54uVTgmrWWSupA2YY8fNc/8U370OaGemUm7vLrVxgQ=",
                        "T2" : "nsHok3PJG2kLhdhjoaQFNelsqMQJuojQxL5VyoN9gts=",
                        "S" : "G1di0pUV40UuRFbeVW6MnEJjFT882XaQrJAaUIzKmtk=",
                        "B" : "IjDfHztddRZBRqkAFMbvEeVgWZFHJmk7LCrFBusqiQg=",
                        "Mu" : "qcA0IgMS1bm8Weto3bZ+DIDqQS/qLB12uSSVhVxlfgI=",
                        "R" : [
                           "udH5Sy8pL795/N+Pe+yqDNarxGqxx/Tb8ooxf04O+yo=",
                           "RlzAq9Nzr3UkC1PPMxq8ZKl85abmfv3Cj+4D8Nbpx34=",
                           "ql34CNfS4CjJ6sHJJtxLg261I9L+jIsc9qdbt8LqDQU=",
                           "PAAIQO8jnfmpube7YeFJ9oXL4VdCy+UxNAhSPpPiFvk=",
                           "geI7ysA0KFimi4lh/8Ug99DfK3je/COPTsylIUBlTp8=",
                           "dd3XLnsiMgbGd51VG5gSL8JHwhdSqkYLbbx81FKiZ2M=",
                           "ddqkCygAoq/Ph0VOpwTeGmeE74K+PwfGXNYXVjprhH4="
                        ],
                        "L" : [
                           "gWV5p3WvZFInut+BN0/fvEPg6S02vPGkTBG6Ok2RW3M=",
                           "urK2YqXys4QsQY3S0BdAY3/OmJecVqGBULD6DIphkNU=",
                           "4eMC1HJIaXAXfxLLtPRx9SZcJsuJVJ1O9BB8BZixPdQ=",
                           "o/efGtzKxm6HgbpfFCDnOd/elcsDSN2F9CJy37yBfns=",
                           "T+6+xybn02B+kTfma8JZfp52qylD6Sjsm57mOlbG3MM=",
                           "agFNcH5VJ7n2BhVuQBvZyFrE+dujLJAZXer5ZtBDZYI=",
                           "JUjP7a/Vp+nOrXNHEZR6D2a1BVeGOyhoUx+xeAckpFU="
                        ],
                        "T" : "JjPniUObCVkEKnUp5mW29YusoFx21nZLTh2nsNET8w4="
                     }
                  ]
               },
               "RctSigBase" : {
                  "OutPk" : [
                     {
                        "Mask" : "ypDcUwW0mzj7sDEQ0m9CkkhUlPT3HHQOdUbYrY7zeMQ=",
                        "Dest" : "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
                     }
                  ],
                  "EcdhInfo" : [
                     {
                        "Mask" : "SoAUZyYa87/Y/4WB/H6HhE+G+FK6cyBTwiV637gaJQw=",
                        "SenderPK" : "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
                        "Amount" : "NAnJdh7dy4B8lpFO9GUV5UeFltknTyVXMwm9xTFt8Aw="
                     }
                  ],
                  "Type" : 0,
                  "TxnFee" : "0",
                  "PseudoOuts" : null
               }
            },
            "signature" : {
               "s" : "21060230996165888414594080395778246988172145535280638705203221867395606692834",
               "v" : 58342,
               "r" : "41175346618973896416810484304580252287215810708491173410791088609882574681352"
            },
            "inputs" : [
               {
                  "value" : {
                     "nonce" : "0",
                     "commit" : "XPR8dM5fkgpAZJ8JDIOgRgXaKRbz+OCV/tCkHC5wyjU=",
                     "amount" : 59000000000000000,
                     "cf" : "ZwnWu9mhhzr7q1tPbLcdc6+DNOJ72/bjaNADzMPXBQY="
                  },
                  "type" : "AccountInput"
               }
            ],
            "fee" : 50000000000000000,
            "add_keys" : [
               "Ml7VIYxDJC+DYvkx1SpCz8ustXzLmtgyX/3pakJc0Fg="
            ],
            "token_id" : "0x0000000000000000000000000000000000000000"
         }
      },
      "from" : "0xa73810e519e1075010678d706533486d8ecc8000"
   }
}

ltk_getTransactionByBlockHashAndIndex

功能：用区块哈希与交易index查询交易
参数：
blockHash 字符串，十六进制区块哈希
index 字符串，十六进制交易在区块中的序号
返回：
参考ltk_getTransactionByBlockNumberAndIndex 示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getTransactionByBlockHashAndIndex","params":["0x93de14f0a3ecc931f508bd155d67d79c59146c18caf48573cfa45dbc8b7556d8","0x0"]}' -H 'Content-Type: application/json'|json_pp

ltk_getRawTransactionByBlockNumberAndIndex

功能：用区块哈希与交易index查询交易
参数：
blockNumber 字符串，十六进制区块编号
index 字符串，十六进制交易在区块中的序号
返回：
raw 字符串，十六进制交易raw
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getRawTransactionByBlockNumberAndIndex","params":["0x1","0x0"]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "result" : "0xf90509f85...",
   "id" : "0"
}

ltk_getRawTransactionByBlockHashAndIndex

功能：用区块哈希与交易index查询交易raw
参数：
blockHash 字符串，十六进制区块哈希
index 字符串，十六进制交易在区块中的序号
返回：
raw 字符串，十六进制交易raw
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getRawTransactionByBlockHashAndIndex","params":["0x93de14f0a3ecc931f508bd155d67d79c59146c18caf48573cfa45dbc8b7556d8","0x0"]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "result" : "0xf90509f85...",
   "id" : "0"
}

ltk_getTransactionCount

功能：查询账户交易nonce值
参数：
address 字符串，十六进制 eth格式账户地址
blockNumber 字符串，区块中的序号，目前只支持 "latest"
返回：
nonce 字符串，十六进制账户的交易nonce值
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getTransactionCount","params":["0xa73810e519e1075010678d706533486d8ecc8000","latest"]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "id" : "0",
   "result" : "0x41c"
}

ltk_getTransactionByHash

功能：根据交易哈希查询交易结构
参数：
hash 字符串，十六进制交易哈希
返回：
参考ltk_getTransactionByBlockNumberAndIndex
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getTransactionByHash","params":["0x2f9c05caefe4372118d951a58e5f6992c597d0bb063b63d3aa0399c0f1e520d6"]}' -H 'Content-Type: application/json'|json_pp

ltk_getRawTransactionByHash

功能：根据交易哈希查询交易raw
参数：
hash 字符串，十六进制交易哈希
返回：
raw 字符串，十六进制交易raw
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getRawTransactionByHash","params":["0x2f9c05caefe4372118d951a58e5f6992c597d0bb063b63d3aa0399c0f1e520d6"]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "id" : "0",
   "result" : "0xf90509f854cf48..."
}

ltk_getTransactionReceipt

功能：根据交易哈希查询交易凭证
参数：
hash 字符串，十六进制交易哈希
返回：
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getTransactionReceipt","params":["0x2f9c05caefe4372118d951a58e5f6992c597d0bb063b63d3aa0399c0f1e520d6"]}' -H 'Content-Type: application/json'|json_pp
{
   "id" : "0",
   "result" : {
      "logsBloom" : "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "blockHash" : "0x93de14f0a3ecc931f508bd155d67d79c59146c18caf48573cfa45dbc8b7556d8",
      "gasUsed" : "0x7a120",
      "cumulativeGasUsed" : "0x7a120",
      "transactionHash" : "0x2f9c05caefe4372118d951a58e5f6992c597d0bb063b63d3aa0399c0f1e520d6",
      "logs" : [],
      "blockNumber" : "0x1",
      "contractAddress" : null,
      "transactionIndex" : "0x0",
      "from" : "0xa73810e519e1075010678d706533486d8ecc8000",
      "tokenAddress" : "0x0000000000000000000000000000000000000000",
      "status" : "0x1",
      "to" : []
   },
   "jsonrpc" : "2.0"
}

ltk_estimateGas

功能：根据交易哈希查询交易raw
参数：
from 字符串，十六进制转账from地址
to 字符串，十六进制转账to地址(选填，估算account转UTXO账户的交易可以不填)
value 字符串，十六进制转账金额单位:wei
data 字符串，十六进制合约参数选填
utxokind 整数 UTXO交易类型（选填，估算account转UTXO账户的交易值为 6）
返回：
交易所需要的gas值，字符串，十六进制
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_estimateGas","params":[{"from":"0xa73810e519e1075010678d706533486d8ecc8000","to":"0xa73810e519e1075010678d706533486d8ecc8001","value":"0x4563918244f40000000","data":"0x4563918244f40000"}]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "id" : "0",
   "result" : "0x3d090000"
}

ltk_signTransaction

功能：计算account账户转账的交易签名参数：
from 字符串，十六进制转账from地址
to 字符串，十六进制转账to地址
value 字符串，十六进制转账金额单位:wei
data 字符串，十六进制合约参数
nonce 字符串，十六进制 from账户的交易序号
gas 字符串，十六进制 gas花费
gasPrice 字符串，十六进制 gasPrice
返回：
tx 交易结构内容
raw 字符串，十六进制签名后的交易
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_signTransaction","params":[{"from":"0xa73810e519e1075010678d706533486d8ecc8000","to":"0xa73810e519e1075010678d706533486d8ecc8001","value":"0x4563918244f40000000","data":"0x4563918244f40000","nonce":"0x4","gas":"0x3d090000","gasPrice":"0x174876e800"}]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "result" : {
      "tx" : {
         "gasPrice" : "0x174876e800",
         "r" : "0xa83cd1f18678f0631ea59c81d4ade2a9b59616073ad6b0f5114d183b3efddbdf",
         "gas" : "0x3d090000",
         "v" : "0xe3e5",
         "s" : "0x56f768216d7def987b369df3d3fa50146029ab7378495f0ec62e1aadf70c8324",
         "value" : "0x4563918244f40000000",
         "nonce" : "0x4",
         "hash" : "0xc7bca4525694bf64cfe58ac2f4ded6457f6c3701109714e73f78042db2140e51",
         "to" : "0xa73810e519e1075010678d706533486d8ecc8001",
         "input" : "0x4563918244f40000"
      },
      "raw" : "0xf87a0485174876e800843d09000094a73810e519e1075010678d706533486d8ecc80018a04563918244f40000000884563918244f4000082e3e5a0a83cd1f18678f0631ea59c81d4ade2a9b59616073ad6b0f5114d183b3efddbdfa056f768216d7def987b369df3d3fa50146029ab7378495f0ec62e1aadf70c8324"
   },
   "id" : "0"
}

ltk_sendRawTransaction

功能：发送普通交易
参数：
raw 字符串，十六进制签名后的交易内容
返回：
交易hash 字符串，十六进制
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_sendRawTransaction","params":["0xf87a0485174876e800843d09000094a73810e519e1075010678d706533486d8ecc80018a04563918244f40000000884563918244f4000082e3e5a0a83cd1f18678f0631ea59c81d4ade2a9b59616073ad6b0f5114d183b3efddbdfa056f768216d7def987b369df3d3fa50146029ab7378495f0ec62e1aadf70c8324"]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "result" : "0xc7bca4525694bf64cfe58ac2f4ded6457f6c3701109714e73f78042db2140e51",
   "id" : "0"
}

ltk_sendRawUTXOTransaction

功能：发送UTXO类型交易
参数：
raw 字符串，十六进制签名后的交易内容
返回：
交易hash 字符串，十六进制
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_sendRawUTXOTransaction","params":["0xf87a0485174876e800843d09000094a73810e519e1075010678d706533486d8ecc80018a04563918244f40000000884563918244f4000082e3e5a0a83cd1f18678f0631ea59c81d4ade2a9b59616073ad6b0f5114d183b3efddbdfa056f768216d7def987b369df3d3fa50146029ab7378495f0ec62e1aadf70c8324"]}' -H 'Content-Type: application/json'|json_pp
{
   "jsonrpc" : "2.0",
   "result" : "0xc7bca4525694bf64cfe58ac2f4ded6457f6c3701109714e73f78042db2140e51",
   "id" : "0"
}

ltk_getLocalUTXOTxsByHeight

功能：通过区块高度查询跟自己相关的解密后的UTXO交易记录
参数：
height 字符串，十六进制，区块高度
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）
返回：

txs 交易数组
- token_id token标识符，目前只支持 0x0000000000000000000000000000000000000000 链克
- hash 字符串，交易hash
- fee 字符串，十六进制，交易费用
- tx_flag 整数，交易转入转出标记 1 - 转入，2- 转出，3-转入转出
- inputs 交易输入
  - account类型输入
    - from 字符串，账户地址
    - amount 字符串，十六进制转账金额，单位wei
    - nonce 字符串，十六进制交易序号
  - utxo类型输入
    - global_index 字符串，十六进制 UTXO的全局索引
- outputs 交易输出
  - account类型输出
    - to 字符串账户地址
    - amount 字符串，十六进制转账金额，单位wei
    - data 字符串，合约调用参数
  - utxo类型输出
    - is_change 布尔类型，是否属于找零输出　　
    - otaddr 字符串，一次性交易地址
    - global_index 字符串，十六进制 UTXO的全局索引
height 字符串，十六进制，区块高度
next_height 字符串，十六进制，下一个包含UTXO交易的区块高度
timestamp 字符串，十六进制，区块时间戳
示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getLocalUTXOTxsByHeight","params":["0x12b54a"]}' -H 'Content-Type: application/json'|json_pp
{
   "result" : {
      "txs" : [
         {
            "token_id" : "0x0000000000000000000000000000000000000000",
            "outputs" : [
               {
                  "is_change" : true,
                  "otaddr" : "0x415a2b409504a0e6cdffa1e1bf33605465e0ccaee47f0e944399a7f73031ec38",
                  "global_index" : "0x3998c"
               }
            ],
            "tx_flag" : 3,
            "fee" : "0x429d069189e0000",
            "hash" : "0xf0820e63dd580e3637c4d8af7c2be23acab997f149f9c1c78c45189474985e8c",
            "inputs" : [
               {
                  "amount" : "0x344d4a284540e0000",
                  "from" : "0xa73810e519e1075010678d706533486d8ecc8000",
                  "nonce" : "0x1ce10"
               }
            ]
         }
      ],
      "timestamp" : "0x5d7f2686",
      "height" : "0x12b54a",
      "next_height" : "0x12b54b"
   },
   "id" : "0",
   "jsonrpc" : "2.0"
}

ltk_getLocalOutputs

功能：查询跟自己相关的output数据
参数：

ids 字符串，十六进制 output global_index数组
addr 字符串，十六进制指定要操作的钱包账户，默认为最后解锁的账户（可选）

返回：

token_id 字符串，十六进制
sub_addr_index 字符串，十六进制子账户序号
remark 字符串交易留言信息
amount 字符串，十六进制交易金额
global_index 字符串，十六进制 output全局索引序号

示例：

curl -s -X POST http://127.0.0.1:18082 -d '{"jsonrpc":"2.0","id":"0","method":"ltk_getLocalOutputs","params":[{"ids":["0x3997e"]}]}' -H 'Content-Type: application/json'|json_pp
{
   "result" : [
      {
         "remark" : "0x0000000000000000000000000000000000000000000000000000000000000000",
         "amount" : "0x340aad21b3b700000",
         "sub_addr_index" : "0x0",
         "token_id" : "0x0000000000000000000000000000000000000000",
         "global_index" : "0x39980"
      }
   ],
   "jsonrpc" : "2.0",
   "id" : "0"
}

ltk_call

功能：立即执行合约调用，而无需在区块链上创建交易。
参数：

交易参数对象 from 字符串，十六进制转账from地址
to 字符串，十六进制转账to地址
value 字符串，十六进制转账金额单位:wei
data 字符串，十六进制合约参数
区块参数，字符串，十六进制区块号或者"latest", "earliest" or "pending"

返回：
data 字符串，十六进制合约执行返回的结果
示例：

curl -s -X POST http://127.0.0.1:18082 -d'{"jsonrpc":"2.0","id":"0","method":"ltk_call","params":[{"to":"0x25faf109d3c0514e4e021dd6baabfa1e8473e97b","data":"0x92d0d153"},"latest"]}' -H 'Content-Type: application/json'|json_pp
{
   "id" : "0",
   "result" : "0x000000000000000000000000000000000000000000000000000000000000000a",
   "jsonrpc" : "2.0"
}

Directories ¶

Path	Synopsis
cmd
config
daemon
mnemonic Package bip39 is the official Golang implementation of the BIP39 spec.	Package bip39 is the official Golang implementation of the BIP39 spec.
wordlists
node
rpc Package rpc is a generated GoMock package.	Package rpc is a generated GoMock package.
types
wallet Package wallet is a generated GoMock package.	Package wallet is a generated GoMock package.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL