“User:LoytokenAPI”的版本间的差异

来自集智百科
跳转到: 导航搜索
数据返回样例和说明
第126行: 第126行:
 
   "elaAddress": "EWdRqZptrfTJYKTJG4WYvpAbnadiZbMbFP",//亦来云地址
 
   "elaAddress": "EWdRqZptrfTJYKTJG4WYvpAbnadiZbMbFP",//亦来云地址
 
   "address": "0x87e03844506824b7a34fe9ca88ed74273c368fe8",以太坊地址
 
   "address": "0x87e03844506824b7a34fe9ca88ed74273c368fe8",以太坊地址
   "btcAddress": "1B7Tbnaid4TcPVbRarcQba4HoN2H1Hdi2v",//比特币地址
+
   "btcAddress": "1B7Tbnaid4TcPVbRarcQba4HoN2H1Hdi2v",//比特币 地址
 +
  "ethSideAddress":"0x87e03844506824b7a34fe9ca88ed74273c368fe8",//亦来云ETH侧链 地址
 
   "mnemonic":"ucCXAy0zqUr4WRTSm6oomIjlfo2T9i1Kzhps+MerglaRaPq- DhnnTXN6cg53R4IWGsB0
 
   "mnemonic":"ucCXAy0zqUr4WRTSm6oomIjlfo2T9i1Kzhps+MerglaRaPq- DhnnTXN6cg53R4IWGsB0
 
                       NN73rRm89SDf4f6LeRldDR7EaR/OQi3EYm- OyfXHc="//助记词(DES加密后字符串)
 
                       NN73rRm89SDf4f6LeRldDR7EaR/OQi3EYm- OyfXHc="//助记词(DES加密后字符串)

2019年12月10日 (二) 14:24的版本

LoyToken服务已经正式上线。

目录

概述

  • 使用前请先参考LoyToken官网
  • Loytoken标准服务接口为各应用提供钱包服务,通过接口调用,完成钱包创建、导入、查询、转帐等相关功能。

使用说明

名词解释

名词 英文 解释
钱包地址 address 钱包的唯一标识,通过地址可以查询其地址下的所有币种、余额、以及交易信息
密码 pwd 钱包的密码,通过密码可以完成交易
助记词 mnemonic 帮助记忆的一组英文单词,可通过助记词导入钱包
钱包文件 keyStore 使用密码生成的一串json,保存钱包一些信息,可通过密码与钱包文件导入钱包
私钥 privateKey 钱包的私钥
交易hash txHash 交易生成的标识,使用交易hash可以查询交易详情
备注 remarks 交易时可携带的少量信息
代币地址 token 每一种代币的地址,以太币默认为“ETH”
gas费用 gas 每笔交易所支付的eth费用

数据格式

  • 接口返回格式统一,采用json格式返回,josn格式中包括data、msg、code。
  • code:接口处理标识,0表示成功,-1表示失败。
  • msg:返回的消息,主要指错误信息。
  • data:返回的业务数据。

加密方式

  • 本系统对隐私数据进行DES标准加密,初始化向量byte[]iv={1,2,3,4,5,6,7,8},DES加密key在用户申请时自定义。
  • 传入参数需要加密字段为:pwd(密码),mnemonic(助记词),privateKey(私钥)。
  • 返回数据加密字段为:pwd(密码),mnemonic(助记词),privateKey(私钥)。

接入系统

  • 使用本系统需要向loytoken接入平台注册,使用注册获得的tenantid和tenantkey换取接入系统access_token。
  • 通过access_token调用接口,用于接入系统的验证。

获取access_token

  • 接入系统初始化

接口说明

URL:http://loytoken.starrymedia.com/app/access

请求方式:get

参数 是否必选 类型 说明
tenantkey true string 申请得到的租户key

数据返回样例和说明

{
	"code": 0,
	"data": {
		"access_token": "0c5c646e-2d36-4708-891b-603d095b87ae",//访问标识
		"refresh_token": "9c148eb2-a27e-4811-98d2-e548d5add094"//刷新标识
	}
}

重新获取access_token

  • 重新获取access_token

