閱讀時間 6 分鐘
本指南使用 Sugar v1 搭配 Candy Machine V2,而 Candy Machine V2 現已不再支援。若要進行新的 NFT 專案,請參閱《如何使用 Metaplex Core Candy Machine 發行 NFT 系列》。本指南僅供歷史教育參考之用。
概覽
您準備好在 Solana 上推出您的 NFT 系列了嗎?Metaplex 的新版 Candy Machine 工具「Sugar」,正是能讓您迅速上線的理想選擇。作為 Metaplex 最新版本的 Candy Machine,「Sugar」帶來了幾項值得注意的改進:
- 提升上傳效能
- 簡化版使用者體驗
- 改進錯誤處理機制
您將負責的工作內容
在本指南中,您將使用 Solana CLI 建立一個新錢包、領取一些 SOL 空投,並透過 Sugar 在 Solana 的開發網(devnet)上部署一台 Candy Machine。接著,您將使用 Candy Machine UI 將您的 Candy Machine 部署至網路。
您需要準備的物品
- 已安裝Node.js(版本 16.15 或更高)
- 已安裝Solana CLI
- 已安裝Phantom Wallet或Solflare 擴充功能
- 已安裝Metaplex Sugar(**舊版,V1.x **)
- 文字編輯器
- 已安裝 npm 或 yarn(我們將使用 yarn 來初始化專案並安裝必要的套件。若您偏好使用 npm,亦可改用 npm。)
設定您的專案
請在終端機中使用以下指令建立一個新的專案目錄:
mkdir sugar-demo
cd sugar-demo
安裝 Sugar
本指南假設您使用的是 Sugar 的舊版(V1.x,即 Candy Machine v2)。若您使用的是較新版本,請參閱此處的指南。
Mac 安裝
請在終端機中輸入:
<(curl -sSf https://sugar.metaplex.com/install.sh)
注意:安裝完成後,您可能需要重新啟動終端機
Windows 安裝
- 請在此處下載 Windows 安裝程式。
- 以系統管理員身分執行安裝程式(右鍵點擊-->以系統管理員身分執行). 若出現關於「不可信二進位檔」的警告,請嘗試點擊 更多資訊 然後 《不管怎樣,還是跑吧》. 若您沒有此選項,請依照以下步驟操作:
- 在可執行檔案上按右鍵,然後選擇「內容」。
- 如果您信任 Metaplex 開發團隊,請如下圖所示勾選「解除封鎖」按鈕。由於微軟不會自動信任此二進位檔,此舉將讓您能在電腦上執行此二進位檔。
- 按下「套用」和「確定」。
- 請再次執行安裝程式
如果一切運作正常,您應該會看到類似以下的內容:

建立新錢包
Sugar 其中一項很棒的新功能是,它允許您透過 Solana CLI 設定錢包和 RPC 設定,這樣您就不必在每次執行 Sugar 指令時都重新輸入這些設定。
我們首先需要使用以下指令,建立一個專門用於 devnet 測試的新錢包:
solana-keygen new --outfile ./wallet.json
由於我們只會在開發網(devnet)上使用這個錢包,因此資金並不重要,可以跳過設定密碼(按下Enter 鍵)。我們可以執行以下指令,確認剛才建立的錢包就是 Solana CLI 將使用的錢包:
Solana 設定 設定 --keypair ./wallet.json
建立與您的 Quicknode RPC 的連線
我們需要確保 Solana CLI 已連線至某個節點。您可以自由選擇使用公共節點,或自行部署並管理基礎架構;不過,若您希望將回應時間縮短 8 倍,不妨將繁重的工作交給我們處理。
了解為何超過 50% 的 Solana 專案選擇 Quicknode,並點此免費註冊。
請務必在 Solana Devnet 環境下啟動您的節點,並複製 HTTP 連結:

在 Solana Devnet 上設定好您的終端點後,現在您可以執行此指令,並將YOUR_QUICKNODE_URL替換為您已複製的 HTTP URL:
Solana 設定 設定 --url 您的 QuickNode URL
現在,若要為您的錢包充值,您可以執行以下指令:
Solana 空投 1
如果指令執行成功,您應該會看到類似以下的內容:

您也可以執行 Solana 餘額 在您的終端機中查看,確認那 1 SOL 確實存在。
準備 NFT 資產
如果您之前曾使用過 Candy Machine,這個流程對您來說應該很熟悉。 我們需要為每個數位資產建立一個.json檔案,採用簡單的數字格式,從 0 開始並依序遞增,且絕不跳過任何數字(例如:0.json 對應至 0.png,接著 1.json 對應至 1.png)。我們也可以選擇性地建立collection.json和collection.png,以便讓 Sugar 自動建立鏈上收藏集。
Metaplex 提供了一組範例資產,我們可以下載並加以運用,以確保一致性。您可以編輯該 JSON 檔案,加入您想要的任何值,只要符合URI JSON 模式即可。
請下載範例資料集,並將內容解壓縮至專案目錄中的./assets/目錄(這是 Sugar 預設用來搜尋檔案的目錄)。
設定糖果機
在專案根目錄中建立一個名為 config.json的新檔案:
echo > config.json
開啟該檔案,並將此設定貼入其中:
{
"price": 0.01,
"number": 10,
"symbol": "NB",
"sellerFeeBasisPoints": 500,
"gatekeeper": null,
"solTreasuryAccount": "YOUR_WALLET_ADDRESS",
"splTokenAccount": null,
"splToken": null,
"goLiveDate": "2022-07-24T00:00:00Z",
"endSettings": null,
"whitelistMintSettings": null,
"hiddenSettings": null,
"uploadMethod": "bundlr",
"awsS3Bucket": null,
"retainAuthority": true,
"isMutable": true,
"creators": [
{
"address": "YOUR_WALLET_ADDRESS",
"share": 100
}
]
}
注意:您可以在終端機中執行「solana address」指令,以取得您剛建立的錢包地址。
現在,一切都準備就緒了。如果你一直跟著操作到這裡,你的目錄結構應該會像這樣:
- sugar-demo/wallet.json
- sugar-demo/config.json
- sugar-demo/assets/[0-9].png
- sugar-demo/assets/[0-9].json
- sugar-demo/assets/collection.png
- sugar-demo/assets/collection.json
Sugar 內建了驗證錯誤機制,讓我們能在繼續執行之前檢查是否有任何錯誤。請在終端機中執行:
sugar 驗證

我們開始了!做得好。來組裝我們的糖果機吧。
製作糖果機
由於我們已使用 Solana CLI 設定好 RPC 和錢包,並且將資產和 config.json儲存至 Sugar 的預設目錄中,因此我們的指令將會非常簡單!
上傳您的素材
請在終端機中輸入:
sugar 上傳
您應該會看到類似以下的內容:

部署糖果機
請在終端機中輸入:
sugar deploy
您應該會看到類似以下的內容:

若出現「Blockhash 未找到」的錯誤訊息,請嘗試再次執行該指令。
請務必將終端機中提供的「糖果機 ID」儲存於本地。稍後我們會需要這個資訊。
驗證糖果機
讓我們確認一切是否如預期般運作。請在終端機中輸入:
sugar 驗證
您應該會看到類似以下的內容:

做得真棒!
測試您的糖果機
試著用糖來鑄造一個 NFT。在終端機中輸入:
糖薄荷
您應該會看到類似以下的內容:

太棒了!讓我們建立一個 Mint 頁面,好讓我們能將這個專案分享給全世界吧!
建立一個鑄幣網站
為了讓設定盡可能簡單,我們將使用 Metaplex 提供的前端介面「Candy Machine UI」。
在您的專案目錄中,於終端機中輸入:
git clone https://github.com/metaplex-foundation/candy-machine-ui ./candy-machine-ui/
cd candy-machine-ui
將檔案.env.example重新命名為.env。更改檔案名稱後,您可以將其中的值修改為以下內容:
REACT_APP_CANDY_MACHINE_ID=<YOUR_CANDY_MACHINE_PUBKEY>
REACT_APP_SOLANA_NETWORK=devnet
REACT_APP_SOLANA_RPC_HOST=<YOUR_QUICKNODE_DEVNET_ENDPOINT>
如果您不記得自己的 Candy Machine ID,應該可以在程式中的cache.json檔案內,於program.candyMachine欄位中找到它。
將所有資訊輸入完畢後,現在就可以儲存檔案了。請在該 candy-machine-ui 資料夾中執行以下指令:
毛線 安裝
yarn 啟動
這將開啟瀏覽器並連至localhost:3000,您可以在該處連接您的錢包並鑄造 NFT。在繼續之前,請確認您的 Phantom 錢包已設定為開發網(devnet),而非主網(mainnet)。
若要鑄造 NFT,您的 Phantom 錢包中必須有 devnet SOL。您可以使用 Solana CLI 將 SOL 空投至您的 Phantom 錢包,方法是在終端機中輸入以下指令:
Solana 空投 1 您的 Phantom 錢包地址
準備就緒後,請點擊「Mint」。若操作成功,您應會看到類似以下的網站:

若您看到「鑄造失敗」的錯誤訊息,可能是因為您的餘額不足。請先補充資金後再試一次。購買完成後,您可以在錢包中查看該 NFT。Phantom 可能需要片刻時間才能在您的錢包中顯示該 NFT。我們的 NFT 看起來是這樣的:

這糖真甜啊!做得真棒。
結論
恭喜!您已使用 Metaplex Sugar 創建了一台「糖果機」,並擁有運作專屬 NFT 鑄造所需的所有工具。我們非常期待看到您將創作出什麼樣的 NFT!歡迎加入我們的Discord社群,或透過Twitter聯繫我們,分享您的 NFT 專案。
我們 ❤️ 您的回饋!
如果您對這份指南有任何意見或疑問,請告訴我們。我們非常樂意聽取您的意見!
