Nodit Quickstart✨

Web3 프로젝트 빌드를 위한 여정을 시작해볼까요? 🎉 이 문서에서는 Nodit이 제공하는 기능들을 살펴보고, 최초 생성된 프로젝트 정보를 이용하여 간단한 Node API를 호출하는 방법을 알아보겠습니다. 순서는 다음과 같습니다.

(1) Nodit 콘솔 Sign up 및 Onboarding (1 min)

(2) 생성된 첫번째 프로젝트 확인하기 (3 mins)

API Key

연결된 Node 정보 확인

보안 설정 확인

Project Dashabord 살펴보기

(3) 연결된 노드 정보 확인하기 (3 mins)

(4) 프로젝트에 다른 네트워크 Nodes 추가하기 (1 min)

(5) 생성된 Endpoint로 Node API 호출해보기 (5 mins)

(1) Nodit 콘솔 Sign up 및 Onboarding (1 min)

Sign Up

Nodit을 사용하기 위해서는 Nodit 콘솔 가입이 필요합니다. Google 계정 또는 Email 주소를 사용하여 가입할 수 있습니다. 아직 Nodit 콘솔 회원이 아니라면, 아래 링크를 클릭하여 Sign Up 페이지로 이동 후 계정을 생성해주세요.

▶︎ Sign Up 바로가기

Onboarding

Public 체인 네트워크 노드가 필요하다면 목록에서 필요한 네트워크를 선택해주세요.
나만의 Private 네트워크를 생성하고 싶다면, Luniverse를 선택하여 나만의 Private 체인을 생성할 수 있습니다.

노드 선택을 마친 후 [Go to Nodit] 버튼을 눌러 가입을 완료하세요!

(2) 생성된 첫번째 프로젝트 확인하기 (3 mins)

Onboarding 과정을 마치면 콘솔 화면으로 이동합니다. My First Project 라는 이름으로 첫번째 프로젝트가 생성되었네요! 🎉

프로젝트 Overview 화면에서는 다음과 같은 항목들을 확인할 수 있습니다.

API Keys

API 호출을 하기 위해 필요한 API Key 정보입니다. API Key는 내부적으로 계정 및 프로젝트 정보를 포함하고 있어 사용량 측정 단위로 사용되기 때문에, 외부에 노출되지 않도록 안전하게 관리되어야 합니다. 최초 하나의 API Key가 생성되며 개발 환경에 따라 추가적인 API Key를 생성한 뒤 분리하여 적용하고 미터링할 수 있습니다.

Connected Nodes

현재 프로젝트에 연결된 전체 노드 목록을 확인할 수 있습니다.

Endpoint 확인하기

[HTTPS Endpoint], [WSS Endpoint], [Node API Endpoint] 버튼을 클릭하여 노드 API 호출 및 개발도구 연동을 위한 노드 Endpoint 주소를 복사할 수 있습니다. Aptos와 같이 Indexer API 형태의 데이터 조회를 제공하는 경우, [Aptos Indexer API Endpoint] 버튼을 클릭하여 쿼리를 위한 Endpoint를 확인할 수 있습니다.

지갑 연동하기

[Metamask]버튼을 클릭하여 지갑을 연동할 수 있습니다. 해당 노드 연결을 삭제하려면 [Disconnect]버튼을 클릭하세요.

Security

이 노드에 할당된 Endpoint와 API Key를 이용하여 API를 호출할 수 있는 Client를 Allow-listing 함으로서 보안을 강화할 수 있습니다. 현재 도메인주소와 IP 필터링을 제공하고 있으며 향후 더 많은 보안 기능이 추가될 예정입니다. 자세한 내용은 Security페이지를 참고해주세요.

Dashboard

노드별 API Request 현황을 한눈에 확인할 수 있는 Dashboard입니다. 전체 요청 수와 실패한 요청 수를 확인할 수 있습니다. 각 노드별 정보를 확인하고 싶은 경우 Connected Nodes 항목에서 각 노드 이름을 선택하여 Node Dashboard 화면으로 이동할 수 있습니다.

(3) 연결된 노드 정보 확인하기

Connected Nodes 항목의 [More→] 영역을 눌러 Node Dashboard 화면으로 이동할 수 있습니다.

Node Dashboard 화면에서는 다음과 같은 노드별 상세 정보 항목을 확인할 수 있습니다.

HTTPS Endpoint / WSS Endpoint
Node 상태 통계
- 성공한 요청 수 (24H)
- 전체 요청 수 (24H)
- 유효하지 않은 요청 수 (24H)
- Throughput Limited 적용되어 처리되지 못한 요청 수(24H)
- 응답 시간 평균값 (최근 5M, ms)
- 응답 시간 중간값 (최근 5M, ms)
- 응답 시간 최소값 (최근 5M, ms)
- 응답 시간 최대값 (최근 5M, ms)
기간별 전체 요청 수 그래프
Throughput Limited 적용되어 처리되지 못한 요청 수 그래프

(4) 프로젝트에 다른 네트워크 Nodes 추가하기 (1 min)

좌측 메뉴바에서 [Nodes] 메뉴를 클릭하여 현재 프로젝트의 노드 현황을 확인할 수 있습니다. 프로젝트 생성 시 연결한 노드들은 모두 Connected 항목에 추가되어있습니다. Available 항목에서 추가로 연결하고 싶은 노드를 클릭하여 프로젝트에 추가할 수 있습니다.

(5) 생성된 Endpoint로 Node API 호출해보기 (5 mins)

원하는 네트워크 연결이 완료되셨나요? 이제 연결된 블록체인 네트워크와 통신해봅시다 🚀

튜토리얼을 위해 이더리움과 같은 EVM 노드를 하나 연결한 뒤, Overview 화면 또는 노드 상세 화면에서 연결된 노드의 HTTPS Endpoint를 복사하세요. 아래 링크의 Recipe 예제 코드를 따라 구현하면 RPC Method Call이 동작함을 확인할 수 있습니다.

생성된 Endpoint로 Node API 호출해보기

이제 Web3 개발을 위한 기초공사는 모두 완료되었습니다!

Nodit Node 사용에 관련된 다음 컨텐츠들을 확인해보고 기능을 확장해보세요.