Token

Overview

네트워크에 존재하는 ERC-20 기반의 자산에 대한 소유자 계정 별 조회, 컨트랙트 별 Mint, Burn 이력 조회 등을 지원합니다. 향후 새로운 형태의 자산이 정의됨에 따라 향후 추가될 수 있습니다.

컨트랙트 기반의 자산이란, 스마트 컨트랙트상에서 발행된 자산을 의미합니다. EVM 계열의 체인상에 존재하는 ERC20 기반의 Fungible Token, ERC721, ERC1155 등을 기반으로 하는 Non-Fungible Token(NFT)등이 대표적인 컨트랙트 기반의 자산입니다. 컨트랙트 기반 자산의 특징은 자산의 총 발급 수량, 현재 해당 자산을 소유하고 있는 소유자 계정 정보 및 각 계정의 보유 수량 등의 상태 정보가 모두 해당 컨트랙트 내에서 관리된다는 것입니다. 따라서 모든 컨트랙트 기반의 자산은 도메인 내에서 컨트랙트 주소(CA)를 구분자로 가집니다.

Usecases

  • POST listTokenBalanceByOwner
    • 특정 주소가 소유한 ERC-20 Token에 대한 Balance를 조회할 수 있습니다.
  • POST listTokenBalanceByContract
    • 특정 컨트랙트가 소유한 ERC-20 Token에 대한 Balance를 조회할 수 있습니다.
  • POST getTokenAllowance
    • 특정 주소가 부여받은 ERC-20 Approval 권한의 개수를 조회할 수 있습니다.
  • POSTlistTokenMintByAccount
    • 특정 주소에서 발생한 Mint 트랜잭션의 이력을 조회할 수 있습니다.
  • POSTlistTokenMintByContract
    • 특정 컨트랙트 주소에서 발생한 Mint 트랜잭션의 이력을 조회할 수 있습니다.
  • POSTlistTokenBurnByAccount
    • 특정 주소에서 발생한 Burn 트랜잭션의 이력을 조회할 수 있습니다.
  • POSTlistTokenBurnByContract
    • 특정 컨트랙트 주소에서 발생한 Burn 트랜잭션의 이력을 조회할 수 있습니다.
  • POSTlistTokenMetadataBySymbols
    • ERC-20 Token의 Symbol을 이용하여 해당 컨트랙트의 Metadata 목록을 조회할 수 있습니다.
  • POSTlistTokenMetadataByContracts
    • 컨트랙트의 주소를 이용하여 해당 컨트랙트의 Metadata 목록을 조회할 수 있습니다.
  • POSTlistTokenPriceByContracts
    • 컨트랙트의 주소를 이용하여 해당 컨트랙트를 통해 발행 토큰의 가격과 24시간 동안의 가격 추이를 조회할 수 있습니다.

Domain

Token

ERC-20 Token에 해당하는 도메인입니다. Supply를 설정하여 최대 발행량을 정할 수 있으며 Decimals를 설정하여 자산의 최소 수량을 처리할 수 있습니다.

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