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

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

contract TradeOffer(assetRequested: Asset,
: J8 E% E0 _$ M, }& E
amountRequested: Amount,- }. W+ O! x/ J: X
seller: Program,
' A* Y! f; W- k
cancelKey: PublicKey) locks offered {
+ ^' G" y6 A7 h2 c# `. \
clause trade() requires payment: amountRequested of assetRequested {+ }: l+ I! k/ C, t$ |/ D2 R3 @
lock payment with seller
9 N, B# d& v7 g4 b+ d& ]
unlock offered! a# K7 _( m- P- C; L- X
}
8 u8 e5 w, q& b% `6 b6 S
clause cancel(sellerSig: Signature) {
G! D: g1 [5 {" |5 ^4 K- X) [3 @8 J
verify checkTxSig(cancelKey, sellerSig)
' z2 L9 H1 d/ R) Q; t
unlock offered1 D! ?/ U9 j H& ~2 U, Y* V/ G0 C0 Q
}5 l- {* F( Q/ J8 n, C; |7 S' S
}

复制代码

导读：初次接触比原只能合约的请点击比原智能合约入门和 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();! l3 ]4 z3 U* Z2 y' [9 \; m
JSONArray agrs=new JSONArray();
5 l: R- O% c6 n
//合约的四个参数值; R' k4 l7 f6 b* W8 I' L% U
JSONObject assetParam=new JSONObject();- R; P. q: i* d/ K5 u |, ]
assetParam.put("string","81d097312645696daea84b761d2898d950d8fba0de06c9267d8513b16663dd3a");6 Y6 p9 V) K/ E# K( ~0 a
agrs.put(assetParam);
, \* r7 Y, X3 R) b
JSONObject amountParam=new JSONObject();) `! G8 g/ }! ?) p" \: I9 B% Q
amountParam.put("integer",200000000l);6 w( `; T# c% R5 \# F
agrs.put(amountParam);, u2 q& c( g+ Q8 ` T ?
JSONObject programParam=new JSONObject();
4 L. {: d( X4 S5 `
programParam.put("string",control_program);
) `( G6 Y( V7 N: p7 \ y* v
agrs.put(programParam);
. w6 D. x% b8 q! O5 t
JSONObject publicKeyParam=new JSONObject();9 J# ~- a9 q! M w) C* @
publicKeyParam.put("string",pubkey);2 K; M; ?/ B3 J. x# Z* ]: L
agrs.put(publicKeyParam);% ]4 n, W1 @' v3 ^- w
param.put("agrs",agrs);5 O) h, x0 @, t- X6 l% a
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 } }");
5 t" M' Z8 B9 J8 {( E
//调用编译合约
2 V/ o. I) C n8 l+ ~
sendHttpPost(param.toString(),"list-pubkeys","http://127.0.0.1:9888","");

复制代码

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

以下是相关代码片段：

