 统一请求参数：; G% x9 g( ]% g3 \1 t" n
标准json字符串8 W1 D+ x9 V, x# a
 统一响应参数5 n& e& s+ F; b) _! W
标准josn字符串
: [; m# L9 n9 Wexample:{code:1,msg:”测试”,result:”json数组”}
: ?9 F$ d- B, e! P' M8 b$ E 统一code说明
' Z0 e  {( b" l& K$ ]. N- ycode:-2 msg:操作失败  l5 j& ~! Y0 Z& p% b! D
code:-1 msg:系统异常5 u  Z8 ^6 O4 b- t% s
code: 0 msg:操作成功: `& y* O; ]  w
1.1. 创建钱包地址/ z0 m" |$ O6 [0 n
请求地址 http://IP:PORT/api/wallet9 P% ]; N: i: ^7 g& ^6 b
请求参数# N' R/ z' l' t2 E1 F6 s% t- S
{9 A+ O  {! o% J; j$ z1 g
"cmd":"wallet_create",( N  ]& W7 D( v3 [& j% g
"params": {
, ^8 c: c7 q( i+ T"password":"123456"
) A+ \4 p4 }1 V6 m- d) ^9 H}1 o4 u6 X. B* b% P
}
) V" \+ Z+ b% L参数说明, ]3 V" s6 ^# ^8 O* M, D
参数名称 说明 必填. v% A, p* p1 z# A# o" h
password 钱包密码 Y& k* ]( V5 }4 B1 C7 b% D4 N, u
响应参数
8 ~0 ]3 [9 e2 a' B& \+ I/ s9 y{) f" s" o8 q& _7 o8 D+ j" u  d5 v
"code":"0",: L. e1 B2 d& I8 t1 {4 y
"msg": "",/ m  A; F+ w1 c" ~/ H8 f2 c$ X4 A
"result":{/ `! I1 c( S- l2 J$ |5 K3 X
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"0 V' s( c+ k- a$ o$ e8 w: l  K& I, v
"keystore": "{\"address\":\"fdd332dd0035eeec1a81ed56fd72633b25f63361\",\"id\":\"e67e1962-d9d7-4cf9-aa07-5387ae5dc320\",\"version\":3,\"crypto\":{\"cipher\":\"aes-128-ctr\",\"ciphertext\":\"466ab1504fc6b1082945779429aba45dc081385a4dc3846ff940d0703741e071\",\"cipherparams\":{\"iv\":\"f5f5a4547bc7f22f44f22ba64ff50603\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":32,\"n\":4096,\"p\":6,\"r\":8,\"salt\":\"3e66f07671383d420ded08098f50a5246f64ddf1c1ab56d0acdc9a04fe96cef0\"},\"mac\":\"4496da44fa9d1d44a5e09f6abd7500fe03500054a5c5aea3d4af6e3a28593fff\"}}"3 [! }0 L4 N( R* `  I6 ^* v$ T
}( @) Z5 u( k( a9 R3 \6 a" A1 _
}' u' P2 |" p1 R* w
参数说明 address 钱包地址
5 n5 [( T7 u8 G4 M3 b6 M. {1.2. 导入钱包7 y7 V/ a7 o2 E+ q
请求地址 http://IP:PORT/api/wallet
3 v4 H8 _, N* o! q1 q请求参数8 z6 j$ e, j1 N/ _9 U8 S5 I
{& {, o- x0 H1 B4 ~' y) L; r: V
"cmd":"wallet_import",
2 k; z8 y4 ~$ [6 C! x+ i/ r"params": {) ?0 ~* \: }5 q. i! Z
"keystore":"{\"address\":\"113d79bea1f6ff0681a778dace3c64d5ff915c89\",\"id\":\"778a5f41-b680-4edb-86fd-e117d426dfbb\",\"version\":3,\"crypto\":{\"cipher\":\"aes-128-ctr\",\"ciphertext\":\"e59369214acc42d6f4b72ae3c1623273c7a6f9238e97c1e3a74401551315fc42\",\"cipherparams\":{\"iv\":\"27227ccc77183e8fc97c57afe644774a\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":32,\"n\":4096,\"p\":6,\"r\":8,\"salt\":\"8f2860de861d5f4273d447dd66b6b8df3ae19bc88c5a5782be7428de64be71b5\"},\"mac\":\"b5f92a51d0dc6c60484204c8559d1debcd3efe89f82f870bd40f8ce6a392ade5\"}}",/ T/ @& f# i; t' D
"password":"123456"& R- C8 W: b" G* }8 h" l9 m7 q
}, M' \7 C# v8 V' S
}
" L7 l* L8 e7 Q% ?参数说明
/ s$ a* i5 P# O% \( Z参数名称 说明 必填+ l; \2 r2 l/ V6 }2 ~  ^
keystore 钱包keystore Y% Y2 z! A, M4 t7 I) ?& F+ t
password 钱包密码 Y! |& K: @% L/ v6 R1 _7 B" M/ @: _
响应参数5 M' p7 F- ~: Z% ?
{9 _  E) \2 l% f5 \2 K% A( l' u" Z
"code":"0",
/ H5 h+ T6 @! N, O% o"msg": "",
( U9 U* n8 l  k, u. {"result":{
8 W. W# ?! a' i) \* s"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"
& h# D( ?# K$ A1 L, x9 U' L}5 x1 F+ c6 {& m3 h6 X9 n* `+ \
}" O" H# {1 I; R7 q1 p, R
参数说明 address 钱包地址' T; r( o7 d) Y. G. \$ E
1.3. 查询余额
9 ~8 f% D8 P" S- s* @8 J2 _请求地址 http://IP:PORT/api/wallet2 a% X, y( Y! j+ j
请求参数
0 B, H5 v1 W' [' I{' B, D: I% p$ g- j  [9 o
"cmd":"wallet_balance",/ n! U7 w& ]7 j1 b) o
"params": {; i( e1 m, m. }7 `3 x$ p0 ?
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"2 a+ [5 u' @' B* C0 |' o% M  ]
}+ W: Y1 n' k! G3 c* N
}
# ?$ k* x7 l( D. ]. H" P+ C参数说明
# I: b# K, \, ?/ l/ q参数名称 说明 必填
0 M( p* w5 M! w* Xkeystore 钱包keystore Y5 {' C- U& j: N! X0 P: A4 {
password 钱包密码 Y
( B+ ]( D5 J! f  X" D响应参数3 j: i- f( |6 p' g( N3 K
{
+ N, X8 u3 D9 c' V& ]$ Z"code":"0",
! Y1 j. x  ^2 r7 ~- D3 z"msg": "",
2 V9 `+ ^2 Y' h: I"result":{
  V/ |, s& ^% `"balance": "88.2",
' A! Q0 Q4 j0 Z& c6 h3 a% t& P"eth_balance": "0.03",7 a( k( U, @5 d
}, P0 r: L0 c* g) o- y4 {
}8 l3 w4 y9 v! t0 Q6 v) I
参数说明
0 g' o, K5 r. m6 Geth_balance 以太币数量
3 \* N. T* I% c1 i) }9 nbalance 代币数量; ?/ J  f' D4 M( d+ ~
1.4. 代币转账
+ V+ S! w" l8 c" c6 \请求地址 http://IP:PORT/api/wallet: B# e" k. K- u2 u/ X; ~
请求参数0 R& F, m% m+ V3 B
{
. S0 x0 R8 K" E' K"cmd":"wallet_transaction",
% ]( M) S0 X4 z$ O"params": {. W6 o. C# m- p7 T# [
"from_address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
6 U6 u, N% {4 J- V" ^- ~$ D5 k5 ?"password":"123",5 g1 r! `- Z& l
"to_address":"0x113d79bea1f6ff0681a778dace3c64d5ff915c89",
* ~) X0 r% p2 [; J8 y, l  k"cost": "0.00018",
1 ~. W* {' j' h0 b8 r"num":"0.22"2 V1 O7 r4 T) W* o8 S' K
}
: Z# n: |" J8 @6 S}1 ?4 t2 V( K& p8 s1 o
参数说明8 i# [; f/ T$ \! e5 Y( X& Q" _
参数名称 说明 必填
/ F- L: g) B2 R% A1 M) ^from_address 转出钱包地址 Y
6 A& B& ?- M) @8 Fpassword 转出钱包的密码 Y! O  L9 u/ h8 G$ D% o+ r% u& B. s
to_address 转入钱包地址 Y
2 |' P1 ?3 n* y: B9 }cost 手续费，单位：以太币。（手续费越高，到账时间越短，过低的手续费可能导致交易失败）目前限制了最低手续费为 0.00018 Y& Q2 N/ V* A* v
num 转出代币数量 Y6 M4 N2 A: T2 h9 B! E4 s
响应参数, U8 e8 g1 Y) V* r/ f: E
{
# J; U& I' U* s"code": "0",
; ^( c; n+ o' n/ X- V"msg": "",5 I7 m8 x9 Z4 u! A# ^- r0 D, R0 S
"result":{& V, M: A3 K2 G4 [9 M
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6") e0 k) j, u' _% M$ {+ L
}
- l3 d2 u/ z4 p}9 `" P  U$ a  c" I
参数说明 trans_hash 交易Hash值$ B) M; m$ }) k) D
1.5. 查询交易状态6 C" a0 l' B+ x6 k
请求地址 http://IP:PORT/api/wallet
% R7 f( @& ?+ y3 F2 L2 N8 _. P) v! _( n请求参数: B8 _" I) R0 G: E2 k) R' P# @
{% y5 s" x4 b  {
"cmd":"trans_status",
. s: D5 }6 @  `- O) m9 Z$ G" j"params": {
/ s& }1 e% `9 o. Q# P. M4 i"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
; C% M# G/ `. @( m4 y2 ~* i: T}+ W6 k- g4 V# P, T. j8 T% K( z
}
/ S5 n$ O# x5 s: a参数说明
1 x# V9 P* L7 C3 R+ ~. {. m参数名称 说明 必填
" a6 P0 m5 N. J. f6 Ztrans_hash 交易hash值 Y
- W$ P/ Y7 P' c: l响应参数9 `7 [% _5 \& ~. L6 I% p) H
{
! v9 c5 G2 }+ k9 Q/ E$ f"code": "0",
- k4 Q# ^: \8 H2 E; _8 W/ K"msg": "",. f* }4 z8 S, Y% g  d. R! D  i! b
"result":{
3 D6 p5 g7 i8 U( `. ]$ k8 D' P"status": "1"/ Q' O' g# J1 M7 u7 x9 a+ ^2 {
}, `  k) j; v" _: s/ N6 U0 P$ w) r4 l
}
. B& |9 O9 P( k' ?6 A参数说明 status 1 交易完成、 0 未完成2 V# G' W* k4 {4 Y0 A# m' ~
1.6. 查询交易详情$ i& g0 }6 D. d4 W  ^7 X0 G4 T3 D
请求地址 http://IP:PORT/api/wallet5 g' |9 }0 I0 H- I
请求参数) A1 v4 G# a7 C5 w9 L4 o' Q" s5 u
{% E4 z" t9 N* L0 b. c' @
"cmd":"trans_detail",
6 ?( R2 u% E  X( G"params": {
6 \* p1 ]9 a3 h0 b- F4 t# T"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"4 a0 T! |' m' H% m( q
}2 X6 X0 D! n; o' ^
}; r; M2 C7 y2 w. @
参数说明$ p; S% s* n- T5 R
参数名称 说明 必填
/ ~8 h& ^" }; T0 A' f! d4 Otrans_hash 交易hash值 Y* B: L3 @9 G2 t+ o- e( p3 b# ~. U
响应参数
8 W* e( N  Z8 I6 O4 v! x2 t; _{
" G) z1 M( x: ]! @"code": "0",
! S3 Q8 K( }' v) R0 m6 G6 c"result":{
8 b9 G* p. h9 W8 s"num": "2",
6 J, a1 x0 ^5 ]  g0 }5 W"from": "0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
* s+ `- |! x' {"to": "0x33852530794c67fac23a010e2e4a88fb84477ff2",
; E$ b% p1 v+ {"timestamp": 1525774296
( q7 s% H5 T: T}7 T" @, s1 X8 \: J
}
7 y: N+ a. R% A8 h参数说明
  s& f% m0 P, B2 ?1.7. 查询交易记录, \2 v% M3 O* x7 _
请求地址 http://IP:PORT/api/wallet8 ~; y) B. d1 T* v/ R9 a
请求参数8 D1 [/ z6 W6 V4 {7 \! f
{$ R0 H0 P3 |+ T
"cmd":"trans_record",& G6 \$ w1 Z0 U, Y$ {/ ]
"params": {/ H' M! U( E4 q
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"
3 X$ \3 f* y# a4 L8 j}, C' P" h: c1 M6 c( o+ R
}
8 e; W  x( ^7 i/ I  S9 W$ ^* z参数说明! ]1 p2 G4 w' O' n; Q) O2 o
参数名称 说明 必填: Q" E: I+ t6 E6 M- V- m  ~' l( ]
trans_hash 交易hash值 Y9 ^! Y0 i4 {7 X( ?4 K4 M7 M8 Z
响应参数
) D4 }/ u% h+ P{
4 D& K4 j$ P6 j2 D5 z0 D3 Y"code": "0",8 E" d# \- E, M. X$ A
"result":{1 P. w7 ?* b0 J! T# G2 g2 E. x1 |
"records":[{# V( ]9 i5 ]# Q) K0 P
"num": "0.02",
/ n) K: s: C% l9 d8 r"from": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",8 y. n- x. `' H( {8 J1 z
"to": "0x70550b9acd503d5154d21985426a0829612dc060",
7 [5 A% p6 m6 Y"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",  Z2 r9 c% n; @. H
"timestamp": 1525774296
# T/ _! U* L% |8 B},{
3 t7 M7 |$ p0 r' M"num": "0.01",
! _3 a  j  S0 @3 {6 t# ~"from": "0x70550b9acd503d5154d21985426a0829612dc060",
* F" {1 |+ n% L4 q) R1 j"to": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",+ k1 R- p- o6 \
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",; j, Z4 m0 k- F" C5 c$ T0 }$ ^
"timestamp": 1525774296
' o1 _* e) R. @- d  _7 |1 i}]
" a+ a9 Q/ H: L3 [+ u0 h# w}% p# Y3 n" u* [% ]+ q
}