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

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

contract TradeOffer(assetRequested: Asset,
7 d5 l5 ?- N3 u+ `
amountRequested: Amount,
) `' K8 c1 ^3 k3 E3 r/ a+ O
seller: Program,
3 k0 {5 k4 y, E9 N7 Q
cancelKey: PublicKey) locks offered {+ z4 _4 J$ ^/ }
clause trade() requires payment: amountRequested of assetRequested {
3 \: f- f- B N8 P
lock payment with seller
9 X) c& G% _& x+ ^+ i% W% _5 p
unlock offered
" a% G9 s/ \* O8 Q
}9 z2 W) V. v' n4 H3 t. h4 @
clause cancel(sellerSig: Signature) {
; w* A A4 a) J _& j3 t
verify checkTxSig(cancelKey, sellerSig)
' X, @6 P7 h) B5 l2 h0 V5 ]
unlock offered
$ }. b& O3 s; h, C& \$ [
}) |, P q( Y5 N: j
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 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();3 v( j* ^; J) b' K5 R1 V' u; x
JSONArray agrs=new JSONArray();! s2 I) \4 ~5 Q9 V
//合约的四个参数值 ?' @; t1 {! K) L- b0 h
JSONObject assetParam=new JSONObject();
: r* c4 t7 c+ J3 X/ }
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");' `! E% K) r0 k; i9 v3 B
agrs.put(assetParam);; t/ q% ~3 T8 d+ S6 v6 }! X
JSONObject amountParam=new JSONObject();
X6 q4 N, L/ K- e" \; X% k
amountParam.put("integer",200000000l);
/ Y8 n* r/ Q! J; R4 D' q- @; ~1 C9 l
agrs.put(amountParam);! s% E% R; z# {+ ?4 c( K9 i
JSONObject programParam=new JSONObject();5 n! [# E% j5 g$ _" p( @ _. R
programParam.put("string",control_program);
: y: o0 w" c3 R9 F- ~
agrs.put(programParam);5 w) D; p; O, O
JSONObject publicKeyParam=new JSONObject();
! q4 I# h3 R6 C% s
publicKeyParam.put("string",pubkey);, L5 r+ ~% n7 u' |- r& `
agrs.put(publicKeyParam);( n. g( o S( p
param.put("agrs",agrs);
' E2 `+ o: \5 m9 p6 T/ w
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 } }");0 t0 c; |$ J" w7 e& l
//调用编译合约9 ^% L% L( P4 Y4 q4 r
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject();& R4 \1 ]2 C/ Y$ _+ L- F. w9 X
agrs=new JSONArray();, M. T- n/ M I& u! U
JSONObject spendAccount=new JSONObject();; z* v H( y# O+ p1 ?+ _
spendAccount.put("account_id","0H757LPD00A02");# J% C+ K& G' F9 M1 M z1 l
spendAccount.put("amount",9909099090000l);
3 M/ ~+ P( D9 F1 |" q6 N
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");) l# g C0 t$ j% D# s* ^* \: B
spendAccount.put("type","spend_account");
/ e$ C' G6 E3 V8 T1 m
agrs.put(spendAccount);: t% b2 O) K/ {7 {. ?
JSONObject controlAccount=new JSONObject();" r+ P9 n/ q! m% m4 C
controlAccount.put("control_program",program);" n4 ?0 G: Y; ~" Z1 h* A& b
controlAccount.put("amount",9909099090000l);( ~ _9 _. Q) M" @0 ~
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");9 W, V4 F! v; u2 _: A: t
controlAccount.put("type","control_program");
+ @; c; _4 y( \! Y
agrs.put(controlAccount);
% B; r) `1 D3 P+ S" s
JSONObject spendAccount2=new JSONObject();7 t2 c0 n1 Q& m" ?, w) b
spendAccount2.put("account_id","0H757LPD00A02");
' D9 r# q' e- w# V) O4 V5 \; r0 e- B* @
spendAccount2.put("amount",6000000l);1 A% e" D: f4 X! s- q. V. ~
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
; R3 K5 S) x$ e* A- E
spendAccount2.put("type","spend_account");
" D" Y8 k- H- r) L& D
agrs.put(spendAccount2);
6 H z+ p8 i& w/ B1 U* n
param.put("actions",agrs);( l( ]. i& }2 x
param.put("ttl",0);- y5 }( K2 e9 }2 C. s6 e2 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: [{# B9 q* }7 ^9 u) o- y7 F
type: 'raw_tx_signature',
$ r9 [# c2 F7 y4 U# H `- W
// 生成合约第二步的pubkeylist 详情9 {4 u- ]6 ?# Z- ?: d( {
raw_data: {- i# Y5 v T% q0 i% B0 p
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,1 e5 J7 F2 F0 R
xpub: pubkeylist.root_xpub
1 a1 _7 k0 ?8 j6 A8 [9 Q$ x1 T
}+ O4 N0 ~# k! l3 `
}, {
1 d0 A, I( `( y4 _
type: 'data',3 X/ Y6 @7 a+ V0 ~) M
raw_data: {
, r6 ?: o. h$ X" a
// 参数偏移量在一个合约里是固定的
8 B/ g) N: [9 j v& X3 S+ v
value: '13000000'! H/ o$ N' P& u4 G1 J# T2 R
}
: c- i' Z" [/ u0 |
}],
B# l) ?, F+ O7 ~5 K
output_id: output_id,
! v, V, } s6 @7 k$ c' `3 i6 n
type: 'spend_account_unspent_output'
/ _7 p+ m7 K) h2 Q
}* E% ~( N6 y- `
const controlAction = {$ v- U) Z5 a, X0 ?4 r" k* E$ ?
type: 'control_program',& X3 {# {, y; k1 B2 X
amount: 100000000,
2 n% j& m9 N# f* f# I
asset_id: asset_id,
- M3 K& u6 B- E9 ]3 T7 Y7 M0 o
control_program:control_program
. _& _- o) N5 g' ~( E
}) Q1 j( Z/ Q3 F! c5 l2 w
const gasAction = {
) e/ A7 ^8 p; g7 B
type: 'spend_account',
7 u% y$ e$ i% f. I$ m
account_id:account_id,
9 ~/ m# U9 u. j- k
asset_alias: 'BTM',
# s6 J* w2 W$ | o5 p+ _
amount: 50000000# F& K* s2 H4 f- q: B8 \# K: Q
}

复制代码

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

const spendAccountUnspentOutput = { z# g V$ A0 L: f( F. C
arguments: [{- b# k* g2 ^! o% L! x! C" N
type: 'data',
1 ?0 H$ B* @ F O4 B @ T
raw_data: {% \5 V+ w6 T9 ]) S, D, E
// 执行合约输入资产偏移量: N; l7 ]; ^. L2 }8 K. ]6 K! I- \
value: '00000000'
: t9 X+ n5 V8 S9 V, ^
}
; C+ H, l- Q; b
}],
* {1 i/ s; o4 v7 W/ z
output_id: output_id,
8 a' s, d" Z3 V8 Y. f8 [- t
type: 'spend_account_unspent_output'4 h/ t8 V* s6 {
}
' V ]% ]1 ~4 V9 K% c4 n. n
// 合约执行提供的资产
/ w8 ]3 k3 x2 l2 c
const issueControlAction = {& n9 c6 u3 I# D, w! }) D
control_program: control_program,, \8 q9 h5 e, C# e- n6 `
amount: 100000000,
, @; q" _- P0 Z- B5 ]
asset_id: asset_id,
- n' p9 F0 C" N/ `/ L/ u3 B
type: 'control_program'5 P8 L' Y0 L3 D+ B5 ]0 p4 m
}6 v( X N" h$ a, W: N
// 合约执行提供的资产& J2 y3 a; }$ m `) D6 ^! z- C' M
const issueSpendAction = {
- p5 }6 h* c+ y- l/ \- J& U$ S5 V
account_id: account_id,
# U; R# h) m2 n+ H2 U4 r. J
amount: 100000000,
0 {$ ^& Z, ^$ C, f- f
asset_id: asset_id,6 M1 V9 e" b D; P* o' q
type: 'spend_account'
) w0 x2 Q' r) O9 G1 W7 U
}
) }4 `5 C: @7 G# C6 |% x6 c
// 旷工费
& W( N f4 w/ o+ \2 `- e/ x- h9 `$ l
const gasAction = {% I( q4 @" i7 P
type: 'spend_account',
& f9 ]* D: _1 O# a
account_id: account_id,- L2 V8 N; p/ C+ [
asset_alias: 'BTM',
4 R" i* d; K; _! h" F
amount: 50000000! P& J) [) y/ n% n9 F
}
6 W* |' |' J7 d/ [! v- ]
// 合约执行获得资产对象
" W& @2 ?6 C: _, h
const controlAction = {4 W: V6 [3 V& l9 l" p& j6 }
type: 'control_program',- G" X1 h9 L, M6 s. s, d8 B
amount: 100000000,# N$ d* T- v' o5 `, _4 a# q
asset_id: asset_id,. L6 z4 x( a- s3 k/ y
control_program: compileData.control_program
2 D! h* m1 Y. a/ m
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {
/ w# ^5 v# T& R7 q% r
OkHttpClient client = new OkHttpClient();) m k! k, t# A# {% P4 z) g$ p4 J4 w
MediaType mediaType = MediaType.parse("application/json");7 S- y( G# o% p1 Y
RequestBody body = RequestBody.create(mediaType, bodyStr);
8 V9 d) ?% w( s6 x
Request request = new Request.Builder()9 C7 J7 Q1 f9 K2 ~# y9 y# z
.url(bytomApiserverUrl+"/"+method). r+ `6 j7 z4 |) X3 B
.post(body)
. O( B) b- _0 ~3 X
.addHeader("cache-control", "no-cache")
3 [. d( X) A# E, N$ Q" g
.addHeader("Connection", "close")
3 D7 f4 M; u/ L1 V1 l% H
.build();4 s9 Y: J9 F8 v7 o
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){$ B3 `. m2 A% F2 u2 L D) v
}else {
1 h9 r6 W% W3 Y5 ?8 |6 J
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));
( q; F4 N8 e1 Z! t
String authHeader = "Basic " + new String(encodedAuth);6 R- J( M! _( Z- `+ K m7 t
request = new Request.Builder()
* R5 {. G6 O4 B7 L r% d9 i5 v
.url(bytomApiserverUrl+"/"+method)
- O7 C1 ]4 g, S3 k+ B+ ~
.post(body)
F0 j2 i8 L6 f1 |4 N, l
.addHeader("authorization", authHeader)5 N( d( |8 I4 ^( x9 w% T
.addHeader("cache-control", "no-cache")& i% v, m9 L1 e0 m/ h, s
.addHeader("Connection", "close")
; }, W- j K& ], t5 ~
.build();- U$ n0 o* n" J, _
}
1 |! V, J2 ]+ z4 H) B0 Q5 d) G+ N
Response response = client.newCall(request).execute();
; }6 @* W& w* @4 S$ ^/ v: J
return response.body().string();9 d% O( ?& @' ]7 W
}

复制代码

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