Overview
네트워크에 존재하는 자산에 대한 정보와 현재 상태를 조회할 수 있습니다. 현재 자산은 크게 Native Token, 컨트랙트 기반의 Fungible Token, 컨트랙트 기반의 Non-Fungible Token(NFT)으로 구분되며 새로운 형태의 자산이 정의됨에 따라 향후 추가될 수 있습니다.
Native Token은 해당 네트워크의 가장 기초 통화로 사용되는 토큰을 의미합니다. 예를 들어, 이더리움 네트워크의 Native Token은 이더(ETH)로, 네트워크 내에서 가스비 지불의 수단 등으로 활용됩니다.
컨트랙트 기반의 자산이란, 스마트 컨트랙트상에서 발행된 자산을 의미합니다. EVM 계열의 체인상에 존재하는 ERC20 기반의 Fungible Token, ERC721, ERC1155 등을 기반으로 하는 Non-Fungible Token(NFT)등이 대표적인 컨트랙트 기반의 자산입니다. 컨트랙트 기반 자산의 특징은 자산의 총 발급 수량, 현재 해당 자산을 소유하고 있는 소유자 계정 정보 및 각 계정의 보유 수량 등의 상태 정보가 모두 해당 컨트랙트 내에서 관리된다는 것입니다. 따라서 모든 컨트랙트 기반의 자산은 도메인 내에서 컨트랙트 주소(CA)를 구분자로 가집니다.
Usecases
GET
getAssetMetadata- 특정 자산 정보를 조회할 수 있습니다. 컨트랙트 기반 자산인 경우 컨트랙트 주소를 입력합니다.
- Asset 도메인에 해당하는 정보가 반환됩니다.
GET
listNftAssetTokens- 특정 NFT 컨트랙트에서 발급된 토큰 목록을 조회할 수 있습니다.
GET
listAssetHolder- 특정 컨트랙트 자산의 모든 holder 계정 주소를 조회할 수 있습니다.
- 필터 옵션을 사용하여, 특정 Non-Fungible Token(NFT)의 현재 소유 계정 주소를 조회할 수 있습니다.
- 필터 옵션을 사용하여, 특정 계정 주소가 이 컨트랙트 자산의 holder인지 여부를 확인할 수 있습니다.
- 필터 옵션을 사용하여, 특정 계정 주소가 이 컨트랙트에서 발행된 특정 토큰의 현재 holder인지 여부를 확인할 수 있습니다.
Domain
Asset
네트워크에 존재하는 자산에 해당하는 도메인입니다.
Property | Type | Description | Required |
---|---|---|---|
type | string | 자산의 타입.native , contract 로 구분됩니다. | required |
contract | string | 컨트랙트 주소 자산이 contract 타입인 경우 존재합니다. | conditional |
symbol | string | 자산의 심볼 | required |
name | string | 자산의 이름 | required |
supply | string | 총 발행된 자산의 수량 (total supply) 자산이 contract 타입의 fungible token인 경우 존재합니다. | conditional |
decimals | integer | 최소 자산의 수량 처리를 위한 decimal 정보 자산의 수량은 실제 보유 수량에 decimal을 곱한 값으로 표기됩니다. | optional |
path | string | 자산 리소스의 경로. 자산의 구분자로 사용 가능합니다. | required |
Token
Non-Fungible Token(NFT)에서 구분되어지는 각 토큰에 대한 정보를 나타내기 위한 도메인입니다. 각 토큰은 id값을 기준으로 구분되며 발행된 컨트랙트 주소와 결합하면 구분자로 사용 가능합니다.
Property | Type | Description | Required |
---|---|---|---|
id | string | 토큰의 ID | required |
uri | string | NFT의 원본 메타데이터의 위치. | required |
name | string | 토큰의 이름 | optional |
description | string | 토큰 상세 | optional |