Account(Wallet)

Overview

블록체인 네트워크에서 계정(Account)은 Entity를 구분하는 주소로 사용됩니다. EVM계열의 네트워크에서 Entity는 네트워크에 참여하는 단위 주체(사용자)와 컨트랙트를 모두 포함하며, 이때 네트워크 외부에서 생성된 사용자의 계정 주소는 EOA(Externally Owned Address), 컨트랙트 배포를 통해 해당 컨트랙트에게 부여된 계정 주소는 CA(Contract Address)로 구분합니다.

모든 계정은 Native Token 또는 컨트랙트상에 존재하는 자산을 소유할 수 있으며 다른 계정으로 전송할 수 있습니다. EOA는 비대칭키의 키쌍 중 공개키로부터 기인하며, 해당 키의 소유자인 사용자는 키쌍 중 비밀키를 사용하여 트랜잭션을 서명 및 전송함으로서 해당 계정의 소유를 증명할 수 있습니다.

Multichain Web3 API에서 특정 계정 주소에 대한 잔고 및 자산 정보들은 계정 Path의 하위 리소스로 표기됩니다.

Usecases

  • GET listAccountBalance
    • 특정 계정 주소가 소유한 자산의 잔고 목록을 조회할 수 있습니다.
    • Native Token, 컨트랙트 자산(FT, NFT)의 잔고 조회를 지원합니다.
  • POST listMultiAccountsBalance
    • 입력한 다수의 계정 주소가 소유하고 있는 Native Token 잔고를 목록으로 조회할 수 있습니다.
  • GET listAccountTransactions
    • 특정 계정 주소로부터 전송되거나, 해당 계정 주소로 전송된 트랜잭션 목록을 조회할 수 있습니다.

Domain

Account

계정에 해당하는 도메인입니다. EOA와 CA를 모두 포함합니다.

PropertyTypeDescriptionRequired
addressstring계정 주소, 구분자required
pathstring해당 계정 리소스의 pathrequired

Balance

특정 계정의 잔고에 해당하는 도메인입니다. 자산의 정보와 수량, 토큰 목록을 포함합니다.

PropertyTypeDescriptionRequired
amountstring잔고에 해당하는 자산의 수량required
tokensarray:token잔고 내 Fungible Token, Non-Fungible Token의 목록
Token 도메인은 Token 페이지를 참고해주세요.
conditional
assetobject:asset자산에 대한 상세 정보
Asset 도메인은 Asset 페이지를 참고해주세요.
required