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을 전송하는 주소를 특정할 수 있습니다.
POST
listNftTransferByContract- 특정 컨트랙트에서 발행한 NFT 전송 이력을 조회할 수 있습니다.
POST
listNftTransferByTokenId- TokenId를 이용하여 특정 NFT 전송 이력을 조회할 수 있습니다.
Domain
Transfer
Transfer 실행 시 필요한 정보를 나타내기 위한 도메인입니다. Transfer를 위한 Transaction의 구조는 항상 표와 같으며 Data 필드에 입력되는 값에 따라 컨트랙트의 Method를 실행할 수 있습니다.
Property | Type | Description | Required |
---|---|---|---|
from | string | 수신자 주소 | required |
to | string | 발신자 주소 | required |
nonce | integer | 트랜잭션 중복을 방지하기 위한 발신자 주소의 Counter | required |
gasPrice | string | 트랜잭션 실행을 위한 gas의 가격 | required |
gasLimit | string | 트랜잭션 실행 시 필요한 최대 gas 소모량 | required |
data | string | 컨트랙트 Method를 실행하기 위한 필드 | optional |
value | integer | 전송할 ETH의 양 | optional |