param=new JSONObject();
2 T p0 k! a2 S
agrs=new JSONArray();
! A( ]! |" U K1 u! s
JSONObject spendAccount=new JSONObject();/ t) g# _) c V
spendAccount.put("account_id","0H757LPD00A02");. S7 V5 J, N) h3 s# g
spendAccount.put("amount",9909099090000l);
& @6 s( Q5 \* j j2 E
spendAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");( W/ M. E2 x9 z' ^% Y
spendAccount.put("type","spend_account");
, K' P" k- [1 A. l5 E+ E2 e. L
agrs.put(spendAccount); V# s% Q4 j% s7 ]- k% c! W
JSONObject controlAccount=new JSONObject();
2 D/ z7 ]2 A: `4 R5 i5 w9 z1 v
controlAccount.put("control_program",program);+ E: J& e3 W% |% K" G9 z2 j9 F
controlAccount.put("amount",9909099090000l);5 |" v9 j2 ]4 \- h6 i$ `
controlAccount.put("asset_id","161b9767b664df907fa926a31f9e835236e57f3e9ccc5f80c12bd97723322652");0 O2 Q6 S6 ^* g, F$ U; r# T
controlAccount.put("type","control_program");
" F# _. S, w; N9 B
agrs.put(controlAccount);
# { q }( y ?/ L& D8 G: X
JSONObject spendAccount2=new JSONObject();) e$ Z8 P N0 ^5 b- M' d, R
spendAccount2.put("account_id","0H757LPD00A02");8 Q/ {9 I: d! Q1 W$ v& X! ?
spendAccount2.put("amount",6000000l);- D* C2 a! C' E1 x( a
spendAccount2.put("asset_id","ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");0 M8 Y/ n L, @0 A4 z
spendAccount2.put("type","spend_account");
2 g2 K1 R& w x9 v" M% \
agrs.put(spendAccount2);
, S& i8 o0 [# f$ z, W: E o! q8 h
param.put("actions",agrs);+ F; i, n: _1 z5 L3 Q
param.put("ttl",0);! x) o) O) Z: k5 O, 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: [{
7 z `' U; b; q) s3 p
type: 'raw_tx_signature',
9 I2 H! d+ E' \/ A
// 生成合约第二步的pubkeylist 详情1 ~& Q' `$ \, M9 ]: O
raw_data: {) t. v4 R( h( m0 O2 e& y) J
derivation_path: pubkeylist.pubkey_infos[0].derivation_path,' n( Q. y! v3 U4 A
xpub: pubkeylist.root_xpub
8 _ V) { m5 X$ D1 N6 c
}
" ?8 [# ~; G7 C! K
}, {
/ S/ z( K1 a' o. {8 ]
type: 'data',
" k$ y- ?% v: t+ n( h
raw_data: {
0 [6 V2 A, t/ x7 g/ S
// 参数偏移量在一个合约里是固定的 $ z: t: A/ R" z& x& h ]
value: '13000000'
b; U5 B7 N7 a; o
}
8 j' v8 L. y! M1 b4 {
}],
3 ^' O0 D: V8 D$ \% B
output_id: output_id,# m% v, `& Y1 g, j1 Z& S/ W" G
type: 'spend_account_unspent_output'2 E% D- Q x0 Y/ z/ l* V; T
}+ O5 \; Y# U2 ]8 l( c% o' t7 ?$ a8 y
const controlAction = {
% _# z/ Z+ `$ q% w1 k0 c8 B
type: 'control_program',( H0 F4 O W# O" `
amount: 100000000,
8 y) b; o1 @# b1 [
asset_id: asset_id,
/ ~, _; R- k; |9 F& X
control_program:control_program% `9 l, @* [; p8 Z4 {; d* w8 c9 m. h; m
}) d7 }; e0 c7 m9 L& N p
const gasAction = {
- g5 j# B5 i9 O4 J! A9 F# |
type: 'spend_account',
% ~ i+ O) i& ~0 u8 \' q
account_id:account_id,
. a ?) q X& h( Z0 \
asset_alias: 'BTM',1 ~3 b" K0 E% h* _' y
amount: 50000000
) F- [! W9 W# K% a
}

复制代码

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

const spendAccountUnspentOutput = {! V0 p; g. J) L* m2 C
arguments: [{8 E& j3 o! y. i2 e
type: 'data',% c3 h$ k+ V+ b: Y( W
raw_data: {
+ |9 d5 P0 t P8 F
// 执行合约输入资产偏移量; q) d& f$ \" p% B' Y$ |4 d
value: '00000000'( c7 T' K) J, B; ~: M, {
}
* q/ D4 V$ g& b$ b
}],# Q$ [) J1 U& t9 L+ R
output_id: output_id,. s; x/ q& J$ E3 a
type: 'spend_account_unspent_output') y( B( b: Z7 L& [1 G5 [, N
}4 J6 J& S% `4 b+ O5 E3 j) F
// 合约执行提供的资产
Q( q& h2 W/ G/ _6 J) D, z
const issueControlAction = {9 n5 ?. B7 r9 w8 ]) `
control_program: control_program,, |! b) L9 M8 F
amount: 100000000,/ B3 Q9 Z3 w# i% S, A3 J) R
asset_id: asset_id,
+ [. n6 a$ ?! _$ [
type: 'control_program'
/ }) Z b4 ^* `0 K Z
}4 ^8 h5 m# C( b: L& h
// 合约执行提供的资产
/ {3 W& [% A- q6 w: ]5 n
const issueSpendAction = {" h% S$ ~1 o" [3 L
account_id: account_id,9 P" e7 y l8 `4 E/ `0 h/ D( W
amount: 100000000,: l. I) @- p: h
asset_id: asset_id,, \& d* ~: X! W V5 `% }! s3 x
type: 'spend_account'
- X, `1 w8 ]; n) N/ E
}9 I: u. ]9 j; g8 |# B- w
// 旷工费
1 S9 t0 C% A3 L0 S) v4 B$ b
const gasAction = {
) `1 Z% a- F- D7 B3 K8 Q6 x% G
type: 'spend_account',
+ W$ {5 ^3 o; a% Y
account_id: account_id,1 J2 H0 n5 b1 ]; _1 z
asset_alias: 'BTM',7 j$ Q' B2 C6 v1 }# Z' p" ]
amount: 500000009 I$ W3 U: x( w5 _. T$ X9 c
}
$ U& ^6 P0 `5 j. @- U8 ?
// 合约执行获得资产对象7 i+ z7 _$ G9 N+ }" s& A6 Z
const controlAction = {; e9 I C% }- d% C0 \
type: 'control_program',
( k W# n' K/ n. K) Z+ O, D* I
amount: 100000000,0 l" P% A! l& g# l
asset_id: asset_id,1 n' d! o& r1 ^3 k0 Z. }
control_program: compileData.control_program; G6 N" ?8 e' Q6 W, K
}

