발행

This is the first of many tutorials in a series where you'll be creating a complete NFT smart contract from scratch that conforms with all the NEAR NFT standards.

Today you'll learn how to create the logic needed to mint NFTs and have them show up in your NEAR wallet. You will be filling a bare-bones skeleton smart contract to add minting functionalities.

Contracts You can find the skeleton contract in our Skeleton folder

A completed version of this tutorial can be found in the Basic NFT folder :::

소개

To get started, go to the nft-contract-skeleton folder in our repo. If you haven't cloned the repository, refer to the Contract Architecture to get started.

cd nft-contract-skeleton/

If you wish to see the finished code of this step-by-step basic NFT contract tutorial, that can be found on the nft-contract-basic folder.

뼈대 컨트랙트 수정

발행에 필요한 로직을 구현하려면, 발행 프로세스를 더 작은 작업으로 나누고 하나씩 처리해야 합니다. 한 걸음 물러나 NFT를 발행한다는 것은 무엇을 의미합니까?

대체 불가능 토큰(NFT)을 발행하려면, 가능한 가장 간단한 방법으로는 컨트랙트에서 블록체인의 소유자와 토큰을 연결할 수 있어야 합니다. 즉, 다음과 같은 것들이 필요합니다.

컨트랙트에 대한 토큰 및 기타 정보를 추적하는 방법.
metadata (나중에 자세히 설명)와 같은 각 토큰에 대한 정보를 저장하는 방법.
소유자와 토큰을 연결하는 방법.

이게 다입니다! 이제 우리는 더 큰 문제를 더 작고 덜 어려운 하위 작업으로 분류했습니다. 첫 번째 문제를 해결하는 것으로 시작하여 나머지 작업까지 진행해 봅시다.

컨트랙트에 정보 저장

Start by navigating to nft-contract-skeleton/src/lib.rs and filling in some of the code blocks. 여기서 계정이 보유한 토큰 목록과 같은 컨트랙트에 대한 중요한 정보를 저장할 수 있어야 합니다.

컨트랙트 구조

가장 먼저 할 일은 struct 컨트랙트를 다음과 같이 수정하는 것입니다.

Loading...

See full example on GitHub

This allows you to get the information stored in these data structures from anywhere in the contract. The code above has created 3 token specific storages:

tokens_per_owner: 모든 계정이 소유한 토큰을 추적할 수 있습니다.
tokens_by_id: 특정 토큰에 대한 모든 정보를 반환합니다.
token_metadata_by_id: 특정 토큰에 대한 메타데이터만 반환합니다.

In addition, you'll keep track of the owner of the contract as well as the metadata for the contract.

You might be confused as to some of the types that are being used. In order to make the code more readable, we've introduced custom data types which we'll briefly outline below:

AccountId: 특수 문자나 지원되지 않는 문자가 없는 문자열입니다.
TokenId: 단순한 문자열입니다.

As for the Token, TokenMetadata, and NFTContractMetadata data types, those are structs that we'll define later in this tutorial.

초기화 함수

Next, create what's called an initialization function; we will name it new, but you can choose any name you prefer.

This function needs to be invoked when you first deploy the contract. It will initialize all the contract's fields that you've defined above with default values. Don't forget to add the owner_id and metadata fields as parameters to the function, so only those can be customized.

This function will default all the collections to be empty and set the owner and metadata equal to what you pass in.

Loading...

See full example on GitHub

개발을 할 때 종종 컨트랙트를 여러 번 배포해야 합니다. 컨트랙트를 초기화할 때마다 메타데이터를 전달해야 하는 것이 지루할 수 있다고 생각할 수 있습니다. 이러한 이유로, 기본 metadata 집합으로 컨트랙트를 초기화할 수 있는 함수를 만들어 봅시다. 당신은 이를 new_default_meta로 부를 수 있고, 매개 변수로 owner_id만 취할 것입니다.

Loading...

See full example on GitHub

