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

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

contract TradeOffer(assetRequested: Asset,
8 h# [- B- ?6 o8 m4 p8 b. V
amountRequested: Amount,5 E6 ], a. m( W% d5 e) j
seller: Program,
0 L* f @9 m3 W% d+ i7 j/ g6 {8 n! k
cancelKey: PublicKey) locks offered {
& v/ v( Y* O) o4 _' @# S
clause trade() requires payment: amountRequested of assetRequested {
( o7 |" z4 a& D$ s2 w
lock payment with seller/ e! L7 T2 _; o( n) k
unlock offered
$ @: T; P: A% O' s0 v c. |9 k
}
# B7 {4 b; C1 e) `, A: |
clause cancel(sellerSig: Signature) {& R4 m8 m% G0 f6 @3 [9 J) D1 v; t _/ N
verify checkTxSig(cancelKey, sellerSig); J+ Z7 f+ l9 {8 K) y
unlock offered
- Z: A) }3 p" P2 [
}7 C; Y% @+ f9 `$ F" ^/ g( p5 ]
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 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();
( I' Y, O/ W" A6 F$ |5 e
JSONArray agrs=new JSONArray();* T9 k% F1 a8 C4 F. x8 ~
//合约的四个参数值, r9 E5 O, g$ Q: q
JSONObject assetParam=new JSONObject();9 R& [2 \9 I! _1 `- j
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");/ u, {7 y0 ]: G( [
agrs.put(assetParam);
; {$ i4 j/ h9 i9 o* n
JSONObject amountParam=new JSONObject();6 a7 d6 t" e5 M1 t
amountParam.put("integer",200000000l);
* A, f& `! t& s. @( E. B
agrs.put(amountParam);
# R8 g3 }% w$ X
JSONObject programParam=new JSONObject();
: Q! K0 w8 | g7 p6 c
programParam.put("string",control_program);6 N3 a, `, Y7 s, N# b( s* b
agrs.put(programParam);* @' Q( D2 o9 J6 |
JSONObject publicKeyParam=new JSONObject();. X2 X: O- J1 ^# G {* m
publicKeyParam.put("string",pubkey);
: ?: d' J$ T# E, ~0 I% ^
agrs.put(publicKeyParam);1 W9 K) `% h* }, x4 M
param.put("agrs",agrs);
' H$ D+ Z M" X9 ^9 E- i
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 } }");# R7 H1 X' {0 |, [ y2 P2 Z
//调用编译合约
. h! [4 x5 z# c: I* W* n0 G
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject();( C3 ~1 J0 J0 v% \9 N& C
agrs=new JSONArray();
0 F2 \) v& q4 ?8 W8 ^+ R" ^* y
JSONObject spendAccount=new JSONObject();% P& K- z: \& N/ G
spendAccount.put("account_id","0H757LPD00A02");
- z3 ?: a9 P' g7 v1 v3 H) }
spendAccount.put("amount",9909099090000l);
) f0 |+ }0 w& a% ]+ f; s* O" i5 v
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
+ i8 P3 E% ]& n. A: B; E
spendAccount.put("type","spend_account");
3 M# T4 a( q( `5 U& H) y4 s
agrs.put(spendAccount);
0 ` V$ x5 s' I0 a
JSONObject controlAccount=new JSONObject();
# H* K/ B1 U( ^4 y- X8 ^
controlAccount.put("control_program",program);
0 u! e% D. x) w4 [ n7 a6 E
controlAccount.put("amount",9909099090000l);. }0 e$ g' v. A# s( C
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");1 h+ O4 c C0 Z$ x$ u
controlAccount.put("type","control_program");
2 ]0 C( j1 I2 Y% C2 }/ z
agrs.put(controlAccount);/ n' r8 R Y/ V6 U$ ~) d+ g+ G+ F
JSONObject spendAccount2=new JSONObject();4 N. m" j3 U! y% O1 X
spendAccount2.put("account_id","0H757LPD00A02");
& G! |$ G7 f. ?7 W4 k& a+ o
spendAccount2.put("amount",6000000l);
, y7 S/ i& k4 s( S( E, f
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
4 z/ Y6 _: {* f* A+ h2 c
spendAccount2.put("type","spend_account");8 G7 L/ i: }& G1 O' L
agrs.put(spendAccount2);( N' r/ } P7 t: _. {' q- s
param.put("actions",agrs);
- w5 u1 e" O9 ]* u. |3 X
param.put("ttl",0);5 }& c4 K! ^5 E; r0 Q5 C
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: [{3 |- K1 h7 c( c; v$ n( `
type: 'raw_tx_signature',3 b2 D; P6 S+ T5 x( d
// 生成合约第二步的pubkeylist 详情' K4 ~& ?( O, T4 i8 V7 \5 [3 k4 {
raw_data: {
; P& M- B* a0 {
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,2 e/ A$ E4 q2 Y' V6 Y: v, p2 }
xpub: pubkeylist.root_xpub
- E1 G5 Y! ~8 S+ k: R
}
/ v5 M, h1 _1 M O5 v
}, {6 d2 t7 ]7 B7 ^$ y' k+ ^' L2 n; h' I5 @
type: 'data',
" ^4 M$ D- I+ X& w& c# B) J
raw_data: {
: P3 g" F* ]9 y7 l/ H. \4 s5 w
// 参数偏移量在一个合约里是固定的 ) \7 h4 W' v; Y6 w; U& i$ @8 P& O2 U
value: '13000000'& |$ I x& Q# Z: |
}
) ?: v4 F8 g% R* u7 L
}],
8 \' W3 `- ?0 g% a$ p* r
output_id: output_id,- Y! O, Z4 B2 T2 n2 F2 b. O; ?
type: 'spend_account_unspent_output'
+ N$ w$ A8 }7 r& Q+ E5 M) O! F8 a
}
4 _. U+ ]1 T( G7 s9 L. U
const controlAction = {9 K; J7 O1 K! n7 p0 ?
type: 'control_program',
. @' [/ Q& P- F3 e3 Y2 G
amount: 100000000,5 r+ [ s4 f+ H& S$ Q0 |- W: |
asset_id: asset_id,% t3 ~' l0 u% l" q+ _# `2 R
control_program:control_program
' Y% K5 p. d( J; i/ [5 I
}+ S* `7 u4 ?& X6 y: G
const gasAction = {
) S6 b" A9 P' R" Y) `6 v) E8 e3 P
type: 'spend_account',6 ~" c+ {* N+ a
account_id:account_id,0 G0 A) \9 d+ p$ g: V% f! i
asset_alias: 'BTM',
$ A/ q& V `% ?3 @4 f& b! l
amount: 50000000
: o8 V( b+ b3 Q8 \0 E! y! l. b
}

复制代码

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

const spendAccountUnspentOutput = {
( J0 x" f f- d1 l
arguments: [{
8 t! U; }1 j$ Q
type: 'data',2 A8 u/ s1 W, z7 w2 T, q+ K
raw_data: {# [! b; m6 v% X L" O- g, k, Q
// 执行合约输入资产偏移量( E8 w; a# m4 m
value: '00000000'
: L+ X: U+ y1 z/ l
}& _+ {5 e; F' J% P
}],: w, l5 M5 z5 U/ D' G4 S
output_id: output_id,
- e5 w5 s6 f! t' `, q
type: 'spend_account_unspent_output'
) N+ d' G4 h' l
}
. q: i) ?& n1 _
// 合约执行提供的资产/ O ?/ F7 F, A7 `' ?! R# m+ L
const issueControlAction = {6 O2 a+ i/ }* T7 p6 \! \, P
control_program: control_program,
) w2 N+ j# y. Y
amount: 100000000,1 M: d% w7 ]1 b9 `
asset_id: asset_id,, q5 M" w; ^! N8 [ l4 s
type: 'control_program'
' X; o- `+ V1 q) u0 d- P
}* I# R4 e% V" d0 h- C. V M% O
// 合约执行提供的资产. Q; _$ F3 O/ p4 `3 f! c5 i2 R1 Y
const issueSpendAction = {
3 |% K% G3 s! K# L, o
account_id: account_id,: p" f. }8 {. e7 R; P+ \
amount: 100000000,
# e2 ?0 g' v! R% {" I$ x
asset_id: asset_id,
! B4 `# k- h/ x4 |- E5 M& Z
type: 'spend_account'
* |& S3 {8 |8 n! }9 a& m' `! D
}% i m7 Z- ^8 }: s6 y* N! X
// 旷工费7 K6 h* o) V7 m
const gasAction = {
. v6 }: y$ j4 C0 q
type: 'spend_account',
8 ]( i- f2 f6 `$ V5 h
account_id: account_id,
% {0 V" S1 U& M% r
asset_alias: 'BTM',1 F" f; S; i e4 I" [3 ^( _
amount: 50000000, ^/ C2 f' o( G4 D% i8 y
}
, A& z' T3 Z, V5 x
// 合约执行获得资产对象! c1 T- D$ J9 b$ c `9 e7 ~
const controlAction = {
) e. ~3 p1 v4 V" x* t
type: 'control_program',
- H. A" E" o' O+ b! v! t( }$ J
amount: 100000000,
& U: m" G$ b# i8 M
asset_id: asset_id,
7 S9 a1 W' E1 D( v, }/ c
control_program: compileData.control_program
2 m$ I& R" k2 R4 C- g& U* Y+ J
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {
4 k0 `* y, Z" Q3 Y6 Q$ D+ C- T
OkHttpClient client = new OkHttpClient();
5 g3 J6 W# G8 @* y9 b( Y) I
MediaType mediaType = MediaType.parse("application/json");
, g' s1 |5 a- p& A
RequestBody body = RequestBody.create(mediaType, bodyStr);1 i% |1 M& u' {" a/ R: p
Request request = new Request.Builder()
; }% J, Q9 H6 }0 |) S! U" w
.url(bytomApiserverUrl+"/"+method)
& l, d6 B1 }8 d8 ^+ m# x: }9 u7 B
.post(body)
; {% R: [- l- `$ V1 A2 C8 a
.addHeader("cache-control", "no-cache")
) x& f" N0 @% ]2 P; p$ P$ M
.addHeader("Connection", "close")
7 T$ ]0 x- {; h U% R
.build();
. k* O- |" N- h1 F( S, h4 f- f( v
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){. {' [7 w6 g0 N7 }% o) E# |
}else {
) B' p D6 D8 g
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));9 a9 ]- Y' k) `* C. }. R' M
String authHeader = "Basic " + new String(encodedAuth); x$ F" ?6 U4 N* @
request = new Request.Builder()
$ X- [, m' C6 [/ t7 }! q
.url(bytomApiserverUrl+"/"+method)
0 S4 G R; y- t* W
.post(body)' g7 `! H% n+ s, @
.addHeader("authorization", authHeader)
# ?3 t% F& ?: X6 B: _
.addHeader("cache-control", "no-cache")
$ t0 S. c9 b: f- m: Z3 K
.addHeader("Connection", "close")2 r5 x) u$ a3 g0 M; u, }
.build();7 |( a ~! J7 i# @% ?" _
}# D0 E! f- M8 `9 z) y6 |1 g- y8 D
Response response = client.newCall(request).execute();# C. m/ g$ W0 u
return response.body().string();
5 g. ~: {) c. s: N# p& E4 N- C
}

复制代码

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