專注於 WEB 3.0 區塊鏈工程師與人才培育，孵化與投資區塊鏈項目，打造亞洲最大的區塊鏈開發與社群人才之生態圈。

KryptoCamp - 區塊鏈人才培育第一品牌

嗨大家好，上篇我們安裝完了 Aptos CLI 及測試第一個開發範例後，本篇將使用 TypeScript SDK 執行並簡單解析第一個程式範例
​
嗨大家好，上篇我們安裝完了 Aptos CLI 及測試第一個開發範例後，本篇將使用 TypeScript SDK 執行並簡單解析第一個程式範例

Step1. 事前準備

請確定已安裝 yarn 指令
https://classic.yarnpkg.com/lang/en/docs/install/
Step2. 進入到指令路徑後，並且安裝必要的環境套件

// Navigate to the Typescript SDK examples directory
cd ~/aptos-core/ecosystem/typescript/sdk/examples/typescript
// Install the necessary dependencies
yarn install
Step3. 執行範例程式

yarn run transfer_coin
執行成果大概會如下圖所呈現



而此範例的步驟大致上如下：

初始化 REST 及 水龍頭
創建兩個帳戶分別為 Alice 及 Bob，並且從水龍頭提供 100000000 個 Token 給 Alice
將 1000 個 Token 從 Alice 的帳戶轉移至 Bob 的帳戶，並且此交易需支付 54100 個 Token 作為手續費用
再執行另外一筆交易，並且與 2~3 步驟相同（將 1000 個 Token 從 Alice 的帳戶轉移至 Bob 的帳戶）
而上述四步驟都是由 transfer_coin.ts 這個程式所完成的，所以接下來我們將簡單解析這個程式檔：

首先，第 6 行至第 10 行是此範例程式所需要調用的工具包或環境設定，而 Aptos 的 TypeScript SDK 工具包文件參考連結如下：
https://aptos-labs.github.io/ts-sdk-doc/modules.html

import dotenv from "dotenv";
dotenv.config();
import { AptosClient, AptosAccount, CoinClient, FaucetClient } from "aptos";
import { NODE_URL, FAUCET_URL } from "./common";
而第 15 行至第 16 行則是初始化 Aptos REST API 及 水龍頭：

// Create API and faucet clients.
const client = new AptosClient(NODE_URL);
const faucetClient = new FaucetClient(NODE_URL, FAUCET_URL);
此範例程式的 API URL 為 https://fullnode.devnet.aptoslabs.com
而 API 文件連結如下：
https://fullnode.devnet.aptoslabs.com/v1/spec#/
裡面會清楚的描述各式各樣的 APIs 可以與 Aptos 公鏈進行互動，並且不論是執行成功或發生錯誤時，可藉由回傳之訊息，作出精準的判斷。

而水龍頭位置的連結為：https://faucet.devnet.aptoslabs.com
上述程式中的環境參數設定 NODE_URL (API URL) 及 FAUCET_URL (水龍頭位置)，皆可在 common.ts 中找到：

export const NODE_URL = process.env.APTOS_NODE_URL || "https://fullnode.devnet.aptoslabs.com";
export const FAUCET_URL = process.env.APTOS_FAUCET_URL || "https://faucet.devnet.aptoslabs.com";
第 20 行則是創建 Coin Client：
顧名思義，CoinClient 就是可以與 Coin 相關的 Module 進行互動，如：轉移代幣或是檢查餘額等

// Create client for working with the coin module.
const coinClient = new CoinClient(client); 
第 24 行至第 31 行則是創建兩個帳戶分別為 Alice 及 Bob，並且分別 print 出他們的錢包地址：

// Create accounts.
const alice = new AptosAccount();
const bob = new AptosAccount(); // <:!:section_2
// Print out account addresses.
console.log("=== Addresses ===");
console.log(`Alice: ${alice.address()}`);
console.log(`Bob: ${bob.address()}`);
console.log("");
第 39 行至第 43 行則是從水龍頭提供 100000000 個 Token 給 Alice，並且 print 出 Alice 及 Bob 的錢包餘額：

// Fund accounts.
await faucetClient.fundAccount(alice.address(), 100_000_000);
await faucetClient.fundAccount(bob.address(), 0);
// Print out initial balances.
console.log("=== Initial Balances ===");
console.log(`Alice: ${await coinClient.checkBalance(alice)}`);
console.log(`Bob: ${await coinClient.checkBalance(bob)}`);
console.log("");
而第 47 行至第 55 行 及 第 58 行至第 66 行為相同的動作，將 1000 個 Token 從 Alice 的帳戶轉移至 Bob 的帳戶，並且此交易 Alice 需支付 54100 個 Token 作為手續費，而交易完成後，print 出 Alice 及 Bob 目前最新的錢包餘額：