接口说明

URL:http://loytoken.starrymedia.com/app/refresh

请求方式:get

参数 是否必选 类型 说明
refresh_token true string 申请得到的租户key

数据返回样例和说明

{
	"code": 0,
	"data": {
		"access_token": "0c5c646e-2d36-4708-891b-603d095b87ae",//访问标识
		"refresh_token": "9c148eb2-a27e-4811-98d2-e548d5add094"//刷新标识
	}
}

钱包服务

创建钱包

  • 创建新钱包

接口说明

URL:http://loytoken.starrymedia.com/app/createWallet

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
pwd true string 用户钱包密码(DES加密密文)
linktype true string 主链类型 ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明

{
"code":0,//0表示成功,-1表示失败
"data":{
  "elaAddress": "EWdRqZptrfTJYKTJG4WYvpAbnadiZbMbFP",//亦来云地址
  "address": "0x87e03844506824b7a34fe9ca88ed74273c368fe8",以太坊地址
  "btcAddress": "1B7Tbnaid4TcPVbRarcQba4HoN2H1Hdi2v",//比特币地址
  "ethSideAddress":"0x87e03844506824b7a34fe9ca88ed74273c368fe8",//亦来云ETH侧链地址	
  "mnemonic":"ucCXAy0zqUr4WRTSm6oomIjlfo2T9i1Kzhps+MerglaRaPq- DhnnTXN6cg53R4IWGsB0
                       NN73rRm89SDf4f6LeRldDR7EaR/OQi3EYm- OyfXHc="//助记词(DES加密后字符串)
  }
}

导入钱包

通过助记词导入

接口说明

URL:http://loytoken.starrymedia.com/app/importWalletByMnemonic

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
pwd true string 密码(DES加密密文)
mnemonic true string 助记词(DES加密密文)
linktype true string 主链类型 ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明
{
"code":0,//0表示成功,-1表示失败
"data":{
  "elaAddress": "EWdRqZptrfTJYKTJG4WYvpAbnadiZbMbFP",//亦来云地址
  "address": "0x87e03844506824b7a34fe9ca88ed74273c368fe8",//以太坊地址
  "btcAddress": "1B7Tbnaid4TcPVbRarcQba4HoN2H1Hdi2v"//比特币地址
 
  }
}

通过Keystore文件导入

接口说明

URL:http://loytoken.starrymedia.com/app/importWalletByKeyStore

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
pwd true string 密码(DES加密密文)
keyStore true string 钱包josn串
linktype true string ETH(目前只支持eth的钱包文件导入)

数据返回样例和说明
{
"code":0,//0表示成功,-1表示失败
"data":{
 
  "address": "0x87e03844506824b7a34fe9ca88ed74273c368fe8",//以太坊地址
 
  }
}

通过私钥导入

接口说明

URL:http://loytoken.starrymedia.com/app/importWalletByPrivateKey

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
pwd true string 密码(DES加密密文)
privateKey true string 私钥(DES加密密文)
linktype true string 主链类型 ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明
{
"code":0,//0表示成功,-1表示失败
"data":{
   "elaAddress": "EWdRqZptrfTJYKTJG4WYvpAbnadiZbMbFP",//亦来云地址
  "address": "0x87e03844506824b7a34fe9ca88ed74273c368fe8",//以太坊地址
  "btcAddress": "1B7Tbnaid4TcPVbRarcQba4HoN2H1Hdi2v"//比特币地址
  }
}

导出私钥

接口说明

URL:http://loytoken.starrymedia.com/app/exportPrivatekey

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
pwd true string 密码(DES加密密文)
address false string 钱包地址
linktype true string 主链类型 ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明

{
"code":0,//0表示成功,-1表示失败
"data":"Gcsh0FoqIIu3nZny4CYWmzqL5YoRZvP/dSHkFJ99pz8hXU0KAneeVjje- XV6eQUYA
            Lu2q0Vl3lPQRutcQZYfqtYyO9D1Ne0wc"//用户私钥(DES加密文件)
}

导出keyStore

接口说明

