币币合约执行解析(包含部分源码)

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

contract TradeOffer(assetRequested: Asset,& i- X% X% ^9 U. w, e G
amountRequested: Amount,
/ k6 |2 {% c. \- T! U
seller: Program,
) p& @$ ^4 e% _1 W$ e4 d4 s. u
cancelKey: PublicKey) locks offered {+ e; o% I% d8 G1 T$ F# X/ j
clause trade() requires payment: amountRequested of assetRequested {
9 j) k E( ~2 x& Q' ]. M; W" F
lock payment with seller: ] }; P1 Y& u
unlock offered$ s. b' x) L# \+ Y0 j6 T; h9 k) `5 {
}
+ u7 v" S" w8 W o7 F* r2 b
clause cancel(sellerSig: Signature) {
K1 m5 E5 e. M' e
verify checkTxSig(cancelKey, sellerSig)
6 H ^$ ], }8 {' q. x! J
unlock offered
- Q- j' t- I4 a4 O8 u# `' B5 g! J
}
8 e0 y: h. \2 @2 b. b
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 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();. \) G! l2 t4 h, T
JSONArray agrs=new JSONArray();
; h y/ j4 C) g" {
//合约的四个参数值
% _0 L. {+ t' J$ r$ N
JSONObject assetParam=new JSONObject();
$ ~- {9 {2 ]0 Z; M( W0 X9 T
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");& ^) n# w' v! n/ g
agrs.put(assetParam);
: Y$ m3 W2 j6 I& c% k6 _" s
JSONObject amountParam=new JSONObject(); X) Y i& y6 \6 i, L
amountParam.put("integer",200000000l); U& l( n* q. y- P; s
agrs.put(amountParam);9 t! v; n) u( c% c
JSONObject programParam=new JSONObject();, @2 E0 h# _$ D" N4 _6 y
programParam.put("string",control_program);8 N0 n) o- P* e: d4 M9 Z% v
agrs.put(programParam);
3 U6 b9 f R' U3 g+ b
JSONObject publicKeyParam=new JSONObject();3 L" F6 ]9 s* a
publicKeyParam.put("string",pubkey);5 f& Y! J! ?4 ]9 Z* k
agrs.put(publicKeyParam);
2 [# T }8 l8 g; _
param.put("agrs",agrs);
$ }% v8 M X; ?. A/ M3 B
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 } }");( S9 v( T- t' R! z7 b
//调用编译合约4 {# Z1 b, y2 x, n1 o5 C
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject();
6 V+ t8 Z& C" ?8 H$ v& x4 ?. e
agrs=new JSONArray();4 X3 t( e5 O" _- h
JSONObject spendAccount=new JSONObject();( i/ u7 V/ u) g2 Y$ Q: x
spendAccount.put("account_id","0H757LPD00A02");0 q+ }( \) y6 i8 K" E
spendAccount.put("amount",9909099090000l);
, Y6 |6 y0 t; d6 u9 Q
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");4 y5 ?+ i2 h9 b" V( m1 R
spendAccount.put("type","spend_account");" Y: j M0 M% ~# v$ K! x1 M
agrs.put(spendAccount);( y% A4 H$ j; K3 p; T
JSONObject controlAccount=new JSONObject();
& {9 u# m8 e2 o6 n6 z9 l5 B1 f, l
controlAccount.put("control_program",program);
; B2 E8 |* G) H+ b( E5 q5 A
controlAccount.put("amount",9909099090000l);
# K" e$ j1 X) K
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");
8 G# A2 s1 A- c" ]0 l7 {: v
controlAccount.put("type","control_program");4 k( N# X K- x6 `' y9 |
agrs.put(controlAccount);
# | Y4 o# L9 e
JSONObject spendAccount2=new JSONObject();; g- v: X s+ F* ?. N$ {; K0 O/ l
spendAccount2.put("account_id","0H757LPD00A02");
% [9 o$ S# B' ~
spendAccount2.put("amount",6000000l);7 `9 h0 B- R2 f _, X8 q
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
: T9 h) i; K; K
spendAccount2.put("type","spend_account");: V6 n7 R# U6 i4 `( |6 r) ^
agrs.put(spendAccount2);6 B' I% e$ P4 m. b* Q. ]
param.put("actions",agrs);* u, z, ~. s; [
param.put("ttl",0);9 H+ R# Z8 e+ C; R
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: [{
$ T% N5 ^7 C! W, E
type: 'raw_tx_signature',& U" W! A2 r8 Q# @5 ~7 E
// 生成合约第二步的pubkeylist 详情
3 z, c; K" u4 |& a) ]
raw_data: {# V( U* d0 _; \( ?' c5 O+ E! H7 c
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,% X& H) w) ?# a8 X& O/ t
xpub: pubkeylist.root_xpub
2 x o- u, Y. H- F" L1 A
}( f/ D8 r, _7 S8 q
}, {
( |( u! i6 {$ }4 G4 ]
type: 'data',9 S p; {, z: \3 ?0 x7 z
raw_data: {: _ m: w; J2 _
// 参数偏移量在一个合约里是固定的 . N' g, \( Y( g! @0 b+ d% l- P3 x
value: '13000000'$ O$ C) \* ?& J/ L
}
# h0 I/ @9 |% b) w
}],0 V8 U) T ]2 B
output_id: output_id,: o8 v6 A% a, L" j2 w. G0 T
type: 'spend_account_unspent_output'
' h6 }% i1 x& F, d
}
/ i* p7 J: p9 x3 g ?/ I
const controlAction = {9 @9 t; X/ x/ M7 V: w. P6 K/ X
type: 'control_program',& I/ n+ N7 {& P N- `
amount: 100000000,
y( A8 d8 I) m; h/ E
asset_id: asset_id,
9 x2 C" w |' _$ C
control_program:control_program
/ ?: b3 H* t3 V) ^: Z. A. M. h
}
% y* n+ w1 l' f3 [! p
const gasAction = {
' [. B t- \" C
type: 'spend_account',: }% A7 l' r b2 T7 ], |
account_id:account_id," N0 \: [# { r4 p3 F
asset_alias: 'BTM',6 J+ E" E; P S1 R8 ^7 W" { a
amount: 50000000
$ @& `% ]- Q3 _ {# Q$ |6 l/ [
}

复制代码

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

const spendAccountUnspentOutput = {/ s1 R* l2 F: {
arguments: [{# L5 o8 K, w- l5 t! L; m( R
type: 'data',
8 {. B" _/ V# A) g8 @8 U
raw_data: {; ^1 \- `3 D/ s% l" k
// 执行合约输入资产偏移量
1 C |! I5 ^- v4 P0 q8 W) z+ O1 m
value: '00000000'
P: r" U1 v6 b, V
}
# X3 m) K3 ]* S* k% j
}],* x" Z+ k" J+ h9 G
output_id: output_id,
$ b! ^! ]$ W E
type: 'spend_account_unspent_output'9 G L H8 M. S8 @( W- l
}
# g6 I, u8 y8 o& i5 v8 e6 g2 w1 g
// 合约执行提供的资产
( W' _5 U7 S7 U' T- i9 S
const issueControlAction = {, T0 x! x* P$ g9 p: Z% ]3 n! E
control_program: control_program,: P% d g% n1 V* `* K+ ?4 X/ m
amount: 100000000," l7 A- j8 I# L% w& ]- i, U% N
asset_id: asset_id,& B$ ?$ v3 W' J7 x8 X& [
type: 'control_program') J+ n# W$ l* E
}
4 r( ?& {( u% S1 F1 {
// 合约执行提供的资产2 [9 m& A/ N) e
const issueSpendAction = {, m$ I: N+ U) c2 E- u4 U
account_id: account_id,
! y- Y3 ~1 w" X- R7 m9 k. c
amount: 100000000,
1 A3 b! H+ y$ E. s8 g& `
asset_id: asset_id,4 m3 ]- ^2 i1 v" J# C5 S( C; s' b0 J# |. M. \
type: 'spend_account'
1 u* Z1 i9 q( e8 A4 x
}5 ?( m0 x+ V8 s# x0 j8 ?, E: q
// 旷工费8 _5 M- y/ b# _. I$ F2 l `: I6 j. Q
const gasAction = {
: K( R4 M6 F6 D( \6 q3 L
type: 'spend_account',
0 k" O0 d9 W& S
account_id: account_id,
* y5 p' [+ r( H. G8 l6 U
asset_alias: 'BTM',6 K8 H' O7 Q- q9 O. w b; k
amount: 50000000- v" _/ }4 G; @
}4 G+ }) H' l+ F, Q' ~5 l4 p B- T
// 合约执行获得资产对象
% v" p4 g0 f$ X
const controlAction = {
3 o4 L! ]- q# O+ i. S7 i1 X1 U7 O% X
type: 'control_program',9 q% l7 @2 }3 W1 ]8 j( F6 ~
amount: 100000000, ?* f5 _; N0 ^
asset_id: asset_id,' W% i6 V4 ]0 _" i @
control_program: compileData.control_program9 D7 f% I: x4 ~! u* Y0 d
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {
1 X. o; ~# g" V- M( i
OkHttpClient client = new OkHttpClient();, u7 `( h2 F2 s0 b7 s4 I6 y8 @
MediaType mediaType = MediaType.parse("application/json");
* m" B/ R7 P9 W+ j2 E1 s$ h
RequestBody body = RequestBody.create(mediaType, bodyStr); M3 @6 V8 w4 M7 n8 _2 ^
Request request = new Request.Builder()
! L) Z8 W: v8 E) y: P: G
.url(bytomApiserverUrl+"/"+method)$ d$ X/ q4 L m
.post(body)
q; K& w# _" W2 R4 E+ l
.addHeader("cache-control", "no-cache")2 i5 c: j) u/ Z# r0 |" h
.addHeader("Connection", "close")
4 X P+ ^* X# z+ b) d
.build();9 C2 m0 e) t; v, B# }/ R4 y
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){
3 E9 }: c, h3 U
}else {/ q! K4 g+ t8 Z( a
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));' c/ P' L, s, C$ J8 I
String authHeader = "Basic " + new String(encodedAuth);( N! H; }) ]4 Z3 l9 A5 G/ c
request = new Request.Builder()% M5 L1 ]6 b) i
.url(bytomApiserverUrl+"/"+method) c! k. ]4 _# E6 z3 v0 U ~1 k* d
.post(body)
/ p6 N+ O( I& z' |1 {0 {
.addHeader("authorization", authHeader)9 F* e& q( S: u7 {7 F( Z5 s
.addHeader("cache-control", "no-cache")( l7 @$ ?1 N0 B& G
.addHeader("Connection", "close"); }* K! A, H0 p7 ^5 N
.build();0 Y! e9 J) S/ v; g% W, r$ u
}
* U) g: l& _1 r) b
Response response = client.newCall(request).execute();* U- }7 Q5 U, _, P
return response.body().string();( w0 @- x' [6 F3 L9 @4 i+ I
}

复制代码

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

浏览过的版块