币币合约执行解析(包含部分源码)

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

contract TradeOffer(assetRequested: Asset,
' a$ O" J$ n" ]8 z
amountRequested: Amount,& m( s3 F {% K" s) H4 j
seller: Program,- ~3 ]8 ]2 }3 G# ?, B
cancelKey: PublicKey) locks offered {$ f. c8 m6 K9 n! S) h9 J
clause trade() requires payment: amountRequested of assetRequested {
1 e# ^* T1 _7 p
lock payment with seller
: \) \! T+ P) P& t- v' _* t# f
unlock offered4 [/ b! r) q/ Q& Q
}
) m1 X% Z0 M3 O, ~
clause cancel(sellerSig: Signature) {
" S7 S2 [9 }4 K9 [" y: }
verify checkTxSig(cancelKey, sellerSig)
Q% b& U' I& R- a: a: K4 l
unlock offered/ \+ w# @6 L! G& A9 g% L
}
2 Q: B+ R$ c3 q& k# k" z% q D
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 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();% t9 g' t$ \0 t" C" D, r! l. z/ c
JSONArray agrs=new JSONArray();
* Z5 y6 z9 R3 v$ r) Y. F2 v6 `* S
//合约的四个参数值* B! s& X2 E7 ?( b3 r
JSONObject assetParam=new JSONObject();
" b/ F& y7 |! Q* t
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");
" c5 V/ z: w9 ^1 s4 O( @
agrs.put(assetParam);
, c5 U! Q# s$ W1 U F L1 v$ h' j
JSONObject amountParam=new JSONObject();0 ~6 W) ?8 M) |% Q b# g: B
amountParam.put("integer",200000000l);/ N4 Z6 U8 N' d8 A" F& G
agrs.put(amountParam);, g+ G" X6 V. E3 g
JSONObject programParam=new JSONObject();
* ]3 b6 _) |/ F# ^+ n
programParam.put("string",control_program);& C: A3 m7 _, z/ t- j7 D' G ^
agrs.put(programParam);+ f# C2 J4 j' _0 x/ e' ~
JSONObject publicKeyParam=new JSONObject();+ o" L6 p2 h W' S ^
publicKeyParam.put("string",pubkey);
% G5 E+ ]$ N3 l- s/ u; s
agrs.put(publicKeyParam);9 d$ p& b- ?0 ]. ?2 V" o
param.put("agrs",agrs);
) G2 m7 R" j/ s( V
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 } }");+ m3 q+ Z) h! {; b2 j0 u* |# X
//调用编译合约$ k) i+ M6 w% a0 ]: V" O
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject();/ F+ H% X6 _3 m
agrs=new JSONArray();
$ `" r; i. F( O
JSONObject spendAccount=new JSONObject();
, P( O( K7 R V' q' e; L
spendAccount.put("account_id","0H757LPD00A02");7 c" l F6 A* y; s% Z# [7 k
spendAccount.put("amount",9909099090000l);
& }! c6 |5 W6 L) p8 r# ]
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
1 |! G, d1 x5 A
spendAccount.put("type","spend_account");
; s7 |0 I2 I: b# G' ~+ w
agrs.put(spendAccount);, f _: j) a1 v# u8 k
JSONObject controlAccount=new JSONObject();
~8 \# K" S* n- R# ]
controlAccount.put("control_program",program);3 h- m, p/ w. W3 d: F5 J3 S
controlAccount.put("amount",9909099090000l);6 z: O1 x" f& B, m1 _: j1 [
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");- Z( H4 q1 f# A/ \$ |; r
controlAccount.put("type","control_program");! ^) V2 k+ D8 w6 g1 c
agrs.put(controlAccount);& ?9 p/ L+ N: v0 |
JSONObject spendAccount2=new JSONObject();
+ z* G1 X& O6 `' b/ X8 f$ X
spendAccount2.put("account_id","0H757LPD00A02");) @1 ~, h4 U" m* _
spendAccount2.put("amount",6000000l);* Y' l4 B; H( o0 H) T
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");. s* Z8 ^* V( ^
spendAccount2.put("type","spend_account");" M2 O" b. W% v4 }& m. `4 G) o( p
agrs.put(spendAccount2);
, O1 {' m0 F0 a$ O2 M" K
param.put("actions",agrs);
! G" [5 G; {1 b" d
param.put("ttl",0);
2 a4 o" W' o/ u1 O" P- ]+ O
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: [{( ^6 D0 D1 i; `
type: 'raw_tx_signature',
+ l/ l. ~1 y+ e9 I
// 生成合约第二步的pubkeylist 详情
/ ?) t) y0 x4 c: F( }
raw_data: {
0 @% Q _9 e1 T2 X" N: i! _& t/ a
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,* M! ? ?' S8 L9 x6 L5 n7 m
xpub: pubkeylist.root_xpub, h% |& z: S! S( }) l* u
}; G9 f9 Q6 \/ ^0 u0 t
}, {& k6 s) ^/ G- v" \
type: 'data',! X9 T. k& W+ P
raw_data: {0 @) |* p5 G+ Q
// 参数偏移量在一个合约里是固定的
$ h+ Z6 @& m6 k
value: '13000000'
9 B) j9 t9 s& S
}
. B9 x8 P: p) b# ^
}],
. J# w/ W, U: u3 y" Q3 K- s5 f
output_id: output_id,
) C& V' ^! Y' G" X
type: 'spend_account_unspent_output'4 f' c3 Q+ m' T3 O
}! S# i6 _% f5 z1 @
const controlAction = {
, H1 @* s; X8 k
type: 'control_program',
- {+ _) l6 R$ T6 P# ~& |7 j
amount: 100000000,
6 ~8 H9 `8 s+ l, @, c# v# O% U5 H
asset_id: asset_id,
, Z+ ^0 e0 \* Z# h* G |) \6 }
control_program:control_program* [4 T# r1 Y% V9 Q) `; j
}
! |9 M( } {& C( B
const gasAction = {
! ? Q* [& F% R* s) H+ k
type: 'spend_account',1 z) d( U, D* R, v* w
account_id:account_id,* z- L' q, ?! L- K: ~- z/ X/ P
asset_alias: 'BTM',! j C, v% ?3 a* J
amount: 500000000 T. a( [- u- |6 _9 n
}

复制代码

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

const spendAccountUnspentOutput = {
2 M' E9 V8 h& |
arguments: [{& e% }/ W7 L% L0 p+ n' z% E
type: 'data',
. j2 s' _ c; _/ f3 @ [3 |
raw_data: {
$ a* ^# I7 h" R$ c
// 执行合约输入资产偏移量7 h8 U/ B3 T% ^: W
value: '00000000'% Y' v4 j$ L l' _' U
}7 R/ N; ]% K% b* P+ D' F
}],
9 G0 F, h* N4 d( A0 m
output_id: output_id,
) {' m J" \" {7 H2 Q
type: 'spend_account_unspent_output'+ _( ~3 e7 V7 {. X' \. K
}
7 }4 Q: k* n( Q6 y5 A( |
// 合约执行提供的资产+ g K8 j% y/ e3 i/ U
const issueControlAction = {
" z) ]- f9 i1 ?- [% q o9 R) K
control_program: control_program,
' ~% O( c1 v5 Y
amount: 100000000,
* [. w! Q* W$ P" h
asset_id: asset_id,' ?' J: Y* ~& Z% s
type: 'control_program'' o. z- \0 [5 h' Y) A
}, Z, Z0 N) J$ D8 L0 B! J- X8 S
// 合约执行提供的资产
( J* } A! P8 C3 a X+ p3 B; I
const issueSpendAction = {2 v7 M# W: J9 N7 ~ R3 _4 ~
account_id: account_id,, w" p/ V, a! z: H" U8 Q% x+ s) l
amount: 100000000,
1 q* z4 e; K( Q1 k6 Z
asset_id: asset_id,* X) X+ ?4 p4 H' c, w
type: 'spend_account'# E% r+ s+ d. r$ D6 b+ `0 n0 @
}( }' `6 s) [* Y# r" g# k# i
// 旷工费. C4 P8 R4 T2 R5 M
const gasAction = {
5 i; P1 H! [0 S+ s% r4 A
type: 'spend_account',
1 u% s: d! o$ W2 C
account_id: account_id,# A/ w, ?) D, K
asset_alias: 'BTM',7 R. ^7 X; q8 @8 d, e$ R# A
amount: 50000000
`# N+ k* F, p6 v$ K! R, `
}8 K- O' d) B$ q/ p7 t2 A5 Q
// 合约执行获得资产对象
\: z% b) K5 I6 _% O* [' E: b
const controlAction = {
" N% P$ A/ C z$ f* |
type: 'control_program',
3 R7 T, _6 i6 H# O. `2 ^. E3 L/ D
amount: 100000000,
' W" c7 s" v/ r5 L- E
asset_id: asset_id,
4 P/ V2 k& Y5 |/ N4 i( T/ s3 h
control_program: compileData.control_program
7 o8 \8 q2 P$ u" u9 R; P
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {) S/ L5 [: F5 l# c" q
OkHttpClient client = new OkHttpClient();
3 H/ \0 G3 m) L, w- f3 `7 L
MediaType mediaType = MediaType.parse("application/json");9 _, B" Y' H2 [
RequestBody body = RequestBody.create(mediaType, bodyStr);
/ `6 ?: h }! d0 O% G+ ?, x
Request request = new Request.Builder()) Q* s2 J) I) N. S- X: u
.url(bytomApiserverUrl+"/"+method)
8 u1 j! W; E* t+ O- m
.post(body)( A% k# {& ~1 n. R. J: M
.addHeader("cache-control", "no-cache"). R a" O7 {3 Q# s' x3 I7 K8 _
.addHeader("Connection", "close")
" V! n1 N9 z$ o @4 u
.build();
" n5 y6 ]3 @ c, V) ^9 Q: A4 w
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){$ ?+ w: a8 l8 K
}else {
9 V9 z7 L: @& H$ f, I7 @) Q
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));4 a+ H* Q( U2 Y" ^+ l! q
String authHeader = "Basic " + new String(encodedAuth);
3 Y9 i) M0 X1 J0 X' t; p* \" Z
request = new Request.Builder()$ ^$ d- T. L' k6 d v
.url(bytomApiserverUrl+"/"+method)
4 w W9 k' A- S. N6 j
.post(body)
; Z# Q& ?7 V' S' t! _' q1 q7 Q' m$ h
.addHeader("authorization", authHeader)
/ N' g2 x# P3 X) r' Z h
.addHeader("cache-control", "no-cache")
4 g5 z" Q8 g: X! I) J _( N
.addHeader("Connection", "close")
* ^2 _6 }. g$ y! u
.build();
^+ \& M( h6 b! @1 P2 Y- W4 F
}5 N7 N c8 z0 G: y# v6 ~+ W* J
Response response = client.newCall(request).execute(); z% _) m# t P V! @
return response.body().string();% t5 y$ q0 p) n/ o) n8 w) V
}

复制代码

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

浏览过的版块