Alchemy의 Optimism NFT API에 대해 알아야 할 모든 것
작성자 Mrig
NFT 컬렉션이 Optimism에서 급증하고 있으며, 더 많은 개발자가 네트워크에서 새로운 NFT 앱을 구축하고 있습니다. 이러한 개발자들은 네트워크를 쿼리하고 사용자 데이터 요청을 처리하기 위해 NFT 메타데이터를 가져올 NFT API가 필요합니다. 적절한 NFT API가 없으면 NFT 메타데이터를 인덱싱하고 쿼리하는 작업이 개별 개발자에게 시간과 리소스를 많이 소모하는 작업이 됩니다.
Alchemy의 Optimism NFT API로 NFT 도구, 마켓플레이스, 앱 등을 구축하는 방법을 알아보세요.
Optimism의 NFT 생태계
Optimism은 옵티미스틱 롤업 인프라 위에서 실행되는 L2(레이어 2) Ethereum 스케일링 솔루션입니다. 옵티미스틱 롤업은 오프체인 트랜잭션을 처리함으로써 Ethereum의 부담을 줄이고, 더 높은 트랜잭션 처리량과 낮은 가스비를 제공합니다. 옵티미스틱 롤업은 여러 트랜잭션을 하나의 트랜잭션으로 묶어 Ethereum으로 다시 보내 검증받음으로써 네트워크 확장성을 높입니다.
Optimism에 내장된 확장성은 NFT 프로젝트를 개발하기에 이상적인 솔루션입니다. 사용자는 Optimism의 빠른 트랜잭션 속도와 저렴한 수수료를 통해 NFT 게임을 플레이하거나 수집품을 거래할 때 향상된 경험을 얻을 수 있습니다.
Optimism NFTScan 웹사이트에 따르면 Optimism에는 238,000개의 NFT 지갑에 걸쳐 100만 개 이상의 NFT 자산이 있으며, 개발자는 NFT 프로토콜을 구축하고 대량의 NFT와 상호작용하기 위해 적절한 도구 세트가 필요합니다. Alchemy의 Optimism NFT API는 개발자가 Optimism 생태계용 NFT 프로젝트를 구축하는 데 필요한 핵심 도구입니다.
Optimism NFT API란?
Optimism NFT API는 개발자가 L2 네트워크에서 정보를 즉시 가져올 수 있도록 돕습니다. 개발자는 Optimism NFT API를 통해 블록/트랜잭션 데이터를 읽고, 스마트 컨트랙트를 실행하고, 온체인 정보를 쿼리하고, 온체인에 데이터를 저장할 수 있습니다.
Alchemy는 JSON-RPC 표준 API를 사용해 Optimism의 탈중앙화 노드 인프라와 상호작용하는 개발자를 위한 멀티체인 NFT API를 제공합니다. Alchemy의 Optimism NFT API는 개발자가 더 높은 요청 처리량에 접근하고, 동시 요청 수를 늘리고, 무료 데이터 아카이브, 로그, 개별 사용량 지표를 사용할 수 있도록 지원합니다. 또한 이 솔루션은 ERC-721 및 ERC-1155 표준을 따르는 모든 NFT와, Ethereum의 표준화된 NFT 컨트랙트보다 앞서 존재한 일부 NFT를 지원합니다.
개발자는 또한 여러 코드 경로를 통해 광범위한 NFT와 그 메타데이터에 접근할 수 있습니다. Alchemy의 Optimism NFT API는 JSON, SVG, UTF-8 형식의 온체인 또는 오프체인 NFT, Pinata와 같은 IPFS 게이트웨이, 그리고 Base64로 인코딩된 이미지를 처리할 수 있습니다.
개발자는 Alchemy의 NFT API를 다음과 같은 용도로 사용할 수 있습니다:
- 사용자에게 NFT 표시
- NFT 마켓플레이스 개발
- NFT 분석 프로토콜 설계
- NFT 게임 애플리케이션 구축
- NFT 소유권 검증
Optimism NFT API는 어떻게 작동하나요?
Alchemy의 Optimism NFT API는 다음과 같은 메커니즘을 사용하여 높은 성능을 달성합니다: 이미지 캐싱, 스팸 필터, 이미지 리사이징, 명확한 오류 설명.
이미지 캐싱
개발자는 일반적으로 IPFS와 같은 탈중앙화 스토리지 제공업체 및 서드파티 서버와 상호작용하여 NFT 미디어 파일에 접근합니다. 그러나 긴 로딩 시간과 타임아웃 오류를 겪게 됩니다.
Alchemy는 Cloudinary로 NFT 이미지를 캐싱하기 때문에 빠른 로딩과 응답 속도를 제공하는 저지연 솔루션을 제공합니다. 따라서 Alchemy는 자체 캐시에서 NFT URL을 개발자에게 제공하여 응답 시간을 줄일 수 있습니다.
스팸 필터
원치 않는 스팸 NFT는 NFT 마켓플레이스, 갤러리, 분석 플랫폼에서 사기로 이어지고 사용자 경험을 저해할 수 있습니다. 개발자는 일반적으로 스팸 NFT를 필터링하기 위해 개별 스마트 컨트랙트를 읽고 파싱하여 NFT 메타데이터에 접근해야 합니다. 이 작업을 더 간단하게 만들기 위해 Alchemy는 다음과 같은 API 엔드포인트를 NFT 스팸 필터로 제공합니다:
- isSpamForContract - 스팸 NFT 스마트 컨트랙트를 확인합니다. 개발자는 스팸 NFT 소유자를 확인하기 위해 컨트랙트 주소를 필터링할 수도 있습니다.
- getSpamContracts - 특정 네트워크의 스팸 ERC-721 및 ERC-1155 스마트 컨트랙트 목록을 반환합니다.
개발자는 Alchemy의 스팸 필터를 사용하여 스팸 NFT를 소각 처리하거나 스팸 NFT를 보낸 지갑 주소를 플래그 처리할 수 있습니다. 2022년 8월까지 Alchemy NFT API는 5,000개의 스마트 컨트랙트를 스팸 NFT로 표시했습니다.
Alchemy는 다음 기준을 사용하여 스팸 NFT를 식별합니다:
- ERC-721 및 ERC-1155 토큰 표준을 위반함
- 토큰 전송 중 토큰 표준을 위반함
- vitalik.eth와 같은 허니팟 주소로 토큰을 발행함
- 전체 토큰 공급량에 대해 잘못된 데이터를 제공함
이미지 리사이징
NFT는 썸네일, 스마트폰, 데스크톱, 태블릿 뷰포트에 따라 다른 이미지 크기가 필요합니다. 개발자는 URL에 높이와 너비 픽셀의 조합을 추가하여 종횡비를 만듦으로써 Alchemy가 호스팅하는 NFT의 크기를 조정할 수 있습니다. 이를 통해 Alchemy는 NFT 개발자를 위한 이미지 리사이징을 더 쉽게 만들어줍니다.
NFT 오류
Alchemy의 NFT API는 대부분의 NFT 메타데이터를 반환하지만, 다음과 같은 경우에는 요청을 처리하지 못합니다:
- Token does not exist - Alchemy가 토큰 ID를 사용해 tokenURI/uri 메서드를 호출하지만, 스마트 컨트랙트가 이를 인식하지 못하는 경우입니다. 이는 토큰이 아직 발행되지 않았거나 존재하지 않음을 의미합니다.
- Malformed token URI - tokenURI/uri가 '잘못된 형식'이거나 유효하지 않은 웹사이트를 반환하여, 해당 웹사이트에 접근해 메타데이터를 반환할 수 없는 경우입니다.
- Failed to get token URI - 토큰이 존재하더라도 토큰 ID가 어떤 메타데이터도 반환하지 않을 때 나타나는 일반 오류 메시지입니다.
- Token URI returns a non-200 response code - 웹사이트가 다운되었거나 Alchemy 서버에 속도 제한을 거는 경우, URI가 '502 Bad Gateway' 메시지를 반환할 때 나타나는 오류입니다.
- Throttled token URI - Alchemy가 메타데이터를 너무 자주 요청하여 속도 제한에 걸렸음을 나타내는 '429 Too Many Requests' 메시지를 반환하는 오류입니다.
- Contract does not have any code - 토큰 주소에 블록체인 네트워크상 해당하는 스마트 컨트랙트 코드가 없을 때 나타나는 오류입니다.
- Contract returned a broken token URI, do not retry - 웹사이트 URL이 존재하지 않거나 DNS 설정이 없어서 tokenURI가 응답하지 않을 때 나타나는 오류 메시지입니다.
Optimism NFT API 지원 메서드
Alchemy의 Optimism NFT API는 다음 카테고리의 NFT API 엔드포인트를 통해 개발자가 Optimism NFT 앱을 구축하도록 돕습니다:
Optimism NFT 소유권 및 토큰 게이팅
- getNFTs - 지갑이 소유한 Optimism NFT 가져오기
- getOwnersForToken - 토큰의 Optimism 소유자 가져오기
- getOwnersForCollection - 컬렉션의 Optimism NFT 소유자 가져오기
- isHolderOfCollection - Optimism 지갑이 NFT를 보유하고 있는지 확인
- getNFTsForCollection - Optimism NFT 컬렉션의 NFT 가져오기
Optimism NFT 메타데이터
- getNFTMetadata - Optimism NFT 메타데이터 가져오기
- getContractMetadata - Optimism NFT 스마트 컨트랙트 메타데이터 가져오기
Optimism NFT API 예시
Alchemy의 getNFTs는 다재다능한 NFT API 엔드포인트이며, 개발자가 여러 NFT 프로토콜에서 이를 사용할 수 있게 해줍니다. getNFTs API 엔드포인트가 어떻게 작동하는지 이해하기 위해 다음 예시를 살펴보겠습니다.
1. Optimism 토큰 게이팅
개발자가 NFT 마켓플레이스를 구축할 때, 사용자가 소유한 NFT를 표시하는 사용자 프로필 페이지를 설계합니다. 개발자는 Optimism NFT 토큰 게이팅 도구인 isHolderOfCollection을 사용하여 특정 지갑 주소가 지정된 컬렉션의 특정 토큰을 보유하고 있는지 확인하여 NFT를 가져올 수 있습니다.
2. Optimism NFT 분석 도구
희귀도 순위 웹사이트나 애그리게이터와 같은 NFT 분석 도구는 목록을 생성하고 거래 데이터를 얻기 위해 NFT 메타데이터가 필요합니다. 개발자는 Optimism NFT 메타데이터 API인 getNFTMetadata를 사용하여 NFT 분석 도구에서 사용되는 온체인 메타데이터를 가져올 수 있습니다.
3. Optimism NFT 에어드랍 목록
NFT 프로젝트가 특정 NFT 소유자에게 새로운 NFT를 에어드랍하기 위해 개발자를 고용합니다. API가 없으면 개발자는 NFT 자산 소유권을 추적하기 위해 전체 블록체인을 파싱해야 합니다. 하지만 Alchemy의 Optimism NFT 컬렉션 API인 getOwnersForToken을 사용하면 개발자가 소유자를 즉시 식별하고 에어드랍 목록을 생성할 수 있습니다. 개발자는 또한 사용자가 특정 NFT를 프로필 사진으로 설정하고자 할 때 자산 소유권을 검증하기 위해 이 API를 사용할 수 있습니다.
Optimism NFT API로 구축을 시작하는 방법
자체 Optimism 노드를 운영하는 대신, Alchemy에서 프라이빗 Optimism 노드를 생성한 다음, Alchemy의 Optimism NFT API로 구축을 시작하기 위해 세 가지 간단한 단계를 따르면 됩니다:
- 패키지 관리자 선택 - npm이나 yarn과 같은 패키지 관리자를 사용합니다
- 저장소 설정 - 터미널을 열어 명령줄에서 퀵스타트 스크립트용 새 저장소를 생성합니다
- 라이브러리 선택 - Fetch, Axios, 또는 다른 표준 HTTP 라이브러리를 사용하여 Optimism NFT API와 상호작용합니다
개발자는 Fetch나 Axios로 Optimism NFT API를 직접 호출할 수 있습니다. 현재 엔드포인트 예시와 지원되는 메서드는 Alchemy의 문서를 참고하세요.
Alchemy와 함께 최고의 Optimism NFT API를 사용하세요
Bloomberg에 따르면 2021년 강세장 동안 NFT 시장은 400억 달러를 넘어섰습니다. 현재 NFT 부문은 힘든 약세장 국면을 겪고 있지만, NFT 기술은 향후 성장에 있어 상당한 잠재력을 가지고 있습니다.
따라서 빌더들은 확장 가능한 Optimism 네트워크에서 NFT 앱을 만들기 위해 적절한 NFT 개발자 도구가 필요할 것입니다. Alchemy에서 무료 계정을 생성하고 Alchemy의 무료 NFT API로 NFT 앱 구축을 시작하세요.
관련 개요
Web32024년 5월 29일
Key3 소개: 일본 최고의 Web3 교육 DAO
일본항공(Japan Airlines)과 일본 스낵 식품 기업 Calbee는 관광 촉진과 브랜드 충성도를 높이기 위해 NFT를 활용하고 있습니다.
Web32024년 5월 29일
Wavehack: 일본 최대 규모의 Web3 해커톤
WaveHack은 일본 최대 규모의 Web3 해커톤으로, 2024년 4월 중순부터 8월 말까지 진행됩니다.
Web32024년 5월 29일
일본의 Web3: 완벽 가이드
일본 정부가 어떻게 혁신을 가속화하고 있는지, 기업들이 블록체인 기술을 어떻게 활용하고 있는지 알아보세요.

블록체인 매직을 만드세요
Alchemy는 가장 강력한 Web3 개발자 제품 및 도구를 리소스, 커뮤니티, 그리고 전설적인 지원과 결합합니다.