NFT 계약 및 민트 토큰을 생성하기 위해 Flow와 IPFS를 결합하는 방법에 대한 튜토리얼

php 편집자 Yuzai는 Flow 및 IPFS를 사용하여 NFT를 생성하는 계약 및 코인 주조 작업에 대한 튜토리얼을 제공합니다. Flow는 블록체인 기반 스마트 계약 플랫폼인 반면, IPFS는 분산 파일 시스템입니다. 이 두 가지를 결합하면 자신만의 대체 불가능한 토큰(NFT)을 만들고 발행할 수 있습니다. 이 튜토리얼에서는 Flow 및 IPFS를 사용하여 이 프로세스를 구현하는 방법을 자세히 소개하여 NFT 생성 및 발행을 더 잘 이해하고 마스터하는 데 도움을 줍니다. 시작하자!

이후 NFT는 성장하기 시작했고 Rarible, OpenSea, Foundation, Sorare 등의 플랫폼이 속속 등장했습니다. 이러한 플랫폼에는 매달 수백만 달러의 트래픽이 발생합니다. 우여곡절에도 불구하고 대부분의 일이 여전히 이더리움 블록체인에서 일어나고 있습니다. 그러나 CryptoKitties를 경험한 후 Dapper Labs 팀은 NFT 사용 시나리오에 매우 적합한 새로운 범용 블록체인을 구축하기 시작했습니다. 이를 수행하는 그들의 목표는 이더리움의 많은 NFT에서 볼 수 있는 문제를 해결하는 동시에 해당 공간의 개발자와 수집가에게 더 나은 경험을 제공하는 것입니다. 그들의 새로운 블록체인인 Flow는 그것이 구현될 수 있고 유명 인사들을 끌어들일 수 있음을 입증했습니다. NBA, UFC, Dr. Seuss 등에서도 Flow를 사용하고 있습니다.

우리는 이전에 IPFS를 사용하여 블록체인에서 NFT를 생성하는 방법에 대해 논의하고 NFT 공간의 책임 문제와 IPFS가 어떻게 도움이 될 수 있는지 탐구했습니다. 이제 Flow 블록체인에서 IPFS 지원 NFT를 생성하는 방법에 대해 이야기해 보겠습니다. Flow 블록체인의 첫 번째 주요 응용 프로그램 중 하나는 NBA Top Shot이었습니다. 우리는 간단한 NFT 채굴 프로세스를 다시 구축하고 NFT 메타데이터와 기본 자산을 IPFS에 저장할 것입니다.

저희는 피냐타를 좋아하기 때문에 NFT는 더 이상 NBA 하이라이트 영상이 아닌 거래 가능한 피냐타 영상이 될 것입니다.

이 튜토리얼에는 3개의 기사가 있습니다.

Creating a contract and minting tokens (이 기사가 첫 번째 기사입니다.)

이 계약을 통해 생성된 NFT를 보려면 애플리케이션을 만드세요.

NFT를 다른 사람에게 양도하는 동시에 IPFS의 기본 자산을 양도할 수 있는 시장을 만드세요.

Flow 및 IPFS를 사용하여 NFT 계약 생성 및 토큰 발행에 대한 튜토리얼

환경 설정

Flow CLI를 설치해야 합니다. Flow 문서에는 몇 가지 좋은 설치 지침이 있습니다.

macOS

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 키를 얻을 수 있습니다. Pinata API는 이 튜토리얼의 두 번째 기사에서 사용되었지만 이 기사에서는 Pinata 웹사이트를 사용합니다.

Flow 스마트 계약(Cadence라는 언어로 작성됨) 코드의 구문을 강조하는 데 도움이 될 수 있는 NodeJS와 텍스트 편집기도 설치해야 합니다. Visual Studio Code에는 Cadence 구문을 지원하는 플러그인이 있습니다.

프로젝트용 디렉터리를 만들어 보겠습니다.

mkdir pinata-party

해당 디렉터리로 이동하여 새 흐름 프로젝트를 초기화합니다.

cd pinata-partyflow project init

이제 즐겨 사용하는 코드 편집기에서 프로젝트를 엽니다. Visual Studio Code를 사용하는 경우 Cadence를 설치할 수 있습니다. 플러그인) 작업을 시작하겠습니다.

flow.json 파일이 표시되며 곧 사용할 것입니다. 먼저 cadence라는 폴더를 만듭니다. 이 폴더 내에 contract라는 다른 폴더를 추가합니다. 마지막으로 contract 폴더에 PinataPartyContract.cdc라는 파일을 만듭니다.