이 함수는 단순히 이전 new 함수를 호출하고, 지정한 소유자를 전달하며, 일부 기본 메타데이터도 전달합니다.

메타데이터 및 토큰 정보

이제 컨트랙트 자체에 저장할 정보를 정의하고 컨트랙트를 초기화하는 몇 가지 방법을 정의했으므로, Token, TokenMetadata, 및 NFTContractMetadata 자료형에 들어갈 정보를 정의해야 합니다.

Let's switch over to the nft-contract-skeleton/src/metadata.rs file as this is where that information will go.

메타데이터에 대한 표준을 살펴보면, TokenMetadata 및 NFTContractMetadata 모두에 대해 저장해야 하는 모든 필수 정보를 찾을 수 있습니다. 다음 코드를 입력하기만 하면 됩니다.

Loading...

See full example on GitHub

이제 Token 구조체와 JsonToken이라는 것이 남습니다. Token 구조체는 메타데이터를 제외하고 토큰과 직접 관련된 모든 정보를 보유합니다. 기억한다면, 메타데이터는 컨트랙트 내 맵에 tokenMetadataById이라는 이름의 자료 구조로 저장됩니다. 이를 통해 토큰의 ID를 전달하기만 하면 모든 토큰에 대한 메타데이터를 빠르게 가져올 수 있습니다.

Token 구조체의 경우, 지금은 소유자만 추적합니다.

Loading...

See full example on GitHub

Since NEAR smart contracts receive and return data in JSON format, the purpose of the JsonToken is to act as output when the user asks information for an NFT. 즉, 소유자, 토큰 ID 및 메타데이터를 저장해야 합니다.

Loading...

See full example on GitHub

여러분 중 일부는 "왜 Token 구조체에 모든 정보를 저장하지 않는 거죠?" 라고 생각할 수도 있습니다. 그 이유는 토큰 구조에 모든 정보를 저장하는 것보다 필요할 때만 즉시 JSON 토큰을 구성하는 것이 실제로 더 효율적이기 때문입니다. 또한 일부 작업에는 토큰에 대한 메타데이터만 필요할 수 있으므로 메타데이터를 별도의 자료 구조에 두는 것이 더 적합합니다. :::

컨트랙트 메타데이터 쿼리를 위한 함수

이제 이전 섹션에서 사용된 일부 자료형을 정의했으므로, 첫 번째 View 함수 nft_metadata를 만들어 보겠습니다. 이를 통해 사용자는 메타데이터 표준에 따라 컨트랙트의 메타데이터를 쿼리할 수 있습니다.

Loading...

See full example on GitHub

이 함수는 컨트랙트에서 NFTContractMetadata 자료형의 metadata 객체를 가져와 반환합니다.

이와 같이 처음 두 작업을 완료했으며 튜토리얼의 마지막 부분으로 이동할 준비가 되었습니다.

발행 로직

이제 모든 정보와 자료형이 정의되었으므로, 생성 로직이 어떻게 실행될지 브레인스토밍을 시작하겠습니다. 결국 특정 소유자에게 Token 및 TokenId를 연결해야 합니다. lib.rs 파일로 돌아가 이를 연결할 수 있는지 확인해보겠습니다. 유용할 수 있는 몇 가지 자료 구조를 살펴보겠습니다.

//keeps track of all the token IDs for a given account
pub tokens_per_owner: LookupMap<AccountId, UnorderedSet<TokenId>>,

//keeps track of the token struct for a given token ID
pub tokens_by_id: LookupMap<TokenId, Token>,

//keeps track of the token metadata for a given token ID
pub token_metadata_by_id: UnorderedMap<TokenId, TokenMetadata>,

이러한 자료 구조를 살펴보면 다음을 수행할 수 있습니다.

수신자가 소유한 토큰 집합에 토큰 ID를 추가합니다. 이는 tokens_per_owner 필드에서 이루어질 것입니다.
토큰 객체를 만들고 토큰 ID를 tokens_by_id 필드의 해당 토큰 개체에 매핑합니다.
token_metadata_by_id를 사용하여 토큰 ID를 메타데이터에 매핑합니다.

