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

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

contract TradeOffer(assetRequested: Asset,
" p9 Y- E" g9 ^) {$ K' }: y
amountRequested: Amount,
8 u; p* L0 _2 s8 p) e
seller: Program,' Z3 y9 C- T0 j" b6 d. [
cancelKey: PublicKey) locks offered {
( H0 d. L3 C9 R& W f' i% @
clause trade() requires payment: amountRequested of assetRequested {! l/ N; t5 A. j3 m- U& s. b
lock payment with seller
" n5 k7 O+ j( p
unlock offered
- `1 W8 {- g6 T* V* d2 d+ V
}
E& r* b! i( t8 B
clause cancel(sellerSig: Signature) {, T5 U- a5 U! `- {
verify checkTxSig(cancelKey, sellerSig)* M( `4 U4 C/ I: ^9 y( _2 C9 {
unlock offered
; d( m6 g: A7 I! f! S6 ?3 s2 Y
}& W+ T. r- ]' x7 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();
7 [, Z( H0 S. ]& B' R- U2 [
JSONArray agrs=new JSONArray();
. {7 O* O# M2 Q7 Z: h8 s
//合约的四个参数值
( \4 X# `+ m/ c( S4 I6 C# S5 I Z
JSONObject assetParam=new JSONObject();2 H( _, N# P' U* G' Z! L( |
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");
; R6 L1 T/ t' v4 |
agrs.put(assetParam);
9 [3 |# x4 ?1 K& c8 Z' ^0 ^" U
JSONObject amountParam=new JSONObject();' J( r! [' s4 G* L2 N
amountParam.put("integer",200000000l);4 I( k7 q* {0 g. B$ F& R# G
agrs.put(amountParam);
& t5 H K9 L! q2 y3 \3 D1 t" j
JSONObject programParam=new JSONObject();
! p5 Y( b: @' n2 e: w! H; z
programParam.put("string",control_program);
: @0 d8 R, F( ^, t% K' }
agrs.put(programParam);5 V/ f, c/ }: U* w' f9 k9 V4 z
JSONObject publicKeyParam=new JSONObject();
t3 O4 o! D9 h( i) y4 h% Q7 A, E" H
publicKeyParam.put("string",pubkey);
0 u) \& \6 I2 `( M* J( _
agrs.put(publicKeyParam);- y/ s8 B5 N& O0 o" h- Z C* v! ^
param.put("agrs",agrs);
/ D2 }' d+ }2 G% {$ u0 P
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 } }");7 h5 M: n3 J8 r9 A& p% P A4 d
//调用编译合约* o& }7 F3 v4 |$ l) a- c
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject();& I. Y4 V4 C# S
agrs=new JSONArray();
& N, D( U) G; L i2 W5 E
JSONObject spendAccount=new JSONObject();
7 w! X, w( b1 @' N1 H& [
spendAccount.put("account_id","0H757LPD00A02");0 R9 b6 Z" P4 x2 b1 J6 s
spendAccount.put("amount",9909099090000l);$ T7 b e4 E: s% S* n3 I2 T3 d
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
4 @, |" L; i: t( W
spendAccount.put("type","spend_account");& V: P; O4 U# `3 F
agrs.put(spendAccount);! T" a7 Z1 G2 ~' l4 f
JSONObject controlAccount=new JSONObject();' A- s4 Y! m, t. X4 H9 T' [1 L( n
controlAccount.put("control_program",program);
) ~8 D8 M. w; e% {+ J
controlAccount.put("amount",9909099090000l);
# \1 R2 W# L' \
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");) o% b+ r3 H1 R0 d+ ^ p7 Q f
controlAccount.put("type","control_program");! [# d$ a4 H% E6 b: h o8 X Q4 k
agrs.put(controlAccount);6 G3 |" O& F# f
JSONObject spendAccount2=new JSONObject();
: V# C6 n9 F7 j1 J4 K
spendAccount2.put("account_id","0H757LPD00A02");
d+ ^8 Z- R' C( j7 |9 V
spendAccount2.put("amount",6000000l);
7 E: W4 Y1 I" U" ]+ W& `/ x
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
1 V7 G3 J4 E4 \& I8 d0 E) i3 h! B
spendAccount2.put("type","spend_account");# a& N& D* ^2 ?$ @
agrs.put(spendAccount2);
* a' @8 j; k, D: W0 J, A2 o
param.put("actions",agrs);
6 F! |- d! u% b+ D- R' f
param.put("ttl",0);
# K+ W: O( `4 E% @3 v" o/ M
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: [{. Y: X& D1 {( h* L
type: 'raw_tx_signature',3 R0 w3 ]3 C; B. I
// 生成合约第二步的pubkeylist 详情" H( ?$ y( n1 x- W2 | L
raw_data: {
" v& J5 y, q* @% E ]- n; J
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,
. V/ L0 I; h6 v/ G. ]) ]2 h" Z
xpub: pubkeylist.root_xpub
: s; j: F7 F6 E: \* Z
} |1 B2 j$ X; m' M, P" D6 d3 r
}, {/ N2 h1 ]: X' m( X& i
type: 'data',9 G1 N! [0 E+ L! I' }2 `
raw_data: {! _! T* @( r: {$ V7 u6 L# M5 u# K! A
// 参数偏移量在一个合约里是固定的 ' \. J% q6 y6 u1 j% s2 I
value: '13000000'; `+ [- D/ R; g# l
}
! \, o7 P$ e1 ^
}], S$ s# e4 S7 R! F3 o: ~. a
output_id: output_id,3 _* _2 ?: J0 e( @* G
type: 'spend_account_unspent_output'
3 P( L( D7 j5 a* v. @1 G
}
. ?) H# h9 z n0 }" N
const controlAction = {0 x! ]/ u* }# n- F
type: 'control_program',5 \* ?- X+ z4 _7 U4 ^6 B
amount: 100000000,/ G; {, o% ^9 W
asset_id: asset_id,5 W$ U' X4 i8 j$ X) _% o6 X
control_program:control_program- `2 d/ y% F1 C0 X
}
3 f- k) ~1 P) I" @6 b( y5 @
const gasAction = {* ~- {& o1 I9 w
type: 'spend_account',6 M! b/ d3 Z2 s8 E$ T4 G* b
account_id:account_id,
& H b9 q+ T, w( q9 L
asset_alias: 'BTM',
$ U* i/ u8 A8 ~/ N8 K/ d
amount: 50000000% Y2 o8 i7 ^" R2 _4 G/ p
}

复制代码

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

const spendAccountUnspentOutput = {
7 M0 W% U+ u; j; ^
arguments: [{+ [* g7 p! K/ F
type: 'data',
% ~. u& T: [$ `) E
raw_data: {
2 m1 a5 q9 n# a: n2 R# L
// 执行合约输入资产偏移量
`. I- W0 F$ @& j( R8 b
value: '00000000'
+ F; R/ [0 @ P' h" t0 @2 N* s
}
* u9 M ]* l; f
}],6 j% ^/ W+ ]6 l0 V& J& a* W
output_id: output_id,
' X1 |) G, }, j! N7 ~
type: 'spend_account_unspent_output'
3 L- u+ I) N/ e1 V6 d2 \# |, l
}$ |% z. P: F3 M& ~* w2 o- z: R
// 合约执行提供的资产
' P! _# P2 V r, k+ ^3 T
const issueControlAction = {* k. Y8 ^9 C( {$ D9 p1 q
control_program: control_program,
. G, x/ |( c# @
amount: 100000000,, `( m, D2 S/ J: e
asset_id: asset_id,
i$ {& @5 Z; _8 t* Y2 S
type: 'control_program'6 c) |, p9 H7 d! ]
}1 H- |1 g( O" v
// 合约执行提供的资产- c% i' t* e+ `
const issueSpendAction = {/ g( h$ O3 i& J+ v5 v
account_id: account_id, M+ z, l. s" ~! r# p
amount: 100000000,
- M I5 [$ t; D+ }0 |$ P5 W/ N% ]/ ~
asset_id: asset_id,
! O' J- t6 p' e; c+ J1 W/ l0 ]
type: 'spend_account'
8 c- N2 W. s! @
}5 s0 Y% {% g. S/ P
// 旷工费: M8 _ P0 N& T* I# h8 w+ O8 }
const gasAction = {1 E! `4 n1 k2 Z/ g
type: 'spend_account',3 }* N+ h" X# p/ n
account_id: account_id,( ^( E7 H) e$ \
asset_alias: 'BTM',. R0 u: Y6 Q; Y g& U* P7 \
amount: 50000000; ^7 r: ]; r9 P5 E' \; H. \
}
( N% A( f# X& O8 F' I1 W9 a
// 合约执行获得资产对象
: v0 B- }2 v& [: f0 C. y
const controlAction = {
1 o6 E. i. p% T
type: 'control_program',$ N6 M D. f" }
amount: 100000000,
) z9 R# r7 @) X8 z0 [5 @
asset_id: asset_id,
5 {3 j! O7 A2 A$ c0 g7 A
control_program: compileData.control_program9 ^/ T8 l6 d% q8 U( l
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {
& h3 p- f- @6 ?3 ^9 q' @/ `
OkHttpClient client = new OkHttpClient();
, ^. a: ~( m, P7 \1 h, Z
MediaType mediaType = MediaType.parse("application/json");
$ [5 T' z3 S4 A7 ]& I
RequestBody body = RequestBody.create(mediaType, bodyStr);4 R; J. q& ^1 s0 ~6 e
Request request = new Request.Builder(); M; M3 ?* Y/ D
.url(bytomApiserverUrl+"/"+method)
& T: c- ?/ ?7 i5 |, g% a' ~
.post(body)) U; D' o) a# S" d" k
.addHeader("cache-control", "no-cache")
+ X7 V: T4 \9 ~, A
.addHeader("Connection", "close")
; i. d) E" Y& U& q
.build();
& w9 @, _6 L' e7 ^: {# V) p
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){
3 c- W# t) \6 @" L
}else {
8 l& G8 l' }# H/ R
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));
- ?; N7 L( E: y$ k
String authHeader = "Basic " + new String(encodedAuth);
5 L* U% y+ b4 Q& v" I( j6 ~
request = new Request.Builder(): b$ P6 a0 F( [1 K8 g
.url(bytomApiserverUrl+"/"+method)' F& U- q. y, D9 n" K2 V
.post(body)
' _* `2 {0 w! G
.addHeader("authorization", authHeader) T& d% [1 Q1 |
.addHeader("cache-control", "no-cache")
+ r$ _8 _* `2 S4 B6 d5 r- C* D4 q
.addHeader("Connection", "close")
9 L6 q+ Q( t. P6 r9 r. o# p
.build();
6 K: n8 F- w% }" Q! T
}
6 u3 u6 T E( Q! V! B2 v' a; P1 v& j
Response response = client.newCall(request).execute();& s% F3 n$ M; O+ `7 X# B
return response.body().string();
3 n" E) Z! ]+ [ S5 m, Y" v# @2 `
}

复制代码

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