PiPi는 Story에서 무료로 Ippy, Story의 공식 마스코트의 파생 작품을 민팅할 수 있게 해주는 생성형 pfp 프로젝트입니다. Ippy에는 Non-Commercial Social Remixing (NCSR) 조건이 붙어 있어, 상업적으로 사용되지 않고 적절한 출처 표시가 이루어지는 한 누구나 사용하거나 파생 작품을 만들 수 있습니다.

원본 Ippy

우리의 탐색기에서 원본 Ippy 마스코트를 확인하세요.

PiPi 파생작

우리의 탐색기에서 PiPi 파생작을 확인하세요.

PiPi 계약 보기

PiPi 계약 소스 코드를 확인하세요.

PiPi가 Ippy의 파생작으로 연결되면 자동으로 동일한 라이선스 조건(NCSR)을 상속받고 그 계보 그래프에 연결되며, 이는 우리의 탐색기에서 직접 확인할 수 있습니다:

오른쪽 하단에서 Ippy가 이 PiPi의 루트 IP임을 확인할 수 있습니다.

다음 튜토리얼에서는 이 PiPi 이미지들이 어떻게 정확히 공식 Ippy IP의 파생작으로 적절히 등록되었는지 배우게 될 것입니다.

​
전제 조건

튜토리얼을 시작하기 전에 완료해야 할 몇 가지 단계가 있습니다.

  1. 다음을 완료하세요 자신의 프로젝트 설정하기

​
1. 메타데이터 설정

새로운 PiPi IP를 등록하기 전에 메타데이터를 설정해야 합니다. 두 가지 유형의 메타데이터가 있습니다:

  1. NFT 메타데이터
  2. IP 메타데이터

NFT vs. IP 메타데이터

NFT와 IP 메타데이터를 올바르게 설정하는 방법을 배우세요.

다음 PiPi를 예로 들어, NFT & IP 메타데이터는 다음과 같아야 합니다:

{
  "name": "PiPi NFT #1103",
  "image": "https://ipfs.io/ipfs/bafybeigsv4cgacndijwy6b7qhxbseonrybrcpbh47zrlm64gsjm4mlpb2q/nft_1103.jpeg",
  "attributes": [
    {
      "trait_type": "Bg",
      "value": "Orange"
    },
    {
      "trait_type": "Body",
      "value": "Pink"
    },
    {
      "trait_type": "Eyes",
      "value": "Cute"
    },
    {
      "trait_type": "Cloth",
      "value": "Blue"
    },
    {
      "trait_type": "Glasses",
      "value": "Neo"
    },
    {
      "trait_type": "Hat",
      "value": "Duck"
    }
  ],
  "description": "Pipi - The first Derivative IP Asset NFT collection on Story Protocol. Limited 2222 generative PFPs inspired by the Ippy, official Story mascot."
}

메타데이터를 작성한 후에는 IPFS에 업로드하고 나중에 NFT를 민팅할 때 설정할 수 있습니다.

​
2. NFT 민팅하기

Story에 IP를 등록하려면 먼저 NFT를 민팅해야 합니다. 이 NFT는 소유권을 나타냅니다 IP 자산의.

PiPi 계약 보기

PiPi 계약 소스 코드를 확인하세요.

다음은 _mintNFT 함수의 일부입니다 PiPi.sol contract:

PiPi.sol
contract PiPi is ERC721, Ownable, IERC721Receiver {

  // ... some code here ...

  function whitelistMint() external payable returns (string memory, address) {
    require(whitelistMintEnabled, "Whitelist mint is not active");
    require(whitelist[msg.sender], "Address not whitelisted");
    require(mintedCount[msg.sender] < WHITELIST_MAX_P_WALLET, "Whitelist mint limit reached");
    require(_totalSupply < MAX_SUPPLY, "Max supply reached");

    return _mintNFT(msg.sender);
  }

  function _mintNFT(address recipient) internal returns (string memory, address) {
    uint256 newTokenId = _totalSupply + 1;
    _safeMint(address(this), newTokenId);

    address ipId = _registerAsIPAsset(newTokenId);

    string memory nftUri = tokenURI(newTokenId);
    bytes32 metadataHash = keccak256(abi.encodePacked(nftUri));
    CORE_METADATA_MODULE.setAll(ipId, nftUri, metadataHash, metadataHash);

    registerDerivativeForToken(ipId);

    _safeTransfer(address(this), recipient, newTokenId, "");

    // ... more code here ...

    return (nftUri, ipId);
  }
}

