新手入門：如何使用Flow和IPFS創建類似NBA Top Shot的NFT

隨着非同質化代幣NFT市場進入狂熱的階段，回顧相對早期的NFT並記住CryptoKitties所面臨的挑战是一件有趣的事情。Dapper Labs團隊構建的平臺是第一個潛在大規模採用的真實示例，也是以太坊區塊鏈上的第一個真正壓力。

從那以後，隨着Rarible、OpenSea、Foundation和Sorare等平臺的湧現，NFT开始蓬勃發展。這些平臺每月都有數百萬美元的資金流入。盡管早期存在一些困難，但大多數情況已經在以太坊區塊鏈上發生了。但是，Dapper Labs的團隊在經歷了CryptoKitties之後，开始着手構建一個通用的新區塊鏈，但也非常適合 NFT用例。這樣做的目的是解決在以太坊上所遇到的許多NFT問題，同時為該領域的开發者和收藏家提供更好的體驗。他們的新區塊鏈Flow已經證明自己有能力獲得一些知名度。NBA、UFC甚至Dr. Seuss都在使用Flow。

我們最近寫了一篇關於在IPFS上創建具有內置資產支持的NFT的文章，並且討論了NFT領域中的責任問題，以及我們認為IPFS可以提供的幫助。現在是時候討論如何在IPFS支持的Flow上創建NFT。Flow區塊鏈的主要早期應用是NBA Top Shot。我們將創建一個非常基本的鑄造NFT過程的副本，然後在IPFS上備份NFT元數據和資產。

由於我們喜歡piñatas，而不是NBA的精彩視頻，因此我們的NFT將專注於可交易性piñatas在派對上被銷毀的視頻。

本教程由三個部分組成

1. 創建合約並鑄造代幣。

2. 創建一個應用程序來查看通過此合約創建的NFT。

3. 創建一個市場，將NFT轉讓給其他人，同時在IPFS上轉讓NFT的基礎資產

讓我們從第一個教程开始。

設置

我們需要安裝Flow CLI。在Flow的文檔中有一些很好的安裝說明，但我將在這裏復制它們:

ios系統

brew install flow-cli

Linux操作系統

