Asset

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

네트워크에 존재하는 자산에 해당하는 도메인입니다.

PropertyTypeDescriptionRequired
typestring자산의 타입.
native, contract로 구분됩니다.
required
contractstring컨트랙트 주소
자산이 contract타입인 경우 존재합니다.
conditional
symbolstring자산의 심볼required
namestring자산의 이름required
supplystring총 발행된 자산의 수량 (total supply)
자산이 contract타입의 fungible token인 경우 존재합니다.
conditional
decimalsinteger최소 자산의 수량 처리를 위한 decimal 정보
자산의 수량은 실제 보유 수량에 decimal을 곱한 값으로 표기됩니다.
optional
pathstring자산 리소스의 경로. 자산의 구분자로 사용 가능합니다.required

Token

Non-Fungible Token(NFT)에서 구분되어지는 각 토큰에 대한 정보를 나타내기 위한 도메인입니다. 각 토큰은 id값을 기준으로 구분되며 발행된 컨트랙트 주소와 결합하면 구분자로 사용 가능합니다.

PropertyTypeDescriptionRequired
idstring토큰의 IDrequired
uristringNFT의 원본 메타데이터의 위치.required
namestring토큰의 이름optional
descriptionstring토큰 상세optional