스토리지 구현

이 단계에서는 NFT 발행의 스토리지 비용을 고려하는 것이 중요합니다. 자료 구조에 항목이 생성되어 컨트랙트에 바이트를 추가하므로, 컨트랙트에서 스토리지 비용을 충당해야 합니다. 모든 사용자가 무료로 NFT를 발행할 수 있도록 만든 경우, 해당 시스템은 쉽게 남용될 수 있으며 사용자는 본질적으로 수천 개의 NFT를 발행하여 모든 컨트랙트 내 자금을 "탈취"할 수 있습니다. 이러한 이유로 사용자가 스토리지 비용을 충당하기 위해 호출에 보증금을 첨부해야 하도록 만들 것입니다. 아무것도 추가되기 전에, 초기 스토리지 사용량을 측정하고 모든 로직이 완료된 후 최종 스토리지 사용량을 측정합니다. 그런 다음 사용자가 해당 비용을 충당하기에 충분한 $NEAR를 첨부했는지 확인하고, 너무 많이 첨부된 경우 환불합니다.

This is how we do it in code:

Loading...

See full example on GitHub

여기서 refund_deposit과 internal_add_token_to_owner와 같은 몇 가지 내부 메서드를 사용하고 있음을 알 수 있습니다. 우리는 refund_deposit의 기능에 대해 설명했습니다. 또한 internal_add_token_to_owner도, 계정이 컨트랙트의 tokens_per_owner 자료 구조에 대해 소유한 토큰 집합에 토큰을 추가합니다. internal.rs라는 파일에서 이 함수들을 만들 수 있습니다. 계속해서 파일을 만드세요. 새 컨트랙트 아키텍처는 다음과 같아야 합니다.

nft-contract
├── Cargo.lock
├── Cargo.toml
├── README.md
├── build.sh
└── src
    ├── approval.rs
    ├── enumeration.rs
    ├── internal.rs
    ├── lib.rs
    ├── metadata.rs
    ├── mint.rs
    ├── nft_core.rs
    ├── events.rs
    └── royalty.rs

새로 만든 internal.rs 파일에 다음을 추가합니다.

Loading...

See full example on GitHub

You may notice more functions in the internal.rs file than we need for now. You may ignore them, we'll come back to them later. :::

그런 다음 빠르게 lib.rs 파일로 이동하여, 방금 만든 함수를 다른 파일에서 호출할 수 있도록 만들어 보겠습니다. 아래와 같이 내부 크레이트를 추가하고 파일을 수정합니다.

Loading...

See full example on GitHub

이 시점에서 NFT를 발행할 수 있는 핵심 로직이 모두 준비되었습니다. 이제 다음 매개변수를 사용하는 nft_mint 함수를 사용할 수 있습니다.

token_id: 발행하려는 토큰의 ID(문자열).
metadata: 생성 중인 토큰의 메타데이터(metadata.rs 파일 내 에서 찾을 수 있는 TokenMetadata 자료형).
receiver_id: 토큰 소유자를 지정.

내부적으로, 함수는 다음과 같이 동작할 것입니다.

컨트랙트에 무엇이든 추가하기 전에, 초기 스토리지를 계산합니다.
소유자 ID로 Token 객체를 만듭니다.
tokens_by_id 필드에 토큰 ID를 삽입하여 새로 만든 토큰 객체에 토큰 ID를 연결합니다.
토큰 ID를 token_metadata_by_id 필드에 삽입하여 전달된 메타데이터에 연결합니다
internal_add_token_to_owner함수를 호출하여 소유자가 소유한 토큰 목록에 토큰 ID를 추가합니다.
사용자가 이러한 비용을 위해 호출에 충분한 NEAR를 첨부했는지 확인하려면 최종 및 순 스토리지를 계산합니다.

