Skip to main content

소개

이 문서는 Quai Network의 Orchard 테스트넷에서 완전히 작동하는 NFT dApp을 구축하고 배포하는 방법을 보여줍니다.

필수 조건

계약을 배포하고 웹앱 프론트엔드를 구축하려면 몇 가지 도구와 종속성이 필요합니다. 사용할 주요 종속성에 대한 개요는 다음과 같습니다.

실습

오늘은 QUAI에서 NFT dApp을 구축하고 웹 인터페이스를 통해 상호 작용하며 민트 가격과 총 공급량과 같은 일부 속성을 관리할 것입니다. 이 가이드를 따를 때 최상의 경험을 위해 MacOS 또는 Linux에서 Chrome 브라우저를 사용하는 것을 권장합니다. 또한 터미널에서 작업하고 코드를 직접 편집하여 이 앱을 구축할 것이므로 아직 없다면 VSCode를 다운로드하고 설치하세요. 마지막으로 Node.js를 사용하여 웹앱을 구축할 것이므로 미리 설치하고 설정하는 것이 중요합니다.

자금이 있는 Quai 지갑 준비하기

이 앱을 구축하려면 자금이 있는 지갑이 필요합니다. pelaguswallet.io에서 Pelagus 지갑을 받고 faucet에서 테스트넷 Quai를 받을 수 있습니다.

개발 환경 설정

개발 작업을 위한 디렉토리를 만들어 보겠습니다.
이제 새 Next.js 앱을 초기화해 보겠습니다. 몇 가지 질문을 하는 다음 명령을 실행하세요. 아래 값을 사용할 수 있습니다.
npxcreate 초기화가 완료되면 앱 디렉토리로 이동하여 Quais.js와 Chakra UI를 설치해 보겠습니다. 프로젝트 이름이 “my-dapp”이라고 가정하지만 다른 이름을 사용했다면 해당 이름으로 교체하세요.
이제 이전에 만든 개발 폴더에서 hardhat-example 저장소를 복제하고 종속성을 설치해 보겠습니다.

NFT 계약 편집

Solidity 디렉토리의 계약 폴더에서 기본 제공되는 두 개의 샘플 계약(ERC20 및 ERC721)을 볼 수 있습니다. 이 예제에서는 dApp에서 사용하기 쉽도록 적응된 ERC721을 사용할 것입니다. VSCode 터미널 창에서 다음 명령을 실행하여 계약 이름을 변경하고 VSCode에서 엽니다.
엔터티 이름과 생성자를 업데이트해 보겠습니다. 먼저 이름을 TestERC721에서 MyNFT로 업데이트합니다.
다음으로 생성자 이름을 동일하게 업데이트합니다.
이제 계약이 dApp에 더 유용하도록 몇 가지 사용자 정의 기능을 추가해 보겠습니다. 엔터티 선언 후에 몇 개의 변수를 추가합니다.
이 코드는 MyNFT.sol 파일의 10번째 줄 다음에 배치되어야 합니다.
다음으로 변수를 설정하기 위해 생성자를 업데이트해 보겠습니다. 생성자에서 다음 줄을 추가합니다.
이제 민트 함수를 추가합니다. 계약의 끝에, 마지막 닫는 중괄호 바로 앞에 민트 함수를 추가합니다.
이렇게 하면 계약은 다음과 같이 보일 것입니다.
좋습니다! 마지막 단계는 민트 가격과 최대 공급량을 업데이트하는 함수를 추가하는 것입니다. 그런 다음 출금 함수도 추가하여 NFT 판매에서 자금을 출금할 수 있게 할 것입니다. 다음 함수를 민트 함수 뒤에 추가합니다.
완료되면 이렇게 보여야 합니다.
그게 다입니다! 이제 계약을 배포할 준비가 되었습니다. Ctrl+S(또는 Mac에서는 Cmd+S)를 눌러 파일을 저장하는 것을 잊지 마세요. 자신의 이미지를 NFT에 사용하려면 IPFS에 이미지와 메타데이터를 업로드해야 합니다. 스마트 계약 확인 페이지에서 이 작업을 수행하는 방법에 대한 자세한 정보를 찾을 수 있습니다. 이 가이드의 목적상 여기에서 사용할 수 있는 이미지가 있습니다.

