Nodit 개발자 문서 1.2버전이 릴리즈되었습니다 🎉 다음과 같은 업데이트가 반영되었습니다.

주요 기능 업데이트

🌟 이제 Nodit Webhook이 Aptos 체인을 지원합니다!

Aptos 생태계를 위한 Webhook 베타 서비스를 시작합니다. 새로 추가된 Aptos의 Event, Transaction Webhook 명세를 확인하고, 주요 서비스 모니터링에 사용해보세요.

EVENT (Beta)

TRANSACTION (Beta)

🌟 Bitcoin, Dogecoin을 위한 Web3 Data API를 새롭게 지원합니다!

비트코인과 도지코인 데이터, 찾기 어려우셨나요? 이제 Nodit API를 통해 비트코인과 도지코인 데이터를 조회하고 활용해보세요.

문서 개편

• Nodit의 주요 기능을 더욱 간결하고 효과적으로 설명하기 위해 아래 문서들의 내용을 개편했습니다.
  • Elastic Node
  • Dedicated Node
  • Web3 Data API
  • Stream
  • Webhook
  • Datasquare
• 튜토리얼과 샘플 코드들을 Learn&Run 카테고리를 통해 새롭게 제공합니다.
• 이제 지원 체인별로 제공하는 API Reference를 같은 카테고리 내에서 쉽게 확인하고 사용할 수 있습니다!
  아래 체인별 Quickstart 페이지를 참고해주세요.
  • Aptos Quickstart
  • Arbitrum Quickstart
  • Base Quickstart
  • Bitcoin Quickstart
  • Dogecoin Quickstart
  • Ethereum Quickstart
  • Kaia Quickstart
  • Optimism Quickstart
  • Polygon Quickstart

Nodit Stream이 이제 더 많은 체인과 기능을 지원합니다 🙌

이제 Kaia에서도 Websocket Stream과 Webhook을 사용해보세요.

Nodit Stream이 이제 Kaia 체인을 지원합니다. 더이상 노드 API를 Polling할 필요 없이, 모니터링 하고 싶은 이벤트를 Websocket Stream 또는 Webhook으로 구독하여 받아볼 수 있습니다. 자세한 사용 방법 및 Kaia 지원 사항은 아래 페이지를 참고해주세요.

• Websocket Quickstart
• Webhook Quickstart

새로운 Event Type,LOG를 지원합니다.

Websocket Stream과 Webhook에 대해 이제 LOG 타입의 필터링 조건을 사용할 수 있습니다. LOG 필터를 활용하면 스마트 컨트랙트에 정의된 event의 event signature와 파라미터 값을 추적 조건으로 사용하여 더욱 효과적인 트랜잭션 추적이 가능합니다.

유명 토큰, NFT 프로젝트의 컨트랙트들에서 발생하는 주요 이벤트들을 추적하고 알림을 받아보세요. 자체적으로 배포한 스마트 컨트랙트에서 어떤 이벤트들이 발생하고 있는지도 효과적으로 실시간 추적할 수 있습니다.

LOG Event Type 활용에 관한 자세한 사항은 아래 문서를 참고해주세요.

• Eventy Type - LOG

이제 Web3 Data API를 통해 Kaia 메인넷과 테스트넷 데이터를 조회할 수 있습니다. 다음 페이지가 업데이트 되었습니다.

• Kaia
• KAS to Nodit Migration Guide

Kaia를 지원하는 Web3 Data API의 목록은 아래와 같습니다.

NFT API

• Get NFT Contract Metadata by Contracts
• Get NFT Contracts by Account
• Get NFT Holders by Contract
• Get NFT Holders by Token ID
• Get NFT Metadata by Contract
• Get NFT Metadata by Token IDs
• Get NFT Transfers By Account
• Get NFT Transfers By Contract
• Get NFT Transfers By TokenId
• Get NFT Transfers Within Range
• Get NFTs Owned By Account
• Search NFT Contract Metadata By Keyword
• Sync Nft Metadata

Token API

• Get Native Balance by Account
• Get Token Allowance
• Get Token Contract Metadata by Contracts
• Get Token Holders By Contract
• Get Token Prices by Contracts
• Get Token Transfers by Account
• Get Token Transfers by Contract
• Get Token Transfers Within Range
• Get Tokens Owned By Account
• Search Token Contract Metadata by Keyword

Blockchain API

• Get Block by Hash or Number
• Get Blocks Within Range
• Get Gas Price
• Get Transaction By Hash
• Get Transactions By Account
• Get Transactions By Hashes
• Get Transactions In Block
• Is Contract
• Search Events