复制代码

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

public static String sendHttpPost(String bodyStr,String method,String bytomApiserverUrl,String bytomApiserverToken) throws IOException {* M8 I% ~2 `6 c# {
OkHttpClient client = new OkHttpClient();0 Z" t0 A( E) [& L# K
MediaType mediaType = MediaType.parse("application/json");
0 @6 k* M" P" A1 g( k
RequestBody body = RequestBody.create(mediaType, bodyStr);# I3 Z2 h, h" s9 `; ?- ~9 |
Request request = new Request.Builder(); r6 J# C$ y3 ?- l0 Y
.url(bytomApiserverUrl+"/"+method)
6 n* t# @) {# L
.post(body)5 p$ F$ s! T9 R0 T* A5 J; Z/ F
.addHeader("cache-control", "no-cache") g; e( \0 F: E9 Q% i: K
.addHeader("Connection", "close")1 x0 S& j" J4 f* @6 B S; _
.build();! H8 e; h! X; Y/ q4 f
if (bytomApiserverUrl==null || bytomApiserverUrl.contains("127.0.0.1") || bytomApiserverUrl.contains("localhost")){! F' m' O: p2 v2 B/ {
}else {. G: [0 l& w( G" N2 W
byte[] encodedAuth = Base64.encodeBase64(bytomApiserverToken.getBytes(Charset.forName("US-ASCII")));
# l8 V: U- @# A$ j
String authHeader = "Basic " + new String(encodedAuth);
: w1 C/ D( _% b" I/ {. d# v
request = new Request.Builder()& |4 `# e9 U8 i
.url(bytomApiserverUrl+"/"+method)6 \3 X: V4 J# m' h
.post(body)& I& z' m+ {3 B! W! i: U S
.addHeader("authorization", authHeader)' y; {- F3 u5 R% b1 |) A- T k
.addHeader("cache-control", "no-cache")
6 r$ ?- T% \# l
.addHeader("Connection", "close")2 L" l9 t8 B5 x0 B
.build();
) g# i. F+ y# Z0 ^4 y
} Z& `+ S* X2 t$ b
Response response = client.newCall(request).execute();, ^5 ]9 g) x# h Z, e/ b, W* ^5 O; H
return response.body().string();) D/ B3 {: i s8 _! M6 y
}

复制代码

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

浏览过的版块