// Have Alice send Bob some AptosCoins.
let txnHash = await coinClient.transfer(alice, bob, 1_000, { gasUnitPrice: BigInt(100) });
await client.waitForTransaction(txnHash);
// Print out intermediate balances.
console.log("=== Intermediate Balances ===");
console.log(`Alice: ${await coinClient.checkBalance(alice)}`);
console.log(`Bob: ${await coinClient.checkBalance(bob)}`);
console.log("");
參考文獻：

https://aptos.dev/tutorials/your-first-transaction
以上為本次範例簡單的程式碼 Review，未來我們還持續撰寫相關 Aptos 文章與大家一同交流，有任何問題也歡迎一起討論，我們下次見！


使用 TypeScript SDK 執行第一個 Aptos 程式範例

​作者：師大科技系 PecuLab 蔡芸琤 (Pecu)

這篇是介紹 Aptos 公鏈上，如何透過 Move 實現智能合約。若對智能合約沒有概念的讀者，可先 Google 一下智能合約，就會跑出一大堆基本介紹。

在 https://www.youtube.com/c/KryptoCamp/videos 上也有許介紹 Ethereum 公鏈上，如何透過 Solidity 實現智能合約的影片。

那假設各位讀者們，可類比 Aptos 公鏈上的智能合約使用 Move (原生語言為 Rust) 開發，之於 Ethereum 公鏈上的智能合約使用 Solidity 開發的概念。

來開始介紹 Move on Aptos 的幾個基本重要關鍵概念 https://aptos.dev/guides/move-guides/move-on-aptos。

除非明確說明，否則會要求signer(這個就是會呼叫使用者進行簽署確認的意思，例如：像在使用 MetaMask，某些合約需要進行使用者確認時，錢包會跳出要使用者簽章的畫面) 限制對帳戶添加或刪除資產的存取。
資料 (Data) 是存在資料自己的帳戶中，而不是發布這筆資料的使用者的帳戶中，這是非常有趣的關鍵概念，把資料擬人化。
因為資料自己是屬於自己的帳戶 (好繞口，你的資料不是你的資料)，所以就需要有個對應使用者與資料之間的關係 indexing works，使得資料流 (Data Flow) 的對應如下圖所示：

https://aptos.dev/guides/indexing/

有了這樣的觀念後，就可以參考 https://github.com/aptos-labs/move/blob/main/language/documentation/tutorial/README.md#Step1 來了解，如何透過 Move 來撰寫 Aptos 上的智能合約。

從範例 https://github.com/aptos-labs/move/blob/main/language/documentation/tutorial/step_1/BasicCoin/sources/FirstModule.move 解釋，程式碼使用說明，可參考 https://move-language.github.io/move/modules-and-scripts.html。

module 0xCAFE::BasicCoin {
    struct Coin has key {
        value: u64,
    }

    public fun mint(account: signer, value: u64) {
        move_to(&account, Coin { value })
    }
}
module <address>::<identifier> {
    (<use> | <friend> | <type> | <function> | <constant>)*
}
其中可對應出，當要發布合約時，可指定此合約要放在哪個地址中 module <address>::<identifier> (地址配上合約名稱)，接著就可以寫合約內容。

在合約中的最開始，會定義此合約使用到的公用變數、資料結構，接著就定義合約要執行的功能 (Functions)，以這個最簡單的範例來看。要定義合約中的資料結構特性 (Type)，可參考 https://move-language.github.io/move/abilities.html。

struct Coin has key {
        value: u64,
    }

以範例程式中提及的資料結構，使用的 Type 為 Key。

當給予相對應的特性，就會依照該特性可運作的範圍來管理這個資料結構。

public fun mint(account: signer, value: u64) {
        move_to(&account, Coin { value })
    }
fun <identifier><[type_parameters: constraint],*>([identifier: type],*): <return_type> <acquires [identifier],*> <function_body>

https://move-language.github.io/move/functions.html

其中可對應出，此合約的唯一功能是 mint，當執行 mint 時，就會呼叫 Move 中的 move_to，將 mint 的此合約的代幣轉入簽署人的錢包中。


https://move-book.com/resources/resource-by-example/storing-new-resource.html

本文是想要提供讀者一個自學文件的閱讀脈絡，以及了解整個合約框架的宣告及定義，接下來會帶著讀者們閱讀更多不同的 Move 合約，請持續追蹤。

智能合約簡介 Move on Aptos