URL:http://loytoken.starrymedia.com/app/exporteystore

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
pwd true string 密码(DES加密密文)
address false string 钱包地址
linktype true string ETH(目前只支持ETH的钱包文件导出)

数据返回样例和说明

{
"code": 0,//0表示成功,-1表示失败
"data": "{
        "address ": "3396225702 b0882b3f6d7910f88de974640de7ef ",
	"id ": "013 bc2d3 - cf25 - 4 d9a - 82 c2 - a8f1ebabd32c ",
	"version ": 3,
	"crypto ": {
		"cipher ": "aes - 128 - ctr ",
		"ciphertext": "de3c810c9be6ab66a564ecafdc70fffb3365a5c- c90bc9e3e510b94264f70edac ",
		"cipherparams ": {
			"iv ": "e9ddd63acd2f0db3a19b526225717906 "
		},
		"kdf ": "scrypt ",
		"kdfparams ": {
			"dklen ": 32,
			"n ": 4096,
			"p ": 6,
			"r ": 8,
			"salt": "f858e17a10f9382a5a116-
			caa7e79fe6c98b4e219062685740188ffaabfad365e " },
			"mac": "52f89d899291c6d6e2c232cb7d11060621b11fe- f65f57576707aae37915bd633"
		}
	}
	"//Keystore文件,json字符串
}

修改密码

接口说明

URL:http://loytoken.starrymedia.com/app/updatepwd

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
address true string 钱包地址
oldPwd true string 旧密码(DES加密密文)
newPwd true string 新密码(DES加密密文)
linktype true string 主链类型 ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明

{
"code":0,//0表示成功,-1表示失败
"msg": ""//说明
}

删除钱包

接口说明

URL:http://loytoken.starrymedia.com/app/deletewallet

请求方式:post

是否需要登录:否

参数 是否必选 类型 说明
access_token true string 访问验证标识
pwd true string 用户钱包密码
address true string 钱包地址
linktype true string ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明

{
"code":0,//0表示成功,-1表示失败
"msg":""//说明
}

钱包查询功能

查询余额

接口说明

URL:http://loytoken.starrymedia.com/app/balance

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
adderss true string 钱包地址
linktype true string 主链类型 ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明

{
"code": 0,
"data": [{
	"logo": null, //币种标识图
	"name": "ITRA", //币种名称
	"balance": "50.0000", //余额
	"tokenAddress": "0x08f28cf0f414d1625eb6ee31d5903e2c41adb839" //代币地址(以太币为ETH)
	}, {
	"logo": null,
	"name": "METRO",
	"balance": "83.0000",
	"tokenAddress": "0x367893d2353b15b8e26bef0b2208072ee0517988"
	}, {
	"logo": null,
	"name": "ETH",
	"balance": "0.0489",
	"tokenAddress": "ETH"
	}]
}

交易详情

接口说明

URL:http://loytoken.starrymedia.com/app/transactioninfo

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
txHash true string 交易哈希
linktype true string 主链类型 ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明

{
"code": 0, //0表示成功,-1表示失败
"data":{
	"gasPrice": "0.00000200",//花费
	"from": "",//发送方
	"to": "",//接收方
	"blockNumber": "6425763",//块号,因为主链差异,ela显示为块哈希
	"txHash": "0x6d05b7d4234d38ea4bbd2473e3e7911dac5def7d4c86b2ca200c69c7f8c81ea4",//交易哈希
	"remarks": null,//备注
	"time": "2018-09-30 13:46:50 +0800",//时间
	"source": "ela",//主链
	}
}

查询账号的交易记录

接口说明

URL:http://loytoken.starrymedia.com/app/adderss/transfers

请求方式:post

是否需要登录:否

参数 是否必选 类型 说明
access_token true string 访问验证标识
address true string 钱包地址
pageNo false string 页码,默认为“1”
linktype true string 主链类型 ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明