보시다시피, 사용자가 whitelistMint를 호출하면 _mintNFT를 호출합니다. 사용자가 화이트리스트에 있는지 확인한 후에요. 16번 줄에서 우리는 계약에 새로운 NFT를 민팅하고 있습니다.

왜 우리는 NFT를 사용자가 아닌 계약에 민팅하나요?

나중에 IP를 Ippy의 파생작으로 등록해야 합니다. 오직 소유자(NFT를 보유한 주소)만이 IP를 다른 IP의 파생작으로 등록할 수 있습니다. 따라서 우리는 NFT를 계약에 민팅 => 계약이 NFT를 IP로 등록하고 나중에 Ippy의 파생작으로 등록 => NFT를 사용자에게 전송하는 순서로 진행합니다.

​
3. NFT를 IP로 등록하기

새로운 NFT를 민팅한 후에는 이를 IP로 등록할 수 있습니다. 위의 18번 줄에서 _registerAsIPAsset function:

PiPi.sol
function _registerAsIPAsset(uint256 tokenId) internal returns (address) {
  try IP_ASSET_REGISTRY.register(block.chainid, address(this), tokenId) returns (address ipId) {
    require(ipId != address(0), "IP Asset registration failed");
    return ipId;
  } catch Error(string memory reason) {
    revert(reason);
  } catch {
    revert("IP Asset registration failed");
  }
}

이 모든 것은 register 함수를 IP Asset Registry에서 호출하는 것입니다. 이는 새로운 IP Asset을 우리 프로토콜에 생성하고, ipId를 반환합니다.

​
4. IP에 메타데이터 설정하기

이제 새로운 IP 자산을 등록했으니, 이전에 만든 메타데이터를 CoreMetadataModule.sol를 사용하여 NFT & IP에 설정할 수 있습니다. 여기에서 설명한 대로, 우리는 4개의 매개변수를 설정해야 합니다:

  1. nftMetadataHash
  2. nftMetadataURI
  3. ipMetadataHash
  4. ipMetadataURI
PiPi.sol
// handles the NFT's `nftMetadataHash`
// handles the IP's `ipMetadataURI` and `ipMetadataHash`
function _mintNFT(address recipient) internal returns (string memory, address) {

  // ... some code here ...

  string memory nftUri = tokenURI(newTokenId);
  bytes32 metadataHash = keccak256(abi.encodePacked(nftUri));
  CORE_METADATA_MODULE.setAll(ipId, nftUri, metadataHash, metadataHash);

  // ... some code here ...

}

// handles the NFT's `nftMetadataURI`
function tokenURI(uint256 tokenId) public view override returns (string memory) {
  return string(abi.encodePacked(_baseUri, StringUtils.uint2str(tokenId), ".json"));
}

​
5. 파생작으로 등록하기

이제 NFT를 민팅하고, IP로 등록하고, 적절한 메타데이터를 설정했으니, Ippy의 파생작으로 등록할 수 있습니다. PiPi.sol 계약은 registerDerivativeForToken를 사용하여 이를 처리합니다:

PiPi.sol
function registerDerivativeForToken(address ipId) internal {
  address[] memory parentIpIds = new address[](1);
  parentIpIds[0] = 0xB1D831271A68Db5c18c8F0B69327446f7C8D0A42;

  uint256[] memory licenseTermsIds = new uint256[](1);
  licenseTermsIds[0] = 1;

  address licenseTemplate = 0x2E896b0b2Fdb7457499B56AAaA4AE55BCB4Cd316;
  bytes memory royaltyContext = hex"0000000000000000000000000000000000000000";
  uint256 maxMintingFee = 0;
  uint32 maxRts = 0;
  uint32 maxRevenueShare = 0;

  LICENSING_MODULE.registerDerivative(
    ipId,
    parentIpIds,
    licenseTermsIds,
    licenseTemplate,
    royaltyContext,
    maxMintingFee,
    maxRts,
    maxRevenueShare
  );
}