用 ChatGPT 寫第一個 Move 合約程式


本文介紹了如何從 GitHub 上的 awesome-move 來看看 Move 的所有在 GitHub 上的相關資源，並比較了 Move 和 Solidity 的 ERC-20 相關函式，並點出兩者最大差異的部分

從 GitHub 上的 awesome-move 開始閱讀更多不同的 Move 合約

​開箱 Aptos 第一個範例程式

作者：師大科技系 PecuLab 蔡芸琤 (Pecu Tsai)

前情提要，請參考【成為 Aptos 公鏈開發者的第一步】

從官方文件中，可找到原始碼路徑為 https://github.com/aptos-labs/aptos-core/blob/main/sdk/examples/transfer-coin.rs。

本文將以此範例程式來帶各位讀者理解 Rust 語言的思維。

Rust 語言的官方文件 https://doc.rust-lang.org/book/ 裡面有更詳盡的語法使用說明，本文不以單一語法逐步介紹 Rust，而是以 Aptos 第一個範例中要達成的執行目標，來說明 Rust 如何實現的。

回顧一下前情提要中的執行結果：

初始化 Representational State Transfer (REST) 和 Aptos 水龍頭。
創建兩個帳戶，Alice 和 Bob。
從水龍頭為 Alice 的帳戶提供 100000000 個 Token。
Alice 轉移 1000 個 Token 給 Bob，此次轉帳由 Alice 支付 54100 個 Token 做為手續費，所以，Alice 的帳戶剩下 99944900 個 Token。
再重複一次，Alice 轉移 1000 個 Token 給 Bob，此次轉帳由 Alice 支付 54100 個 Token 做為手續費，最終，Alice 的帳戶剩下 99889800 個 Token。
為了達成上述的五項描述，Aptos 公鏈上已經幫各位開發者建立好【連上鏈】和到【水龍頭】領測試幣的工具包，我們只需要知道如何調用即可。

額外補充，所有 Aptos 提供的 Typescript SDK 工具包 (Rust SDK 還沒看到，若之後有發現，再補上來)，都可在此找到定義及使用方式 https://aptos-labs.github.io/ts-sdk-doc/modules.html。

這份範例程式測試鏈使用的 Aptos REST API，可在此 https://fullnode.devnet.aptoslabs.com/v1/spec#/ 找到所有細節與說明。

範例程式中的第 4 到第 10 行，是這份範例程式中所使用到的工具包。

Rust 調用工具包的語法為【use】，更詳細的官方文件請參考，https://doc.rust-lang.org/book/ch07-04-bringing-paths-into-scope-with-the-use-keyword.html?highlight=%22The%20use%20keyword%22#bringing-paths-into-scope-with-the-use-keyword。

use anyhow::{Context, Result};
use aptos_sdk::coin_client::CoinClient;                             use aptos_sdk::rest_client::{Client, FaucetClient};                             use aptos_sdk::types::LocalAccount;
use once_cell::sync::Lazy;
use std::str::FromStr;
use url::Url;
範例程式中的第 13 到 21 行，是定義【如何連結哪個鏈上】。

static NODE_URL: Lazy<Url> = Lazy::new(|| {
    Url::from_str(
        std::env::var("APTOS_NODE_URL")
            .as_ref()
            .map(|s| s.as_str())
            .unwrap_or("https://fullnode.devnet.aptoslabs.com"),
    )
    .unwrap()
});
以上的所有語法，都可以直接在 https://doc.rust-lang.org/std/all.html 查閱。例如，不清楚甚麼是 std::env::var，就直接搜尋，畫面如下：


在 Rust 找到了 std::env::var 的定義與使用方式，就知道這是個可以回報環境錯誤訊息的變數宣告。

範例程式會使用這個宣告來和 Aptos 公鏈透過 REST API https://fullnode.devnet.aptoslabs.com 互動，是為了要知道，如果這個公鏈背後有甚麼狀況，可以回傳錯誤訊息到調用這個範例程式中，開發者才能知道錯誤是在自己的程式本身，還是發生在連結的公鏈上。

若是 Aptos 公鏈所建立的 REST API，定義及使用方式請參閱https://fullnode.devnet.aptoslabs.com/v1/spec#/。

Aptos 目前的開法者測試鏈可在 https://github.com/aptos-labs/aptos-networks 找到官方說明。

範例程式中的第 23 到 21 行，是定義【如何拿水龍頭的測試幣】。

為了不要讓文章太冗長，接下來就不再貼程式碼到文章中，請自行參照 https://github.com/aptos-labs/aptos-core/blob/main/sdk/examples/transfer-coin.rs 範例程式的行數來對應本文的說明。

