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가지입니다.

  1. 클레이튼에 트랜잭션 전송

  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 인증 키를 API 호출 헤더에 사용하는 방법

Basic Authorization 사용

페이지네이션

페이지네이션으로 API 호출, 응답값 수신 방법

쿼리 파라미터 사용

KRN

KRN (KAS Resource Name) 소개

KRN 기반 계정 저장소 사용

트랜잭션 수수료 대납

KAS에서 제공하는 트랜잭션 수수료 대납 방법

UserFeePayer, GlobalFeePayer

SDK

KAS SDK 설치와 사용방법

Caver-js, Caver-java

이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.

KAS 주요 용어집

용어

설명

클레이튼

클레이튼(Klaytn) 블록체인 플랫폼

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