이 함수는 registerDerivative를 호출합니다 라이선싱 모듈, 다음과 함께:

  • ipId: 3단계에서 얻은 새로운 ipId
  • parentIpIds: Ippy의 를 포함하는 배열ipId, 이는 0xB1D831271A68Db5c18c8F0B69327446f7C8D0A42
  • licenseTermsIds: 를 포함하는 배열1, 이는 의 라이선스 조건 ID입니다Non-Commercial Social Remixing (NCSR). 이는 파생작이 Ippy를 무료로 사용할 수 있지만 상업화할 수 없음을 의미합니다
  • licenseTemplate: 의 주소PILicenseTemplate, 에서 찾을 수 있음배포된 스마트 컨트랙트
  • royaltyContext: 그냥 제로 주소로 설정
  • maxMintingFee, maxRts, 그리고 maxRevenueShare 는 0으로 설정할 수 있습니다. 라이선스 조건이 비상업적이기 때문에 이들은 아무 작용을 하지 않습니다.

​
6. NFT 전송

이제 컨트랙트가 IP를 파생작으로 등록하는 것을 처리했으므로, PiPi IP에 대한 소유권을 갖도록 사용자에게 NFT를 전송합니다:

PiPi.sol
function _mintNFT(address recipient) internal returns (string memory, address) {
  // ... some code here ...
  _safeTransfer(address(this), recipient, newTokenId, "");
  // ... some code here ...
}

​
7. 완료!

축하합니다, 공식 Ippy IP의 파생작을 등록했습니다!

Explorer에서 보기

우리의 explorer에서 파생 PiPi를 확인하세요.

더 알아보기

우리의 문서에서 더 많은 튜토리얼을 탐험해보세요

PiPi는 Story에서 무료로 Ippy, Story의 공식 마스코트의 파생 작품을 민팅할 수 있게 해주는 생성형 pfp 프로젝트입니다. Ippy에는 Non-Commercial Social Remixing (NCSR) 조건이 붙어 있어, 상업적으로 사용되지 않고 적절한 출처 표시가 이루어지는 한 누구나 사용하거나 파생 작품을 만들 수 있습니다.

원본 Ippy

우리의 탐색기에서 원본 Ippy 마스코트를 확인하세요.

PiPi 파생작

우리의 탐색기에서 PiPi 파생작을 확인하세요.

PiPi 계약 보기

PiPi 계약 소스 코드를 확인하세요.

PiPi가 Ippy의 파생작으로 연결되면 자동으로 동일한 라이선스 조건(NCSR)을 상속받고 그 계보 그래프에 연결되며, 이는 우리의 탐색기에서 직접 확인할 수 있습니다:

오른쪽 하단에서 Ippy가 이 PiPi의 루트 IP임을 확인할 수 있습니다.

다음 튜토리얼에서는 이 PiPi 이미지들이 어떻게 정확히 공식 Ippy IP의 파생작으로 적절히 등록되었는지 배우게 될 것입니다.

​
전제 조건

튜토리얼을 시작하기 전에 완료해야 할 몇 가지 단계가 있습니다.

  1. 다음을 완료하세요 자신의 프로젝트 설정하기

​
1. 메타데이터 설정

새로운 PiPi IP를 등록하기 전에 메타데이터를 설정해야 합니다. 두 가지 유형의 메타데이터가 있습니다:

  1. NFT 메타데이터
  2. IP 메타데이터

NFT vs. IP 메타데이터

NFT와 IP 메타데이터를 올바르게 설정하는 방법을 배우세요.

다음 PiPi를 예로 들어, NFT & IP 메타데이터는 다음과 같아야 합니다:

