簡介

因為Libra和Move都是在不斷發(fā)展的過程，在本文發(fā)布的時候，自定義Move modules還不能在testnet上面發(fā)布，只能在本地環(huán)境發(fā)布，下面我們將會看一下到底怎么才能在本地網(wǎng)絡上面運行一個自定義Move程序。

創(chuàng)建Move modules

這里，我們創(chuàng)建了一個非常簡單的名為MyModule的模塊。

該模塊具有一個稱為id的單一過程，該過程是一個操作coin的恒等過程。 它輸入LibraCoin.T資源，最后將其返還給調(diào)用程序。 下面提供了此模塊的Move IR代碼，并將其保存在名為my_module.mvir的文件中。

module MyModule {
  import 0x0.LibraCoin;

  // The identity function for coins: takes a LibraCoin.T as input and hands it back
  public id(c: LibraCoin.T): LibraCoin.T {
    return move(c);
  }
}

啟動本地網(wǎng)絡

啟動本地網(wǎng)絡很簡單，需要用到libra倉庫下面的libra_swarm包。啟動命令如下：

$ cd libra
$ cargo run -p libra_swarm -- -s

上面的命令會創(chuàng)建一個本地網(wǎng)絡的Libra區(qū)塊鏈（生成節(jié)點的創(chuàng)世交易，初始密鑰和引導程序配置），并啟動一個本地驗證節(jié)點。

最后它會啟動一個Libra cli客戶端，如下所示：

usage: <command> <args>

Use the following commands:

account | a
Account operations
query | q
Query operations
transfer | transferb | t | tb
<sender_account_address>|<sender_account_ref_id> <receiver_account_address>|<receiver_account_ref_id> <number_of_coins> [gas_unit_price_in_micro_libras (default=0)] [max_gas_amount_in_micro_libras (default 100000)] Suffix 'b' is for blocking.
Transfer coins (in libra) from account to another.
dev
Local Move development
help | h
Prints this help
quit | q!
Exit this client


Please, input commands:

libra%

接下來我們就可以通過命令行和libra進行交互了。

創(chuàng)建賬號并送測試幣

之前的文章我們也講到了怎么創(chuàng)建賬號，這里直接列命令：

libra% account create
>> Creating/retrieving next account from wallet
Created/retrieved account #0 address 810abcc08dbed34ea15d7eb261b8001da6a62d72acdbf87714dd243a175f9b62


libra% account mintb 0 100
>> Minting coins
waiting ....transaction is stored!
Finished minting!

我們給賬戶0創(chuàng)建了100個幣。

編譯Move Module

在上面我們已經(jīng)把編輯好的Move module程序保存為my_module.mvir， 我們需要編譯它：

libra% dev compile 0 <path to my_module.mvir> module

0表示這個module將使用0賬戶來發(fā)布。

module 表示你你正在編譯一個Move module程序。如果你在編譯交易腳本，那么將其替換為script .

成功編譯模塊后，您將在輸出中看到以下消息，其中包含編譯my_module.mvir生成的字節(jié)碼文件的路徑。

Successfully compiled a program at /var/folders/tq/8gxrrmhx16376zxd5r4h9hhn_x1zq3/T/.tmpigAZCx

發(fā)布編譯好的Module

使用dev publish來發(fā)布上一步編譯好的Module：

libra% dev publish 0 /var/folders/tq/8gxrrmhx16376zxd5r4h9hhn_x1zq3/T/.tmpigAZCx

waiting .....transaction is stored!
no events emitted.
Successfully published module

成功執(zhí)行dev publish命令后，MyModule的字節(jié)碼將在發(fā)送者的帳戶下發(fā)布。 要使用MyModule中聲明的過程和類型，其他事務腳本和模塊可以使用import <sender_address> .MyModule將其導入。

在<sender_address>下發(fā)布的后續(xù)模塊不得命名為MyModule。 每個帳戶最多可以擁有一個給定名稱的模塊。 嘗試在<sender_address>下發(fā)布名為MyModule的第二個模塊將導致事務失敗。

創(chuàng)建交易腳本

我們編寫如下的交易腳本，并將其保存為custom_script.mvir。

import 0x0.LibraAccount;
import 0x0.LibraCoin;
import {{sender}}.MyModule;

main(amount: u64) {
  let coin: LibraCoin.T;
  coin = LibraAccount.withdraw_from_sender(move(amount));
  //calls the id procedure defined in our custom module
  LibraAccount.deposit(get_txn_sender(), MyModule.id(move(coin)));
  return;
}

這個腳本就是簡單的調(diào)用了MyModule的id過程。

在此腳本中，執(zhí)行腳本時，{{sender}}將自動替換為發(fā)件人帳戶地址。 或者，您可以import完全限定地址：

 import 0x810abcc08dbed34ea15d7eb261b8001da6a62d72acdbf87714dd243a175f9b62.MyModule;

編譯編譯腳本

同樣使用dev compile來進行編譯：

libra% dev compile 0 <path_to_custom_script.mvir> script

結(jié)果如下：

Successfully compiled a program at /var/folders/tq/8gxrrmhx16376zxd5r4h9hhn_x1zq3/T/.tmpDZhL21

執(zhí)行腳本

使用dev execute 命令來執(zhí)行腳本。

libra% dev execute 0 /var/folders/tq/8gxrrmhx16376zxd5r4h9hhn_x1zq3/T/.tmpDZhL21 10
waiting .....transaction is stored!
Successfully finished execution

0是發(fā)送者的賬戶index.

/var/folders/tq/8gxrrmhx16376zxd5r4h9hhn_x1zq3/T/.tmpDZhL21是上面編譯好的腳本地址。

10 是要調(diào)用的幣的數(shù)量。

這樣一個自定義Move module就完成并成功調(diào)用了。

更多教程請參考 flydean的博客