계약 배포

계약을 배포하려면 Hardhat이 필요하며 배포 스크립트와 구성 파일도 필요합니다. Hardhat 구성 파일 설정부터 시작하겠습니다. hardhat-example 저장소의 루트에는 환경 변수를 안전하게 보관하는 .env.dist 파일이 있습니다. 이것을 .env 파일로 복사해 보겠습니다.
이제 편집기에서 개인 키와 RPC URL을 추가할 수 있습니다. 계속하기 전에 MetaMask, Koala Wallet, Pelagus 또는 다른 Quai 지갑에서 개인 키와 주소를 복사해야 합니다. 민트 함수에 대한 수수료와 가스를 지불하는 데 사용되므로 지갑에 테스트넷 QUAI가 있는지 확인하세요. .env 파일이 다음과 같이 보이도록 편집합니다.
파일을 저장하고 닫습니다. 다음으로 hardhat이 올바른 계약을 가져오도록 배포 스크립트를 업데이트합니다. 파일을 열어보겠습니다.
6번째 줄에서 다음과 같이 변경합니다.
Hardhat에게 계약을 컴파일하도록 지시해 보겠습니다.
이제 배포할 준비가 되었습니다!
배포 스크립트가 문제를 일으킨다면 환경 변수가 올바르게 설정되었는지, 종속성이 설치되었는지 확인하세요. 축하합니다! 당신은 방금 Quai 테스트넷에 NFT 계약을 배포했습니다! 계약 주소를 복사하여 안전한 곳에 보관하세요. 나중에 필요할 것입니다.

계약 확인

이제 계약을 Quaiscan 블록 탐색기에서 확인해 보겠습니다. 먼저 계약 ABI를 IPFS에 업로드하고 Quaiscan의 확인 페이지로 이동하여 계약을 확인해야 합니다. 스마트 계약 확인에 대한 자세한 내용은 이 가이드를 참조하세요.

프론트엔드 구축

이제 프론트엔드를 구축할 차례입니다! app.js 파일을 업데이트하여 시작해 보겠습니다. 먼저 기본 내용을 제거하고 상단에 필요한 가져오기를 추가합니다.
파일의 모든 내용을 다음으로 바꿉니다.
계약 ABI를 가져와야 합니다. VSCode의 새 터미널에서 다음을 실행합니다.
출력에서 "abi": [ 다음부터 마지막 ]까지(포함)를 복사하여 contractABI 변수에 붙여넣습니다. 또한 contractAddress 변수를 이전에 저장한 계약 주소로 업데이트하는 것을 잊지 마세요. 이제 컴포넌트에 기능을 추가해 보겠습니다. return 문 바로 앞에 다음 함수를 추가합니다.
이제 UI를 업데이트해 보겠습니다. return 문을 다음으로 교체합니다.

앱 실행하기

이제 앱을 실행할 준비가 되었습니다! VSCode의 터미널에서 다음을 실행합니다.
브라우저를 열고 http://localhost:3000으로 이동합니다. 다음과 같은 것을 볼 수 있을 것입니다.
지갑 연결 버튼을 클릭하고 지갑을 연결합니다. 연결되면 다음과 같이 보일 것입니다.
계약을 배포한 계정으로 연결했다면 소유자 컨트롤 섹션도 볼 수 있을 것입니다.
축하합니다! Quai에서 첫 번째 NFT dApp을 성공적으로 구축했습니다!

다음 단계

이 예제를 확장하는 몇 가지 방법은 다음과 같습니다.
  1. 커스텀 아트워크 추가: 자신만의 NFT 아트워크와 메타데이터를 IPFS에 업로드하고 계약의 baseURI를 업데이트합니다.
  2. 민트된 NFT 표시: 사용자가 민트한 NFT를 표시하는 갤러리 섹션을 추가합니다.
  3. 화이트리스트 기능: 특정 주소만 민트할 수 있는 화이트리스트 기능을 추가합니다.
  4. 개선된 UI: 애니메이션, 더 나은 스타일링, 반응형 디자인을 추가합니다.
  5. 메타데이터 온체인: 메타데이터를 온체인에 저장하여 완전히 분산화된 NFT를 만듭니다.
계속 구축하고 Quai에서 가능한 것의 한계를 탐험해보세요!