UNT:DAOrayaki：Aptos & Move實操講解

DAOrayakiDAO研究獎金池：

資助地址:?DAOrayaki

Struct&Abilities

struct?Counter?has?key,?store?{????value:u64,}

使用struct定義了一個叫做Counter的結構體，同時被key,store兩種限制符修飾。

Move的類型系統靈活，每種類型都可以定義四種能力。

它們定義了類型的值是否可以被復制、丟棄和存儲。

這四種abilities限制符分別是:Copy,Drop,Store和Key。

它們的功能分別是：

Copy?-值可以被復制。

Drop?-在作用域結束時值可以被丟棄。

Key?-值可以作為鍵值被「全局存儲操作」進行訪問。

Store?-值可以被?存儲?到全局狀態。

這里用key、store修飾，則表示它不能被復制，也不能被丟棄或重新使用，但是它卻可以被安全地存儲和轉移。

Abilities的語法

基本類型和內建類型的abilities是預先定義好的并且不可改變:integers,vector,addresses和boolean類型的值先天具有copy、drop和storeability。

然而，結構體的ability可以按照下面的語法進行添加：

struct?NAME?has?ABILITY??{??}

一個簡單的圖書館例子：

Shell Protocol已開放“是否成立DAO以接受其他項目空投”投票:3月22日消息，DeFi協議Shell Protocol已開放“是否成立Shell DAO以接受其他項目空投”投票。此前報道，Shell Protocol曾于Arbitrum網絡發行Toucan NFT，并將此NFT系列用于社區治理投票。[2023/3/22 13:18:44]

