Wallet API

Wallet API는 Klaytn 계정을 관리하는 API입니다. 이 API를 이용해 Klaytn 계정을 생성하면 개인키를 따로 관리할 필요가 없습니다. 키 관리의 중요성을 잘 알기에, 사용자의 편의성과 보안을 모두 고려해 안전한 지갑을 제공합니다. KAS가 제공하는 Wallet API로 키 관리는 잊고 계정과 트랜잭션을 관리해보세요. Wallet API의 기능은 다음과 같습니다.

  • 기본 계정 관리
    • 계정 생성/삭제/비활성화
    • 계정 목록 조회
    • 트랜잭션에 서명
    • 다중 서명 계정 업데이트
    • 계정 등록
  • 대납 계정 관리
    • 대납 계정 생성/삭제
    • 대납 계정 목록 조회
  • 기본 트랜잭션
    • 레거시 트랜잭션 생성
    • KLAY 전송
    • 컨트랙트 배포/실행/취소
    • 앵커링
    • 계정 업데이트
    • 컨트랙트 호출
  • KAS가 대납하는 트랜잭션
    • 글로벌 대납 KLAY 전송
    • 글로벌 대납 컨트랙트 배포/실행/취소
    • 글로벌 대납 앵커링
    • 글로벌 대납 계정 업데이트
  • 사용자가 대납하는 트랜잭션
    • 사용자 대납 KLAY 전송
    • 사용자 대납 컨트랙트 배포/실행/취소
    • 사용자 대납 앵커링
    • 사용자 대납 계정 업데이트
  • 다중 서명 트랜잭션
    • 보류 중인 트랜잭션 조회/서명
    • 준비된 서명값으로 트랜잭션 서명
  • 키 관리
    • 키 생성/삭제
    • 키 목록 조회
    • 키를 이용한 서명
  • 이력 관리
    • 대납 트랜잭션 내역 조회

계정

블록체인 애플리케이션을 개발한다면 아마도 그 애플리케이션은 블록체인에 트랜잭션을 보낼 것입니다. 블록체인에 트랜잭션을 보내는 주체를 계정이라고 하며 Klaytn에서 계정은 계정 주소(EOA, Externally Owned Account)라는 형태로 표현됩니다. Wallet API로 Klaytn에 트랜잭션을 보내거나, Token History API로 KLAY 또는 토큰을 전송한 기록을 조회하려면 Klaytn 계정이 반드시 필요합니다.

수수료 대납 계정과 오퍼레이터

Klaytn 계정은 KLAY를 보관, 전송, 수신할 수 있는 Klaytn 계정(=외부 사용자 계정, EOA)과 스마트 컨트랙트를 배포하면 생성되는 스마트 컨트랙트 계정으로 나뉩니다.

계정 저장소

KAS 계정은 여러 Klaytn 계정을 소유할 수 있습니다. KAS에서는 하나의 KAS 계정으로 여러 Klaytn 계정을 쉽고 편하게 관리하도록 Klaytn 계정들을 보관하는 계정 저장소를 제공합니다. 계정 저장소는 Klaytn 계정 유형마다 별도로 존재하며, 하나의 KAS 계정이 여러 저장소를 만들어 운영할 수 있습니다. KAS에서는 계정 역할에 따라 아래와 같은 계정 저장소 유형을 제공합니다.

  • 계정 저장소(Account Pool) : 일반적인 Klaytn 계정들을 관리하는 저장소
  • 수수료 대납 계정 저장소(Fee-payer Pool) : 수수료 대납 계정들을 관리하는 저장소

기본 계정 저장소

기본 계정 저장소란 KAS API를 호출 시 사용할 계정 저장소를 별도로 지정하지 않을 때 기본으로 사용하는 계정 저장소입니다. API를 호출 시 헤더의 x-krn에 사용할 계정 저장소의 KRN (KRN KAS Resource Name)을 입력하지 않으면 기본 계정 저장소에 있는 Klaytn 계정이 사용됩니다. 기본 계정 저장소는 KAS Console > Service > Wallet > Account Pools 페이지에서 확인할 수 있으며 DEFAULT 태그가 붙습니다.

가장 먼저 생성한 계정 저장소가 자동으로 기본 계정 저장소로 지정됩니다. 예를 들어, KAS Console에서 계정 저장소 A를 만들었다고 가정해 봅시다. 이후 API 호출 시 사용할 계정 저장소를 별도로 지정하지 않을 경우 A 계정 저장소에 있는 Klaytn 계정이 API 호출에 사용됩니다.

만약 계정 저장소가 없는 상태에서 Klaytn 계정을 생성하는 API를 호출하면 KAS는 자동으로 기본 계정 저장소를 생성한 후 이 기본 저장소에 생성한 Klaytn 계정을 저장합니다.

info

다른 계정 저장소에 있는 Klaytn 계정으로 API를 호출하려면 x-krn에 사용할 계정 저장소 KRN을 입력하십시오.

Wallet API를 실행해보고 싶으신가요? 그렇다면 튜토리얼 문서를 읽고 따라해보세요. 각 기능별 API 레퍼런스는 KAS API Reference에서 확인할 수 있습니다.