使用者:LoytokenAPI

出自集智百科
跳轉到: 導覽搜尋

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",//比特币地址
  "ethSideAddress":"0x87e03844506824b7a34fe9ca88ed74273c368fe8",//亦来云ETH侧链地址		
  }
}

通過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",//比特币地址
  "ethSideAddress":"0x87e03844506824b7a34fe9ca88ed74273c368fe8",//亦来云ETH侧链地址
  }
}

導出私鑰

介面說明

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",//交易哈希
	"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

數據返回樣例和說明

{
"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 代币地址
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 " }]
}


轉賬

  • 比特幣和亦來幣使用默認費用,BTC為0.0001,ELA為0.00001

介面說明

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
}



跨鏈轉賬

  • 亦來雲主鏈和亦來雲ETH側鏈間轉賬

介面說明

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

请求方式:post

参数 是否必选 类型 说明
access_token true string 访问验证标识
pwd true string 密码(DES加密)
from true string 发送方地址
to true string 接收方地址
value true string 转出金额
remarks false string 备注
linktype true string ELA(主链向侧链转账)/ETHSIDE(侧链向主链转账)

數據返回樣例和說明

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



個人工具
名字空間
動作
導覽
工具箱