Statistics API

• Get Account Stats

📘

사용 전 꼭 확인하세요!

Kaia는 Klaytn과 Finschia의 합병으로 탄생한 체인으로, 기존 Klaytn에서 하드포크된 체인입니다. 본 API는 하드포크 이후 데이터에 대한 정합성을 보장하지만, 하드포크 이전의 Klaytn 데이터는 조회 및 정합성을 보장하지 않습니다.
Kaia 네트워크의 하드포크 시점은 아래와 같습니다.

• Mainnet: 162,900,480 (Estimated time: 2024 Aug 29, 10:29 UTC+9)
• Kairos(Testnet): 156,660,000 (Estimated time: 2024 June 13, 10:13 UTC+9)

새로운 Nodit 문서 페이지를 만나보세요! 다음과 같은 부분들이 개선되었습니다.

Intro 페이지를 한눈에 보기 쉽게 개편했습니다 👀

이제 새로운 Intro 페이지에서 Nodit 컨텐츠를 한눈에 쉽게 살펴보고 바로 이동할 수 있습니다.

새로운 카테고리와, 카테고리에 맞는 컨텐츠를 준비했어요 😄

새로운 카테고리 체계와 함께 아래 추가된 컨텐츠들을 확인해보세요.

카테고리: WELCOME TO NODIT

• Nodit Node Quickstart
• Web3 Development Environment Setup

카테고리: NODIT FEATURES

• Elastic Nodes Vs. Dedicated Nodes
• Usage Measuring(CU)
• Webhook
• Stream
• Supported Chains
• Datasquare

카테고리: SUPPORTED CHAINS

• Ethereum
• Aptos
• Polygon
• Arbitrum
• Optimism
• Base
• Kaia

카테고리: TUTORIALS

• Building a Simple NFT Explorer Using Web3 Data APIs
• Building a Simple Token Tracker Using Web3 Data APIs

이제 Nodit에서 Base 체인과 Kaia 체인을 지원합니다! 자신의 프로젝트에 새로운 체인들을 연결하여 서비스를 확장해보세요! Base 체인과 Kaia체인에 추가되는 기능은 아래와 같습니다.

아래의 기능을 사용하기 위해서는 자신의 프로젝트에서 사용하고자 하는 네트워크를 연결해야합니다. 기능을 사용하기 전, 프로젝트에 연결된 노드를 반드시 확인하세요!

1. Base

1-1. Supported Networks

• Base mainnet
• Base sepolia (testnet)

1-2.Supported Features

[ Node API ]

Base Node API는 아래의 namespace의 메서드를 제공합니다.
더 상세한 목록을 원하신다면 아래 링크를 확인하세요.
▶️ Base Node API

• eth namespace
• net namespace
• web3 namespace
• trace namespace
• debug namespace
• optimism namespace

[ Event Stream (Webhook / Websocket) ]

Base 체인에서도 모든 이벤트 타입을 사용하여 이벤트 로그를 실시간으로 수집하고 활용할 수 있습니다. 사용할 수 있는 이벤트 목록을 보고 싶다면, 아래 문서를 참고하세요!
▶️ Event Type

[ Web3 Data API ]

기존에 사용하던 Web3 Data API를 Base체인에서도 활용할 수 있습니다. Web3 Data API 문서에서 직접 체험해보세요!
▶️ Web3 Data API Docs

• NFT API
• Token API
• Blockchain API
  • Get Internal Transactions By Account ❌
  • Get Internal Transactions By Transaction Hash ❌
  • Rest of APIs ✅
• Statistics API
  • Get Account Stats ✅
  • Rest of APIs ❌

2. Kaia

2-1. Supported Networks

• Kaia kairos (testnet)

2-2. Supported Features

[ Node API ]

Kaia Node API는 아래의 namespace의 메서드를 제공합니다.
더 상세한 목록을 원하신다면 아래 링크를 확인하세요.

▶️ Kaia Node API

• eth namespace
• net namespace
• web3 namespace
• trace namespace
• debug namespace
• kaia namespace
• klay namespace

[ Event Stream (Webhook / Websocket) ]

Kaia 체인에서도 모든 이벤트 타입을 사용하여 이벤트 로그를 실시간으로 수집하고 활용할 수 있습니다. 사용할 수 있는 이벤트 목록을 보고 싶다면, 아래 문서를 참고하세요!
▶️ Event Type

[ Kaia Faucet ]