水龍頭位置 https://faucet.devnet.aptoslabs.com，但這還沒有 web 畫面可以互動直接取得測試幣，要透過 Aptos SDK 撰寫對應的程式來獲得。

範例程式中的第 35 到 139 行，是主程式區，所有的步驟都在這裡面完成。

第 37 行和 38 行先分別初始化連上的 Aptos 公鏈和 Aptos 水龍頭。

第 41 行是初始化 coin_client 這個物件，之後要使用 CoinClient 這個 Class 來查閱錢包的內容，可參考 https://aptos-labs.github.io/ts-sdk-doc/classes/CoinClient.html。

一點點物件導向的觀念建立，等於的右邊是調用哪個 Class (屬於定義)，透過 new 來將 Class 實體化，放到等於的左邊，就變成之後可以使用的物件。

例如：一隻猴子的特徵定義，就是 Class，但真的把一隻猴子生出來，就是物件。

第 45 行和第 46 行，分別創建兩個帳戶，Alice 和 Bob。

第 49 行到第 51 行，分別印出這兩個帳戶的錢包地址。

第 55 行到第 62 行，分別將這兩個帳戶放上範例程式所連上的公鏈，並從水龍頭中拿 100000000 個 Token 給 Alice，Bob 沒有放入任何 Token。

第 65 行到第 79 行，分別印出目前這兩個帳戶的錢包餘額。

第 82 行到第 89 行，Alice 轉移 1000 個 Token 給 Bob，此次轉帳由 Alice 支付 54100 個 Token 做為手續費。

第 92 行到第 107 行，印出目前兩個錢包餘額，因為進行過一次轉帳，所以，Alice 的帳戶剩下 99944900 個 Token。

第 111 行到第 119 行，再重複一次，Alice 轉移 1000 個 Token 給 Bob，此次轉帳由 Alice 支付 54100 個 Token 做為手續費。

第 122 行到第 136 行，分別再印出目前這兩個帳戶的錢包餘額。

第 138 行，完成這份範例，Rust 回傳程式正常執行完畢，細節可參考 https://doc.rust-lang.org/std/result/。

 

複習上述提過的，重要語法參考區，初學者容易搞混，請參照上述的段落提示，感受一下哪些語法是要去哪裡查。

1. Rust 原生語法：https://doc.rust-lang.org/std/all.html
2. Aptos REST API：https://fullnode.devnet.aptoslabs.com/v1/spec#/
3. Aptos Typescript SDK：https://aptos-labs.github.io/ts-sdk-doc/modules.html
下篇文章，PecuLab 預計開箱 Move Module，開始帶著新手了解 Aptos 上的智能合約如何寫，下個周末再見囉！

 
 
 
 
 
 
 

​

開箱 Aptos 第一個範例程式

使用 Move Module 進入 Aptos 智能合約開發的第一步

​
使用 Move Module 進入 Aptos 智能合約開發的第一步
作者：師大科技系 PecuLab 蔡芸琤 (Pecu)

這篇會帶到 https://aptos.dev/tutorials/first-move-module 提及的，在智能合約開發過程中，所需要的 compile (編譯), test (測試), publish (發布) and interact (與合約互動) with Move modules on the Aptos blockchain。

前情提要，請參考【成為 Aptos 公鏈開發者的第一步】

確認已經都安裝過上述的環境，若先前已成功安裝過，要再繼續在 Visual Studio Code 開啟 Docker 專案，要先將 Docker Desktop 開起來，如下圖。


在專案開始前，先開啟 Docker Desktop，請更新至最新版本 (lastest)。

確認 Docker 開啟著，就會看到 Visual Studio Code 的 Docker IMAGES 有成功出現 maxmilian/aptos-sdk，我們先使用 latest 這個版本，繼續前進。


看到 Visual Studio Code 的 Docker IMAGES 有成功出現 maxmilian/aptos-sdk。

成功載入後，執行 image 啟動 Aptos 開發環境

docker run --rm -it maxmilian/aptos-sdk:latest

若成功進入 Docker 的環境，終端機的本地端會從 DESKTOP 變成 d 開頭的編號型式。

因為，我們使用的 Docker image 已經存在 Aptos CLI，所以，可以直接從官網文件 https://aptos.dev/tutorials/first-move-module 中的 Step 2: Create an account and fund it 往下走。

aptos init

帳號初始化

上圖的帳號初始化，會詢問要在 Aptos 的哪個鏈上開啟新帳號，本文先以 devnet 做示範，接著，會詢問使用者，是要開新帳戶，還是要輸入已經在此鏈上開會的帳號地址。若是新開帳戶，就直接按下 Enter 鍵，讓系統繼續協助我們產生一組帳號地址。

