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

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

contract TradeOffer(assetRequested: Asset,( ], R5 `4 h8 v& x
amountRequested: Amount,
# t( u9 P6 r* x h$ c0 ^1 |
seller: Program,% U; c D" `) \5 Q
cancelKey: PublicKey) locks offered {! k& [; u7 ~8 L2 p4 ~. \
clause trade() requires payment: amountRequested of assetRequested {
" h3 V% D( X9 F
lock payment with seller" X8 Q2 a [$ {, X$ m
unlock offered
* n# m! c# n& x: x* D% B
}: g, \8 |7 i+ v1 u; `
clause cancel(sellerSig: Signature) {
* H' v( q9 p- l m& Q' [
verify checkTxSig(cancelKey, sellerSig). _8 C5 i3 n! F' e
unlock offered
/ S! ?- T/ [' N6 t
}
$ q" D: k! ^$ _' o5 }
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 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 [7 ^8 L5 F% `4 H% u. D
JSONArray agrs=new JSONArray();9 j# K4 G' }/ H8 \" p
//合约的四个参数值
m2 |0 r2 y. _/ t1 F
JSONObject assetParam=new JSONObject();
5 q) [0 b0 |% X' i& y8 f: c- H
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");
# D9 K2 w( r4 {/ T
agrs.put(assetParam);
7 l6 ~1 f. ^( l( I% w8 l
JSONObject amountParam=new JSONObject();
% S* Z3 d2 {# \2 j& ?$ k
amountParam.put("integer",200000000l);
: K% _2 X0 T" J# q: ]
agrs.put(amountParam);
% j' G" D7 j" }
JSONObject programParam=new JSONObject();
) J7 ?* ]+ L: M- t4 G- E% y/ |% `
programParam.put("string",control_program);
# c. W" Y( [9 X8 @" o
agrs.put(programParam);
* P, y9 Y- w$ I
JSONObject publicKeyParam=new JSONObject();
: S3 F7 u- o! |
publicKeyParam.put("string",pubkey);: t3 ]2 W7 W l. d
agrs.put(publicKeyParam);/ n T w! n5 _8 }& t0 o
param.put("agrs",agrs);& C8 V; `* v" H+ s; h( g
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 } }");
8 ~9 q: m. X$ R9 m
//调用编译合约
2 Q- X8 p1 ]! q' w" Y0 K
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject();- |9 K4 E' h4 q1 `+ y! C0 p
agrs=new JSONArray();7 n- U0 f, S8 T$ p$ @% N% }
JSONObject spendAccount=new JSONObject();
' z) Z" Q N( t* w- z5 A% V2 N
spendAccount.put("account_id","0H757LPD00A02");
/ O. O5 _' g+ |6 R
spendAccount.put("amount",9909099090000l);& P* z: A" `% q" S
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
+ x2 c! A6 q/ W1 \9 Q5 z6 `
spendAccount.put("type","spend_account");, d* L# w4 [3 [
agrs.put(spendAccount);
JSONObject controlAccount=new JSONObject();+ @5 z. f' i1 Z' f2 z- Q+ e$ S! z
controlAccount.put("control_program",program);# L! u% n% M$ j' e' B+ ]+ k7 x
controlAccount.put("amount",9909099090000l);
! \; _4 c ]! ` j1 T
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");8 B- V- V. `" z
controlAccount.put("type","control_program");
Y4 k: i5 _1 l9 G5 i# r
agrs.put(controlAccount);
, q' |6 g$ p: m# {$ o
JSONObject spendAccount2=new JSONObject();( g7 }+ f/ {! N' E, ~3 b
spendAccount2.put("account_id","0H757LPD00A02");
2 k- Z, y* C9 [# R
spendAccount2.put("amount",6000000l);
3 F- C+ M, ^5 G
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
# S( X) [' q1 ~$ W: W. v: _+ i
spendAccount2.put("type","spend_account");- g5 m5 b- |4 M4 u
agrs.put(spendAccount2);4 T& b+ ~% g" g5 \4 l6 F+ i2 T
param.put("actions",agrs); r. _/ k# {4 s6 F% R" P7 B
param.put("ttl",0);
) |0 f. s, T8 p% a2 Q. l* d3 A0 ^1 G
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: [{
" x- y! ^& u' B, ^) O/ T# E
type: 'raw_tx_signature',; m/ Y, z* t1 }
// 生成合约第二步的pubkeylist 详情
: J6 z4 {: I$ S0 E- X
raw_data: {
" K* O) N6 |3 I: Q% ?( n; s
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,! z& Y* I, P# x4 u2 T' e
xpub: pubkeylist.root_xpub
) ~/ {( Q- _' q* R* T- \
}* Z6 W* f9 g# _- [6 v& X1 o
}, {/ `; b- K* o/ G# Y, N! u% z
type: 'data',5 w' [5 e/ Y% P+ e( K
raw_data: {; B2 o- g# q5 p% Q2 j
// 参数偏移量在一个合约里是固定的 0 a" t: y( `% l
value: '13000000'0 g: R. N( J; v7 J4 J
}
0 L( T c" g7 ?) O/ c' ?
}],; d4 @5 z, Y8 O. ?- h2 Z' c( _
output_id: output_id,) [9 D+ F$ }7 @" @! s
type: 'spend_account_unspent_output'
" p# s$ ^2 S& T8 a7 u( S7 A0 E
}
9 M% }9 M# a) s. w5 J: X
const controlAction = {
8 E! M! R0 s3 [3 ]3 B
type: 'control_program',9 s: [! v% ~& D2 K1 z7 f& Z+ U
amount: 100000000,
! g [8 p& @' Y! S# Z0 V- x
asset_id: asset_id,7 R+ @: T0 Y, G- B* v9 V
control_program:control_program
) k G/ ~. c# m. n2 r+ M6 O. F( `
}. V3 A2 r" J0 G6 _, X
const gasAction = {6 w) K$ e" s" r3 U+ R# w
type: 'spend_account',: K- Q9 X% N8 D9 @9 Q
account_id:account_id,) i! v4 z4 N; s( \. j
asset_alias: 'BTM',2 t* v6 x9 M# @) z4 f
amount: 50000000
2 v/ F- Z6 W6 p. K% z9 V
}

复制代码

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

const spendAccountUnspentOutput = {" e: E9 m# J% o
arguments: [{
6 O- @1 h% c3 Y/ m# g' N
type: 'data',
/ @1 S. p' k% Z7 h' k$ {: q
raw_data: {
1 O8 S9 K. ^5 S' C
// 执行合约输入资产偏移量9 O9 {4 ]6 h* t. g) ?8 ?; x/ R
value: '00000000'
+ ~) E5 Q. y9 ~5 l( D; @
}
}],
8 U1 F& C( i/ O6 R
output_id: output_id,
/ D9 t4 h2 ?0 Y
type: 'spend_account_unspent_output'
{" g4 d* ^* y m
}
i/ t8 I* c$ G; q, w
// 合约执行提供的资产
. ^6 [7 u" p4 S* }* b
const issueControlAction = {! Z/ m/ s4 s5 Y: R4 R+ B" m$ r1 O+ u7 m1 R
control_program: control_program,4 x( R/ C2 E+ C* [8 ]
amount: 100000000,2 I' j; C* {1 b7 j" m% @5 B
asset_id: asset_id,1 T# L/ n" u# h( Q0 F( z
type: 'control_program'6 z+ @3 N+ j0 \* D
}
8 ]% |3 F8 E8 W# J' y+ _" x
// 合约执行提供的资产! d7 B& L$ }# H4 d
const issueSpendAction = {& Z, W: n3 {1 K
account_id: account_id,
% S( y5 G/ K+ s3 `
amount: 100000000,6 Y8 [+ v6 H. P, _/ h; A
asset_id: asset_id,
, d9 p+ ]6 m1 y1 U( p& m
type: 'spend_account'7 g' W! o) Q% i# O+ l( k3 p* k6 C
}/ f$ `. |3 D, a: @1 B+ s
// 旷工费4 h3 E* o0 ]# r! Y( r E
const gasAction = {6 \/ G! a: w$ U
type: 'spend_account',0 H& x z3 L c
account_id: account_id,2 [7 B& x7 R: S' E! Y" ?# |( n5 H- X
asset_alias: 'BTM',9 c7 J; _7 A g5 R
amount: 50000000
8 A' `/ Z# m+ {" ?
}9 b" R, r1 R( c! S O$ |5 y
// 合约执行获得资产对象
5 R6 F4 o* [. g. \9 n
const controlAction = {
* o' o) \1 y! q/ y( E
type: 'control_program',' ^- [! I( f2 u
amount: 100000000,7 r0 a+ c6 L, u5 S3 @' T
asset_id: asset_id,6 g. t5 _6 Z# N3 `
control_program: compileData.control_program
6 r, A3 I9 k; E7 B! S: t
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {8 h5 S4 d5 Y& |) M
OkHttpClient client = new OkHttpClient();
8 M* L. W) s3 U6 c
MediaType mediaType = MediaType.parse("application/json");
; I* H- v& Z) D) @! U, ~
RequestBody body = RequestBody.create(mediaType, bodyStr);
$ C3 H' o P$ s# d. t
Request request = new Request.Builder(); j0 c. }. f: t ~, }
.url(bytomApiserverUrl+"/"+method)
! S8 }$ {% o* f* {5 Y
.post(body)6 c5 ]! {5 w: [* q* g) f Q
.addHeader("cache-control", "no-cache")
4 m' l5 K7 b; t0 i$ {
.addHeader("Connection", "close")
: L8 S" a5 O; O
.build();: A7 e/ @0 j0 P0 Q0 D2 J4 L
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){
2 B9 x7 b; q7 `3 {+ k
}else {! c* n" E7 ?2 W/ P$ H3 F4 ?' Q
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));9 _% I: ]* }/ {
String authHeader = "Basic " + new String(encodedAuth);
9 Y1 p6 c# E! @ J( Z2 o
request = new Request.Builder()
: R; b+ F# u4 x
.url(bytomApiserverUrl+"/"+method)
" ]1 E1 `( L) i* f1 u" }. Q
.post(body)/ g$ f) t8 t4 T5 t3 }6 ~
.addHeader("authorization", authHeader)4 Z0 N! `0 D$ @9 w+ C' x, H% k
.addHeader("cache-control", "no-cache") g) x* n3 Z0 ]8 [
.addHeader("Connection", "close")
9 E1 M _! F0 ?* c
.build();
A/ g; s2 h% L7 ?7 E) I
}; H* N. l2 m( H9 s6 d; m5 }. R
Response response = client.newCall(request).execute();
$ D+ ~0 k5 C& J; }4 z. \: Q" K
return response.body().string();- j. s% I$ E2 z; t+ x8 a
}

复制代码

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