币币合约执行解析(包含部分源码) - 区块链技术 - BitMere

本文解析的为比原提供的币币合约模板如下：

contract TradeOffer(assetRequested: Asset,, Z, _( m( ]3 i: \1 D$ _/ p' Q9 P' H
amountRequested: Amount,3 n0 F0 w+ A c2 H6 j+ \
seller: Program,
6 ?4 L0 k6 R& i3 O6 j! m
cancelKey: PublicKey) locks offered {
* U& w7 L8 p& h! b: S
clause trade() requires payment: amountRequested of assetRequested {+ C/ n1 t! V( i" c* L$ a: d
lock payment with seller
- {: v* ]! E+ l, i
unlock offered
8 z& W" U9 b6 |6 f
}( x2 I# w3 d, p. t4 l& A0 M
clause cancel(sellerSig: Signature) {$ [! m1 O$ V8 ]8 o
verify checkTxSig(cancelKey, sellerSig)
3 Q6 r- d6 ?! h: d0 u
unlock offered
- T. D+ Y& c+ d# o6 V% t
}% b& u4 l/ `% L
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 Equity 语言入门学习，方便更好的理解该文档
锁定合约
第一步：调用create-account-receiver 生成 control_program

以下是相关代码片段：
sendHttpPost("{\"account_id\":\"0IJVD7MNG0A02\"}","create-account-receiver","http://127.0.0.1:9888","");
第二步调用list-pubkeys 获取 pubkey

以下是相关代码片段：
sendHttpPost("{\"account_id\":\"0IJVD7MNG0A02\"}","list-pubkeys","http://127.0.0.1:9888","");
第三步：将1 2步获取的值调用compile接口编译合约获得program 合约程序

以下是相关代码片段：

JSONObject param=new JSONObject();
: ~) V7 h& F ?% J& C6 v
JSONArray agrs=new JSONArray();8 I& ^" B( |" z9 o- m& n
//合约的四个参数值
1 S9 R! Q8 x' x
JSONObject assetParam=new JSONObject();
" _: ?+ s6 ^! j8 q" Q7 V
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");- f. o3 h( o+ ?8 a
agrs.put(assetParam);
& E6 P. \% L) H# u5 ], h; [
JSONObject amountParam=new JSONObject();/ t6 Q% F3 x' C. S; s( U6 a5 \3 c& e
amountParam.put("integer",200000000l);
+ J! }. S! K* G- G( {
agrs.put(amountParam);+ U4 @ v# L# N( d
JSONObject programParam=new JSONObject();
4 Z9 r. y" m8 n/ p/ d3 X
programParam.put("string",control_program);
5 C$ X- o, |4 j
agrs.put(programParam);
+ O2 g( a4 S- _2 f
JSONObject publicKeyParam=new JSONObject();+ N0 h2 x; \/ r# h: b# _' d5 ~* l
publicKeyParam.put("string",pubkey);
; f% J$ t9 u8 u9 w1 E% z2 y
agrs.put(publicKeyParam);. N5 U. y5 |1 H3 F4 b- k
param.put("agrs",agrs);0 {0 e& J/ v- |6 I# f
param.put("contract","contract TradeOffer(assetRequested: Asset, amountRequested: Amount, seller: Program, cancelKey: PublicKey) locks offered { clause trade() requires payment: amountRequested of assetRequested { lock payment with seller unlock offered } clause cancel(sellerSig: Signature) { verify checkTxSig(cancelKey, sellerSig) unlock offered } }");9 X3 } s; V" r- O% i
//调用编译合约
' ~" r+ L& c/ ]5 p1 l5 w0 Z
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

第四步：将program 传入build-transaction接口去build一个交易的到data

以下是相关代码片段：

param=new JSONObject();' A0 T& t4 \4 a3 g$ M
agrs=new JSONArray();( y5 E1 f& |* }) a. b
JSONObject spendAccount=new JSONObject();+ E: o# U: {6 Z d
spendAccount.put("account_id","0H757LPD00A02");3 [9 r5 e0 q, |; c% N( D
spendAccount.put("amount",9909099090000l);, _% n7 J' |& g* k& u" B! h1 W( M
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
, |& z- W0 {+ M/ T, {% V. _
spendAccount.put("type","spend_account");1 \* G8 {# E+ u- N
agrs.put(spendAccount); J9 t, j( B' }; t
JSONObject controlAccount=new JSONObject();+ h. }4 q+ p' c/ X" M* {
controlAccount.put("control_program",program);$ H v6 y9 G/ D- b# E) z
controlAccount.put("amount",9909099090000l);
+ R9 Q- k$ c# @ W5 r0 A& p! f" B- Y
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");; S- \( b" L, q( E$ i
controlAccount.put("type","control_program");( g8 x' M! c5 u' t9 k9 x3 Y
agrs.put(controlAccount);: u2 m1 X. ~, e* v" ^" M8 A
JSONObject spendAccount2=new JSONObject();
* ~' g& u, S+ w( Y
spendAccount2.put("account_id","0H757LPD00A02");
0 P0 p/ v1 @5 R/ {! O
spendAccount2.put("amount",6000000l);( H2 `* x5 O1 m. C" ~/ r2 R
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
. B9 H. i* `1 ?0 C
spendAccount2.put("type","spend_account");5 w" U2 P9 `# m# a) q" D
agrs.put(spendAccount2);9 E" H3 d2 l9 j$ k- [% q' v
param.put("actions",agrs);
+ } h6 I' N- P: q; w. Z! a+ A" y, H
param.put("ttl",0);/ S2 Y! V8 o2 ?; }5 o/ R
sendHttpPost(param.toString(),"build-transaction","http://127.0.0.1:9888","");

复制代码

第五步：输入密码调用sign-transaction签名第四步build的data 得到raw_transaction

以下是相关代码片段：
         param=new JSONObject();
         param.put("password","xxx");
         param.put("transaction",data);
         sendHttpPost(param.toString(),"sign-transaction","http://127.0.0.1:9888","");
第六步：调用submit-transactions提交交易

以下是相关代码片段：
         param=new JSONObject();
         param.put("raw_transaction",raw_transaction);
         sendHttpPost(param.toString(),"submit-transactions","http://127.0.0.1:9888","");
解锁/取消合约
首先需要decode出生成合约时候的参数
调用list-unspent-outputs 获取生成的合约信息获取program

以下是相关代码片段：
param=new JSONObject();
      param.put("id",outputid);
      param.put("smart_contract",true);
      sendHttpPost(param.toString(),"list-unspent-outputs","http://127.0.0.1:9888","");
调用decode-program 传入获取生成的合约参数信息

以下是相关代码片段：
param=new JSONObject();
      param.put("program",program);
      sendHttpPost(param.toString(),"decode-program","http://127.0.0.1:9888","");
需要注意的是decode出来的为值是逆序的(后续会有文章详细介绍)
解锁/取消其实就是把生成合约的步骤中的第三步去掉,替换调用生成合约第四步的参数即可
取消合约的构造参数如下：

spendAccountUnspentOutput = arguments: [{/ q5 H# @! D) Y, k& j& k8 L
type: 'raw_tx_signature',
- b. V% R( ?! Y; b3 _$ e3 |2 M. T2 N
// 生成合约第二步的pubkeylist 详情
5 w1 A1 Q: |1 K) ?3 J8 k9 V
raw_data: {
6 l! r. H& m$ i9 c% R( o1 t" k6 B
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,# \1 \, B9 ]. W0 K8 e
xpub: pubkeylist.root_xpub+ g u8 o$ n8 f
}
% q% N7 H" R9 O
}, {+ X/ @! H0 K: ^3 G; t, q
type: 'data',9 _: ]0 r6 S; T
raw_data: { A/ a3 ^# T. M1 [8 B
// 参数偏移量在一个合约里是固定的 & s. ?0 L8 C! Y- L, f- n7 a
value: '13000000', b$ l0 ~7 }0 `) G& j
}
! s7 z9 x! E% `- H. \+ `& O9 g4 x
}],+ \( |8 w9 f3 F9 n1 k- v+ O
output_id: output_id," g9 N# M- W( {, W i
type: 'spend_account_unspent_output'! n2 t8 s% D$ Y1 B6 D1 M
}
! N% h/ p, B- v; q' o; X6 j! }
const controlAction = {/ D" F% V* u9 u$ ~1 N3 C
type: 'control_program',0 [. ~& C) j; e9 y* d! o, ?1 T5 r" v
amount: 100000000,5 e/ W0 ~& k1 ^* b9 G8 Q' _
asset_id: asset_id,
! v, ?/ A3 t; R
control_program:control_program" @' @% g8 Q4 S7 V' b2 o1 @* w" Q
}7 |7 |6 @$ V [4 y" S
const gasAction = {
& ?9 {* r5 E0 s0 {" i
type: 'spend_account',; |# L6 Y& T, Z4 Y4 [2 V
account_id:account_id,
, e! @$ k2 @9 k! i! v
asset_alias: 'BTM',
/ Q+ A. A0 Q- @/ l3 o9 \
amount: 50000000
7 a: T, }% [% e2 H3 j3 s
}

复制代码

执行合约的参数构造如下：

const spendAccountUnspentOutput = {/ f8 I6 _3 {! p- t# {1 | i4 h
arguments: [{
6 |9 i& L, t( o% i# N
type: 'data',
D# T( |$ d8 i% G; f, e
raw_data: {4 j" H6 B) e1 c2 j# P3 a6 h
// 执行合约输入资产偏移量
2 X7 G2 I7 p! l( T. Y) y
value: '00000000'$ d! ], b7 K; @( C. n
}6 \/ [$ e+ u. ~! W$ b1 K3 X/ `
}],
* c$ ~& Q8 T. u' ?
output_id: output_id,7 D0 B9 b: T" v& a' Q
type: 'spend_account_unspent_output'& ?3 L9 ^) N; C1 J! @% j% r" W
}
6 o3 {1 `; D! z) z: ?
// 合约执行提供的资产 O( u! G* a8 l5 d% X8 U, t
const issueControlAction = {
: n% R G: ^! r' ?* i
control_program: control_program,
' m3 R5 P& k2 m* G. v
amount: 100000000,
9 O: n, P7 l6 R" [8 `
asset_id: asset_id,
- l% w, f- a8 c
type: 'control_program'
( s& u+ ~$ J4 O& @/ V7 A
} G V9 y6 c( [+ f8 i3 D1 T6 P9 C3 ], N
// 合约执行提供的资产% |2 I/ w: x: a! d( u6 U. _
const issueSpendAction = {
2 _" p# o3 P4 o9 T- s5 t7 k7 \
account_id: account_id,4 M% e# }% b1 e6 ~4 l% c9 A* b
amount: 100000000,
, S2 p+ G+ h' Y* ]* d9 W. I
asset_id: asset_id,- o3 j3 O4 V. i7 g5 H
type: 'spend_account'' k7 ^$ k/ h" F- B; J
}0 W; z/ V, R7 O+ |- |; q
// 旷工费
( P, O. q+ ^! h
const gasAction = {* N+ E) W8 {5 j0 }2 B2 V$ X
type: 'spend_account',5 m' j8 ]- x. c7 \+ |1 ]
account_id: account_id,4 o. K- o- y! q6 m3 ]- r
asset_alias: 'BTM',) h8 X7 p* p) A9 M5 _* N
amount: 50000000
$ [6 r% J# s$ Z; D, k
}3 d) |- _7 `1 V' G
// 合约执行获得资产对象
$ B& \, a" \6 z2 [5 e
const controlAction = {
5 ]4 S+ \0 F: r& f% K
type: 'control_program',! H0 ]/ N2 x. T
amount: 100000000,
8 l6 S5 U, N+ d+ o- D0 i2 J0 Z& S
asset_id: asset_id,( ^7 w& y* I: t! O. `) E' O( B- a
control_program: compileData.control_program
2 F+ e( s% F; L* I
}

