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

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

contract TradeOffer(assetRequested: Asset,: ]" i1 n; M& V0 O4 g. u
amountRequested: Amount,
: I! ^ ]0 @$ [+ R% [% \
seller: Program," \7 G+ |4 H6 O
cancelKey: PublicKey) locks offered {
$ {" z$ _. u3 h0 B4 p
clause trade() requires payment: amountRequested of assetRequested {
. G' Y* x P) V
lock payment with seller
4 o: ~# W8 O- O# @# K/ F
unlock offered% f& b$ w. W* Z i
}! f! {+ h$ @, R5 I
clause cancel(sellerSig: Signature) {
( W! [+ x: Z9 Y( q4 a! E& h
verify checkTxSig(cancelKey, sellerSig). G% T: ~# [% U+ d* A6 g7 ~4 E1 L
unlock offered
2 F- H* I* z" i5 Q! ^8 A
}- y3 h/ V' G" k6 H
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 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();! R+ j* m1 l- E
JSONArray agrs=new JSONArray();6 S# `2 w9 W3 Y. }( @/ R, m' k
//合约的四个参数值
1 [* }# D; j3 e/ W9 _! f
JSONObject assetParam=new JSONObject();1 _: x0 ~# ~$ [# @
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");# V. R: ?! t8 x1 B8 c' o: s
agrs.put(assetParam);
. ^& v- s; k: k# k( }
JSONObject amountParam=new JSONObject();0 a" y/ ?9 x: U$ R* r
amountParam.put("integer",200000000l);0 ~2 \" T! q) _" e
agrs.put(amountParam);
; ^9 p. |3 I0 v% P& T5 C4 g
JSONObject programParam=new JSONObject();! F6 \) D' i. e+ a- w
programParam.put("string",control_program);+ `' Y+ S* h: |6 A6 s+ w
agrs.put(programParam);" I" i' L, U0 o) `0 x
JSONObject publicKeyParam=new JSONObject();
! q( x" G: v: H2 C( B* J( \ D8 i: [
publicKeyParam.put("string",pubkey);
( X5 Y) d2 L& {$ j4 H/ g L
agrs.put(publicKeyParam);8 ]' T& P1 e" ^8 j% O
param.put("agrs",agrs);
( ~+ I0 J8 b4 p# f% t" P+ d
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 } }");, Y& k6 d+ e" A
//调用编译合约% I& U; q! q- N. f8 A9 R9 `
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject();) E! A6 W M7 Y3 t* X
agrs=new JSONArray();
% L; d, |1 r; J* [3 K1 m3 U8 q
JSONObject spendAccount=new JSONObject();
3 k. a M; {* E$ ?1 ^% e
spendAccount.put("account_id","0H757LPD00A02");
# }" U# `% G: r, d1 V5 Y
spendAccount.put("amount",9909099090000l);( k! f: S8 j+ @! ^
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
/ r6 \, w' G( X6 C
spendAccount.put("type","spend_account");
& S2 u$ A$ ]& p. Z' g0 X
agrs.put(spendAccount);. x7 C/ P) X8 R S/ e6 @
JSONObject controlAccount=new JSONObject();# M4 `% d/ L! F+ U: |
controlAccount.put("control_program",program);
" Q3 e- f0 ?" J; b Y, B% W
controlAccount.put("amount",9909099090000l);
: z/ c" U% W) ?& u- [5 W/ H
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");% D# N' l9 s/ i
controlAccount.put("type","control_program");
+ k* `$ O; }9 F* r0 Z
agrs.put(controlAccount);
8 W% ], I |# Y9 [' r; v$ l$ e" _
JSONObject spendAccount2=new JSONObject();- s7 y+ T* y7 D* l! U
spendAccount2.put("account_id","0H757LPD00A02");
" H" u: p$ x/ X# Y# k5 z
spendAccount2.put("amount",6000000l);; S+ o m* H4 G# m9 M( u
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
2 k @' l9 l# G# {# e7 ^. q8 M
spendAccount2.put("type","spend_account");
3 d- n/ M; d3 W' p0 h; a
agrs.put(spendAccount2);
. }6 o8 M5 D$ H3 v( I$ h
param.put("actions",agrs);
+ F- l5 z- N3 c: D6 V9 k
param.put("ttl",0);3 h4 m/ r5 W) }/ u7 K
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: [{2 f# f3 m7 D! U* P" `* W) N
type: 'raw_tx_signature',
5 {2 I/ q2 t/ e0 c' B u9 X9 h
// 生成合约第二步的pubkeylist 详情0 `4 w2 S! j2 F8 G! q0 ?; D6 R
raw_data: {
8 o- K# Q/ R( R) D7 X8 W! N+ C; c2 a
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,
0 A6 ?( u6 }$ I3 u2 Y
xpub: pubkeylist.root_xpub% g" @( _! F0 y+ P
}
" Q, w( z6 F; [ E) k' _; O, Q
}, {# L: r+ J! h% R) d& K
type: 'data',
& D* N7 k- B1 Q4 b
raw_data: {7 o! ?2 J0 ^( y8 {1 Y
// 参数偏移量在一个合约里是固定的
7 @8 @# p+ W/ X" s. L4 S# m- W% P9 w
value: '13000000'
0 w# T1 ~/ ]4 x) P, m( X# n- z9 f
}
6 u$ C) u0 Z' H/ g1 q2 f( Q9 u7 A
}],* Y1 r) f" F) z
output_id: output_id,
; n% P) |- u k, y4 ?$ o2 o3 }+ `. ~
type: 'spend_account_unspent_output'
" E4 Q' p8 ?4 ^. `# X
}
: k4 {# ~- Z0 w
const controlAction = {- \/ O, k3 M+ `, I
type: 'control_program',8 i6 Q! K6 c7 G) F+ B! M
amount: 100000000,8 |$ ]; R5 T* y0 u" ]& J! D. r
asset_id: asset_id,
, {8 A; {1 Q9 g: I
control_program:control_program
9 u. P/ G: u& f7 ~, d5 x
}
9 |+ ?8 h, P/ r8 q1 ~) s
const gasAction = {6 l! j0 K& }) [
type: 'spend_account',
% m) Q9 I' }! s. i0 |/ m
account_id:account_id,
; z+ F9 }' a# o' _
asset_alias: 'BTM',
) R9 C) P Q& @ S! s/ {0 `- ^6 q
amount: 50000000
# m1 y# L$ s8 N& c& L
}

复制代码

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

const spendAccountUnspentOutput = {0 z0 s' p! R+ h e3 }5 h: J5 o
arguments: [{0 o: E) X" o- ?. C# t- T+ Q2 F" c0 U
type: 'data',
& I& O6 i+ R1 L, {* x5 r- s
raw_data: {9 S5 a" X/ z1 S) ?
// 执行合约输入资产偏移量
- \# z1 U( t% J
value: '00000000'
+ u& V7 h) f: c1 q5 e
}6 ?6 ^" R( ?# A% [
}],# Z1 M5 Y2 m" P5 f1 v
output_id: output_id,
8 {2 l% t1 N$ c) q
type: 'spend_account_unspent_output'" q1 M* e; u$ {$ P2 m
}
3 z2 D; Z& W7 b0 l
// 合约执行提供的资产- d$ [; L5 p. T7 E
const issueControlAction = {
+ |. T* j1 ]! y
control_program: control_program,9 F! V7 p. t! s- v |8 _
amount: 100000000,
! \- Q& D/ z L3 c' i, g6 P
asset_id: asset_id,
, }' o& R3 |( m$ M( p4 @) m
type: 'control_program'" B5 [$ }) @% A0 ?* { h# l2 j- Y
}, g3 y4 G1 |0 i* H: ^8 e2 z4 l
// 合约执行提供的资产
9 _" L6 J! }" _, H
const issueSpendAction = {
# L; L$ ^! @2 [! J8 F5 V/ \ _" ?
account_id: account_id,. n9 ]& I. q0 H# {
amount: 100000000, O0 t4 }* T; ~" s' k6 o3 R9 @
asset_id: asset_id,% q1 @' v! C: G- ^" P
type: 'spend_account'4 N/ ?9 ]3 D+ k. x% b
}
: V) Q$ O5 x+ ?2 s. l
// 旷工费# g: V2 k9 B$ d% r% I5 m" p
const gasAction = {
' y$ b: @% d5 {5 U, \
type: 'spend_account',
0 y: ?% E" _, o% D4 L4 c% G2 t, u
account_id: account_id,+ o' d+ |+ Z8 t# G( l9 e
asset_alias: 'BTM',
; S# m4 u& y+ M0 u
amount: 50000000
2 a* L Z p- |8 t0 \! K u) U
}& H+ {& \9 ~4 c3 c# W
// 合约执行获得资产对象
: ?2 m% S( v. D% h( C. f/ g( L1 w
const controlAction = {! A3 l, I6 ^4 ]; |, o: M# S
type: 'control_program',4 q! W5 T" K. E
amount: 100000000,+ I% |( {6 @8 J" w9 `- a
asset_id: asset_id,
$ M; p. ^! V% o7 l
control_program: compileData.control_program! z% h" A0 R% t0 s# ^1 o6 x# c2 O
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {
' [) f/ J4 |$ z& Q' H+ S
OkHttpClient client = new OkHttpClient();5 m+ t5 p% k! _+ a% M. }* H
MediaType mediaType = MediaType.parse("application/json");, \2 y# Z/ T1 B# a n5 O3 ~+ Y
RequestBody body = RequestBody.create(mediaType, bodyStr);9 E V5 A: Q7 b$ j
Request request = new Request.Builder()
7 g: y& S: J$ [6 d7 `/ S1 R
.url(bytomApiserverUrl+"/"+method)9 k6 Y! l8 `% E1 O, Z6 D0 ]
.post(body)
2 t3 Q! z1 Z1 s+ S
.addHeader("cache-control", "no-cache") u4 F4 W6 q4 c. ]: p
.addHeader("Connection", "close")
1 w) r: z. [" F. K. c
.build();( z0 p3 u2 R* s, c7 Z
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){ F5 h% Q- o4 Q
}else {) U$ Z) ?1 X, C4 b" P
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));0 P4 c2 t, M# r# X* K: l+ {5 l; I' K
String authHeader = "Basic " + new String(encodedAuth);
( Z4 f6 ~( r K/ Y2 S8 m
request = new Request.Builder()
+ ]6 S$ [+ w5 W. l9 N
.url(bytomApiserverUrl+"/"+method), A- Q( e) [! I% r9 O) e' m
.post(body)% {# ^7 z( M0 S5 [
.addHeader("authorization", authHeader)* Y) |& }3 c+ b7 p. h& W& u1 l
.addHeader("cache-control", "no-cache")
; U+ r5 I/ e' X) [; z0 P# U/ W
.addHeader("Connection", "close")
' a: W5 t' c# S. T' x7 ?9 d
.build();
$ U/ @3 Q9 \8 f4 `5 Q
}! M" b2 H9 E" g
Response response = client.newCall(request).execute();: ~7 k" y# m, Z, o& U
return response.body().string();/ b9 f! S* y+ b$ P' ^ S U: U# m
}

复制代码

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