 统一请求参数：: ?9 Y& A) `" x1 r  V
标准json字符串+ S+ u3 ]+ e  v0 O/ y
 统一响应参数& {& E* F# C' ?" D
标准josn字符串
) G( w- Q" ?4 k7 H0 D( o0 l( jexample:{code:1,msg:”测试”,result:”json数组”}
  c; }9 c7 d9 i1 S 统一code说明
& r7 ^+ T( r0 D2 ucode:-2 msg:操作失败
: _  R9 n9 u. ~4 N7 }code:-1 msg:系统异常
6 N+ V( C" ]3 S9 K7 mcode: 0 msg:操作成功) R5 n- a3 [# C4 N( {$ O
1.1. 创建钱包地址& g" o8 L8 V& R# g' M
请求地址 http://IP:PORT/api/wallet
2 u3 j1 g0 l) k& A, B# [% q请求参数3 L, Z% B/ E- `* l( E
{
# a' `% t8 o% t4 ~; R9 ^"cmd":"wallet_create",
) Y! b  t! l5 `9 ~& K' C"params": {4 \) ^/ L( S# B2 _1 y0 X
"password":"123456"
' R; d* R: U' E+ b" `# \}
$ F: o* U& N0 o- C  n5 J}
* N$ P0 d5 g% ~1 U, T% |参数说明
# l, D/ X+ P/ ]+ x参数名称 说明 必填
% L& V% a( W% W4 ?password 钱包密码 Y
6 g8 ]1 V3 |6 o# n2 N3 f% w( F( ~响应参数
) J+ t. f/ \  ?& N{# Z9 w: ?0 c/ x( g7 d5 |
"code":"0",, C& @6 P9 K9 a0 a) v
"msg": "",
8 l* n9 A. m1 I7 r' u" u"result":{
- C5 |2 d) U- I) M5 q$ d3 ^, y"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"& q  X4 @* I1 N
"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 K$ I# ?' i% k$ T; n}' c6 K* r! t, v
}
, X: I. c# w9 e- c& W参数说明 address 钱包地址
/ z, h  k8 s3 ~( V- s' P1.2. 导入钱包
8 a# P% @3 o+ u4 z5 l请求地址 http://IP:PORT/api/wallet+ b0 Q- o; r: m+ R9 j- z/ N
请求参数+ \5 o  s" O& B& n& j
{
, r6 D! Z/ `8 [3 d* J! Z' x! J"cmd":"wallet_import",/ x/ `- @% C+ ]/ b, Z1 k: G. [& `
"params": {
; s7 y; Q1 g& [) K/ V"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\"}}",
5 w5 \' x1 R% i"password":"123456"
& v+ d1 h; G5 u& d6 v) w* @) ~9 \, }}
) ^, {& l( E/ M5 F% S}/ R2 O" g6 T, t2 v; R8 [
参数说明! |' z/ f! |- l1 f: A4 Y( o
参数名称 说明 必填' ^8 H2 w- r! f  {6 T& @2 P4 `
keystore 钱包keystore Y& `8 v1 X* D! @  w+ @7 Z
password 钱包密码 Y7 Y/ ~9 _* k. t' `' _' {
响应参数( D& e7 F8 F9 X
{6 W* d5 `! @. |) V
"code":"0",
, o( Y, q* u4 z. B" x+ R"msg": "",
* L% H; u: I& L! h$ E2 n+ F"result":{
+ ~$ C! a/ O& p7 S0 w, z"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"6 f) M! M) a& i) j8 T' S
}) o0 n+ W% v$ v! ?. x0 e
}( D: M; Q/ W# G8 `* S0 R& b) S' F3 w! v
参数说明 address 钱包地址8 q2 H4 B' O1 d; |) O
1.3. 查询余额
+ N4 h2 w& e# t% E+ P. D请求地址 http://IP:PORT/api/wallet$ m' B6 `) v! b3 R+ U9 s- f
请求参数' ]# Y- |$ x0 [6 ^
{% j+ {8 m$ H7 r  ]
"cmd":"wallet_balance",
1 w/ H2 B" F9 E4 J- d, E/ R9 `6 ?"params": {
( V: K2 O2 z- t+ T5 ^/ l0 c"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"- l" E( ~5 {  I+ J
}) x* o& v8 F% Y7 }
}" @1 u# b7 Q, a/ Q4 f
参数说明  Q+ [/ q- l- D' W( y( M6 P- a
参数名称 说明 必填- Z( K; }1 M) }2 `$ {6 w$ E
keystore 钱包keystore Y
* i8 ~; g: |" z+ W6 g" Qpassword 钱包密码 Y
. X7 B% e" j. t, d' y4 j响应参数, \8 ?9 k+ a* y, {6 ^7 f
{, t- f! ~$ W+ ?6 b0 l3 b
"code":"0",
, m( {. d6 R- n) _! K4 y"msg": "",7 k' U# t" A( L) t
"result":{$ u* g( }/ P2 }
"balance": "88.2",
- \- |! M9 w' p: l"eth_balance": "0.03",0 u( L4 Y  }: q8 L1 ~  |
}% X  L. p) a: [+ _$ {
}* W+ g% \# w  @7 S! \$ l. X, t3 L
参数说明
* V0 k0 A0 s# X9 ^9 P( f9 j8 y0 Oeth_balance 以太币数量
2 f& ], I! w/ \, nbalance 代币数量5 ?0 U* \' c: \; z) C, M# J
1.4. 代币转账% K; q( Y1 }5 S( o, [8 P$ }9 N
请求地址 http://IP:PORT/api/wallet
* ^1 r* I& G' l6 f0 V1 Q8 v请求参数1 V2 u! ]; S5 \$ f
{
& s2 A6 C2 p- Z& X5 i0 L"cmd":"wallet_transaction",$ m9 Z+ X/ ?9 l* c8 t
"params": {0 U5 s! X  C& p
"from_address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
- s/ t( q2 s. k' Q9 B0 u"password":"123",
( n$ [# C, L. H) r* R"to_address":"0x113d79bea1f6ff0681a778dace3c64d5ff915c89",1 ^$ Y) M3 b9 o2 U4 D
"cost": "0.00018", * a+ F9 }* |0 e
"num":"0.22"% u0 M% o2 a6 a( b& D9 ]) Y
}
6 r! t2 |6 h% Q4 f9 D9 U! @' v, Z}( O: g! ^; z' y) A0 Z5 r/ K" V
参数说明
2 b3 N1 p! F7 {, I# T参数名称 说明 必填
' C! s1 Z. p; L! }from_address 转出钱包地址 Y
0 l& ?. \: x) x+ ]" z/ u2 @! hpassword 转出钱包的密码 Y
, l% t/ E+ g1 o  l6 ?1 [to_address 转入钱包地址 Y
, K( x) Z# {, {1 T  fcost 手续费，单位：以太币。（手续费越高，到账时间越短，过低的手续费可能导致交易失败）目前限制了最低手续费为 0.00018 Y
8 J) M  {* x5 [, h* Anum 转出代币数量 Y9 {" }$ ^: p: m& v
响应参数
  A8 ~; g: \% ?6 _' y$ j& g( `) l8 X{$ p3 l, o( X: Z/ K1 f
"code": "0",
1 g: G% H$ c! s' H. ]- ?"msg": "",
- J& E) A0 L0 N6 N5 W0 a# z$ m+ g"result":{2 ]6 f$ o% h& e
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"- M9 h; M6 n* B+ }
}, n5 p: b1 g) H) L& h  i- a
}
  K8 h5 K" r: G) O参数说明 trans_hash 交易Hash值