Nodit은 노드 연결 뿐만 아니라, Kaia Testnet Faucet을 제공합니다! Kaia Testnet에서 Dapp을 개발하고 테스트할 분들은 Nodit Kaia Faucet을 통해 Kaia Testnet Token을 받아보세요.
▶️ Kairos Faucet

이번 업데이트에서는 Get Account Stats API가 추가되었으며, 기존 Get Token Prices by Contracts API에 listings 필드가 추가되었습니다. 자세한 사항은 아래 내용을 확인해주세요.

1. Get Account Stats

이 API를 통해서 특정 Account와 관련된 발생한 트랜잭션과 자산 활동에 대한 누적 데이터를 조회할 수 있습니다.

• 트랜잭션 통계: 특정 Account와 연관된 트랜잭션의 개수를 제공합니다. 트랜잭션 타입에 따라 external, internal로 구분되어 제공됩니다.
• 자산 이동 통계: 특정 Account와 연관된 토큰과 NFT 전송 이벤트의 개수를 제공합니다.
• 보유 자산 통계: 특정 Account이 보유 중인 토큰 종류 및 개수, NFT 종류 및 개수를 제공합니다.

Response Example:

{
  "transactionCounts": {
    "external": 43,
    "internal": 43
  },
  "transferCounts": {
    "tokens": 168,
    "nfts": 1
  },
  "assets": {
    "tokens": 0,
    "nfts": 1,
    "nftContracts": 1
  }
}

2. Get Token Prices by Contracts

이번 업데이트를 통해 listings 필드가 추가되었습니다. 이를 활용하여 조회한 토큰이 상장된 거래소 목록을 확인할 수 있습니다.

Response Example:

[
  {
    "currency": "USD",
    "price": "0.9995642389649487",
    "volumeFor24h": "174339728110.7602",
    "volumeChangeFor24h": "-49.1535",
    "percentChangeFor1h": "-0.00610014",
    "percentChangeFor24h": "0.00713253",
    "percentChangeFor7d": "0.01203043",
    "marketCap": "112892475974.28152",
    "updatedAt": "2024-06-23T00:03:00.000Z",
    "listings": [
      "Binance",
      "Bybit",
      "OKX",
      "Bitget",
      "TruBit Pro Exchange",
      "Gate.io",
      // ...snip
    ],
    "contract": {
      "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "deployedTransactionHash": "0x2f1c5c2b44f771e942a8506148e256f94f1a464babc938ae0690c6e34cd79190",
      "deployedAt": "2017-11-28T00:41:21.000Z",
      "deployerAddress": "0x36928500Bc1dCd7af6a2B4008875CC336b927D57",
      "logoUrl": "https://cdn.luniverse.io/img/crypto-currencies/ethereum/mainnet/0xdac17f958d2ee523a2206206994597c13d831ec7/64x64.png",
      "type": "ERC20",
      "name": "Tether USD",
      "symbol": "USDT",
      "totalSupply": "51995716056975351",
      "decimals": 6
    }
  }
]

더 자세한 내용을 원하신다면 아래 링크를 눌러 API 스펙 문서를 확인해보세요!

▶️ Get Account Stats

▶️ Get Token Prices by Contracts

이번 업데이트에서는 Aptos Indexer API가 추가되었습니다. 이를 통해 Aptos 네트워크 데이터를 효율적으로 쿼리하고, 다양한 쿼리 옵션을 통해 필요한 데이터를 신속하게 가져올 수 있습니다.

1. 주요 기능 및 장점

Aptos Indexer API는 Aptos 네트워크의 데이터를 구조화된 형식으로 인덱싱하여 빠르게 검색할 수 있도록 합니다.

• 빠르고 효율적인 데이터 검색: 인덱싱된 데이터를 활용하여 복잡한 쿼리도 신속하게 처리합니다.
• 명확한 스키마 정의: API의 가독성을 높이고 오류를 줄여줍니다.
• 경제적 데이터 이용: 중첩된 데이터를 한 번의 요청으로 받아올 수 있습니다.

2. Aptos Node API와 다른가요?

Aptos Node API와 Aptos Indexer API는 데이터 접근 방식과 사용 방법에서 차이가 있습니다. 아래의 내용을 확인하고 용도에 맞는 서비스를 사용해보세요!

• Node API: 실시간 데이터 조회에 적합하며, 노드와 직접 통신하여 최신 상태 정보를 제공합니다.
• Indexer API: 인덱싱된 데이터를 통해 특정 조건에 맞는 데이터를 빠르게 검색할 수 있습니다.

3. Aptos 재단에서 제공하는 Indexer API와 어떤 차이가 있나요?

