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

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

contract TradeOffer(assetRequested: Asset,
. O# m p7 T6 \* {& ^" [6 ~
amountRequested: Amount,9 y6 W) H- W7 {' I' E7 H
seller: Program,
. ?9 S6 r0 K7 F) v
cancelKey: PublicKey) locks offered {
2 c0 I- b. \4 A
clause trade() requires payment: amountRequested of assetRequested {
) e8 H# g y- f* B& f. m; Y6 W
lock payment with seller
: p* e' l. a5 p. ~ U5 B+ c5 O
unlock offered
4 n y4 c \9 E' g% F
}8 h0 E* ^/ _3 W$ k1 }3 b% U
clause cancel(sellerSig: Signature) {, b- G$ L* A X7 e& F* ~6 C5 \
verify checkTxSig(cancelKey, sellerSig)- L* K! g& F" U+ }, g+ P
unlock offered* \% F9 ?% x, [. m& }
}" O# e+ C3 ~9 \& u( v3 q' Z" V: p
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 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();
. h/ `6 h/ [* D/ ^ F6 _" ]
JSONArray agrs=new JSONArray();
7 N4 r! `& Q0 Q! v
//合约的四个参数值7 E$ M9 T7 G5 ^( w; I- j+ R
JSONObject assetParam=new JSONObject();( z) |6 w3 q) z" [$ W1 ?' u
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");4 \, E# S4 w9 |. s6 ?
agrs.put(assetParam);/ _1 T8 P0 }( [1 A' A; p' e
JSONObject amountParam=new JSONObject();
& t L. U: [9 T. |! K' X
amountParam.put("integer",200000000l);( [! t, W, D1 q- C# u
agrs.put(amountParam);
3 f* R8 h% p) d; t
JSONObject programParam=new JSONObject(); s. W; m& D1 P& K! r8 y
programParam.put("string",control_program);
2 G8 o' ?6 T* t* ?+ ^! ?9 j6 Y
agrs.put(programParam);; L$ v; ?- Y5 W; X$ s
JSONObject publicKeyParam=new JSONObject();
* w0 F9 J6 ?( `6 i+ X9 a% j1 ?; h. f
publicKeyParam.put("string",pubkey);5 V1 e) V5 W; d% G# v. h4 O6 u
agrs.put(publicKeyParam);
' Z/ |6 J! y: Z8 Q; W
param.put("agrs",agrs);
4 D; E1 `1 l5 ?
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 } }");
/ n4 ]% J4 p% D1 V6 x7 T' R
//调用编译合约
- r. [3 \4 s( n8 j$ E# @2 W* R
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject();
4 a5 j3 P$ \% @9 p
agrs=new JSONArray();
# W+ n b, s$ X2 _4 r% W# Z
JSONObject spendAccount=new JSONObject();, G4 p( h" K& T, _* z; m7 d3 k T
spendAccount.put("account_id","0H757LPD00A02");' e" d0 [$ j5 c H0 @
spendAccount.put("amount",9909099090000l);
$ F/ T: {- _2 z
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
" _+ P7 \; x9 {# B9 S# U
spendAccount.put("type","spend_account");) s) Y8 G3 E. D4 D, |& L
agrs.put(spendAccount);7 d. ^& R/ W9 Q/ C3 M- n
JSONObject controlAccount=new JSONObject();6 X$ L- N3 p) i; i1 N3 K
controlAccount.put("control_program",program); H1 v, ]8 A1 Y
controlAccount.put("amount",9909099090000l);
% c5 G" M: x R
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
- C) F# s. p- x& M! \5 M" f
controlAccount.put("type","control_program");
3 ^' l7 ~, a% \. q* V
agrs.put(controlAccount);$ n3 ^8 A' n% ?/ Y& P# j
JSONObject spendAccount2=new JSONObject();; A0 N- S# I4 G) ^0 \+ x
spendAccount2.put("account_id","0H757LPD00A02");# i2 n; l9 j7 n* ]
spendAccount2.put("amount",6000000l);2 y1 N/ U/ ^1 q* }. q; \: {
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
% ]! R0 K( V3 G! ?3 p: S! I) P! z
spendAccount2.put("type","spend_account");
+ p" A7 a: w; C$ A J, `0 X
agrs.put(spendAccount2);, A3 l7 v; h% j/ f( O1 e- c
param.put("actions",agrs);! ]1 O3 q' F+ @# u& K
param.put("ttl",0);$ V0 K0 [2 e, t! J/ _
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: [{
9 q* p8 z, K* D& H4 q' C
type: 'raw_tx_signature',
' b7 n6 e$ r7 d: z/ z+ |
// 生成合约第二步的pubkeylist 详情
; U; j( Q5 Y. L/ e- f! B" Y
raw_data: {
# r+ ]8 t6 u9 {1 D
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,: \4 y% Y; m1 C: I0 u
xpub: pubkeylist.root_xpub3 O0 b. k# ]0 Q# y
}
, v( _- y8 L$ P6 e0 ~/ Y
}, {
2 g6 J! i$ c) A* [
type: 'data',
6 s; k7 P4 X7 u0 u2 L* q
raw_data: {
, D% b, X2 T/ Y9 R
// 参数偏移量在一个合约里是固定的
( S4 L. b+ p% ]& I% [& j
value: '13000000'! K, @! J8 C/ D# Z5 d
}3 F! v- M: x! v# r" l) T, U# K) R
}],
" Q* {% t7 ~* ~$ V4 s! r
output_id: output_id,6 f! c6 `; s/ X& q+ ]; p8 H/ K
type: 'spend_account_unspent_output'% e- ?( \6 |) S6 @
}( C) C- c+ O) k3 `, O; g
const controlAction = {; t2 U9 r/ S" B, m
type: 'control_program',, b7 ]* r( {9 f. S2 g* _
amount: 100000000,1 E2 P" B% a! n2 R2 r5 Y
asset_id: asset_id,
1 w. v7 O: S6 x8 e j6 L( U
control_program:control_program
* y8 ?& g9 t; O8 W5 c+ s2 {
}
' h0 R8 r* |. G- ^- s. K' q: v
const gasAction = {& z T9 s j. `) a' Q# r& G
type: 'spend_account',: `0 y2 V) d! ~
account_id:account_id,# s4 @) [# i n6 C' o% w' m
asset_alias: 'BTM',) z. _4 S$ r- C$ m
amount: 50000000
1 o, G# i2 E+ Q$ r6 R
}

复制代码

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

const spendAccountUnspentOutput = {
+ P0 o; }% F3 b; J
arguments: [{
9 R1 _& F: h/ q, a( M; g# t- v: g- v
type: 'data',
* P$ F4 d( f: J/ ^. n
raw_data: {0 \! E+ G# [) C! o, T5 d2 p
// 执行合约输入资产偏移量 B1 v2 w& h8 C r/ r) Y, [6 F" j
value: '00000000'
9 S! y. e9 T2 a
}
% e# e, o8 d" o# O' F
}],
! f% n$ N/ X. a8 Y& X
output_id: output_id, Q/ y) n4 `2 b7 w- k y
type: 'spend_account_unspent_output'3 ~$ b I8 O* L+ y
}
8 b1 A$ L2 @) A9 T
// 合约执行提供的资产5 j9 l* Q* A% ]6 F9 q
const issueControlAction = {
' {8 f2 }' E6 I1 a* M# ]9 O( a
control_program: control_program,
- |. g4 F; s+ S! u# Y# X. J$ I% Q
amount: 100000000,
4 c+ Y1 C. ^6 i4 j* D: C- A+ V8 V
asset_id: asset_id,. r5 S" f7 G/ ?7 G9 ]' T3 V3 B
type: 'control_program'
& g/ N$ @. L2 j7 s1 ]
}( F6 F, o6 f( a9 [
// 合约执行提供的资产
5 n, r0 m7 f! B4 Z+ M. {/ q# O
const issueSpendAction = {
+ p0 L' V q2 q# O* r. k2 _
account_id: account_id,7 w0 o2 b( {, h; Q
amount: 100000000,* V* X( S" V% x" V, A
asset_id: asset_id,0 _5 V8 X5 i5 R/ d
type: 'spend_account'( {) P; @$ u5 j5 W- I: [0 g
}
B7 m2 O# w8 [( v$ U
// 旷工费8 ]1 K3 c/ j8 B1 B6 }
const gasAction = {
& ? d$ Q4 j, w+ S5 E$ ?. v( j" Q
type: 'spend_account',; e- z: d$ p% ?" _1 a5 o/ `
account_id: account_id,
. N6 m: M. N' @2 x; _. J
asset_alias: 'BTM',; M: L2 D, H& V, O
amount: 50000000
6 c7 o) ^# m2 W7 w: _6 f }3 E
}
0 Q4 R9 ~! ]* F; B
// 合约执行获得资产对象
5 F0 ^0 J; d) s
const controlAction = {' ]% C# o. ~: l
type: 'control_program',6 l) V; t$ A( d( Q$ q) b8 p
amount: 100000000,
* H6 U- \, {4 e
asset_id: asset_id,
: f8 {0 ? J: h6 T
control_program: compileData.control_program
) S) {" L4 B8 h) `# n/ i
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {) o* H1 A3 _" s; L
OkHttpClient client = new OkHttpClient();
# \ {' |$ M2 N0 U
MediaType mediaType = MediaType.parse("application/json");: _- b: g1 g/ _2 l4 ]
RequestBody body = RequestBody.create(mediaType, bodyStr);
: O$ g/ F8 B9 W. G) L
Request request = new Request.Builder()5 E& M) @4 w, \( U9 [! z
.url(bytomApiserverUrl+"/"+method)6 ]) e: U2 C: {6 j4 W# b+ Z
.post(body)4 d! p& f( @% ~+ |8 S0 E) F* ?
.addHeader("cache-control", "no-cache")
4 ~& } E' [3 L6 {/ i# z/ z
.addHeader("Connection", "close")6 d" g9 @+ O0 E# }& C6 p0 r
.build();
1 W5 G( N2 j( V1 e0 Y/ M
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){
# ]8 O$ B7 R$ S, X& @; ]
}else {: v3 ]7 l# I$ h z* M
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));
% |7 T5 Q% G* h3 A8 k" b
String authHeader = "Basic " + new String(encodedAuth);: Q$ C1 g% [3 u- s" U
request = new Request.Builder()
" Q( g _ W M% N8 J) @
.url(bytomApiserverUrl+"/"+method)
! l0 o* v- y6 X: X! d
.post(body)7 Z4 c' e- D6 v9 K" p! g9 D
.addHeader("authorization", authHeader)
% V$ | W) \1 i. |2 J) e7 r
.addHeader("cache-control", "no-cache")- ^% B. S5 T: V
.addHeader("Connection", "close")- \4 W$ X- \5 r5 {) x1 x' j, Q
.build();8 e9 t! n( j. D/ U k6 e
}
1 b) ], m* S1 D0 z! {/ I% F, s
Response response = client.newCall(request).execute(); G ]+ F7 c% K6 |) n, {
return response.body().string();+ M- j7 e% H+ v# \ w6 Y
}

复制代码

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