{
  "name": "PiPi NFT #1103",
  "image": "https://ipfs.io/ipfs/bafybeigsv4cgacndijwy6b7qhxbseonrybrcpbh47zrlm64gsjm4mlpb2q/nft_1103.jpeg",
  "attributes": [
    {
      "trait_type": "Bg",
      "value": "Orange"
    },
    {
      "trait_type": "Body",
      "value": "Pink"
    },
    {
      "trait_type": "Eyes",
      "value": "Cute"
    },
    {
      "trait_type": "Cloth",
      "value": "Blue"
    },
    {
      "trait_type": "Glasses",
      "value": "Neo"
    },
    {
      "trait_type": "Hat",
      "value": "Duck"
    }
  ],
  "description": "Pipi - The first Derivative IP Asset NFT collection on Story Protocol. Limited 2222 generative PFPs inspired by the Ippy, official Story mascot."
}

메타데이터를 작성한 후에는 IPFS에 업로드하고 나중에 NFT를 민팅할 때 설정할 수 있습니다.

​
2. NFT 민팅하기

Story에 IP를 등록하려면 먼저 NFT를 민팅해야 합니다. 이 NFT는 소유권을 나타냅니다 IP 자산의.

PiPi 계약 보기

PiPi 계약 소스 코드를 확인하세요.

다음은 _mintNFT 함수의 일부입니다 PiPi.sol contract:

PiPi.sol
contract PiPi is ERC721, Ownable, IERC721Receiver {

  // ... some code here ...

  function whitelistMint() external payable returns (string memory, address) {
    require(whitelistMintEnabled, "Whitelist mint is not active");
    require(whitelist[msg.sender], "Address not whitelisted");
    require(mintedCount[msg.sender] < WHITELIST_MAX_P_WALLET, "Whitelist mint limit reached");
    require(_totalSupply < MAX_SUPPLY, "Max supply reached");

    return _mintNFT(msg.sender);
  }

  function _mintNFT(address recipient) internal returns (string memory, address) {
    uint256 newTokenId = _totalSupply + 1;
    _safeMint(address(this), newTokenId);

    address ipId = _registerAsIPAsset(newTokenId);

    string memory nftUri = tokenURI(newTokenId);
    bytes32 metadataHash = keccak256(abi.encodePacked(nftUri));
    CORE_METADATA_MODULE.setAll(ipId, nftUri, metadataHash, metadataHash);

    registerDerivativeForToken(ipId);

    _safeTransfer(address(this), recipient, newTokenId, "");

    // ... more code here ...

    return (nftUri, ipId);
  }
}

보시다시피, 사용자가 whitelistMint를 호출하면 _mintNFT를 호출합니다. 사용자가 화이트리스트에 있는지 확인한 후에요. 16번 줄에서 우리는 계약에 새로운 NFT를 민팅하고 있습니다.

왜 우리는 NFT를 사용자가 아닌 계약에 민팅하나요?

나중에 IP를 Ippy의 파생작으로 등록해야 합니다. 오직 소유자(NFT를 보유한 주소)만이 IP를 다른 IP의 파생작으로 등록할 수 있습니다. 따라서 우리는 NFT를 계약에 민팅 => 계약이 NFT를 IP로 등록하고 나중에 Ippy의 파생작으로 등록 => NFT를 사용자에게 전송하는 순서로 진행합니다.

​
3. NFT를 IP로 등록하기

새로운 NFT를 민팅한 후에는 이를 IP로 등록할 수 있습니다. 위의 18번 줄에서 _registerAsIPAsset function:

PiPi.sol
function _registerAsIPAsset(uint256 tokenId) internal returns (address) {
  try IP_ASSET_REGISTRY.register(block.chainid, address(this), tokenId) returns (address ipId) {
    require(ipId != address(0), "IP Asset registration failed");
    return ipId;
  } catch Error(string memory reason) {
    revert(reason);
  } catch {
    revert("IP Asset registration failed");
  }
}

이 모든 것은 register 함수를 IP Asset Registry에서 호출하는 것입니다. 이는 새로운 IP Asset을 우리 프로토콜에 생성하고, ipId를 반환합니다.

​
4. IP에 메타데이터 설정하기