Aptos 재단에서 제공하는 Indexer API는 Rate Limit의 제약이 있지만, Nodit에서는 자체적으로 Indexer API를 호스팅하여 Rate Limit의 제약 없이 사용할 수 있는 환경을 제공합니다.

• Labs-Hosted Indexer API: Aptos 재단에서 제공하는 Aptos Indexer API로, 5분 동안 5,000 Request의 Rate Limit이 있습니다.
• Self-Hosted Indexer API: 자체적으로 Indexer API를 호스팅해야 하기 때문에 구축 및 관리의 번거로움이 있으나 구축 후 Rate Limit 없이 이용할 수 있습니다.

4. 베타 버전 안내

이 서비스는 Aptos 재단에서 제공하는 Aptos Indexer API를 활용하고 있으며, 현재 베타 버전으로 운영 중입니다. 별도의 알림 없이 변경 사항이 생길 수 있으며, 예기치 못한 이슈가 발생한 경우 aptos-indexer-processors 레포지토리 에서 관련 이슈 상황을 확인해 주시기 바랍니다.

Aptos Indexer API에 대한 자세한 내용과 사용법을 알고 싶다면 아래 링크를 클릭하세요.

▶️ Aptos Indexer API Overview

▶️ How to use Aptos Indexer API?

이제 사용할 준비가 되었나요? Aptos Indexer API를 Nodit 문서에서 직접 테스트 해보세요!

▶️ graphql for Aptos Indexer API

이번 업데이트에서는 Event Stream 서비스의 알림 시스템이 개선되었습니다. 주요 변경 사항은 특정 토픽에 대해서 이벤트 단위로 알림을 제공하던 방식이 블록 단위로 알림을 제공하는 방식으로 전환되었습니다. 이 변경을 통해 알림의 지연 시간을 줄일 수 있게 되었습니다.

1. 업데이트 개요

1-1. 적용된 토픽

• Transaction
• ERC20 Transfer
• ERC721 Transfer
• ERC1155 Transfer

1-2. 영향받는 이벤트

변경된 알림 방식은 다음 이벤트에 영향을 미칩니다:

• ADDRESS_ACTIVITY
• MINED_TRANSACTION
• SUCCESSFUL_TRANSACTION
• FAILED_TRANSACTION
• TOKEN_TRANSFER
• BLOCK_LIST_CALLER
• ALLOW_LIST_CALLER

1-3. 이점

이번 업데이트는 특히 블록체인 기반 데이터의 실시간 처리와 관련하여 큰 개선을 이루었습니다. 블록 단위로 알림을 받음으로써 사용자는 보다 신속하게 블록체인 네트워크 내의 변화를 파악하고 반응할 수 있게 되었습니다. 또한 이 변경을 통해 블록 내에서 발생한 여러 이벤트에 대한 정보를 한 번에 수신할 수 있게 되어, 이벤트 처리 효율성이 크게 향상됩니다.

2. 폐지된 이벤트

TRANSACTION 이벤트는 이번 업데이트를 통해 폐지되었습니다. 대신, 사용자는 MINED_TRANSACTION 이벤트를 통해 목표 주소로의 알림을 더 쉽게 받을 수 있습니다.

2-1. 영향받는 이벤트

• TRANSACTION

변경된 Event의 상세 정보를 확인하고 싶다면 아래 링크를 클릭하세요!

▶ Event Type 바로가기

BUILD IT, SCALE IT, <span style={{ color: "#00D179" }}>NODIT

Nodit은 Public chain 환경을 쉽고 편리하게 이용할 수 있는 Developer Friendly Multichain Platform 입니다! Nodit을 통해 필요한 체인의 Node를 쉽게 구축하고 Web3 Data API를 이용하여 체인의 데이터를 추출하고 필요한 서비스를 구축해 보세요!

Nodit 사용법이 궁금하신가요?

Nodit 사용법이 궁금하신가요? 아래 링크를 클릭하여 자세한 내용을 확인할 수 있습니다.

How to use Nodit?

Nodit의 API가 궁금하신가요?

Nodit은 다양한 퍼블릭 체인 환경에서 이용할 수 있는 Web3 Data API와 노드에 직접 호출할 수 있는 Node API를 제공합니다. 아래 링크를 클릭하여 자세한 내용을 확인할 수 있습니다.

Nodit의 Web3 Data API 알아보기

Nodit의 Node API 사용해보기

이 외에도 Nodit은 다양한 기능을 지원합니다!

추가적인 Nodit에 대한 문의는 Q&A 혹은 [email protected] 로 메일을 보내주세요!