module?Library?{????//?each?ability?has?matching?keyword????//?multiple?abilities?are?listed?with?comma????struct?Book?has?store,?copy,?drop?{????????year:?u64????}????//?single?ability?is?also?possible????struct?Storage?has?key?{????????books:?vector????}????//?this?one?has?no?abilities????struct?Empty?{}}

什么是Resource

Move白皮書中詳細描述了Resource這個概念。最初，它是作為一種名為resource的結構體類型被實現，自從引入ability以后，它被實現成擁有?Key和?Store兩種ability的結構體。Resource可以安全的表示數字資產，它不能被復制，也不能被丟棄或重新使用，但是它卻可以被安全地存儲和轉移。

Resource的定義

Resource是一種用?key?和?store?ability限制了的結構體:

TreasureDAO推出新的創作者計劃Treasure Create:3月8日消息，去中心化游戲生態系統 TreasureDAO 宣布推出新的創作者計劃 Treasure Create，旨在培養 Treasure 生態系統和游戲中的優秀視頻內容創作者社區。

作為官方的 Treasure Creator，內容創造者可以利用 Treasure 的 15 萬以上玩家和游戲的大型社區來增加曝光率，并獲得諸如 Allow List、游戲內道具、游戲測試的早期訪問以及與其他創造者合作的機會。目前該計劃已與 10 位早期創造者合作，并正募集更多的內容創造者加入 Treasure Create。[2023/3/8 12:49:03]

module?M?{????struct?T?has?key,?store?{????????field:?u8????}}Resource的限制

在代碼中，Resource類型有幾個主要限制：

Resource存儲在帳戶下。因此，只有在分配帳戶后才會存在，并且只能通過該帳戶訪問。

一個帳戶同一時刻只能容納一個某類型的Resource。

Resource不能被復制；與它對應的是一種特殊的kind：resource，它與copyable不同，這一點在泛型章節中已經介紹。

Resource必需被使用，這意味著必須將新創建的Resource?move到某個帳戶下，從帳戶移出的Resource必須被解構或存儲在另一個帳戶下。

剛才的案例

struct?Counter?has?key,?store?{????value:u64,}

MakerDAO投票決定在3個月內用300萬DAI進行MKR回購試驗:6月24日消息，MakerDAO投票決定在3個月內用300萬DAI購買和銷毀MKR，通過部署試運行DssKiln來實現整個過程，MakerDAO旨在讓其金庫維持高于當前水平的盈余緩沖，以降低未來債務拍賣中MKR鑄造崩盤事件的可能性。

據悉，該提案是Restart the burn SR V2提案的升級版本。而DssKiln是一個無需許可的代幣購買和處置工具，將直接使用DAI從Uniswap市場購買MKR并通過調用MKR的burn()功能來銷毀它們。[2022/6/24 1:29:08]

所以這里就有一個和solidity的區別了，在eth上如果需要發行一個新資產，比如usdc。那這個資產是記錄在合約里的某個map中。而move就不同了，資產是作為resource存在用戶地址下的。

定義函數

public?fun?init(account:?&signer){????move_to(account,?Counter{value:0});}public?fun?incr(account:?&signer)?acquires?Counter?{????let?counter?=?borrow_global_mut(signer::address_of(account));????counter

public?entry?fun?init_counter(account:?signer){????Self::init(&account。public?entry?fun?incr_counter(account:?signer)??acquires?Counter?{????Self::incr(&account。

DeFi協議Ondo Finance提案組成DAO聯盟接管Sushi部分治理:2 月 5 日，DeFi協議OndoFinance本周三在Sushi的論壇上發布了一項提案，提議由Ondo Finance組織的DAO聯盟Poke Bowl來接管Sushi的部分管理權。由Ondo Finance組織的DAO聯盟Poke Bowl還包括Frax、Synapse、UMA和NEAR等，它們希望為SushiDAO建立一個正式的區塊鏈上和合法的離岸實體。（彭博社）[2022/2/5 9:33:08]

定義格式則是:

public?fun?函數名(參數：參數類型){?}

move函數默認是私有函數，只能在定義它們的模塊中訪問。關鍵字public將更改函數的默認可見性并使其公開，即可以從外部訪問。

init方法參數是一個&signer，意味著該方法必須是一個賬戶合法簽名過后才可以調用，move_to則是move的一個原語，作用是發布、添加Counter資源到signer的地址下。Move的賬戶模型，code和data是存儲在一個賬戶地址下的。

下面是列舉的常用原語

move_to<T>(&signer,T)：發布、添加類型為T的?Resource?到signer的地址下。

move_from<T>(addr:address):T-從地址下刪除類型為T的?Resource?并返回這個資源。

borrow_global<T>(addr:address):&T-返回地址下類型為T的?Resource?的不可變引用。

MakerDAO已添加GUSD為抵押資產:金色財經報道，據Gemini官方推特消息，GUSD（Gemini USD）作為新抵押資產添加到Maker Protocol的提案獲得一致通過。GUSD已作為抵押資產添加到MakerDAO。[2020/9/1]

borrow_global_mut<T>(addr:address):&mutT-返回地址下類型為T的?Resource?的可變引用。

exists<T>(address):bool：判斷地址下是否有類型為T的?Resource。

incr方法參數也是一個&signer，意味著該方法必須是一個賬戶合法簽名過后才可以調用,

關鍵字?acquires，放在函數返回值之后，用來顯式定義此函數獲取的所有Resource。

Signer::address_of(account)從簽名者中拿到address

borrow_global_mut上面有介紹到，可變借用到address下的resourceCounter，然后將Counter結構體下的value進行1操作。

這下面的兩個方法則是script方法,它與上面兩個函數有什么區別呢？

publicfun:方法可以在任何模塊中被調用。

public(script)fun/publicentryfun：scriptfunction是模塊中的入口方法，表示該方法可以通過控制臺發起一個交易來調用，就像本地執行腳本一樣

下個版本的Move會用publicentryfun替代public(script)fun

Self則是代表自身module。

使用AptosCli編譯、部署、調用合約

#?創建新的測試環境aptos?init?--profile?devtest?--rest-url??--faucet-url?#?編譯move合約aptos?move?compile?--package-dir?my-counter#?部署合約#?例如：aptos?move?publish?--package-dir?my-counter?--named-addresses?basecoin=0x8e00bd9827faf171996ef37f006dd622bb5c3e43ec52298a8f37fd38cd59664?--profile?devtestaptos?move?publish?--package-dir?my-counter?--named-addresses?basecoin=?--profile?devtest#?調用合約#?例如：#?aptos?move?run?--function-id?0x8e00bd9827faf171996ef37f006dd622bb5c3e43ec52298a8f37fd38cd59664::MyCounter::init_counter?--profile?devtest#?aptos?move?run?--function-id?0x8e00bd9827faf171996ef37f006dd622bb5c3e43ec52298a8f37fd38cd59664::MyCounter::incr_counter?--profile?devtestaptos?move?run?--function-id?::::?--profile?devtest#?列出指定賬戶的modules/resources信息aptos?account?list?--query?modules?--account?0xa1285adb4b8abedf5faf7a46d260c5844f1f64d59dd9b8869db1543cf5bbadf4?--profile?devtestaptos?account?list?--query?resources?--account?0x4200c2b801870f20a709abba80b6edb90a45ecd9b8acce9842b93d597602edcf?--profile?devtest

AptosSDK調用Move合約

編譯好合約之后，我們可以通過sdk調用我們的合約。

我們可以選擇通過sdk部署合約，也可以通過sdk調用move合約。

通過sdk部署合約

當我們編譯完成之后，會在move合約文件夾下生成?build/?文件夾

我們需要把?my-counter/build/Examples/bytecode_modules/MyCounter

通過SDK發送交易

這里，我們以my-counter合約中的init_counter?和?incr_counter?為例。

構造兩個方法用于調用這兩個方法，從而實現客戶端調用?init?和?incr?的功能。

async?function?initCounter(contractAddress:?string,?accountFrom:?AptosAccount):?Promise?{??const?scriptFunctionPayload?=?new?TxnBuilderTypes

async?function?incrCounter(contractAddress:?string,?accountFrom:?AptosAccount):?Promise?{??const?scriptFunctionPayload?=?new?TxnBuilderTypes

通過?SDK?獲取賬戶里的資源信息。

resource是存放在所屬的賬戶地址下的，我們可以根據account地址，查詢相關的resource信息。

getCounter()方法其實就是獲取?my-counter?下的**Counter**資源。

async?function?getCounter(contractAddress:?string,?accountAddress:?MaybeHexString):?Promise?{??try?{????const?resource?=?await?client

執行效果

執行成功，在這里通過SDK，給一個隨機生成的賬戶init了Counter資源，然后incr了三次，所以最后Counter的Value為?3。

image-20220831200516865

my-counter相關代碼：https://github.com/99Kies/Aptos-Move-Dapp

參考資料

UsingCLItoRunaLocalTestnet|AptosDocs:?https://aptos.dev/nodes/local-testnet/using-cli-to-run-a-local-testnet

源碼:?https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/framework/move-stdlib/sources/signer.move

Tags：UNTCOURESTERSuntonEncountrRestoreNeoteric

狗狗幣