NFT 마켓플레이스 스마트 계약 생성을 위한 단계별 가이드

핵심 아키텍처 이해

1. NFT 마켓플레이스 스마트 계약은 ERC-721 또는 ERC-1155 표준에 크게 의존하여 이더리움 호환 블록체인의 고유한 디지털 자산을 나타냅니다.

2. 계약서는 작성자가 가격, 통화 유형(ETH 또는 ERC-20 토큰) 및 판매 기간을 정의할 수 있는 목록 메커니즘을 통합해야 합니다.

3. 소유권 확인은 전송 또는 목록을 허용하기 전에 msg.sender 및 ownerOf(tokenId) 호출을 사용하여 온체인 확인을 통해 시행됩니다.

4. 2차 ​​판매 중에 제작자가 설정한 비율을 존중하기 위해 로열티 집행 모듈을 내장해야 하며 종종 EIP-2981 인터페이스를 활용합니다.

5. 승인되지 않은 기능 실행을 방지하기 위해 admin , minter , feeCollector 등의 역할을 통해 액세스 제어가 구현됩니다.

토큰 표준 선택 및 구현

1. ERC-721은 엄격한 일대일 토큰 매핑으로 인해 예술 작품이나 수집품과 같은 완전히 고유하고 대체 불가능한 항목에 대한 지배적인 선택으로 남아 있습니다.

2. ERC-1155는 단일 계약으로 여러 자산 유형을 처리할 때 효율성을 제공합니다. 이는 NFT와 반 대체 가능 게임 아이템을 모두 지원하는 마켓플레이스에 이상적입니다.

3. 개발자는 메타데이터 검색 및 일괄 작업을 지원하기 위해 OpenZeppelin의 ERC721Enumerable 또는 ERC1155URIStorage를 상속해야 합니다.

4. 메타데이터 URI는 오프체인에 저장되지만 온체인에서 참조됩니다. 계약은 URI 형식의 유효성을 검사해야 하며 승인된 주소로만 업데이트를 허용해야 합니다.

5. 발행된 각 토큰에는 충돌을 방지하고 불변성을 보장하기 위해 카운터 또는 해시 기반 체계를 통해 생성된 고유한 tokenId가 ​​필요합니다.

상장 및 거래 로직

1. 목록 구조에는 판매자 , 가격 , 통화 , 상태 및 만료 와 같은 필드가 포함됩니다.

2. 구매 기능은 단일 원자 트랜잭션에서 내부 잔액 확인, transferFrom 호출 및 수수료 분배 로직을 트리거합니다.

3. 제안 및 입찰은 시간 제한이 있는 수락 기간과 함께 tokenId 및 bidder 로 인덱싱된 매핑에 저장된 입찰 구조를 통해 관리됩니다.

4. 활성 목록을 취소하면 재진입이나 오래된 상태 악용을 방지하기 위해 이벤트를 발생시키고 저장소 슬롯을 재설정해야 합니다.

5. 모든 거래 기능에는 보안 보장을 유지하기 위해 nonReentrant 및 whenNotPaused 를 적용하는 수정자가 포함되어 있습니다.

수수료 관리 및 수익 배분

1. 플랫폼 수수료는 ETH 또는 스테이블코인으로 징수되며 거버넌스 또는 다중 서명에 의해 통제되는 전용 feeWallet 주소에 보관됩니다.

2. 수수료 비율은 10000(예: 2.5% = 250)으로 확장된 uint256 값으로 저장되므로 부동 소수점 연산 없이 정확한 계산이 가능합니다.

3. 로열티 지불은 로열티정보(tokenId, salePrice) , 반환 수신자 및 EIP-2981에 따른 금액을 사용하여 판매 후 실행됩니다.

4. 출금 기능은 지정된 feeCollector 역할에 대한 액세스를 제한하고 투명성과 오프체인 추적을 위한 이벤트 방출을 포함합니다.

5. 수수료 매개변수는 시간이 제한된 거버넌스 제안이나 명시적인 이벤트 로깅이 있는 소유자 전용 기능을 통해서만 업데이트할 수 있습니다.

보안 감사 및 배포 고려 사항

1. 재진입 보호, 정수 오버플로 보호 및 확인되지 않은 외부 호출 반환은 모든 지불 기능에서 필수입니다.

2. 가격 오라클에 대한 오라클 피드나 크로스체인 브릿지와 같은 외부 종속성은 알려진 보안 구현에 대해 검증되어야 합니다.

3. 계약 배포는 가능한 경우 CREATE2를 통해 결정론적 주소를 사용하므로 예측 가능한 프록시 업그레이드와 사전 저항이 가능합니다.

4. 모든 상태 변경 함수는 인덱싱 서비스를 위해 ItemListed , ItemSold 및 RoyaltyPaid 와 같은 표준화된 이벤트를 내보냅니다.

5. 사용자 트랜잭션 비용을 줄이기 위해 구조체 패킹, 스토리지에 대한 메모리 사용량, 루프 언롤링 등의 가스 최적화 기술이 적용됩니다.

자주 묻는 질문

Q: 이 계약을 수정 없이 Polygon이나 Arbitrum에 배포할 수 있나요? A: 예, 가스 한도와 같은 체인별 매개변수를 조정하고 해당 네트워크의 가상 머신을 지원하는 호환 가능한 OpenZeppelin 버전을 사용한다면 가능합니다.

Q: 발행 후 메타데이터 업데이트를 어떻게 처리합니까? A: 토큰 소유자 또는 관리자로 제한된 setTokenURI 함수를 구현하여 명시적으로 허용되지 않는 한 URI 불변성을 보장할 수 있습니다.

Q: 누군가가 자신이 소유하지 않은 NFT를 상장하는 것을 막는 것은 무엇입니까? A: 계약은 목록 요청을 수락하기 전에 ownerOf(tokenId) == msg.sender를 통해 소유권 확인을 시행합니다.

Q: ETH 대신 USDC나 DAI로 결제가 가능한가요? A: 예, ERC-20 승인 워크플로를 통합하고 소수점 및 전송 성공 여부를 확인하는 동시에 구매 기능 내에서 safeTransferFrom을 사용하면 됩니다.