Public Node API 호출

Public Node API는 여러분이 Klaytn 기반 블록체인 애플리케이션 개발에 빠르게 적응할 수 있도록 Krust와 KAS가 협업하여 제공하는 서비스입니다. KAS의 Klaytn Node API와 동일한 기능을 별도의 인증 절차 없이 제공합니다. 이를 통해 직접 노드를 설치, 운영할 필요 없이 JSON-RPC 함수들(데이터 조회, 트랜잭션 전송 등)을 실행할 수 있습니다. 현재 KAS에서 지원하는 Node API는 Node API 목록에서 확인하십시오.

튜토리얼에 앞서

Public Node API는 다음의 목적을 가진 대상이 사용합니다.

목적 예시
Non-custodial Wallet 사용 예. MetaMask, Kaikas 사용자
학습 예. 블록체인 입문자 혹은 블록체인 관련 서비스 제공을 고려 중인 자
연구 예: 블록체인 기술 관련 연구자

Public EN은 총 5000RPS 이하로 제한되기 때문에 트래픽이 많은 시간에는 이용자간 영향을 미칠 수 있습니다. 가용성 측면에서 KAS의 Klaytn Node API와 차이가 있기 때문에 서비스 제공 목적이라면 KAS를 사용하시기 바랍니다. 상세한 내용은 아래의 비교표를 참고하십시오.

  • Public Node API와 KAS의 차이
항목 Public EN KAS
Rate limit per a second 5000 RPS를 모든 사용자가 공유 사용자별 Rate limit 관리
Daily Request limit Unlimited KAS 플랜에 따라 제한
Productivity Node API만 제공 Wallet, KIP, Token History, Metadata 등 다양한 API 제공
Availability H/A H/A
Technical Support - KAS Help center / Jira
Abusing 특정 계정/IP에 대해서 조치 -
danger

Public Node API는 서비스 목적으로 제공되는 API가 아닙니다. 과도하게 사용할 경우 이로 인한 불이익이 있을 수 있습니다. 학습 및 적응 용도로 제공되는 API임을 유의하시기 바랍니다.

  • Public Node API의 도메인

    메인넷(cypress) 혹은 테스트넷(baobab) 환경에 따라 도메인을 설정하시고, Klaytn JSON-RPC 요청을 별도의 인증 헤더 없이 보낼 수 있습니다.

    • Cypress(Klaytn 메인넷) : https://public-node-api.klaytnapi.com/v1/cypress
    • Baobab(Klaytn 테스트넷) : https://public-node-api.klaytnapi.com/v1/baobab
info

Klaytn JSON-RPC API에 관한 더 자세한 내용은 다음을 확인하십시오.

Non-Custodial Wallet 사용하기

아래는 비수탁형 지갑(Non-Custodial Wallet)을 Public Node API를 이용해 연결할 때 필요한 정보입니다.

항목 설명
네트워크 이름 Klaytn Cypress(Klaytn 메인넷) 또는
Klaytn Baobab(Klaytn 테스트넷)
새 RPC URL Cypress: https://public-node-api.klaytnapi.com/v1/cypress 또는
Baobab: https://public-node-api.klaytnapi.com/v1/baobab
체인 ID 8217(Cypress) 또는 1001(Baobab)
통화 기호 KLAY
블록 탐색기 URL Cypress: https://scope.klaytn.com/ 또는
Baobab: https://baobab.scope.klaytn.com/

Kaikas와 연동

Kaikas는 Klaytn에서 제공하는 암호화폐 지갑입니다. Cypress와 Baobab의 RPC URL이 기본값으로 이미 설정돼 있지만 Public Node API로 RPC URL 변경하려는 경우에는 아래 방법을 참고하시기 바랍니다.

1. Kaikas 실행

Kaikas 실행

2. 네트워크 탭 클릭 후 네트워크 추가 클릭

네트워크 탭 클릭 및 네트워크 클릭

3. 연결하려는 Klaytn chain의 EN 정보를 입력 후 저장 클릭

네트워크 저장

MetaMask와 연동

1. MetaMask 실행

메타마스크 실행

2. 네트워크 탭 클릭 후 네트워크 추가 클릭

네트워크 탭 클릭 및 네트워크 클릭

3. 연결하려는 Klaytn chain의 EN 정보를 입력 후 저장 클릭

네트워크 저장

가장 최근에 생성된 블록 번호 확인

Node API로 여러분의 계정 잔고, 계정 키 타입 등 계정 관련 최신 정보를 확인하려면 Klaytn 상에 있는 가장 최신 블록의 블록 번호를 알아야 합니다. 이를 위해 JSON-RPC 요청 { "method": "klay_blockNumber", "id": 1 }을 보내 최신의 블록 번호를 요청합니다.

API 호출

Copy
Copied
curl --location --request POST 'https://public-node-api.klaytnapi.com/v1/cypress' \
    --header 'Content-Type: application/json' \
    --data-raw '{"jsonrpc":"2.0","method":"klay_blockNumber","params":[],"id":1}'
info

API 호출에 관한 더 자세한 내용은 다음을 확인하십시오.

API 응답

API가 성공적으로 실행되면 다음과 같은 응답을 받습니다.

Copy
Copied
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5d39"
}
info
  • Klaytn JSON-RPC API에 관한 더 자세한 내용은 다음 을 확인하십시오.
  • API에 관한 자세한 내용은 다음 을 확인하십시오.
    :::

현재 지원하는 JSON-RPC API 목록

위에서 안내한 방식으로 Klaytn의 다른 JSON-RPC API도 KAS에서 호출할 수 있습니다. 단, 현재 KAS는 일부 Node API만을 지원합니다. 현재 KAS에서 지원하는 Node API 목록은 Node API 목록을 확인하십시오.