Comment on page
nft_token_table
NFT에 대한 상세정보 테이블입니다.
토큰 및 컬렉션 아이디, 토큰 이름 등의 기본적인 정보부터 image, attribute 등 tokenURI를 통해 가져온 metadata를 파싱한 컬럼들까지, '대체불가능한' 각 토큰의 주요 특징을 담고 있습니다.
컬럼명 | 설명 |
|---|---|
network
collection_id
token_id
nft_type | 토큰의 주요정보입니다.
network = [ethereum, klaytn, polygon, bnb] |
nft_name
external_url
image_url
s3_image_url
token_uri | token_info의 key를 파 싱하여 가져옵니다.
ex) token_info = {name: “ABC”, tags: “ABC” …} |
block_number | 해당 NFT에 대한 정보가 수집된 블럭의 번호를 의미합니다. |
minted_time | 해당 NFT가 발행(민트)된 시간을 의미합니다. |
token_uri | 토큰 URI를 의미합니다. |
ipfs | 탈중앙화 여부를 의미합니다. |
token_info | 해당 NFT의 metadata를 의미합니다. |
대부분의 토큰 민트 트랜잭션은 from 주소가 null address인 특징을 갖고 있습니다(민트함수를 새로 정의했거나, 인터널트랜잭션을 사용한 경우 등 예외있음). 크롤러는 민트 트랜잭션을 가려내 해당 트랜잭션이 발생한 시간을 'minted_time' 컬럼에 insert하고 있습니다.
NFT는 tokenURI를 반환하는 메소드를 포함합니다. 기본적으로 tokenURI()를 호출하여 가져올 수 있습니다.
*ERC721/1155 표준이므로 항상 있는것은 아닙니다.
*721은 tokenURI(), 1155는 uri()로 정의합니다.
ipfs(탈중앙화 저장소) 여부를 체크합니다. 아래와 같은 절차를 따릅니다.
tokenURI 확인 > 메타데이터 image_url 확인 > tokenURI 및 image_url 주소에 ipfs를 포함하는지 확인
*최근 'arweave' 를 이용하는 경우도 많아졌기에, 로직에 추가했습니다.
tokenURI는 정해진 규격이 없기 때문에 토큰마다 제각각 다른 형식으로 보입니다. 예를 들면 https://와 같은 프로토콜을 생략하는 경우가 있는데, 이런 경우 tokenURI에 접근할 수 없어 token_info 즉, metadata를 가져올 수 없습니다. 크롤러는 이러한 상황에서도 정상적으로 token_info를 받을 수 있게 설계되어 있습니다.
metadata(token_info)는 기본적으로 json 형식을 지켜야 하기때문에 크롤러는 해당 부분을 철저하게 검증합니다.
Last modified 3mo ago