이제 새로운 IP 자산을 등록했으니, 이전에 만든 메타데이터를 CoreMetadataModule.sol를 사용하여 NFT & IP에 설정할 수 있습니다. 여기에서 설명한 대로, 우리는 4개의 매개변수를 설정해야 합니다:

  1. nftMetadataHash
  2. nftMetadataURI
  3. ipMetadataHash
  4. ipMetadataURI
PiPi.sol
// handles the NFT's `nftMetadataHash`
// handles the IP's `ipMetadataURI` and `ipMetadataHash`
function _mintNFT(address recipient) internal returns (string memory, address) {

  // ... some code here ...

  string memory nftUri = tokenURI(newTokenId);
  bytes32 metadataHash = keccak256(abi.encodePacked(nftUri));
  CORE_METADATA_MODULE.setAll(ipId, nftUri, metadataHash, metadataHash);

  // ... some code here ...

}

// handles the NFT's `nftMetadataURI`
function tokenURI(uint256 tokenId) public view override returns (string memory) {
  return string(abi.encodePacked(_baseUri, StringUtils.uint2str(tokenId), ".json"));
}

​
5. 파생작으로 등록하기

이제 NFT를 민팅하고, IP로 등록하고, 적절한 메타데이터를 설정했으니, Ippy의 파생작으로 등록할 수 있습니다. PiPi.sol 계약은 registerDerivativeForToken를 사용하여 이를 처리합니다:

PiPi.sol
function registerDerivativeForToken(address ipId) internal {
  address[] memory parentIpIds = new address[](1);
  parentIpIds[0] = 0xB1D831271A68Db5c18c8F0B69327446f7C8D0A42;

  uint256[] memory licenseTermsIds = new uint256[](1);
  licenseTermsIds[0] = 1;

  address licenseTemplate = 0x2E896b0b2Fdb7457499B56AAaA4AE55BCB4Cd316;
  bytes memory royaltyContext = hex"0000000000000000000000000000000000000000";
  uint256 maxMintingFee = 0;
  uint32 maxRts = 0;
  uint32 maxRevenueShare = 0;

  LICENSING_MODULE.registerDerivative(
    ipId,
    parentIpIds,
    licenseTermsIds,
    licenseTemplate,
    royaltyContext,
    maxMintingFee,
    maxRts,
    maxRevenueShare
  );
}

이 함수는 registerDerivative를 호출합니다 라이선싱 모듈, 다음과 함께:

  • ipId: 3단계에서 얻은 새로운 ipId
  • parentIpIds: Ippy의 를 포함하는 배열ipId, 이는 0xB1D831271A68Db5c18c8F0B69327446f7C8D0A42
  • licenseTermsIds: 를 포함하는 배열1, 이는 의 라이선스 조건 ID입니다Non-Commercial Social Remixing (NCSR). 이는 파생작이 Ippy를 무료로 사용할 수 있지만 상업화할 수 없음을 의미합니다
  • licenseTemplate: 의 주소PILicenseTemplate, 에서 찾을 수 있음배포된 스마트 컨트랙트
  • royaltyContext: 그냥 제로 주소로 설정
  • maxMintingFee, maxRts, 그리고 maxRevenueShare 는 0으로 설정할 수 있습니다. 라이선스 조건이 비상업적이기 때문에 이들은 아무 작용을 하지 않습니다.

​
6. NFT 전송

이제 컨트랙트가 IP를 파생작으로 등록하는 것을 처리했으므로, PiPi IP에 대한 소유권을 갖도록 사용자에게 NFT를 전송합니다:

PiPi.sol
function _mintNFT(address recipient) internal returns (string memory, address) {
  // ... some code here ...
  _safeTransfer(address(this), recipient, newTokenId, "");
  // ... some code here ...
}

​
7. 완료!

축하합니다, 공식 Ippy IP의 파생작을 등록했습니다!

Explorer에서 보기

우리의 explorer에서 파생 PiPi를 확인하세요.

더 알아보기

우리의 문서에서 더 많은 튜토리얼을 탐험해보세요