현재 Flow 블록체인에서 수행하는 모든 작업은 시뮬레이터에서 수행될 것이라고 설명하세요. 그러나 테스트넷이나 메인넷에 프로젝트를 배포하는 것은 flow.json 파일의 구성을 업데이트하는 것만큼 간단합니다. 이제 이 파일을 시뮬레이터 환경으로 설정한 다음 계약서 작성을 시작할 수 있습니다.

다음 코드를 사용하여 flow.json의 계약 개체를 업데이트합니다.

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

그런 다음 다음 코드를 사용하여 파일의 배포 개체를 업데이트합니다.

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

이는 Flow CLI가 시뮬레이터를 사용하여 계약을 배포하도록 지시하는 것입니다. 또한 (시뮬레이터에서) 우리가 작성하려고 하는 계약과 관련하여...

Contracts

Flow에는 NFT 계약 생성에 대한 훌륭한 튜토리얼이 있습니다. 그는 훌륭한 참고 자료이지만 Flow 자체가 지적했듯이 아직 NFT 메타데이터 문제를 해결하지 못했습니다. 그들은 메타데이터를 체인에 저장하고 싶어합니다. 이것은 좋은 생각이며, 그들은 분명히 합리적인 해결책을 찾아낼 것입니다. 그러나 이제 우리는 메타데이터와 함께 일부 토큰을 만들고 해당 미디어 파일(객체)을 연결하려고 합니다. 메타데이터는 단지 하나의 구성요소일 뿐입니다. 또한 토큰이 궁극적으로 나타내는 미디어 파일을 표시해야 합니다.

이더리움 블록체인의 NFT에 익숙하신 분이라면 많은 토큰의 기본 자산이 기존 클라우드 서버에 저장되어 있다는 사실을 아실 것입니다. 이는 가능하지만 단점이 있습니다. 우리는 IPFS 콘텐츠의 주소 지정 가능성과 기존 클라우드 플랫폼에 블록체인 데이터를 저장할 때의 단점에 대해 썼습니다. 이는 두 가지 주요 사항으로 요약됩니다:

자산은 검증 가능해야 합니다

유지 관리 책임을 쉽게 양도할 수 있어야 합니다

IPFS解决了这两点。而 Pinata 则以一种简单的方式将该内容长期保存在 IPFS 上。这正是我们的 NFT 关联的资料所需要的？我们要确保能够证明拥有 NFT 的所有权，并确保我们能控制对标的资产（IPFS）--媒体文件或其他内容，确保不是复制品。

考虑到这一点，让我们写一份合约，它可以铸造 NFT，将元数据关联到 NFT，并确保元数据指向存储在 IPFS 上的标的资产。

打开PinataPartyContract.cdc，编写一下代码：

pub contract PinataPartyContract {  pub resource NFT {    pub let id: UInt64    init(initID: UInt64) {      self.id = initID    }  }}

第一步是定义合约，后面会添加更多的内容，但我们首先定义PinataPartyContract，并在其中创建一个resource。资源是存储在用户账户中并通过访问控制措施进行访问。在这里，NFT资源最终用来代表 NFT 所拥有的东西。NFT 必须是唯一的，id属性允许我们标识代币。

接下来，我们需要创建一个资源接口，我们将用它来定义哪些能力可以提供给其他人（即不是合约所有者）。

pub resource interface NFTReceiver {  pub fun deposit(token: @NFT, metadata: )  pub fun getIDs(): [UInt64]  pub fun idExists(id: UInt64): Bool  pub fun getMetadata(id: UInt64) : }

把这个代码放在 NFT resource 代码的下面。这个NFTReceiver资源接口用来定义对资源有访问权的人，就可以调用以下方法:

deposit

getIDs

idExists

getMetadata

接下来，我们需要定义代币收藏品（ Colletion ）接口。把它看成是存放用户所有 NFT 的钱包。

pub resource Collection: NFTReceiver {    pub var ownedNFT: @    pub var metadataObjs: }    init () {        self.ownedNFT <- {}        self.metadataObjs = {}    }    pub fun withdraw(withdrawID: UInt64): @NFT {        let token <- self.ownedNFT.remove(key: withdrawID)!        return <-token    }    pub fun deposit(token: @NFT, metadata: ) {        self.ownedNFT[token.id] <-! token    }    pub fun idExists(id: UInt64): Bool {        return self.ownedNFT[id] != nil    }    pub fun getIDs(): [UInt64] {        return self.ownedNFT.keys    }    pub fun updateMetadata(id: UInt64, metadata: ) {        self.metadataObjs[id] = metadata    }    pub fun getMetadata(id: UInt64):  {        return self.metadataObjs[id]!    }    destroy() {        destroy self.ownedNFT    }}

这个资源里有很多东西，说明一下。首先，有一个变量叫ownedNFT。这个是很直接的，它可以跟踪用户在这个合约中所有拥有的 NFT。