토큰 정보 쿼리

계속 진행하여 이 컨트랙트를 배포하고 초기화하여 NFT를 생성한다면, 방금 생성한 토큰에 대한 정보를 알거나 쿼리할 방법이 없습니다. 특정 NFT의 정보를 쿼리하는 방법을 빠르게 추가해 보겠습니다. You'll move to the nft-contract-skeleton/src/nft_core.rs file and edit the nft_token function.

이는 토큰 ID를 매개변수로 사용하고 해당 토큰에 대한 정보를 반환할 것입니다. JsonToken에는 토큰 ID, 소유자 ID 및 토큰의 메타데이터가 포함됩니다.

Loading...

See full example on GitHub

완료되면 첫 NFT를 생성할 수 있도록 컨트랙트를 구축하고 배포할 차례입니다.

온체인에서 컨트랙트와 상호 작용

이제 발행 로직이 완료되고 특정 토큰에 대한 정보를 쿼리하는 방법을 추가했으므로 컨트랙트를 빌드하고 블록체인에 배포할 차례입니다.

컨트랙트 배포

배포하려면 로컬 기기에 키가 저장된 NEAR 계정이 필요합니다. Navigate to the NEAR wallet site and create an account.

정보

기존 컨트랙트가 없는 계정에 컨트랙트를 배포했는지 확인하세요. 새 계정을 만들거나 이 튜토리얼의 하위 계정을 만드는 것이 가장 쉽습니다.

near account import-account using-web-wallet network-config testnet

이 튜토리얼을 더 쉽게 복사/붙여넣기할 수 있도록, 계정 ID에 대한 환경 변수를 설정하겠습니다. 아래 명령에서 YOUR_ACCOUNT_NAME를 .testnet 부분을 포함하여 방금 로그인한 계정 이름으로 바꿉니다.

export NFT_CONTRACT_ID="YOUR_ACCOUNT_NAME"

다음을 실행하여 환경 변수가 올바르게 설정되었는지 테스트합니다.

echo $NFT_CONTRACT_ID

터미널에 올바른 계정 ID가 출력되어 있는지 확인하세요. 모든 것이 올바르게 보이면 이제 컨트랙트를 배포할 수 있습니다. In the root of your NFT project run the following command to deploy your smart contract and answer questions:

cargo near deploy $NFT_CONTRACT_ID

> Select the need for initialization: with-init-call     - Add an initialize
> What is the name of the function? new_default_meta
> How would you like to pass the function arguments? json-args
> Enter the arguments to this function: {"owner_id": "<YOUR_NFT_CONTRACT_ID>"}
> Enter gas for function call: 100 TeraGas
> Enter deposit for a function call (example: 10NEAR or 0.5near or 10000yoctonear): 0 NEAR
> What is the name of the network? testnet
> Select a tool for signing the transaction: sign-with-keychain
> How would you like to proceed? send

You don't need to answer these questions every time. If you look at the results you will find the message Here is the console command if you ever need to re-run it again. The next line is the command which you may use instead of answering to interactive questions:

cargo near deploy $NFT_CONTRACT_ID with-init-call new_default_meta json-args '{"owner_id": "'$NFT_CONTRACT_ID'"}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' network-config testnet sign-with-keychain send

You've just deployed and initialized the contract with some default metadata and set your account ID as the owner. 이제 첫 번째 view 함수를 호출할 준비가 되었습니다.

컨트랙트 메타데이터 보기

이제 컨트랙트가 초기화되었으므로 이전에 작성한 일부 함수를 호출할 수 있습니다. 보다 구체적으로 컨트랙트 메타데이터를 반환하는 함수를 테스트해 보겠습니다.

near contract call-function as-read-only $NFT_CONTRACT_ID nft_metadata json-args {} network-config testnet now

그러면 다음과 유사한 출력이 반환됩니다.