我在 Aptos 的 devnet 鏈上獲得的新帳號地址為：0b2a44b96e26ca90198d5843e1f66fbd6a423be9b8f8ada76068e71e00687e48。

讀者可自行記下自己的帳號地址，在下回要繼續開發智能合約時，就直接填入自己的地址即可，不需要每次都重新建立一個。

aptos account fund-with-faucet --account default
初始化後的新帳戶地址，devnet 會先空投 500000 Octas 代幣到這個帳號中。Octa 是 Aptos鏈上代幣 APT 的最小單位，1 Octa = 0.00000001 APT。所以，首次空投得到的 500000 Octas = 0.005 APT。


執行查閱帳戶餘額初始狀態會看到的結果。

確認準備好帳戶 (不一定是等於使用者錢包，在這裡的例子，是合約本身自己就擁有這個帳戶)，就可以開始先編譯第一個以 Move 撰寫的智能合約範例。原始程式碼 https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/move-examples/hello_blockchain/sources/hello_blockchain.move 可在此找到。

cd aptos-core/aptos-move/move-examples/hello_blockchainaptos move compile --named-addresses hello_blockchain=default

順利編譯成功之後會看到的畫面。

測試的目的在於，還沒將智能合約發布至鏈上時，可以先模擬前端呼叫智能合約的行為，看看是否如同我們所設計的邏輯，撰寫測試程式也能額外進行對各 function 的功能單元測試，避免一些非常基礎的錯誤在還沒測試過，就誤以為編譯成功，就代表程式沒有問題的開發者盲點。原始程式碼 https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/move-examples/hello_blockchain/sources/hello_blockchain_test.move 可在此找到。

aptos move test --named-addresses hello_blockchain=default

順利執行測試程式後會看到的畫面。

確認編譯、測試都沒問題之後，就能進行發布動作。

aptos move publish --named-addresses hello_blockchain=default

發布成功之後會看到的畫面。

在確認發布前，終端機會出現目前的發布手續費 (gas fee) 為多少，若接受這個手續費，就按下 y 鍵，繼續完成發布，否則就按下 n 鍵，離開這次的發布動作。

確認發布此智能合約之後，就可以透過終端機跟這張已經在鏈上的合約進行互動。從原始檔中可觀察到，要寫入此張智能合約的資料，可以此張合約的 set_message(~) 函式所接受的兩個 input 來完成，分別為 account 和 message。而 account 不需要額外輸入，是因為在執行的過程中，已經跟我們的帳戶連在一起了，所以，執行後的程式已自動取得帳戶地址，由 signer 這個型態來管理，更多此型態的說明可參考 https://ithelp.ithome.com.tw/articles/10299773。


在這個範例中的程式碼看到，能與透過 set_message 函式來寫入資料至此智能合約中。

aptos move run \
  --function-id 'default::message::set_message' \
  --args 'string:hello, blockchain'
因此，透過 — function-id 呼叫執行 ‘default::message::set_message’，透過 — args 來塞入參數設定另一個 input，‘string:hello, blockchain’。


順利執行透過 set_message 函式來寫入資料至此智能合約中會看到的畫面。

若要查詢此筆資料是否有順利上鏈，可透過瀏覽器，使用 Aptos Node API (以 RESTful API方式進行) 來查看。因為我的 account address 是 0b2a44b96e26ca90198d5843e1f66fbd6a423be9b8f8ada76068e71e00687e48，所以網址在 https://fullnode.devnet.aptoslabs.com/v1/accounts/ 後面接上我的 address (請讀者要自行更動為自己的 address)，網址 /resource 後面要跟的也是這個 address，只是要注意，把開頭的 0b 改成 0xb。最後，這份合約存在 MessageHolder 這個 function，可直接看到被寫入的資料內容，若未來開始撰寫其他合約時，就要依照合約內容置換這個 function 的名稱。


這是此合約中的 resource段落所提供的 MessageHolder 函式，才能直接透過瀏覽器使用 Aptos Node API 直接呼叫此函式。

https://fullnode.devnet.aptoslabs.com/v1/accounts/0b2a44b96e26ca90198d5843e1f66fbd6a423be9b8f8ada76068e71e00687e48/resource/0xb2a44b96e26ca90198d5843e1f66fbd6a423be9b8f8ada76068e71e00687e48::message::MessageHolder

順利看到寫入的資料已經在 Aptos 的 devnet 鏈上了。

關於 Move Module 的官方語法介紹，可在此找到 https://move-language.github.io/move/introduction.html。