接下来，有一个变量叫metadataObjs。这个有点特殊，因为我们扩展了 Flow NFT 合约功能，为每个 NFT 存储元数据的映射。这个变量将代币 id 映射到其相关的元数据上，这意味着我们需要在设置代币 id 之前，将其设置为元数据。

然后我们初始化变量。定义在 Flow 中的资源中的变量必需初始化。

最后，我们拥有了 NFT Collection 资源的所有可用函数。需要注意的是，并不是所有这些函数大家都可以调用。你还记得在前面，NFTReceiver资源接口中定义了任何人都可以访问的函数。

我尤其想指出 deposit函数。正如我们扩展了默认的 Flow NFT 合约以包含 metadataObjs映射一样，我们正在扩展默认的 deposit函数，以接受额外的 metadata参数。为什么要在这里做这个？因为需要确保只有 token 的 minter 可以将该元数据添加到 token 中。为了保持这种私密性，将元数据的初始添加限制在铸币执行中。

合约代码就快完成了。因此，在 Collection资源的下面，添加以下内容：

pub fun createEmptyCollection(): @Collection {    return <- create Collection()}pub resource NFTMinter {    pub var idCount: UInt64    init() {        self.idCount = 1    }    pub fun mintNFT(): @NFT {        var newNFT <- create NFT(initID: self.idCount)        self.idCount = self.idCount + 1 as UInt64        return <-newNFT    }}

首先，我们有一个函数，在调用时创建一个空的 NFT Collection。这就是第一次与合约进行交互的用户如何创建一个存储位置，该位置映射到定义好的 Collection资源。

之后，我们再创建一个资源（resource）。它很重要的，因为没有它，我们就无法铸造代币。NFTMinter资源包括一个idCount，它是递增的，以确保我们的 NFT 不会有重复的 id。它还有一个功能，用来创造 NFT。

在NFTMinter资源的下方，添加主合约初始化函数；

init() {      self.account.save(<-self.createEmptyCollection(), to: /storage/NFTCollection)      self.account.link<&>(/public/NFTReceiver, target: /storage/NFTCollection)      self.account.save(<-create NFTMinter(), to: /storage/NFTMinter)}

这个初始化函数只有在合约部署时才会被调用。它有三个作用。

为收藏品（Collection）的部署者创建一个空的收藏品，这样合约的所有者就可以从该合约中铸造和拥有 NFT。

Collection资源发布在一个公共位置，并引用在一开始创建的NFTReceiver接口。通过这个方式告诉合约，在NFTReceiver上定义的函数可以被任何人调用。

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 代币。

铸造 NFT

在教程的第二篇文章中，我们将通过一个应用程序和用户界面使铸币过程更加友好。为了看到所铸造的内容，并展示元数据如何在 Flow 上与 NFT 一起工作，我们将使用 Cadence 脚本和命令行。

在 pinata-party项目的根目录下创建一个新的目录，我们把它叫做 transactions。创建好文件夹，在里面创建一个名为MintPinataParty.cdc 的新文件。

为了编写出交易，先需要提供给 NFT 的元数据一个引用文件。为此，我们将通过 Pinata 上传一个文件到 IPFS。这个教程中，我将上传一个孩子在生日派对上砸 pinata 的视频。你可以上传任何你想要的视频文件。你真的可以上传任何你喜欢的资产文件，并将其与你的 NFT 关联起来，在本教程系列的第二篇文章将期待视频内容。一旦你准备好你的视频文件，在这里上传。

当你上传文件后，你会得到一个 IPFS 哈希（通常被称为内容标识符或 CID）。复制这个哈希值，因为我们将在铸币过程中使用它。

现在，在你的MintPinataParty.cdc文件中，添加以下内容：

import PinataPartyContract from 0xf8d6e0586b0a20c7transaction {  let receiverRef: &  let minterRef: &PinataPartyContract.NFTMinter  prepare(acct: AuthAccount) {      self.receiverRef = acct.getCapability<&>(/public/NFTReceiver)          .borrow()          ?? panic("Could not borrow receiver reference")      self.minterRef = acct.borrow<&pinatapartycontract.nftminter>(from: /storage/NFTMinter)          ?? panic("could not borrow minter reference")  }  execute {      let metadata :  = {          "name": "The Big Swing",          "swing_velocity": "29",          "swing_angle": "45",          "rating": "5",          "uri": "ipfs://QmRZdc3mAMXpv6Akz9Ekp1y4vDSjazTx2dCQRkxVy1yUj6"      }      let newNFT <- self.minterRef.mintNFT()      self.receiverRef.deposit(token: <-newNFT, metadata: metadata)      log("NFT Minted and deposited to Account 2's Collection")  }}