{
  spec: 'nft-1.0.0',
  name: 'NFT Tutorial Contract',
  symbol: 'GOTEAM',
  icon: null,
  base_uri: null,
  reference: null,
  reference_hash: null
}

이제 첫 번째 NFT를 발행할 준비가 되었습니다.

첫 NFT 발행

이제 생성한 발행 함수를 호출해 보겠습니다. 이를 위해 token_id와 metadata가 필요합니다. 이전에 생성한 TokenMetadata 구조체를 다시 살펴보면, 잠재적으로 온체인에 저장할 수 있는 많은 필드가 있습니다.

Loading...

See full example on GitHub

시작하려면 제목, 설명 및 미디어가 있는 NFT를 만들어 봅시다. 미디어 필드는 미디어 파일을 가리키는 URL일 수 있습니다. 우리에게는 생성할 수 있는 훌륭한 GIF가 있지만, 사용자 지정 NFT를 생성하고 싶다면 미디어 링크를 선택한 것으로 교체하기만 하면 됩니다. 다음 명령을 실행하면 다음 매개 변수를 사용하여 NFT를 생성합니다.

token_id: "token-1"
metadata:
- title: "My Non Fungible Team Token"
- description: "The Team Most Certainly Goes :)"
- media: https://bafybeiftczwrtyr3k7a2k4vutd3amkwsmaqyhrdzlhvpt33dyjivufqusq.ipfs.dweb.link/goteam-gif.gif
- receiver_id: "'$NFT_CONTRACT_ID'"

near contract call-function as-transaction $NFT_CONTRACT_ID nft_mint json-args '{"token_id": "token-1", "metadata": {"title": "My Non Fungible Team Token", "description": "The Team Most Certainly Goes :)", "media": "https://bafybeiftczwrtyr3k7a2k4vutd3amkwsmaqyhrdzlhvpt33dyjivufqusq.ipfs.dweb.link/goteam-gif.gif"}, "receiver_id": "'$NFT_CONTRACT_ID'"}' prepaid-gas '100.0 Tgas' attached-deposit '0.1 NEAR' sign-as $NFT_CONTRACT_ID network-config testnet sign-with-legacy-keychain send

amount 플래그는 호출에 첨부할 NEAR의 양을 지정합니다. 스토리지 비용을 지불해야 하므로 0.1 NEAR가 첨부되고, 마지막에 사용하지 않은 초과분은 환불됩니다. :::

NFT에 대한 정보 보기

이제 NFT가 발행되었으므로, nft_token 함수를 호출하여 모든 것이 올바르게 진행되었는지 확인할 수 있습니다. 이는 token_id, owner_id, 및 metadata를 포함해야 하는 JsonToken를 반환합니다.

near contract call-function as-read-only $NFT_CONTRACT_ID nft_token json-args '{"token_id": "token-1"}' network-config testnet now

응답 예시:

{
  token_id: 'token-1',
  owner_id: 'goteam.examples.testnet',
  metadata: {
    title: 'My Non Fungible Team Token',
    description: 'The Team Most Certainly Goes :)',
    media: 'https://bafybeiftczwrtyr3k7a2k4vutd3amkwsmaqyhrdzlhvpt33dyjivufqusq.ipfs.dweb.link/goteam-gif.gif',
    media_hash: null,
    copies: null,
    issued_at: null,
    expires_at: null,
    starts_at: null,
    updated_at: null,
    extra: null,
    reference: null,
    reference_hash: null
  }
}

완료되었습니다! 이제 모든 것이 올바르게 작동함을 확인했으며, NEAR 지갑의 수집품 탭에서 새로 발행된 NFT를 볼 시간입니다!

지갑에서 NFT 보기

If you navigate to the collectibles tab in the NEAR wallet, this should list all the NFTs that you own. 현재 비어 있어야 합니다.

empty-nft-in-wallet

