Basics
이 페이지는 KAS 콘솔과 API를 사용할 때 필요한 지식을 안내합니다.
KAS 콘솔과 KAS API
여러분이 KAS로 블록체인 애플리케이션을 개발하려면 KAS 콘솔과 KAS API를 함께 사용하셔야 합니다. KAS API를 호출하려면 먼저 KAS 콘솔에서 API에서 사용할 클레이튼 계정들을 모아 보관, 관리하는 계정 저장소를 만들어야 하며 API를 호출할 때 필요한 API 인증 키를 생성해야 합니다.
또 여러분의 애플리케이션이 클레이튼에서 트랜잭션을 보낼 때 트랜잭션 수수료 대납 방식을 사용한다면 KAS 콘솔상에서 클레이튼의 트랜잭션 수수료 대납 계정을 만들고 이 계정 주소(EOA)를 API 호출 시 파라미터로 사용해야 합니다. 마찬가지로, 여러분의 애플리케이션이 여러분의 서비스 체인 데이터를 메인 체인에 앵커링하는 트랜잭션을 보내야 한다면 KAS 콘솔에서 오퍼레이터 계정을 만들고 이들의 계정 주소(EOA)를 API 호출 시 사용해야 합니다.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
KAS 계정과 클레이튼 계정
KAS 계정과 클레이튼 계정은 다릅니다. KAS 계정은 KAS API를 사용하기 위한 계정이며 API 호출에 필요한 사전 설정, API 사용량 모니터링, 결제 등을 담당합니다. 클레이튼 계정은 클레이튼 블록체인 플랫폼에 존재하는 계정(Account)이며 블록체인에 트랜잭션을 보내거나 블록체인에 있는 데이터에 접근하는 주체입니다.
하나의 KAS 계정으로 여러 클레이튼 계정 저장소를 만들 수 있습니다. 하나의 클레이튼 계정 저장소에 여러 클레이튼 계정을 만들 수 있습니다.
여러분이 블록체인을 사용하는 목적은 블록체인에 트랜잭션을 보내거나 블록체인에 있는 데이터에 접근하는 것입니다. KAS는 여러분이 이러한 작업을 API 호출로 더 간단하게 수행하는 서비스를 제공합니다. API를 호출하는 주체가 바로 KAS 계정이며, API 호출 시 클레이튼 계정 정보를 함께 입력하면 이 클레이튼 계정으로 트랜잭션을 보내거나 블록체인 데이터에 접근합니다. 그리고 API를 호출 시 어떤 클레이튼 계정을 선택할 것인지에 관해 여러분의 편의를 위해 제공하는 것이 바로 클레이튼 계정 저장소입니다.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
KAS 콘솔
여러분은 KAS 콘솔에서 KAS API를 호출 시 필요한 인증 키를 생성/관리하고 KAS 계정별로 API 호출 권한을 설정할 수 있습니다. 또 각 KAS API를 쓸 때 필요한 클레이튼 계정들을 그룹별로 보관하는 계정 저장소와 KLAY, FT (KIP-7, ERC-20), NFT (KIP-17, ERC-721) 정보와 전송 기록을 추적하기 위한 Preset을 만들고 관리할 수 있습니다. 마지막으로 여러분의 KAS 계정 정보를 관리하고 여러분이 만든 ERC-20/ERC-721 토큰 전송 기록을 추적하기 위해 토큰 정보를 KAS에 등록할 수 있습니다.
항목 | 설명 | 비고 |
Dashboard | KAS 계정의 KAS API 사용량 확인 | KAS 콘솔 메인화면 |
Security | API 인증 키 생성/관리, KAS 계정별 API 호출 권한 설정 | Credential 메뉴, Permission 메뉴 |
Service | API 소개, 계정 저장소와 계정 생성, Preset 생성 | Klaytn Node 메뉴, Token History 메뉴, Wallet 메뉴, Anchor 메뉴 |
My Page | KAS 계정 정보 관리, ERC-20/ERC-721 토큰 라벨링 신청 | My Info 메뉴, Change Password 메뉴, My ERC Tokens 메뉴, Upgrade 메뉴 |
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
KAS API
KAS API로 할 수 있는 작업은 크게 2가지입니다.
클레이튼에 트랜잭션 전송
KIP-7, KIP-17, ERC-20, ERC-721 토큰 정보와 토큰을 주고 받은 기록 조회
KAS API를 사용하려면 API 인증 키를 발급받아야 하며, API 호출 헤더(HEADER)에 발급받은 API 인증 키를 입력해야 합니다. 또 API 호출 헤더 항목 중 x-krn에 KRN을 입력하면, 여러분이 원하는 계정 저장소에 있는 클레이튼 계정만을 골라 API 호출 시 사용할 수 있습니다. 그리고 API를 호출한 후 응답값을 받을 때 커서(cursor) 기반 페이지네이션으로 데이터를 받을 수 있습니다.
API 인증 키는 타인이 함부로 사용할 수 없도록 주의해야 합니다.
KAS 콘솔에서 여러 계정 저장소를 만들어 클레이튼 계정들을 용도별로 그룹핑해 관리할 수 있습니다.
또 KAS API로 트랜잭션을 보낼 때 여러분의 트랜잭션 수수료 대납 계정을 사용하거나 KAS에서 트랜잭션 수수료를 대신 먼저 납부하도록 하고 이 수수료를 나중에 지불할 수 있습니다. 마지막으로, SDK를 사용해 KAS API를 다른 개발 환경에서도 사용할 수 있습니다.
항목 | 설명 | 비고 |
API 인증 키를 API 호출 헤더에 사용하는 방법 | Basic Authorization 사용 | |
페이지네이션으로 API 호출, 응답값 수신 방법 | 쿼리 파라미터 사용 | |
KRN (KAS Resource Name) 소개 | KRN 기반 계정 저장소 사용 | |
KAS에서 제공하는 트랜잭션 수수료 대납 방법 | UserFeePayer, GlobalFeePayer | |
KAS SDK 설치와 사용방법 | Caver-js, Caver-java |
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
KAS 주요 용어집
용어 | 설명 |
클레이튼 | |
KLAY | Klaytn 내부에서 통용되는 기본 가상자산으로, 스마트 컨트랙트 생성/실행 및 KLAY 전송시 트랜잭션 수수료를 지불하는데 사용 |
FT | 대체 가능 표준 토큰(Fungible Token), KIP-7 참조 |
NFT | 대체 불가 표준 토큰(Non-fungible Token), KIP-17 참조 |
Wallet API | 트랜잭션, 키, 계정 관리를 위한 API |
리소스 | 계정 및 키 등의 KAS 서비스에서 사용하는 자원(Resource) |
KRN | KAS 리소스 식별자(KAS Resource Name) |
계정 | 클레이튼 계정(Account)으로 Wallet API 서비스에서 키를 관리하는 계정 |
EOA | 개인키/공개키 쌍으로 제어되는 외부 소유 계정(Externally Owned Account), Klaytn의 Account 참조 |
계정 키 | 데이터 서명을 위한 개인 키와 공개 키 쌍으로 Wallet API 서비스에서 관리하는 키(AccountKey) |
다중 서명 | 하나의 트랜잭션에 여러 클레이튼 계정 키로 서명하는 행위 |
기준치 | 다중 서명 시 트랜잭션을 전송할 수 있는 다중 서명 키 가중치 합계의 최소값(Threshold) |
가중치 | 다중 서명 시 각 다중 서명 키의 가중치(Weight) |
RLP | Recursive Length Prefix |
Last updated