这是一个非常简单的交易代码，这在很大程度上要归功于 Flow 所做的工作，但让我们来看看它。首先，你会注意到顶部的导入语句。如果你还记得，在部署合约时，我们收到了一个账户地址。它就是这里引用的内容。因此，将0xf8d6e0586b0a20c7替换为你部署的账户地址。

接下来我们对交易进行定义。在我们的交易中，我们首先要做的是定义两个参考变量，receiverRef和minterRef。在这种情况下，我们既是 NFT 的接收者，又是 NFT 的挖掘者。这两个变量是引用我们在合约中创建的资源。如果执行交易的人对资源没有访问权，交易将失败。

接下来，我们有一个prepare函数。该函数获取试图执行交易的人的账户信息并进行一些验证。它会尝试 借用两个资源 NFTMinter和 NFTReceiver上的可用能力。如果执行交易的人没有访问这些资源的权限，验证无法通过，这就是交易会失败的原因。

最后是execute函数。这个函数是为我们的 NFT 建立元数据，铸造 NFT，然后在将 NFT 存入账户之前关联元数据。如果你注意到，我创建了一个元数据变量。在这个变量中，添加了一些关于 token 的信息。由于我们的代币代表的是一个事件，即一个 piñata 在派对上被打碎，并且因为我们试图复制你在 NBA Top Shot 中看到的大部分内容，所以我在元数据中定义了一些统计数据。孩子挥棒打 piñata 的速度，挥棒的角度和等级。我只是觉得这些统计数字有意思。你可以用类似的方式为你的代币定义任何有意义的信息。

你会注意到，我还在元数据中定义了一个uri属性。这将指向 IPFS 哈希，它承载着我们与 NFT 相关的标的资产文件。在这种情况下，它是 piñata 被击中的真实视频。你可以用你之前上传文件后收到的哈希值来替换。

我们用ipfs://作为哈希的前缀，有几个原因。这是 IPFS 上文件的标识符，可以使用 IPFS 的桌面客户端和浏览器扩展。也可以直接粘贴到 Brave 浏览器中（Brave 浏览器现在提供了对 IPFS 内容的原生支持）。

调用 mintNFT函数来创建代币。然后调用deposit函数将其存入我们的账户。这也是我们传递元数据的地方。如果你还记得，我们在 deposit函数中定义了一个关联变量，将元数据添加到关联的 token id 中。

最后，我们只需要日志记录代币已被铸造和存入账户的信息。

现在我们差不多可以执行代码发送交易铸造 NFT 了。但首先，我们需要准备好我们的账户。在项目根目录下的命令行中，创建一个新的签名私钥。

运行以下命令。

flow keys generate

这将返回你一个公钥和一个私钥， 请始终保护好你的私钥。

我们将需要私钥来签署交易，所以我们可以把它粘贴到flow.json文件中。我们还需要指定签名算法。下面是flow.json文件中的accounts 的内容：

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

如果你打算在 github 或任何远程 git 仓库上存储这个项目的任何内容，请确保你不包含私钥。你可能想.gitignore你的整个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

最后，验证 token 是否在我们的账户中，并获取元数据。做到这一点，我们要写一个非常简单的脚本，并从命令行调用它。

在项目根目录，创建一个名为 scripts的新文件夹。在里面，创建一个名为CheckTokenMetadata.cdc的文件。在该文件中，添加以下内容：

import PinataPartyContract from 0xf8d6e0586b0a20c7pub fun main() :  {    let nftOwner = getAccount(0xf8d6e0586b0a20c7)    // log("NFT Owner")    let capability = nftOwner.getCapability<&>(/public/NFTReceiver)    let receiverRef = capability.borrow()        ?? panic("Could not borrow the receiver reference")    return receiverRef.getMetadata(id: 1)}

这个脚本可以被认为是类似于以太坊智能合约上调用只读方法。它们是免费的，只返回合约中的数据。

在脚本中，导入部署的合约地址。然后定义一个 main函数（这是脚本运行所需的函数名）。在这个函数里面，我们定义了三个变量：

nftOwner：拥有 NFT 的账户。由于使用部署了合约的账户中铸造了 NFT，所以在我们的例子中，这两个地址是一样的。这一点不一定，要看你将来的合约设计。

capability：需要从部署的合约中 借用的能力（或功能）。请记住，这些能力是受访问控制的，所以如果一个能力对试图借用它的地址不可用，脚本就会失败。我们正在从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。

本翻译由Cell Network赞助支持。

来源：

https://medium.com/pinata/how-to-create-nfts-like-nba-top-shot-with-flow-and-ipfs-701296944bf

위 내용은 NFT 계약 및 민트 토큰을 생성하기 위해 Flow와 IPFS를 결합하는 방법에 대한 튜토리얼의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!