; r4 r# B3 |$ C/ `6 Q" ~& v9 ^; K1.5. 查询交易状态
+ n8 l8 J$ N' z2 Y" W$ f7 O3 N请求地址 http://IP:PORT/api/wallet
1 X' S' g) r/ h& d, D& s- c* D请求参数' X- U: r# z9 n
{
7 S* E- Q  _/ c# o. Y+ B"cmd":"trans_status",
" ?  e+ Q; v' T: v" U& O"params": {' h7 W( U9 R* e
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
' O5 z& t8 _* H! H}( j" q% U+ C/ [: t8 m7 Q5 X
}4 }- |5 D; i' p8 T
参数说明" ?; Q! e4 B) ]! r8 P$ v0 s* C
参数名称 说明 必填
7 I7 g8 u; d0 Y/ ]1 Mtrans_hash 交易hash值 Y6 D- H; ?: k3 Q, J3 z+ S6 i
响应参数
! u: G2 ?; \8 n, b$ I{: n: T1 n* W7 B+ b
"code": "0",+ c& L$ l6 w/ [" _2 A! m  \- B2 A
"msg": "",
! r" E' X% v+ i1 J. {"result":{, v7 N9 y3 n6 \# W3 q& l7 u
"status": "1"
1 |- ]& H3 A# ^* A" }: u}
5 i4 E6 T  u8 d* a}
3 S% u) D' {& b& X参数说明 status 1 交易完成、 0 未完成/ D+ q& H, ~* K1 j
1.6. 查询交易详情
& |" N( _, Z/ g* q请求地址 http://IP:PORT/api/wallet
1 j0 v) |1 @0 R9 U" j请求参数' T7 Y0 I  ]5 F* a2 P# b  W+ [$ R
{
6 Y7 L# G# G  V  a$ [8 n"cmd":"trans_detail",
. d/ ?# ]2 q* _; X6 J1 o"params": {& _  T  p! \" P7 m  }; U2 O) P" j
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"4 z; Y! {9 \+ G1 ?  E
}4 o( g; [9 m0 ^0 n
}/ O- ]: d; Q! Z
参数说明) `+ [/ q( q  P. D
参数名称 说明 必填1 Z5 M7 O/ b8 d% g# b: O
trans_hash 交易hash值 Y
1 f' X+ h+ |: R5 V8 B+ z. e$ e响应参数
8 v- a# X# V4 [# I, R{2 O9 ~* W" |. Y  H2 J1 m
"code": "0",; G9 r7 B( F/ t4 O, w
"result":{
0 k& J4 R6 @6 O"num": "2",+ w3 \# w* Q: q* m
"from": "0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",4 q( Z( ^8 C. z
"to": "0x33852530794c67fac23a010e2e4a88fb84477ff2",
. B! v; O- ]0 J4 r* C8 D( `  i5 ]"timestamp": 1525774296! t$ w1 e' Y% m8 Z4 g2 s' L3 l" q1 q
}9 ]8 v5 u5 \0 `. R
}
# [3 |2 M3 W1 Y2 l+ {% P4 [参数说明) m) t. W% \* z* b+ p9 g
1.7. 查询交易记录
8 O! W! H; c+ A, Z, b请求地址 http://IP:PORT/api/wallet3 G4 g/ ]( m/ d+ q. q& d
请求参数& M! S% r+ s) U2 B/ k. Z
{& {- X6 m& V2 p8 R
"cmd":"trans_record"," Y) H( B2 y& p; n) A
"params": {* W+ q1 s! I$ E: U
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"# x2 ~" F2 y1 a- J
}0 Z6 O7 k1 O, V0 ]$ m9 N
}
9 i4 ]- v- [: M- ~3 u1 M0 L0 v, F参数说明
( w6 ?7 z7 Y# ?3 O/ @参数名称 说明 必填
0 l5 J$ a$ M7 \6 D3 D" y- Y1 \trans_hash 交易hash值 Y, `9 ], Z) X6 u: g1 |  W* c
响应参数
, B+ u6 i: Q# k{
' [+ y: h: l0 g2 J, p: [) W"code": "0",
+ a/ K: j+ ^5 c"result":{
8 A9 M3 Z7 x0 j1 {7 `3 s5 w"records":[{4 O5 q: W9 T" A0 F& ^
"num": "0.02",
" j* P! }* Q& Q! j6 u5 C1 N"from": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",
) G9 q( i+ ^( Z"to": "0x70550b9acd503d5154d21985426a0829612dc060",
  A. H* w  z5 V+ C0 c- }$ e' i"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",  c* _2 ?: B& g6 D$ h8 \3 Z) w
"timestamp": 15257742962 R+ K% c5 m7 F( n/ s
},{5 H9 I( {. K7 S: c, J
"num": "0.01",# ^2 a& Q0 v8 U2 E* z. F
"from": "0x70550b9acd503d5154d21985426a0829612dc060",
" s# ~. E* ~, g2 h* |" H: f"to": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",& f/ _' }3 W- }
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",
: ?, i4 u0 K+ n5 i9 }7 g" e9 L"timestamp": 1525774296' Q: ?8 p8 Y' ?' R; H. T/ a
}]5 }5 d+ a$ K3 i
}* x& U: `( n0 z5 f/ m$ h4 ]
}