Libra教程之:运行自定义move modules
文章目錄
- 簡介
- 創建Move modules
- 啟動本地網絡
- 創建賬號并送測試幣
- 編譯Move Module
- 發布編譯好的Module
- 創建交易腳本
- 編譯編譯腳本
- 執行腳本
簡介
因為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 backpublic 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 clientPlease, input commands:libra%接下來我們就可以通過命令行和libra進行交互了。
創建賬號并送測試幣
之前的文章我們也講到了怎么創建賬號,這里直接列命令:
libra% account create >> Creating/retrieving next account from wallet Created/retrieved account #0 address 810abcc08dbed34ea15d7eb261b8001da6a62d72acdbf87714dd243a175f9b62libra% 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> module0表示這個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/.tmpigAZCxwaiting .....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 moduleLibraAccount.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 execution0是發送者的賬戶index.
/var/folders/tq/8gxrrmhx16376zxd5r4h9hhn_x1zq3/T/.tmpDZhL21是上面編譯好的腳本地址。
10 是要調用的幣的數量。
這樣一個自定義Move module就完成并成功調用了。
更多精彩內容且看:
- 區塊鏈從入門到放棄系列教程-涵蓋密碼學,超級賬本,以太坊,Libra,比特幣等持續更新
- Spring Boot 2.X系列教程:七天從無到有掌握Spring Boot-持續更新
- Spring 5.X系列教程:滿足你對Spring5的一切想象-持續更新
- java程序員從小工到專家成神之路(2020版)-持續更新中,附詳細文章教程
更多教程請參考 flydean的博客
總結
以上是生活随笔為你收集整理的Libra教程之:运行自定义move modules的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Libra教程之:来了,你最爱的Move
- 下一篇: JDK12的五大重要新特性