로열티
이 튜토리얼에서는 대체 불가능 토큰(NFT) 스마트 컨트랙트를 계속 구축하고, NFT에 영구 로열티를 구현하는 방법을 배웁니다. 이를 통해 사람들은 NFT가 판매될 때 구매 가격의 일정 비율을 얻을 수 있습니다.
소개
지금쯤이면 로열티 지원을 제외하고는 완전한 NFT 컨트랙트가 있어야 합니다. 시작하려면 GitHub 레퍼지토리에서 5.approval 브랜치로 전환하거나 이전 튜토리얼에서 작업을 계속하십시오.
git checkout 5.approval
6.royalty 브랜치를 확인해 보세요. :::문제에 대한 생각
로열티 기능을 구현하려면, 먼저 NFT 판매 방식을 이해해야 합니다. 이전 튜토리얼에서는, NFT를 가진 사람이 적절하게 디코딩할 수 있는 메시지를 전달하여 nft_approve 함수를 통해 마켓플레이스에 NFT를 리스팅하는 것을 보았습니다. 사용자가 마켓플레이스에서 NFT를 구매하면 어떤 일이 일어나나요?
지금 가지고 있는 지식을 사용했을 때의 합리적인 결론은, 마켓플레이스가 교차 컨트랙트 호출(cross-contract call)을 수행하여 NFT를 구매자에게 전송하고, NFT 컨트랙트의 nft_transfer 메서드를 호출하는 것입니다. 해당 함수가 완료되면, 마켓플레이스는 구매자가 지불한 정확한 금액을 판매자에게 지불합니다.
이제 판매자가 아닌 다른 계정으로 가는 금액을 삭감할 수 있도록 확장할 수 있는 방법에 대해 생각해 보겠습니다.
현재 솔루션 확장
영구 로열티는 토큰 기준이므로, Token 및 JsonToken 구조체를 변경해야 한다고 가정하는 것이 안전합니다. 즉, 로열티가 있는 각 계정이 가져가는 비율을 추적할 수 있는 방법이 필요합니다. 정수에 계정을 연결하는 맵을 도입하면, 효과가 있을 것입니다.
이제 해당 정보를 마켓플레이스에 전달할 메서드가 필요합니다. 이 메서드는 이전 솔루션과 똑같이 NFT를 전송할 수 있어야 하지만, 마켓플레이스가 정확히 어떤 계정에 어떤 금액을 지불해야 하는지 알려주는 데에서 추가적인 이점이 있습니다. NFT를 전송하는 메서드를 구현한 다음, 전달된 잔액을 기준으로 정확히 어떤 계정이 지불되고 얼마의 금액을 지불하는지 계산하면 됩니다.
이는 로열티 표준이 설명하는 것입니다. 이제 이 동작을 도입하기 위해 스마트 컨트랙트로 이동하여 수정하겠습니다.
컨트랙트 수정
가장 먼저 해야 할 일은 로열티 정보를 구조체에 추가하는 것입니다. nft-contract/src/metadata.ts 파일을 열고 Token 및 JsonToken 구조체에 royalty를 추가합니다.
royalty: { [accountId: string]: number };
두 번째로, JsonToken 구조체에도 royalty를 추가합니다.
loading...
내부 헬퍼 함수
royaltyToPayout
To simplify the payout calculation, let's add a helper royaltyToPayout function to src/internal.ts. This will convert a percentage to the actual amount that should be paid. In order to allow for percentages less than 1%, you can give 100% a value of 10,000. This means that the minimum percentage you can give out is 0.01%, or 1. For example, if you wanted the account benji.testnet to have a perpetual royalty of 20%, you would insert the pair "benji.testnet": 2000 into the payout map.
loading...
royaltyToPayout 함수를 사용하여 royaltyPercentage에 2000이라는 값을, amountToPay에 1 NEAR라는 값을 전달하면 0.2 NEAR를 로열티로 반환할 것입니다.
로열티
nft_payout
이제 주어진 NFT에 대해 금액 또는 잔액이 지급될 계정을 확인하는 메서드를 구현해 보겠습니다. nft-contract/src/royalty.ts 파일을 열고 아래 표시된 대로 internalNftPayout 함수를 수정합니다.
loading...
이 함수는 토큰의 로열티 맵을 반복하여 잔액을 가져와, 이전에 생성한 royaltyToPayout 함수를 통해 잔액을 지불금으로 변환합니다. 이는 총 로열티에서 남은 금액을 토큰 소유자에게 제공할 것입니다. 그 예시로,
다음과 같이 로열티 필드가 있는 토큰이 있습니다.
Token {
owner_id: "damian",
royalty: {
"benji": 1000,
"josh": 500,
"mike": 2000
}
}
사용자가 nft_payout 토큰을 호출하고 1 NEAR의 금액을 전달하는 경우, 토큰의 로열티 필드를 반복하고 지불 객체에 다음을 삽입합니다.
Payout {
payout: {
"benji": 0.1 NEAR,
"josh": 0.05 NEAR,
"mike": 0.2 NEAR
}
}
맨 마지막에, 이는 damian을 지불 객체에 삽입하고, 그에게 1 NEAR - 0.1 - 0.05 - 0.2 = 0.65 NEAR를 전달할 것입니다.
nft_transfer_payout
지불금 계산 방법을 알았으므로, 이제 NFT를 전송하고 지불금을 마켓플레이스에 반환하는 함수를 만들 차례입니다.
loading...
영구 로열티
영구 로열티에 대한 지원을 추가하기 위해, src/mint.ts 파일을 편집해 보겠습니다. 먼저 영구 로열티에 대한 선택적인 매개변수를 추가합니다. 이는 NFT를 구매할 때 어떤 계정으로 가는 비율을 결정하는 것입니다. 또한 Token 객체에 넣을 로열티를 생성하고 삽입해야 합니다.
loading...
구조체 구현에 로열티 객체 추가
Token 및 JsonToken 구조체에 새 필드를 추가했으므로, 이에 따라 구현을 편집해야 합니다. nft-contract/src/internal.ts 파일로 이동해서, 새 Token 객체를 만드는 internalTransfer 함수 부분을 편집합니다.
loading...
완료되면 nft-contract/src/nft_core.ts 파일로 이동합니다. 거기서 internalNftToken의 구현을 수정해서, JsonToken가 새 로열티 정보를 다시 보내도록 해야 합니다.
loading...
그런 다음, CLI를 사용하여 새 nft_payout 함수를 쿼리하고 제대로 작동하는지 확인할 수 있습니다.
컨트랙트 배포
이전 튜토리얼에서 본 것처럼, 이와 같은 변경 사항을 추가하면 재배포할 때 문제가 발생합니다. 이러한 변경 사항은 다른 모든 토큰에 영향을 미치고, 상태는 새 코드에 의해 자동으로 상속될 수 없기 때문에 단순히 컨트랙트를 재배포하면 오류가 발생합니다. 이러한 이유로 새 하위 계정을 다시 만듭니다.
하위 계정 배포
다음 명령을 실행하여 초기 잔액이 25 NEAR인 하위 계정 royalty를 만듭니다.
near create-account royalty.$NFT_CONTRACT_ID --masterAccount $NFT_CONTRACT_ID --initialBalance 25
다음으로, 개발을 쉽게 하기 위해 환경 변수를 내보낼 수 있습니다.
export ROYALTY_NFT_CONTRACT_ID=royalty.$NFT_CONTRACT_ID
빌드 스크립트를 사용하여 이전 튜토리얼에서와 같이 컨트랙트 배포를 빌드합니다.
yarn build && near deploy --wasmFile build/nft.wasm --accountId $ROYALTY_NFT_CONTRACT_ID
초기화 및 발행
이는 새로운 컨트랙트이므로 토큰을 초기화하고 발행해야 합니다. 다음 명령을 사용하여 컨트랙트를 초기화합니다.
near call $ROYALTY_NFT_CONTRACT_ID init '{"owner_id": "'$ROYALTY_NFT_CONTRACT_ID'"}' --accountId $ROYALTY_NFT_CONTRACT_ID
다음으로 토큰을 발행해야 합니다. 이 명령을 실행하면 토큰 ID "royalty-token"로 토큰이 발행되고, 수신자가 새 계정이 됩니다. 또한 토큰이 판매될 때마다 영구 로열티를 받는 두 개의 계정을 포함한 맵을 전달합니다.
near call $ROYALTY_NFT_CONTRACT_ID nft_mint '{"token_id": "approval-token", "metadata": {"title": "Approval Token", "description": "testing out the new approval extension of the standard", "media": "https://bafybeiftczwrtyr3k7a2k4vutd3amkwsmaqyhrdzlhvpt33dyjivufqusq.ipfs.dweb.link/goteam-gif.gif"}, "receiver_id": "'$ROYALTY_NFT_CONTRACT_ID'", "perpetual_royalties": {"benjiman.testnet": 2000, "mike.testnet": 1000, "josh.testnet": 500}}' --accountId $ROYALTY_NFT_CONTRACT_ID --amount 0.1
열거(Enumeration) 함수 중 하나를 호출하여 모든 것이 제대로 진행되었는지 확인할 수 있습니다.
near view $ROYALTY_NFT_CONTRACT_ID nft_tokens_for_owner '{"account_id": "'$ROYALTY_NFT_CONTRACT_ID'", "limit": 10}'
그러면 다음과 유사한 출력이 반환됩니다.
[
{
"token_id": "approval-token",
"owner_id": "royalty.goteam.examples.testnet",
"metadata": {
"title": "Approval Token",
"description": "testing out the new approval extension of the standard",
"media": "https://bafybeiftczwrtyr3k7a2k4vutd3amkwsmaqyhrdzlhvpt33dyjivufqusq.ipfs.dweb.link/goteam-gif.gif"
},
"approved_account_ids": {},
"royalty": {
"josh.testnet": 500,
"benjiman.testnet": 2000,
"mike.testnet": 1000
}
}
]
이제 이 NFT의 전체 매출의 35%를 합산한 3개의 계정을 포함하는 로열티 필드가 어떻게 생겼는지 확인해 보실까요? 작동하는 것 같습니다! 화이팅 :)
NFT 지급
100 yoctoNEAR의 잔고가 주어졌을 때, "approval-token" NFT에 대한 지불금을 계산해 봅시다. nft_payout 함수로 전달되는 금액이 yoctoNEAR 단위로 표시될 것으로 예상된다는 점에 유의하는 것이 중요합니다.
near view $ROYALTY_NFT_CONTRACT_ID nft_payout '{"token_id": "approval-token", "balance": "100", "max_len_payout": 100}'
이 명령은 다음과 유사한 출력을 반환해야 합니다.
{
payout: {
'josh.testnet': '5',
'royalty.goteam.examples.testnet': '65',
'mike.testnet': '10',
'benjiman.testnet': '20'
}
}
NFT가 100 yoctoNEAR에 판매된 경우, josh는 5, benji는 20, mike는 10, 소유자(이 경우 royalty.goteam.examples.testnet)는 나머지 65를 받습니다.
결론
이 시점에서 마켓플레이스와 상호 작용하기 위해 완벽하게 작동하는 NFT 컨트랙트에 필요한 모든 것이 존재합니다. 구현할 수 있는 마지막 남은 표준은 이벤트 표준입니다. 이렇게 하면 인덱서는 호출되는 함수에 대해 알 수 있기에, 지갑의 수집품 탭을 채우는 데 사용할 수 있는 정보 등에 대해 추적하는 것을 더 쉽고 안정적으로 할 수 있게 됩니다.
