Transfer

Overview

네트워크에 존재하는 ERC-20과 ERC-721, ERC0-1155 기반의 자산에 대한 전송 이력을 조회할 수 있습니다. 향후 새로운 형태의 자산이 정의됨에 따라 향후 추가될 수 있습니다.


Transfer란

코인이나 토큰 등, 자산을 전송하는 트랜잭션을 의미합니다. 이더리움으로 예로 들면, ETH를 전송하는 트랜잭션, ERC-20 기반의 Fungible Token, ERC-721, ERC-1155 등을 기반으로 하는 Non-Fungible Token(NFT) 등을 전송하는 트랜잭션이 Transfer 입니다. ETH의 경우, 소유자 계정 정보, 수량 등의 상태 정보가 Account Level에서 관리되며 Fungible Token, NFT 등 컨트랙트 기반 자산의 경우, 상태 정보가 해당 컨트랙트 내에서 관리됩니다. ETH를 전송하는 트랜잭션이나 컨트랙트 기반의 자산을 전송하는 트랜잭션은 모두 동일한 구조로 구성되어 있으며 자세한 구조는 아래에 작성된 Domain 파트에서 확인할 수 있습니다.


Usecases

  • POST listTokenTransferByAccount
    • 특정 주소로부터 이체되거나 특정 주소로 전송된 ERC-20의 이력을 조회할 수 있습니다.
    • 조건에 따라, Token을 전송받는 주소, Token을 전송하는 주소를 특정할 수 있습니다.
  • POST listTokenTransferByContract
    • 특정 컨트랙트의 Token 전송 이력을 조회할 수 있습니다.
  • POST listNftTransferByAccount
    • 특정 주소로 부터 전송되거나 특정 주수로 전송된 NFT의 이력을 조회할 수 있습니다.
    • 조건에 따라, Token을 전송받는 주소, Token을 전송하는 주소를 특정할 수 있습니다.
  • POSTlistNftTransferByContract
    • 특정 컨트랙트에서 발행한 NFT 전송 이력을 조회할 수 있습니다.
  • POSTlistNftTransferByTokenId
    • TokenId를 이용하여 특정 NFT 전송 이력을 조회할 수 있습니다.

Domain

Transfer

Transfer 실행 시 필요한 정보를 나타내기 위한 도메인입니다. Transfer를 위한 Transaction의 구조는 항상 표와 같으며 Data 필드에 입력되는 값에 따라 컨트랙트의 Method를 실행할 수 있습니다.

PropertyTypeDescriptionRequired
fromstring수신자 주소required
tostring발신자 주소required
nonceinteger트랜잭션 중복을 방지하기 위한 발신자 주소의 Counterrequired
gasPricestring트랜잭션 실행을 위한 gas의 가격required
gasLimitstring트랜잭션 실행 시 필요한 최대 gas 소모량required
datastring컨트랙트 Method를 실행하기 위한 필드optional
valueinteger전송할 ETH의 양optional