{
"code": 0, //0表示成功,-1表示失败
"data": [{
	   "isError": "0", //交易状态,0表示成功,1表示失败,null表示打包中
	    "value": "0.0003", //交易金额
	    "token": "ETH", //币种名称
	    "from": "0xedf05c600ad3be116060cc5e982d5d28aef9892e", //交易发送方
	    "gasPrice": "0.000278304", //交易gas费用
	    "to": "0x481cb6dc4248a7b68801b47025a7a4a8ea782c11", //交易接收方
	    "age": "2018-05-30 16:10:42 +0800", //交易时间
	     "txHash":"0x6118dc0998d3331d60ccf380ead3d3d42f412cfd1c0ea7581f0c6c27f32aee68 " //交易哈希值
			}, {
		"isError": "1",
		"value": "0",
		"token": "ETH",
		"from": "0xedf05c600ad3be116060cc5e982d5d28aef9892e",
		"gasPrice": "0.000318617",
		"to": "0x367893d2353b15b8e26bef0b2208072ee0517988",
		"age": "2018-05-30 15:37:48 +0800",
		"txHash": "0xb0567c75fd3f6a2e38f6ecb3fea1f5420d5cc2991172f4-
		ca32feb36c64b09a8d " }]
}

查询账号下某一币种的交易记录

接口说明

URL:http://loytoken.starrymedia.com/app/token/transfers

请求方式:post

是否需要登录:否

参数 是否必选 类型 说明
access_token true string 访问验证标识
token true string 币种地址,以太币地址为“ETH”
address true string 钱包地址
pageNo false string 页码,默认为“1”
linktype true string eth(以太坊下有代币概念)

数据返回样例和说明

{
"code": 0, //0表示成功,-1表示失败
"data": [{
	   "isError": "0", //交易状态,0表示成功,1表示失败,null表示打包中
	    "value": "0.0003", //交易金额
	    "token": "ETH", //币种名称
	    "from": "0xedf05c600ad3be116060cc5e982d5d28aef9892e", //交易发送方
	    "gasPrice": "0.000278304", //交易gas费用
	    "to": "0x481cb6dc4248a7b68801b47025a7a4a8ea782c11", //交易接收方
	    "age": "2018-05-30 16:10:42 +0800", //交易时间
	     " t x H a s h ": " 0 x 6 1 1 8 d c 0 9 9 8 d 3 3 3 1 d 6 0 c c f 3 8 0 e a d-
				3 d3d42f412cfd1c0ea7581f0c6c27f32aee68 " //交易哈希值
			}, {
		"isError": "1",
		"value": "0",
		"token": "ETH",
		"from": "0xedf05c600ad3be116060cc5e982d5d28aef9892e",
		"gasPrice": "0.000318617",
		"to": "0x367893d2353b15b8e26bef0b2208072ee0517988",
		"age": "2018-05-30 15:37:48 +0800",
		"txHash": "0xb0567c75fd3f6a2e38f6ecb3fea1f5420d5cc2991172f4-
		ca32feb36c64b09a8d " }]
}

获取建议gasPrice

  • 目前比特币和亦来币使用默认费用

接口说明

URL:http://loytoken.starrymedia.com/app/suggestGas

请求方式:get

请求参数:无

数据返回样例和说明

{
"code": 0,  //0表示成功,-1表示失败
"data": {
	       "ethSuggestGas": "0.000164",//以太币转账建议gas费用
		"ethMinGas": "0.000229",//以太币转账建议最小gas费用
               "ethMaxGas": "0.002520",//以太币转账建议最大gas费用
		"tokenSuggestGas": "0.000390",//代币转账建议gas费用
		"tokenMaxGas": "0.006000",//代币转账建议最大gas费用
		"tokenMinGas": "0.000546"//代币转账建议最小gas费用
	}
}

转账

  • 比特币和亦来币使用默认gas费用

接口说明

URL:http://loytoken.starrymedia.com/app/transaction

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
pwd true string 密码(DES加密)
from true string 发送方地址
to true string 接收方地址
token false string eth代币地址
gas false string 一笔交易所需gas费用
value true string 转出金额
remarks false string 备注
linktype true string 主链类型 ETH/BTC/ELA/ETHSIDE(亦来云ETH侧链)

数据返回样例和说明

{
	"msg": "交易已发送",
	"code": 0
}



个人工具
名字空间
操作
导航
工具箱