sh -ci “$(curl -fsSL https://storage.googleapis.com/flow-cli/install.sh)"

Windows系統

iex “& { $(irm ‘https://storage.googleapis.com/flow-cli/install.ps1') }”

我們將在IPFS上存儲資產文件。為了簡化操作，我們可以使用Pinata。您可以在這裏注冊一個免費帳戶，然後在這裏獲取一個API密鑰。

我們還需要安裝NodeJS和文本編輯器，以幫助突出顯示Flow智能合約代碼的語法（以Cadence語言編寫的）。您可以在此處安裝Node。Visual Studio Code具有支持Cadence的擴展。

讓我們創建一個目錄來記錄我們的項目。

mkdir pinata-party

切換到該目錄並初始化新的Flow項目：

cd pinata-party
flow project init

現在，在您最喜歡的代碼編輯器中打开項目（同樣，如果您使用的是Visual Studio code，請獲取Cadence擴展），然後开始工作。

您會看到一個flow.json文件，我們將很快使用它。首先，創建一個名為cadence的文件夾。在該文件夾中，添加另一個名為contracts的文件夾。最後，在contracts文件夾中創建一個名為PinataPartyContract.cdc的文件。

在我們繼續前進之前，重要的是要指出，從現在开始，我們對Flow區塊鏈所做的一切都將在模擬器上完成。然而，將項目部署到測試網或主網就像更新flow.json文件中的配置設置一樣簡單。現在將文件設置為模擬器環境，然後我們就可以开始編寫合約了。

更新flow.json中的合約對象，如下文所示：

"contracts": {
     "PinataPartyContract": "./cadence/contracts/PinataPartyContract.cdc"
}

然後，將該文件中的deployments對象更新為如下文所示：

"deployments": {
     "emulator": {
          "emulator-account": ["PinataPartyContract"]
     }
}

這是告訴Flow CLI使用模擬器來部署我們的合約，它還引用了（模擬器上的）帳戶和我們即將編寫的合約。實際上……

讓我們开始寫這個合約吧。

合約

Flow提供了關於創建NFT合約的出色教程。這是一個很好的參考點，但是正如Flow所指出的，他們尚未解決NFT元數據問題。他們希望將元數據存儲在鏈上。這是個好主意，他們肯定會想出一個合乎邏輯的方法。然而，我們現在想用元數據鑄造一些代幣，並且我們想要與NFT相關聯的媒體文件。元數據只是一個組成部分。我們還需要指向代幣最終代表的媒體。

如果您熟悉以太坊區塊鏈上的NFT，您可能知道這些代幣背後的許多資產存儲在傳統數據存儲和雲托管提供商中。這是可以的，除非它不是。我們過去曾寫過關於內容尋址內容的天才，以及在傳統雲平臺上存儲與區塊鏈相鄰數據的弊端。這一切歸結為兩點：

• 資產應該是可驗證的

• 應該很容易轉移維護職責

IPFS解決了這兩個問題。然後，Pinata以一種簡單的方式分層，將該內容長期固定在IPFS上。這正是我們希望支持NFT的媒體所需要的，對吧？我們希望確保我們能夠證明所有權（NFT），提供關於NFT的數據，並確保我們對基礎資產（IPFS）具有控制權，而不是一些副本。

打开PinataPartyContract.cdc，讓我們开始工作。

第一步是定義我們的合約。我們將在此基礎上添加更多內容，但我們從自定義PinataPartyContract开始，並在其中創建一個資源。資源是存儲在用戶帳戶中的項目，並可以通過訪問控制措施進行訪問。在這種情況下，NFT資源最終是因為用於表示NFT的東西擁有。NFT必須是唯一可識別的。該id屬性使我們能夠識別代幣。

接下來，我們需要創建一個資源接口，該接口將用於定義哪些功能可供給其他人使用(例如，不是合約所有者的人):

將其放在NFT資源代碼的正下方。這個NFTReceiver資源接口表示，我們定義的任何可以訪問該資源的人都可以調用以下方法：

• 存款

• 獲取ID

• 理想主義者

• 獲取元數據

接下來，我們需要定義代幣收集接口。可以將其視為容納所有用戶NFT的錢包。

這個資源中有很多內容，但是很快就會有意義。首先，我們有一個名為ownedNFTs的變量。這很簡單。它跟蹤該合約中用戶擁有的所有NFT。

接下來，我們有一個名為metadataObjs的變量。這一點有點獨特，因為我們擴展了Flow NFT合約功能，以存儲每個NFT的元數據映射。這個變量將代幣ID映射到其關聯的元數據，這意味着在設置代幣id之前需要該代幣ID。

然後，我們初始化變量。這對於在Flow的資源中定義的變量是必需的。

最後，我們擁有NFT收集資源的所有可用功能。請注意，並非所有這些功能都可以使用。如果您還記得，我們在NFTReceiver資源接口中定義了任何人都可以訪問的功能。

我想指出存款功能。就像我們擴展了默認的Flow NFT合約以包含metadataObjs映射一樣，我們也擴展了默認的deposit功能以獲取額外的元數據參數。我們為什么要這樣做？我們需要確保只有代幣的鑄造者才能將元數據添加到代幣中。為了保持這種私密性，我們將初始的元數據添加限制在鑄造執行中。

我們幾乎完成了合約代碼。因此，在Collection資源的正下方，添加以下內容：

首先，我們有一個功能，該功能在調用時創建一個空的NFT集合。這就是首次與我們的合約交互的用戶創建存儲位置的方式，該存儲位置映射到我們定義的資源存儲位置。

之後，我們再創建一個資源。這很重要，因為沒有它，我們將無法鑄造代幣。NFTMinter資源包括一個idCount，以確保我們的NFT永遠不會有重復的ID。它還具有實際創建NFT的功能。

在NFTMinter資源的正下方，添加主合約初始化程序：

僅在部署合約時才調用此初始化函數。它有三個功能：

1.為集合的部署者創建一個空集合，以便合約的所有者可以從該合約中創建並擁有該NFT。

2.集合資源發布在公共位置，並引用我們在开始時創建的NFTReceiver接口。這就是我們告訴合約NFTReceiver上定義的函數可以被任何人調用的方式。

3.NFTMinter資源保存在帳戶存儲中，供合約創建者使用。這意味着只有合約的創建者才能鑄造代幣。

完整的合約可以在這裏找到。

現在我們已經准備好了一個合約，讓我們來部署它，對嗎？我們應該在Flow Playground上對其進行測試。看那裏，點擊左邊欄的第一個帳戶。用我們的合約代碼替換示例合約中的所有代碼，然後單擊“部署”。如果一切順利，您應該會在屏幕底部的日志窗口中看到這樣的日志：

16:48:55 Deployment Deployed Contract To: 0x01

現在，我們准備將合約部署到本地運行的模擬器。 在命令中，運行以下命令：

flow project start-emulator

現在，在我們的模擬器運行且正確配置了flow.json文件的情況下，我們可以部署合約了。只需運行以下命令：

flow project deploy

如果一切順利，您將看到以下輸出：

Deploying 1 contracts for accounts: emulator-accountPinataPartyContract -> 0xf8d6e0586b0a20c7

現在，我們在Flow模擬器上有一個合約，但是我們想要鑄造一個代幣。讓我們以這個話題來結束這篇文章。

鑄造NFT

在本教程的第二篇文章中，我們將致力於通過應用程序和用戶界面使鑄造過程更加友好。為了更好地理解並展示元數據如何在Flow上與NFT一起使用，我們將使用Cadence腳本和命令操作。

讓我們在pinata-party項目的根目錄中創建一個新目錄，並將其稱為transactions。創建了該文件夾後，在其中創建一個名為mintpinatparty .cdc的新文件。

為了編寫交易，我們需要在我們提供給NFT的元數據中引用一個文件。為此，我們將通過Pinata上傳一個文件到IPFS。出於本教程的目的，也因為我們的NFT專注於在派對上被砸的piñata的可交易視頻，您可以上傳一個孩子在生日聚會上敲擊piñata的視頻。您可以上傳任何所需的視頻文件。您可以上傳所需的任何資產文件，並將其與您的NFT關聯，但本教程系列的第二篇文章將會提供視頻內容。一旦您准備好了視頻文件，請在這裏上傳。

上傳文件後，系統將提供一個IPFS哈希（通常稱為內容標識符或CID）。復制此哈希，因為我們將在鑄造過程中使用它。

現在，在你的MintPinataParty.cdc文件中，添加以下內容:

這是一個非常簡單的交易，這在很大程度上歸功於Flow簡化了工作，使事情變得容易，但是讓我們來看看它。首先，您將注意到頂部的import語句。如果您還記得，當我們部署合約時，我們收到了一個账戶。這是我們需要參考的。因此，將0xf8d6e0586b0a20c7替換為部署時的帳戶地址。

接下來我們定義交易。這裏發生的所有事情都與我們計劃執行的交易相關。

我們在交易中做的第一件事是定義兩個引用變量receiverRef和mininterref。在這種情況下，我們既是NFT的接受者，也是NFT的執行者。這兩個變量引用了我們在合約中創建的資源。如果執行交易的人沒有訪問資源的權限，則交易將失敗。

接下來，我們有一個prepare功能。該功能獲取嘗試執行交易的人的帳戶信息，並進行一些驗證。我們試圖“借用”定義的NFTMinter和NFTReceiver這兩個資源上的可用功能。如果執行交易的人無法訪問這些資源，那么交易就會失敗。

最後，我們有execute功能。在這個功能中，我們為NFT構建元數據，鑄造NFT，然後在將NFT存入我們的帳戶之前關聯元數據。如果您注意到了，我創建了一個元數據變量。在這個變量中，我添加了一些關於我們的代幣的信息。由於我們的代幣表示的是一個piñata在派對上被打碎的事件，而且我們試圖復制您在NBA Top Shot中看到的大部分內容，所以我在元數據中定義了一些統計數據。孩子揮杆擊中piñata的速度、揮杆的角度和等級。我只是覺得這些數據很有趣。不過，您可以以類似的方式為您的代幣輸入有意義的任何信息。

您將注意到，我還在元數據中定義了一個uri屬性。這將指向托管與NFT相關聯的資產文件的IPFS哈希。在這種情況下，被擊中的是piñata的實際視頻。您可以用先前上傳文件後收到的哈希值替換哈希值

我們在哈希前加上ipfs://有幾個原因。這是IPFS上對文件的正確引用，可以與IPFS的桌面客戶端和瀏覽器擴展一起使用。既然Brave瀏覽器提供了對IPFS內容的本機支持，我們也可以直接將其粘貼到Brave瀏覽器中。

我們調用鑄造代幣的mintNFT函數。然後我們必須調用存款功能來將其存入我們的帳戶。這也是我們傳遞元數據的地方。如果您還記得，我們在存款功能中定義了一個變量關聯，它將元數據添加到相關的代幣ID。

最後，我們只需注銷已鑄造和存放代幣的事實。

現在，我們幾乎已經准備好發送交易並鑄造NFT。但是首先，我們需要准備我們的账戶。在項目的根文件夾中，從命令行創建一個新的私鑰進行籤名。

執行以下命令：

flow keys generate

這將為您提供一個公鑰和一個私鑰。**始終保護您的私鑰**

我們將需要私鑰來籤署交易，因此我們可以將其粘貼到我們的flow.json文件中。我們還需要指定籤名算法。以下是您的帳戶在flow.json文件現在應該是這樣的：

"accounts": {
  "emulator-account": {
     "address": "YOUR ACCOUNT ADDRESS",
     "privateKey": "YOUR PRIVATE KEY",
     "chain": "flow-emulator",
     "sigAlgorithm": "ECDSA_P256",
     "hashAlgorithm": "SHA3_256"
  }
},

如果打算將該項目中的任何一個存儲在github或任何遠程git存儲庫上，請確保不包括私鑰。您可能想要.gitiignore您的整個flow.json。盡管我們只使用本地模擬器，但保護密鑰是一個很好的做法。

現在我們已經更新了此信息，我們可以發送交易。這樣做就像運行以下命令一樣簡單：

flow transactions send --code ./transactions/MintPinataParty.cdc --signer emulator-account

我們從flow.json引用我們寫的交易文件和籤名者帳戶。如果一切順利，您應該會看到以下輸出：

Getting information for account with address 0xf8d6e0586b0a20c7 ...Submitting transaction with ID 4a79102747a450f65b6aab06a77161af196c3f7151b2400b3b3d09ade3b69823 ...Successfully submitted transaction with ID 4a79102747a450f65b6aab06a77161af196c3f7151b2400b3b3d09ade3b69823

現在，我們需要做的最後一件事是驗證代幣是否在我們的帳戶中，並獲取元數據。要做到這一點，我們將編寫一個非常簡單的腳本，並從命令行調用它。

在項目的根目錄下，創建一個名為scripts的新文件夾。在其中，創建一個名為CheckTokenMetadata.cdc的文件。在該文件中，添加以下內容：

這個腳本可以用類似於使用以太坊智能合約的只讀方法的方式來考慮。它們是免費的，只是從合約中返回數據。
 

在我們的腳本中，我們從部署的地址導入合約。然後我們定義一個主要功能（這是運行腳本所需的函數名稱）。在這個函數中，我們定義了三個變量：
 

• nftOwner：這只是擁有NFT的帳戶。我們從部署合約的帳戶中創建了NFT，因此在我們的示例中，取決於將來的合約設計，這可能並不總是正確的。

• 功能：我們需要從部署的合約中“借用”可用的能力（或功能）。請記住，這些功能是受訪問控制的，因此，如果某個功能不能被試圖借用它的地址使用，那么腳本將失敗。我們借用了NFTReceiver資源的功能。

• receiverRef：這個變量簡單地獲取我們的功能，並告訴腳本從部署的合約中借用。

現在，我們可以調用（可用的）函數。在這種情況下，我們希望確保所涉及的地址確實收到了我們鑄造的NFT，然後我們希望看到與代幣關聯的元數據。

讓我們運行我們的腳本，看看我們得到了什么。在命令行中執行以下命令：

flow scripts execute ./scripts/CheckTokenMetadata.cdc

對於元數據輸出，您會看到類似以下的輸出：

{"name": "The Big Swing", "swing_velocity": "29", "swing_angle": "45", "rating": "5", "uri": "ipfs://QmRZdc3mAMXpv6Akz9Ekp1y4vDSjazTx2dCQRkxVy1yUj6"}

恭喜您！您成功地創建了一個Flow智能合約、鑄造了一個代幣，並將元數據關聯到代幣，並將代幣的底層數字資產存儲在IPFS上。對於教程的第一部分來說還不錯。

接下來，我們將提供一個關於構建前端React應用程序的教程，該應用程序將允許你通過獲取元數據並解析該元數據來顯示您的NFT。

祝您好運！

鄭重聲明：本文版權歸原作者所有，轉載文章僅為傳播信息之目的，不構成任何投資建議，如有侵權行為，請第一時間聯絡我們修改或刪除，多謝。