문제가 생겼습니다. 지갑은 당신이 NFT를 발행했다고 올바르게 선택했지만, 컨트랙트는 해당 view 기능을 구현하지 않습니다. 뒤에서 지갑은 컨트랙트에서 당신의 계정이 소유한 모든 NFT 목록을 얻기 위해 nft_tokens_for_owner 호출을 시도하고 있습니다. 그러나 우리가 만든 유일한 함수는 nft_token 함수입니다. 지갑이 사용자가 정보를 얻어야 하는 모든 단일 NFT에 대해 nft_token을 매번 호출하는 것은 매우 효율적이지 않으므로, 대신 nft_tokens_for_owner 함수를 호출하려고 합니다.

다음 튜토리얼에서는 지갑에서 NFT를 볼 수 있도록 기존 컨트랙트에 패치 수정을 배포하는 방법에 대해 알아봅니다.

결론

이 튜토리얼에서는 컨트랙트 뼈대를 사용하여 블록체인에서 NFT를 생성하는 로직을 설정하고 이해하는 기본 사항에 대해 살펴보았습니다.

먼저 NFT를 발행하는 것이 무엇을 의미하는지, 그리고 문제를 보다 실현 가능한 덩어리로 나누는 방법을 살펴보았습니다. 그런 다음 컨트랙트에 정보/상태를 저장하는 문제를 해결하는 것부터 시작하여 컨트랙트 뼈대의 덩어리들을 덩어리 별로 수정하기 시작했습니다. 그런 다음 메타데이터 및 토큰 정보에 무엇을 넣을지 살펴보았습니다. 마지막으로 NFT 발행에 필요한 로직을 살펴보았습니다.

컨트랙트가 작성된 후 블록체인에 배포할 시간이었습니다. 현재 컨트랙트를 배포하고 초기화했습니다. 마지막으로, 첫 NFT를 발행하고, 지갑에서 보기 전에 일부 변경이 필요하다는 것을 확인했습니다.

다음 단계

In the next tutorial, you'll find out how to deploy a patch fix and what that means so that you can view your NFTs in the wallet.

문서 버전 관리

글을 작성하는 시점에서, 해당 예제는 다음 버전에서 작동합니다.

rustc: 1.77.1
near-cli-rs: 0.11.0
cargo-near 0.6.1
NFT standard: NEP171, version 1.0.0
메타데이터 표준: NEP177, 1.0.0 버전

발행

소개

뼈대 컨트랙트 수정

컨트랙트에 정보 저장

컨트랙트 구조

초기화 함수

메타데이터 및 토큰 정보

컨트랙트 메타데이터 쿼리를 위한 함수

발행 로직

스토리지 구현

토큰 정보 쿼리

온체인에서 컨트랙트와 상호 작용

컨트랙트 배포

컨트랙트 메타데이터 보기

첫 NFT 발행

NFT에 대한 정보 보기

지갑에서 NFT 보기

결론

다음 단계

Concepts

Build

Tutorials

RPC

Tools

Resources

소개​

뼈대 컨트랙트 수정​

컨트랙트에 정보 저장​

컨트랙트 구조​

초기화 함수​

메타데이터 및 토큰 정보​

컨트랙트 메타데이터 쿼리를 위한 함수​

발행 로직​

스토리지 구현​

토큰 정보 쿼리​

온체인에서 컨트랙트와 상호 작용​

컨트랙트 배포​

컨트랙트 메타데이터 보기​

첫 NFT 발행​

NFT에 대한 정보 보기​

지갑에서 NFT 보기​

결론​

다음 단계​

소개

뼈대 컨트랙트 수정

컨트랙트에 정보 저장

컨트랙트 구조

초기화 함수

메타데이터 및 토큰 정보

컨트랙트 메타데이터 쿼리를 위한 함수

발행 로직

스토리지 구현

토큰 정보 쿼리

온체인에서 컨트랙트와 상호 작용

컨트랙트 배포

컨트랙트 메타데이터 보기

첫 NFT 발행

NFT에 대한 정보 보기

지갑에서 NFT 보기

결론

다음 단계