這裡有個和 solidity 不太一樣的地方，就是我們創建出來的這個帳戶 address 不見得是等於使用者的錢包，而是屬於合約本身，Move 將每張合約都擬人化，是目前我觀察到最有趣的設計方式，之後有更深入的探討，再來分享。

下一篇再來仔細解釋這個範例程式碼的內容，請各位持續追蹤每週更新的 Aptos 技術白話文。

 
 
 
 
 
 
 

​

使用 Move Module 進入 Aptos 智能合約開發的第一步

​
作者：師大科技系 PecuLab 蔡芸琤 (Pecu)

ICO (Initial Coin Offering) = 首次代幣發行

在每個公鏈上，都可使用該鏈上最基礎的智能合約去創造代幣，本文所使用的合約內容來自 https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/move-examples/moon_coin/sources/MoonCoin.move。

依照【成為 Aptos 公鏈開發者的第一步】已完成了 aptos-core 專案下載，先重新連上 Docker 環境，前情提要可參考【使用 Move Module 進入 Aptos 智能合約開發的第一步】。

在預設的 Aptos 中的 devnet 測試鏈創建新帳號
cd ~/aptos-core/aptos-move/move-examples/moon_coin
aptos init

取得新地址為78e1a3787f089fddfc294826765ee304f229f97da8a44cee3c0bdc698c5e78a8。

編譯範例 MoonCoin 合約
aptos move compile --named-addresses MoonCoin=78e1a3787f089fddfc294826765ee304f229f97da8a44cee3c0bdc698c5e78a8
發布合約至 Aptos 中的 devnet 測試鏈
aptos move publish --named-addresses MoonCoin=78e1a3787f089fddfc294826765ee304f229f97da8a44cee3c0bdc698c5e78a8

成功發布 MoonCoin 合約至 Aptos 的 devnet 測試鏈上。

檢查合約是否存在於測試鏈上
若要查詢此筆資料是否有順利上鏈，可透過瀏覽器，使用 Aptos Node API (以 RESTful API方式進行) 來查看。因為我的 account address 是 78e1a3787f089fddfc294826765ee304f229f97da8a44cee3c0bdc698c5e78a8，所以網址在 https://fullnode.devnet.aptoslabs.com/v1/accounts/ 後面接上我的 address (請讀者要自行更動為自己的 address)。

https://fullnode.devnet.aptoslabs.com/v1/accounts/78e1a3787f089fddfc294826765ee304f229f97da8a44cee3c0bdc698c5e78a8
因為，我執行了 publish 兩次，所以，看到的會是 sequence_number: "2"。


只是確定有發布了合約上鏈，但還沒看到合約細節。

若要看到合約細節，就要加上 transactions 的資訊，可參考 Aptos Node API 官方文件 https://fullnode.devnet.aptoslabs.com/v1/spec#/operations/get_account_transactions。

https://fullnode.devnet.aptoslabs.com/v1/accounts/78e1a3787f089fddfc294826765ee304f229f97da8a44cee3c0bdc698c5e78a8/transactions

成功看到 moon_coin 新幣合約已經在鏈上了。

以下解釋合約內容
合約內容 https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/move-examples/moon_coin/sources/MoonCoin.move，裡面包含了MoonCoin 結構或類型。在將合約上鏈時，會透過物件建構元 init_module 來定義新幣。在這個範例中，新幣初始化，命名為 MoonCoin，並將幣種定為 ManagedCoin，由發行新幣者維護此合約。

//:!:>moon
module MoonCoin::moon_coin {
    struct MoonCoin {}

    fun init_module(sender: &signer) {
        aptos_framework::managed_coin::initialize<MoonCoin>(
            sender,
            b"Moon Coin",
            b"MOON",
            6,
            false,
        );
    }
}
//<:!:moon
而合約調用的 aptos_framework 細節，可從 https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/framework/aptos-framework/sources/coin.move 找到。

例如，新幣需要的幾大功能：

Minting: Creating new coins.
Burning: Deleting coins.
Freezing: Preventing an account from storing coins in CoinStore.
Registering: Creating a CoinStore resource on an account for storing coins.
Transferring: Withdrawing and depositing coins into CoinStore.
相關的官方文件 https://aptos.dev/tutorials/your-first-coin 中文化介紹已可在 https://gushi10546.gitbook.io/aptos-kai-fa-zhe-wen-dang/kai-fa-zhe-jiao-cheng/di-yi-ge-dai-bi 找到，就不再此重新贅述。

