Aptos Indexer API가 처음이신가요? 아래의 설명을 따라 차근차근 진행해보세요. 아래의 과정을 모두 끝마치면 여러분도 손쉽게 Aptos data를 조회하고 활용할 수 있습니다!

1. 내 프로젝트에 Aptos 노드 연결하고 Indexer API Endpoint 얻기
2. Hasura Public Cloud에 Aptos Indexer API 연결하기
3. Query문 작성하고 Data 조회하기

Nodit으로 Aptos Indexer API 사용하는 방법

1. Aptos Indexer Endpoint 생성하기

자신의 프로젝트에 Aptos 노드가 연결되었는지 확인하세요! Aptos 노드를 연결해야 Indexer API를 사용할 수 있습니다. 만약 Aptos 노드가 연결되어 있지 않다면, Nodes 페이지에서 Aptos 네트워크를 연결해야 합니다. Available 섹션에서 Aptos Mainnet과 Aptos Testnet을 찾아 [Connect] 버튼을 클릭하세요.

아래의 그림과 같 Connected 섹션에 Aptos 노드가 보인다면 연결이 완료된 상태입니다.

Aptos의 Mainnet과 Testnet 중 원하는 네트워크의 Indexer API Endpoint를 복사합니다.

💁

아직 Nodit 계정이 없으신가요?

회원가입페이지에서 새로운 계정을 생성하세요! 온보딩 과정에서 Aptos Mainnet과 Aptos Testnet을 선택하고 [Go to Nodit] 버튼을 누르세요. 이 과정을 통해 앱토스가 연결된 프로젝트를 얻을 수 있습니다.

2. Hasura Public Cloud에 Aptos Indexer API 연결하기

Hasura Public Cloud는 Hasura GraphQL 엔진을 클라우드 환경에서 관리형 서비스로 제공하는 플랫폼으로, GraphQL API를 테스트할 수 있도록 무료로 인터페이스를 제공하고 있습니다. 이 인터페이스를 사용하여 Aptos Indexer API를 손쉽게 테스트해볼 수 있습니다. Hasura Public Cloud 페이지에 접속하면 아래의 화면이 나옵니다.

이전 단계에서 복사한 endpoint를 입력하고 [Connect to Endpoint] 버튼을 클릭하면, GraphiQL을 사용할 수 있는 페이지로 이동합니다. 그림의 1번 박스에는 Indexer API에서 사용 가능한 스키마를 확인할 수 있으며, 2번 박스에서는 실제 query문을 작성할 수 있습니다.

3. Query문 작성하고 Data 조회하기

이제는 직접 Query문을 작성해볼까요? 이번 예제에서는 특정 계정이 보유하고 있는 Fungible Asset을 조회해보겠습니다. 아래의 query문을 복사하여 Hasura Public Cloud에 붙여넣습니다.

query MyQuery {
  current_fungible_asset_balances(
    where: {
      owner_address: {
        _eq: "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50"
      }
    }
  ) {
    owner_address
    amount
    asset_type
    storage_id
    token_standard
    last_transaction_version
    is_primary
    last_transaction_timestamp
    is_frozen
    metadata {
      asset_type
      creator_address
      decimals
      icon_uri
      last_transaction_timestamp
      last_transaction_version
      name
      project_uri
      symbol
      token_standard
    }
  }
}

아래의 그림처럼 데이터가 조회된다면 성공입니다!

이제는 여러분이 원하는 데이터 스키마, 필드를 조합해서 나에게 필요한 데이터를 조회해보세요!