复制代码

build 操作其实就是指定输入输出的过程,详情请查看官方build文档和官方api文档
备注
调用比原基于okhttp接口javautil 如下：

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {
; V0 [, b) l; P; l' n$ |
OkHttpClient client = new OkHttpClient();7 x5 J! ^- C7 _* m3 I, `" ^& U
MediaType mediaType = MediaType.parse("application/json");
% u. f9 E H* }' O
RequestBody body = RequestBody.create(mediaType, bodyStr); h% {/ C8 P1 ]+ N+ I
Request request = new Request.Builder()
* U, k9 m) Z6 v- J
.url(bytomApiserverUrl+"/"+method)9 p( S% @1 P" }, E% d, ?; Y
.post(body)
& o' N% `( }) Y2 ?4 X5 ? M
.addHeader("cache-control", "no-cache")
4 r% Z5 R( M7 m+ G
.addHeader("Connection", "close")* f" ^+ m, B; F$ |
.build();( J& a8 E) J: [$ b
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){
' J, T" k- R4 P8 o! c. Q x( M( T
}else {
. A2 W* V4 Z3 j
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));% J' C p' E2 L9 ~; G
String authHeader = "Basic " + new String(encodedAuth);$ J3 I% |2 D3 _$ E. j2 @
request = new Request.Builder()
6 P: A/ P5 M7 s' b. l" n% T' u! j
.url(bytomApiserverUrl+"/"+method)
# a: G3 }! l& E
.post(body)
4 N0 _+ J* u; g' ]+ Y
.addHeader("authorization", authHeader)
7 h; K$ s0 N! S) j q, j" I1 D
.addHeader("cache-control", "no-cache")
7 H- `9 a. B; g% |8 ~# @
.addHeader("Connection", "close")8 y* M1 X4 g p5 e$ a8 y k
.build();
5 h( ?! q/ }0 P: z* {6 v. N) b
}
( C7 M8 u+ l, |. |9 w
Response response = client.newCall(request).execute();
& C. s% O. [4 u* H
return response.body().string();( D5 }5 s/ V, b$ v" n
}

复制代码

比原项目仓库：
Github地址：https://github.com/Bytom/bytom
Gitee地址：https://gitee.com/BytomBlockchain/bytom