簡介

因為Libra和Move都是在不斷髮展的過程，在本文釋出的時候，自定義Move modules還不能在testnet上面釋出，只能在本地環境釋出，下面我們將會看一下到底怎麼才能在本地網路上面執行一個自定義Move程式。

建立Move modules

這裡，我們建立了一個非常簡單的名為MyModule的模組。

該模組具有一個稱為id的單一過程，該過程是一個操作coin的恆等過程。 它輸入LibraCoin.T資源，最後將其返還給呼叫程式。 下面提供了此模組的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);
  }
}
複製程式碼

啟動本地網路

啟動本地網路很簡單，需要用到libra倉庫下面的libra_swarm包。啟動命令如下：

$ cd libra
$ cargo run -p libra_swarm -- -s
複製程式碼

上面的命令會建立一個本地網路的Libra區塊鏈（生成節點的創世交易，初始金鑰和載入程式配置），並啟動一個本地驗證節點。

最後它會啟動一個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進行互動了。

建立賬號並送測試幣

之前的文章我們也講到了怎麼建立賬號，這裡直接列命令：

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建立了100個幣。

編譯Move Module

在上面我們已經把編輯好的Move module程式儲存為my_module.mvir， 我們需要編譯它：

libra% dev compile 0 <path to my_module.mvir> module
複製程式碼

0表示這個module將使用0賬戶來發布。

module 表示你你正在編譯一個Move module程式。如果你在編譯交易指令碼，那麼將其替換為script .

成功編譯模組後，您將在輸出中看到以下訊息，其中包含編譯my_module.mvir生成的位元組碼檔案的路徑。

Successfully compiled a program at /var/folders/tq/8gxrrmhx16376zxd5r4h9hhn_x1zq3/T/.tmpigAZCx
複製程式碼

釋出編譯好的Module

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

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

waiting .....transaction is stored!
no events emitted.
Successfully published module
複製程式碼

成功執行dev publish命令後，MyModule的位元組碼將在傳送者的帳戶下發布。 要使用MyModule中宣告的過程和型別，其他事務指令碼和模組可以使用import <sender_address> .MyModule將其匯入。

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

建立交易指令碼

我們編寫如下的交易指令碼，並將其儲存為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;
}
複製程式碼

這個指令碼就是簡單的呼叫了MyModule的id過程。

在此指令碼中，執行指令碼時，{{sender}}將自動替換為發件人帳戶地址。 或者，您可以import完全限定地址：

 import 0x810abcc08dbed34ea15d7eb261b8001da6a62d72acdbf87714dd243a175f9b62.MyModule;
複製程式碼

編譯編譯指令碼

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

libra% dev compile 0 <path_to_custom_script.mvir> script
複製程式碼

結果如下：

Successfully compiled a program at /var/folders/tq/8gxrrmhx16376zxd5r4h9hhn_x1zq3/T/.tmpDZhL21
複製程式碼

執行指令碼

使用dev execute 命令來執行指令碼。

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

0是傳送者的賬戶index.

/var/folders/tq/8gxrrmhx16376zxd5r4h9hhn_x1zq3/T/.tmpDZhL21是上面編譯好的指令碼地址。

10 是要呼叫的幣的數量。

這樣一個自定義Move module就完成併成功呼叫了。

更多教程請參考 flydean的部落格