截至目前為止，我已經提供了所有初學者要進入 Aptos 開發環境的基礎教學內容，下周開始，會開始進入 move 智能合約撰寫的技術教學文，請有興趣的各方同好們，持續追蹤關注連載。

 
 
 
 
 
 
 

​

如何在 Aptos 上發布第一個 ICO 範例

​
作者：師大科技系 PecuLab 蔡芸琤 (Pecu)

根據 https://aptos.dev/tutorials/your-first-nft 的步驟，以及【成為 Aptos 公鏈開發者的第一步】來帶著初學者一步步完成，在 Aptos 上發行第一個 NFT。

因為，RUST SDK 在我撰寫此文的當下，還沒把創建 NFT 需要的 SDK 公開出來，所以，我先以 Typescript SDK 來進行說明。

依照【成為 Aptos 公鏈開發者的第一步】已完成了 aptos-core 專案下載，本文從 https://aptos.dev/tutorials/your-first-nft 中的以下步驟開始進行說明。


官方文件中的第二步，一開始是專案下載，在本文中略過不再重述，直接從如何透過 Typescript SDK 來進行第一個 simple_nft 的例子開始說明。

先重新連上 Docker 環境，前情提要可參考【使用 Move Module 進入 Aptos 智能合約開發的第一步】。


開始測試第一個 simple_nft 的例子，執行成功會看到 Alice 和 Bob 的交易過程被展示出來。

本文所使用的 Docker 環境，與官方文件中要進行的 pnpm 有些許不同，請將 pnpm 更改為 npm 來執行。

依序執行指令如下：

cd ~/aptos-core/ecosystem/typescript/sdk/examples/typescript
npm install
npm run simple_nft
接著說明這個交易過程的逐步細節以及對應的程式碼。官方文件在這個例子中，為了區別 FT (Fungible Token) 和 NFT，分別使用 Coin 代表 FT，而 Token 代表 NFT。

初始化 Representational State Transfer (REST) 和 Aptos 水龍頭。
創建兩個帳戶，Alice 和 Bob。
從水龍頭為 Alice 和 Bob 的帳戶，分別提供 100000000 個 Coin。
在 Alice 的帳戶中創建放置 NFT 的 Collection，並產生第一個 NFT。
Alice 將這個 NFT 轉給 Bob。
Bob 透過代理商將這個 NFT 再轉給 Alice。
以上步驟，透過 https://github.com/aptos-labs/aptos-core/blob/main/ecosystem/typescript/sdk/examples/typescript/simple_nft.ts 原始碼所完成，以下的逐步說明，會根據原始碼中的行號來進行對應解釋。

第一步：初始化 Representational State Transfer (REST) 和 Aptos 水龍頭。
請參閱第 15 行至第 16 行，使用 Typescript SDK 來與 Aptos 溝通，確認完成第一步的初始化動作。

第 20 行，建一個 TokenClient 的物件 tokenClient，等著完成第二步之後所需要的常見操作，例如創建 Collection 和 NFT、進行轉移 (transferring)、建立聲明 (claiming)。

第二步：創建兩個帳戶，Alice 和 Bob。
第 27 行至第 28 行，分別建立 AptosAccount 的帳戶物件為 alice 和 bob。

第三步：從水龍頭為 Alice 和 Bob 的帳戶，分別提供 100000000 個 Coin。
第 38 行至 39 行，從水龍頭為 Alice 和 Bob 的帳戶，分別提供 100000000 個 Token。在 Aptos 中，每個 AptosAccount 帳戶物件，都必須具有鏈上的代幣呈現形式 (representation)，此段程式利用水龍頭為 Alice 和 Bob 的帳戶領取同質化代幣 (Fungible Token)，代表著 Alice 和 Bob 目前的這個帳戶中的 representation 是 Fungible Token。

第四步：在 Alice 的帳戶中創建放置 NFT 的 Collection，並產生第一個 NFT。
因為，第三步創建帳戶時，已經將 representation 指定為 Fungible Token。所以，第 63 行至第 69 行是，在 Alice 的帳戶下，再建立可放入 NFT 的 Collection。一個 Collection 代表著一個容器的概念，其中可以包含零個、一個或多個不同的 NFT 呈現形式。第 73 至第 81 行，是在這個 Collection 下創立 Alice 的第一個 NFT。

這個公版 NFT 是由 Aptos 所提供，透過 https://github.com/aptos-labs/aptos-core/blob/53d3e1675c005771bdcd7b908479e002dd8fe145/ecosystem/typescript/sdk/src/token_client.ts#L90 可看到能填入的 NFT 資訊欄位有哪些，公版 NFT 合約內容可從 https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/framework/aptos-token/sources/token.move 看到。

