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

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

contract TradeOffer(assetRequested: Asset,
; B5 q4 n9 m# }4 |% x. @' q$ o
amountRequested: Amount,
M5 I5 s4 C" u
seller: Program,4 P! v2 ]) D8 {. J3 T4 Y9 H
cancelKey: PublicKey) locks offered {* X/ i& A% s( M& ?, P! G
clause trade() requires payment: amountRequested of assetRequested {" M# F6 `" t' e9 B" w7 F
lock payment with seller
2 `+ |; o* h6 _- V0 N. T4 x) f
unlock offered6 V; v# E. P8 C- m3 Q
}$ _& V0 O, J) \5 r1 P7 j: w
clause cancel(sellerSig: Signature) {
' R% L; `& e5 w/ D) Z1 Y5 r
verify checkTxSig(cancelKey, sellerSig)
( J& T% q, _2 G& Q/ e
unlock offered
5 o9 i0 G' y" D5 }
}# I8 h, g7 Q% n# @' M
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 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();
! |% L! }( K0 L% F4 L! ^, r6 `
JSONArray agrs=new JSONArray();
* O0 S: u/ O$ U3 x$ B2 G
//合约的四个参数值
* o( T2 M, K/ k1 V1 H$ B
JSONObject assetParam=new JSONObject();
B9 a/ a# T5 j! @, m& V$ |( e, R/ N
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");
& D* F0 ~8 R; x/ u
agrs.put(assetParam);" X2 L J# I9 k% D
JSONObject amountParam=new JSONObject();
% E& _% v M, A: v- B
amountParam.put("integer",200000000l);
' W( m% j" D- L; j1 ?2 }* i d
agrs.put(amountParam);
; q; ~4 I Q( @$ f6 E% i) I
JSONObject programParam=new JSONObject();& i2 X/ S, p% [ A
programParam.put("string",control_program);& s: N, ?& e+ d" F
agrs.put(programParam);
& L6 G6 W6 \" U1 @- ~1 f+ A, L
JSONObject publicKeyParam=new JSONObject();
, j! E( H+ N" [ i- a
publicKeyParam.put("string",pubkey);
9 s3 N) f3 e; z6 P6 `/ C3 {
agrs.put(publicKeyParam);
3 j) }! D: N! k1 C6 i
param.put("agrs",agrs);8 ?* v8 A% ^+ n1 Y8 R% u
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 } }");
; T! ~+ l# O* s
//调用编译合约/ g, |/ c; L# P& K7 i# m
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject(); q8 l1 Z5 P+ |; I" i% V, }
agrs=new JSONArray();
/ r# m* s; I* u J8 y6 k
JSONObject spendAccount=new JSONObject();# U0 }6 M: D6 ?8 n3 x5 Q
spendAccount.put("account_id","0H757LPD00A02");& s0 L! C4 Y9 o9 ~
spendAccount.put("amount",9909099090000l);% I3 _: o4 p/ k1 l5 w! g. [- C
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
) q- G" B5 x' _
spendAccount.put("type","spend_account");7 ]1 t% n0 E* U' [0 e
agrs.put(spendAccount);
+ W9 w q% k; k. z$ [. ?% r! l4 C( Q
JSONObject controlAccount=new JSONObject();" R- ?0 ]4 o3 d1 U. x& z: n; L
controlAccount.put("control_program",program);
% R- j1 l) k0 r1 D
controlAccount.put("amount",9909099090000l);
4 G1 P; U, @$ Y) ] z9 z1 z& W
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");. V) x; z/ c! k- m4 e4 }, u
controlAccount.put("type","control_program");
+ p2 p4 M- x& ]# R, m/ T; n
agrs.put(controlAccount);
- _, x' m# {: Y- A" t
JSONObject spendAccount2=new JSONObject();
) R1 a- U( X: f2 Y' l, u
spendAccount2.put("account_id","0H757LPD00A02");
$ z3 C2 M! }1 p' h2 f
spendAccount2.put("amount",6000000l);1 A3 X: D. [; Z& u4 m ~% ]/ U
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
x* O* [ K7 K6 P7 ]2 _3 v
spendAccount2.put("type","spend_account");0 c9 R2 ^' {. E; F; l' y
agrs.put(spendAccount2);
4 d9 J8 ]+ S) ~ f/ @+ h( z
param.put("actions",agrs);7 C- H1 ^4 {% m0 x' R0 b9 F
param.put("ttl",0);
2 t7 _7 m, q: o( J* D& `9 D
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: [{
8 I0 M* c4 H! v' Z3 @
type: 'raw_tx_signature',! W% v/ l. v6 Z3 v9 w# y
// 生成合约第二步的pubkeylist 详情
* c9 \$ S/ K$ k3 g* H0 R
raw_data: {
8 x3 g: E K$ O% Z7 |' \
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,
3 d1 d' H7 ?! H
xpub: pubkeylist.root_xpub7 C& b7 N0 y5 d- U2 x
}& b, Y2 U: l0 g* v, j( s& E$ ?
}, {
- Q; z) W+ [# x- l
type: 'data',
( x* @6 X' z9 w7 q
raw_data: {
0 [/ d* Y3 r7 P; W0 {# [" h# J
// 参数偏移量在一个合约里是固定的
) E: u; M, `. v! g
value: '13000000'/ `* _* k5 p+ D; q7 |$ A
}
6 D8 G) x' U p, ?
}],, C$ C0 p+ T# x2 r2 Z# p
output_id: output_id,
3 Q: i) c1 |; m, m% k4 H3 j
type: 'spend_account_unspent_output'
; Y$ R* J/ R7 j8 Z
}- ?, x, a3 ~# `4 `7 e* {! j
const controlAction = {
5 ?! P7 Q% l2 n$ _/ V, f! I5 N
type: 'control_program',+ P7 [, P) F5 ? i# S) ^9 Q6 S
amount: 100000000,
! n4 P3 W0 w/ e ^
asset_id: asset_id,3 u+ @) L9 o+ n9 \5 f1 J
control_program:control_program
/ V+ U k% `& R- n1 W" A0 \8 K
}6 ~; F9 P( y" p
const gasAction = {
8 O5 p) i; n) Q2 `
type: 'spend_account',' O8 L4 \$ ]+ W! G3 X# x! W
account_id:account_id,3 z9 K3 b8 z, N+ Y0 s
asset_alias: 'BTM',
: a$ o% w1 {9 G' X% I [
amount: 50000000
% t T& s+ e& @+ _0 F
}

复制代码

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

const spendAccountUnspentOutput = {& X( J4 q) \# m1 [6 K
arguments: [{
3 @7 W& c5 n n3 b! p4 G# V2 S
type: 'data',2 L# L) N6 f' g: E( M
raw_data: {
% s4 U" _; o& p, _$ K+ r
// 执行合约输入资产偏移量/ N7 s. \+ e. O. S6 T5 m/ b# ^6 K
value: '00000000'
5 N: h6 [; Z% n2 {
}1 @2 N5 l3 m% k+ _; P& e
}],8 R j2 g$ v- f
output_id: output_id,
# z! W9 l& ^& I2 N8 _: g4 e! c
type: 'spend_account_unspent_output'- N) N" d( X( b$ E$ g
}
+ o! b9 p* d0 ^; R8 X
// 合约执行提供的资产) v% j- v- f0 a8 A
const issueControlAction = {
) d( e6 a+ h9 L* P+ \! w0 L
control_program: control_program,
0 M2 s+ Y- }# n3 L) ~
amount: 100000000, B [, o& X0 }* `- i
asset_id: asset_id,( R; P( m0 n; Y( }
type: 'control_program'
9 @! E% G) F7 U9 q4 o6 Q
}
$ Y8 R+ J3 @* X1 t) p5 B ^
// 合约执行提供的资产
0 `2 k4 A$ |3 ]
const issueSpendAction = {# R4 Y: K0 K) N
account_id: account_id,
9 {9 Z' g2 i- T" {; G
amount: 100000000,+ M( B a" q& u5 i
asset_id: asset_id,0 K0 ^# e0 U. s+ g$ a1 s
type: 'spend_account'* f4 L2 M7 B$ a
}( r3 l: d1 A8 T% U
// 旷工费! @# _* o+ ^) N( w8 a
const gasAction = {( Z# b$ ?3 n6 M$ H: K. n/ q- T
type: 'spend_account',
1 G- m2 n+ |5 R
account_id: account_id,
: S$ z6 g5 u6 v
asset_alias: 'BTM',
( S# S. ?( z" G+ D( l) @
amount: 500000008 U% B- I5 Z: `$ P1 v! B: Y
}
6 \, K& {2 Z4 M8 c+ H
// 合约执行获得资产对象
) t/ J, W7 b6 s& v# H
const controlAction = {
9 S- S9 E" r0 C4 N' h
type: 'control_program',% Y) z0 z: [/ [3 G/ A6 o
amount: 100000000,, T6 J& r5 h. ~/ N4 c% H
asset_id: asset_id,0 z1 d( T1 I, W0 K
control_program: compileData.control_program
- N2 E+ N; f6 b/ ?
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {
; D: U, o( J7 Y" B4 u x
OkHttpClient client = new OkHttpClient();
. i+ T9 ]# e; ^ K) u
MediaType mediaType = MediaType.parse("application/json");! q/ p0 V1 R* P% P% ~+ z; z* Y: |( T
RequestBody body = RequestBody.create(mediaType, bodyStr);
+ r# Y& |9 z. B( Y; s& A
Request request = new Request.Builder()0 o' h J8 o. L" ^4 Q
.url(bytomApiserverUrl+"/"+method)5 D. O. m+ z! g
.post(body)
7 v& m- o6 s t0 L5 I2 ?0 B
.addHeader("cache-control", "no-cache"). I' \7 O5 f& m5 ]! I; t, v7 w5 t
.addHeader("Connection", "close")
& `( h- t+ [' L* Z
.build();: J0 a) o8 `+ Q6 _
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){6 ` K: O0 ~2 g, {4 v
}else {
# g. I/ K6 f1 v) ]# W0 Q" F
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));' v' f2 w {7 {% v5 A6 V
String authHeader = "Basic " + new String(encodedAuth);
# ?9 H; d7 E7 d7 M- N9 F. ?
request = new Request.Builder()
: P- J* D6 ~$ x T9 x- k2 ?
.url(bytomApiserverUrl+"/"+method)4 X0 X O3 {/ I" b# B* h
.post(body)( R, }% |4 ?0 e* p# w$ q! X
.addHeader("authorization", authHeader)
3 |* T, M `' ]/ J
.addHeader("cache-control", "no-cache")4 V# c: \3 F4 J
.addHeader("Connection", "close")$ l( @: _; @. { c
.build();
3 c' g# b) z5 h
}4 C# y! l3 @* R. B
Response response = client.newCall(request).execute();
2 M5 g. G! P7 f
return response.body().string();+ B8 p6 G* ]; @5 s! [' y
}

复制代码

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