若要自行創建公版 NFT 之外的合約，就要自行撰寫 Move 發布新合約，再自建跟這張合約互動的 SDK (Typescript SDK, Python SDK, or Rust SDK)。

第五步：Alice 將這個 NFT 轉給 Bob。
第 85 行至第 86 行，先確認 Alice 的 Collection 中的內容物是甚麼。第 90 行至第 96 行，確認 Alice 的帳號中餘額有多少。第 100 行至第 101 行，查閱 Alice 的 Collection 中的 NFT 詳細內容。第 104 行至第 115 行，Alice 將這個 NFT 轉給 Bob。第 119 行至第 127 行，Bob 確認收到 Alice 傳來的 NFT。

第 130 行至第 138 行，查閱這筆轉移結束後，Alice 和 Bob 當前帳戶中的 NFT 數量。

第六步：Bob 透過代理商將這個 NFT 再轉給 Alice。
第 140 行至第 151 行，Bob 透過代理商將這個 NFT 再轉給 Alice。在這邊使用的是 tokenClient.directTransferToken 而不是 Alice 轉移給 Bob 使用的 tokenClient.offerToken，所以，也不需要 Alice 再做一次 tokenClient.claimToken 進行，確認收到 NFT 的動作，就可以直接拿到。

第 154 行至第 163 行，，查閱這筆轉移結束後，Alice 和 Bob 當前帳戶中的 NFT 數量。

Aptos 的思維和以太鏈有甚麼不同？
在這個例子裏面，我發現了以下幾項有趣的不同，以下是在 Aptos 中有的新鮮事。

對於每個帳戶中的代幣呈現形式 (representation)，會強制要求確認。
若要存放 NFT，必須先建立 Collection，代表著一個容器的概念，其中可以包含零個、一個或多個不同的 NFT 呈現形式。
透過代理商轉移 tokenClient.directTransferToken，就比較像是在以太坊中的直接轉移的動作。如果是在 Aptos 進行直接轉移 tokenClient.offerToken，收件方需要進行 tokenClient.claimToken 的確認動作。
若有更新的體悟，再來分享給大家，為何 Aptos 要這麼設計。

 
 
 
 
 
 
 

​

在 Aptos 上，透過 Typescript SDK 創建一個公版 NFT

作者：Alan Lin

本文章適合的讀者為使用 MacOS (Intel or M系列處理器皆可) 之開發者

安裝環境
Step1. 事前準備

請確定已安裝 brew 指令
https://brew.sh/
請確定已安裝 git 指令
https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
Step2. 使用 git 指令將 Aptos core 的 repository 下載至本機端

git clone https://github.com/aptos-labs/aptos-core.git
Step3. 完成後，開始設定環境

進入到 aptos-core 之資料夾
cd aptos-core
執行開發設置的腳本
./scripts/dev_setup.sh
最後更新你的 shell 環境
source ~/.cargo/env
Step4. 建立 Aptos CLI

將環境切換至 Aptos 的 testnet 上
git checkout --track origin/testnet
Build the CLI tool
cargo build --package aptos --release
Step5. 將 build 好的 CLI Binary 移動至 /usr/local/bin 資料夾中

mv target/release/aptos /usr/local/bin
就可以開始使用 aptos 指令啦！


使用 Rust 執行第一個開發範例
Step1. 移動至 Rust SDK 的資料夾中

cd ~/aptos-core/sdk
Step2. 執行 transfer-coin 的程式範例

cargo run --example transfer-coin
執行成功後，將會出現以下類似成果：


而此範例之所代表的各個步驟，官網亦有詳細說明：


參考文獻：

https://aptos.dev/guides/getting-started
https://aptos.dev/tutorials/your-first-transaction
未來我們還持續撰寫相關 Aptos 文章與大家一同交流，有任何問題也歡迎一起討論，我們下次見！

如何安裝 Aptos CLI 並測試第一個開發範例

師大科技系 PecuLab 與 KryptoCamp 共同規劃了 Aptos 寒假培訓營，旨在培養具備 Aptos 實務開發能力與解讀技術解讀能力，課程共有 10 堂，主題包括 Aptos 環境建置、Move Module、Aptos Move 合約開發、Typescript SDK、Aptos 與 DApp 結合開發，以及 Aptos 開發的 CI/CD 與 Move 合約迭代 (AWS 雲端開發環境)。此外，此次培訓營也歡迎對象包括想透過自學 Move on Aptos 來認識志同道合的戰友，讓前往 Web3 的路上有會思考、能實作、好溝通的神隊友同行。

標籤：move

更多文章