infrablockchain-docs
ko
ko
  • 인프라블록체인
    • 배우기
      • 아키텍처
        • 아키텍처
        • 네트워크 참여자
        • 파라체인
          • 시스템 파라체인
      • 프로토콜
        • 시스템 토큰
        • 트랜잭션 수수료
        • Proof of Transaction
      • Substrate
        • 배우기
          • 기초 지식
            • 암호학
            • 블록체인 기본 개념
            • 합의
            • 네트워크와 노드
            • 트랜잭션과 블록 기본 사항
            • 트랜잭션 수명주기
            • 오프체인 작업
            • 라이트 클라이언트
            • Substrate를 위한 Rust
            • 라이브러리 소개
            • 아키텍처와 Rust 라이브러리
            • 파일 구조
            • 계정, 주소 및 키
            • 트랜잭션 형식
            • 난수 생성
          • 프레임
            • FRAME 팔레트
            • FRAME 매크로
            • 커스텀 팔레트
            • 팔레트 커플링
            • Origin
            • 이벤트와 에러
            • 런타임 스토리지 구조
            • 상태 전이와 스토리지
            • SCALE 인코딩
            • 트랜잭션, Weight 및 수수료
            • 런타임 API
            • 런타임 업그레이드
            • 런타임 개발
          • 계정 데이터 구조
          • 주소 형식
          • 용어집
          • cli
            • 아카이브
            • 메모리 프로파일러
            • 노드 템플릿
            • 사이드카
            • srtool
            • 서브키
            • subxt
            • try-runtime
            • tx-wrapper
          • 런타임 개발
            • 기본
              • Genesis 상태 구성하기
              • 런타임 상수 구성
              • 체인 스펙을 커스텀하기
              • 팔레트 가져오기
              • 도우미 함수 사용하기
            • 합의 모델
              • 작업 증명을 사용하는 체인 구성
              • 하이브리드 노드 생성하기
            • 오프체인 워커
              • 오프체인 HTTP 요청하기
              • 오프체인 인덱싱
              • 오프체인 로컬 스토리지
            • 팔레트 설계
              • 크라우드펀딩 구성하기
              • 스토리지 구조체 (struct) 생성하기
              • 잠금 가능한 통화 구현
              • 무작위성 적용하기
              • 느슨한 팔레트 결합 사용하기
              • 타이트한 팔레트 결합 사용하기
            • 파라체인 개발
              • HRMP 채널 추가하기
              • 로컬 파라체인 노드 추가하기
              • 릴레이 체인에 연결하기
              • 솔로 체인을 변환하기
              • 론칭 준비
              • 콜레이터 선택
              • 파라체인 업그레이드
            • 스토리지 마이그레이션
              • 기본 저장소 마이그레이션
              • 스토리지 마이그레이션 트리거
            • 테스트
              • 기본 테스트 설정하기
              • 전송 함수 테스트하기
            • 도구
              • 체인을 위한 txwrapper 생성
              • REST 엔드포인트를 사용하여 체인 데이터 가져오기
              • try-runtime 사용하기
              • Wasm 바이너리 검증하기
            • 가중치
              • 벤치마크 추가
              • 수수료 계산하기
              • 조건부 가중치 사용
              • 사용자 정의 가중치 사용하기
        • 빌드하기
          • 제작할 것을 결정하세요
          • 빌드 프로세스
          • 결정론적 런타임 빌드
          • 체인 스펙
          • Genesis 구성
          • 애플리케이션 개발
          • RPC
          • 문제 해결
        • 튜토리얼
          • 설치하기
            • 개발자 도구
            • 리눅스 개발 환경
            • macOS 개발 환경
            • Rust 툴체인
            • Rust 문제 해결 방법
            • Windows 개발 환경
          • 빠른 시작
            • 코드 탐색하기
            • 런타임 수정하기
            • 노드 시작하기
            • Substrate 한눈에 보기
          • 블록체인 구축
            • 신뢰할 수 있는 노드 추가
            • 특정 노드 승인
            • 로컬 블록체인 구축하기
            • 네트워크 시뮬레이션
            • 실행 중인 네트워크 업그레이드
          • 애플리케이션 로직 구축
            • 런타임에 팔레트 추가하기
            • 오프체인 워커 추가
            • 사용자 정의 팔레트 게시
            • 함수 호출의 출처 지정하기
            • 사용자 정의 팔레트에서 매크로 사용하기
          • 유용한 도구들
            • EVM 계정에 접근하기
            • 이더리움 통합
            • 사이드카 엔드포인트 탐색하기
            • 경량 클라이언트 노드 통합
          • 스마트 컨트랙트
            • 스마트 컨트랙트
            • 토큰 계약 작성하기
            • 스마트 컨트랙트 개발하기
            • 첫 번째 계약 준비하기
            • 스마트 컨트랙트 문제 해결
            • 값 저장을 위한 맵 사용
      • XCM
        • XCM
        • XCM 형식
    • 서비스 체인
      • 인프라DID
      • 인프라EVM
      • URAuth(Universal Resource Auth)
    • 데브 옵스
      • 체인 빌드
      • 배포
      • 모니터링
    • 튜토리얼
      • 기초
        • 시스템 토큰 관리 프로세스
        • 시스템 토큰을 트랜잭션 수수료로 사용해보기
        • 트랜잭션에 투표 포함 시키기
        • 밸리데이터 보상 받기
      • 구축하기
        • 인프라릴레이체인 구축하기
        • 파라체인 구축하기
        • 메시지 전달 채널 열기
        • XCM을 이용하여 토큰 전송하기
        • Asynchronous Backing 적용하기
      • 테스트
        • 벤치마크
        • 런타임 확인
        • 디버그
        • 테스트 네트워크에서 파라체인 시뮬레이션하기
        • 단위 테스트
      • 서비스체인
        • 인프라DID
          • 구축하기
          • 공개키 추가하기
          • 서비스 엔드포인트 등록하기
          • DID 생성하기
        • 인프라EVM
          • 구축하기
          • EVM에 자금 입금 및 인출하기
          • ERC20 토큰 컨트랙트 배포하기
          • ERC721 토큰 컨트랙트 배포하기
          • ERC1155 토큰 컨트랙트 배포하기
  • 뉴날 데이터 마켓
Powered by GitBook
On this page
  • 시작하기 전에
  • 튜토리얼 목표
  • 사이드카 다운로드 및 설치
  • API 컬렉션 가져오기
  • 환경 변수 정의하기
  • 엔드포인트 목록 가져오기
  • 계정 정보 가져오기
  • 다음 단계로 넘어가기는?
  1. 인프라블록체인
  2. 배우기
  3. Substrate
  4. 튜토리얼
  5. 유용한 도구들

사이드카 엔드포인트 탐색하기

Postman을 사용하여 Substrate REST 서비스 (사이드카) API를 탐색하는 방법을 보여줍니다.

Previous이더리움 통합Next경량 클라이언트 노드 통합

Last updated 1 year ago

Substrate 서비스는 FRAME을 사용하여 구축된 Substrate 블록체인 노드와 상호작용하기 위한 REST API를 제공합니다. 사이드카 REST 서비스는 Substrate 기반 블록체인의 노드, 계정, 트랜잭션, 파라체인 등 다양한 구성 요소와 상호작용할 수 있는 많은 엔드포인트를 노출합니다.

이 튜토리얼에서는 sidecar 서비스를 탐색하기 위해 Postman을 사용합니다. Postman은 API를 검사, 구축 및 테스트하는 데 사용되는 인기있는 플랫폼입니다. Postman은 브라우저 기반 또는 데스크톱 클라이언트를 사용하여 새로운 및 경험있는 API 개발자 모두가 협업하고 실험할 수 있도록 쉽게 사용할 수 있는 인터페이스를 제공합니다.

sidecar가 제공하는 기능을 RESTful 엔드포인트를 통해 탐색하기 위해 을 사용합니다. 미리 정의된 API 컬렉션은 Postman을 사용하여 생성한 저장된 요청의 집합을 제공하며, 사용자 정의 및 재사용할 수 있습니다. Postman으로 생성된 API 컬렉션을 사용하면 인라인 문서, 데이터에 액세스하기 위한 재사용 가능한 변수, 매개변수 형성 오류 감지 등과 같은 기능을 활용할 수 있습니다.

시작하기 전에

시작하기 전에 다음을 확인하세요:

  • 을 완료하고 Substrate 노드 템플릿을 로컬에 설치하고 실행했습니다.

  • 로컬 컴퓨터에 Node.js 14 버전 이상이 설치되어 있어 sidecar 패키지를 다운로드하고 설치할 수 있습니다.

  • 계정을 가지고 있거나 생성할 수 있습니다.

  • Postman for Web 또는 Postman for Mac 클라이언트에 액세스하거나 설치할 수 있습니다.

튜토리얼 목표

이 튜토리얼을 완료함으로써 다음을 포함하여 Postman을 사용하여 sidecar API REST 서비스를 탐색하는 방법을 배우게 됩니다.

  • sidecar 서비스를 다운로드하고 설치합니다.

  • Postman API 컬렉션을 가져옵니다.

  • 작업 환경을 설정합니다.

  • sidecar API에 대한 API 요청을 수행합니다.

  • 데이터를 저장하여 나중에 사용합니다.

사이드카 다운로드 및 설치

sidecar를 다운로드하고 설치하려면 다음을 수행하세요:

  1. 터미널 쉘을 엽니다.

  2. npm 또는 yarn을 사용하여 @substrate/api-sidecar 서비스를 전역 또는 로컬로 설치합니다.

    예를 들어, yarn을 사용하는 경우 다음 명령을 실행하여 @substrate/api-sidecar 서비스를 전역으로 설치합니다:

    yarn global add @substrate/api-sidecar

    패키지 관리자로 npm을 사용하는 경우 다음 명령을 실행하여 @substrate/api-sidecar 서비스를 전역으로 설치합니다:

    npm install -g @substrate/api-sidecar
  3. 서비스가 연결할 Substrate 노드가 실행 중인지 확인합니다.

    기본적으로 서비스는 ws://127.0.0.1:9944를 사용하여 로컬 호스트에 연결을 시도합니다. SAS_SUBSTRATE_URL 환경 설정을 수정하여 서비스가 다른 URL을 사용하도록 구성할 수 있습니다. 로컬에서 기본 포트를 사용하여 로컬에서 실행 중인 노드 템플릿에 연결하려는 경우 구성이 필요하지 않습니다.

  4. 다음 명령을 실행하여 서비스를 시작합니다:

    substrate-api-sidecar

    기본 구성을 사용하는 경우 다음과 유사한 출력이 표시됩니다:

    SAS:
      📦 LOG:
         ✅ LEVEL: "info"
         ✅ JSON: false
         ✅ FILTER_RPC: false
         ✅ STRIP_ANSI: false
      📦 SUBSTRATE:
         ✅ URL: "ws://127.0.0.1:9944"
         ✅ TYPES_BUNDLE: undefined
         ✅ TYPES_CHAIN: undefined
         ✅ TYPES_SPEC: undefined
         ✅ TYPES: undefined
      📦 EXPRESS:
         ✅ BIND_HOST: "127.0.0.1"
         ✅ PORT: 8080
    2023-01-04 14:35:41 info: Version: 14.2.2
    2023-01-04 14:35:41 warn: API/INIT: RPC methods not decorated: transaction_unstable_submitAndWatch, transaction_unstable_unwatch
    2023-01-04 14:35:41 info: Connected to chain Development on the node-template client at ws://127.0.0.1:9944
    2023-01-04 14:35:41 info: Listening on http://127.0.0.1:8080/
    2023-01-04 14:35:41 info: Check the root endpoint (http://127.0.0.1:8080/) to see the available endpoints for the current node

API 컬렉션 가져오기

sidecar를 위한 미리 정의된 API 컬렉션을 사용하려면 다음을 수행하세요:

  1. 페이지의 오른쪽 상단에 있는 Postman에서 실행을 클릭합니다.

  2. Postman for Web 또는 Postman for Mac 데스크톱 클라이언트 중 하나를 사용하여 컬렉션을 실행할지 선택합니다.

    macOS 컴퓨터를 사용하는 경우 데스크톱 클라이언트를 사용하는 것이 좋습니다. 데스크톱 클라이언트는 일반적으로 더 안정적이며 더 많은 기능을 지원합니다. 로컬 컴퓨터에 Postman for Mac이 설치되어 있지 않은 경우 앱 다운로드를 클릭하여 다운로드할 수 있습니다.

  3. Postman에서 워크스페이스를 선택한 다음 가져오기를 클릭하여 미리 정의된 컬렉션을 Postman 워크스페이스에 추가합니다.

    Substrate API sidecar 컬렉션을 Postman에서 열면 환경 변수를 정의하기 시작할 준비가 되었습니다.

환경 변수 정의하기

미리 정의된 Postman API 컬렉션에는 Dev라는 내장 개발 환경이 포함되어 있습니다. 이 환경에는 미리 정의된 변수가 포함되어 있으며, 이 변수들은 미리 정의된 쿼리를 사용하여 sidecar 서비스에 대한 다양한 API 요청에서 사용할 수 있습니다. Dev 환경에 정의된 변수는 다음과 같습니다:

  • url: 사용할 sidecar REST API의 URL을 지정합니다. 기본값은 http://127.0.0.1:8080입니다.

  • account: 블록체인의 특정 사용자의 계정 식별자를 지정합니다.

  • number: 블록체인의 특정 블록 번호를 지정합니다.

  • extrensicIndex: 특정 블록의 특정 extrinsic의 인덱스 번호를 지정합니다.

  • assetId: 팔렛 자산의 식별자를 지정합니다.

  • storageItemId: 팔렛 저장소 항목의 식별자를 지정합니다.

  • paraId: 특정 파라체인의 고유 숫자 식별자를 지정합니다.

모든 요청은 url 변수를 필요로 합니다. Dev 환경은 새로운 sidecar 서비스 인스턴스를 시작할 때 생성되는 기본 REST API 주소인 http://127.0.0.1:8080을 기본값으로 제공합니다. sidecar 서비스를 외부 호스팅 위치에서 사용하거나 환경 설정을 사용하여 기본 로컬 URL을 변경한 경우 url 변수의 기본값을 해당 URL에 맞게 변경해야 합니다. url 변수 외에도 다른 유형의 요청에는 다른 변수를 정의해야 할 수 있습니다.

예를 들어, 이 튜토리얼에서는 블록체인의 특정 계정의 잔액을 반환하는 쿼리를 실행하기 위해 account 변수에 값을 정의해야 합니다.

엔드포인트 목록 가져오기

Postman을 사용하여 sidecar에 GET 요청을 보내 API 컬렉션에 사용 가능한 모든 활성 엔드포인트 목록을 반환할 수 있습니다. 이 요청은 url 변수만 정의하면 됩니다. 대부분의 경우 로컬 개발 환경 외에 sidecar를 사용하지 않는 한 로컬 호스트 IP 주소와 포트의 기본값을 사용할 수 있습니다.

엔드포인트 목록을 가져오려면 다음을 수행하세요:

  1. Postman 클라이언트에서 컬렉션을 클릭하고 Substrate API Sidecar 컬렉션을 엽니다.

  2. 목록에서 GET List of API Endpoints 요청을 선택합니다.

    Get the List of API Endpoints 요청을 선택하면 Postman에서 이 요청에 대한 사용 가능한 옵션을 표시합니다. 이 요청은 URL만 필요로 하며 다른 매개변수를 사용하지 않으므로 여기에서 구성할 설정이 없습니다.

    요청이 추가 매개변수를 사용하는 경우 매개변수에 대해 다른 값을 제공하여 해당 값이 API에서 다른 응답을 제공하는지 확인할 수 있습니다.

  3. 미리 정의된 url 변수를 사용하여 연결할 URL을 지정합니다. {{url}}을 입력합니다.

  4. Send를 클릭합니다.

    요청을 보낸 후에는 Postman의 응답 섹션이 데이터로 채워집니다. 기본적으로 데이터는 JSON 형식으로 표시되지만 응답을 XML, HTML 또는 일반 텍스트로 변경할 수 있습니다. 다음과 유사한 부분적인 응답을 볼 수 있어야 합니다:

    {
      "docs": "https://paritytech.github.io/substrate-api-sidecar/dist",
      "github": "https://github.com/paritytech/substrate-api-sidecar",
      "version": "14.2.2",
      "listen": "127.0.0.1:8080",
      "routes": [
         {
             "path": "/accounts/:address/asset-balances",
             "method": "get"
         },
         {
             "path": "/accounts/:address/asset-approvals",
             "method": "get"
         },
       ]
    }
  5. 이 응답을 Save response를 클릭하여 출력 파일로 저장하면 나중에 사용하여 자체 애플리케이션의 기능을 구축하는 데 도움이 됩니다.

    응답을 예제로 저장할 수도 있습니다. 응답을 예제로 저장하면 GET List of API Endpoints 요청 옵션 아래에 추가됩니다.

    이 엔드포인트 목록 요청은 간단한 요청의 유용한 데모입니다. 그러나 더 자주 사용하는 경우 사이드카 엔드포인트를 사용하여 특정 데이터에 액세스하려면 다른 변수에 정의된 값을 조작하여 원하는 특정 정보를 검색해야 합니다.

    이 튜토리얼의 다음 단계입니다.

계정 정보 가져오기

Alice 주소의 계정 정보를 가져오려면 다음을 수행하세요:

  1. 새로운 터미널 쉘을 엽니다.

  2. Alice의 계정 주소를 복사합니다.

    예를 들어, 다음 명령을 실행하여 //Alice 계정의 키 정보를 검사합니다:

    ./target/release/node-template key inspect //Alice

    계정의 공개 키를 복사합니다:

    5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY
  3. Postman 클라이언트에서 Dev 환경을 선택하여 환경 변수와 해당 값의 목록을 표시합니다.

    각 변수에는 초기 값과 현재 값이 있습니다.

    • 초기 값은 Dev 환경을 처음 시작할 때 변수에 로드되는 값입니다.

    • 현재 값은 현재 세션의 값을 나타냅니다.

    현재 값은 로컬에만 저장되며 Postman에게 전송되거나 동일한 Postman API 컬렉션을 사용하는 다른 팀원과 공유되지 않습니다.

  4. Alice의 계정 주소를 현재 값 필드에 붙여넣습니다.

  5. 컬렉션을 클릭하고 Substrate API Sidecar 컬렉션을 엽니다.

  6. Accounts 폴더를 선택한 다음 GET Account Balance Info를 선택합니다.

  7. 이전에 사용한 url 변수와 Step 4에서 설정한 account 변수를 사용하여 요청을 구성합니다:

  8. Send를 클릭합니다.

    JSON 형식으로 다음과 유사한 응답을 받아야 합니다:

    {
      "at": {
         "hash": "0xfc354903a665c7847ba4f83dd9e5fb0389e31bc2015086aca56a68bb345493a5",
         "height": "1189"
      },
      "nonce": "0",
      "tokenSymbol": "UNIT",
      "free": "1152921504606846976",
      "reserved": "0",
      "miscFrozen": "0",
      "feeFrozen": "0",
      "locks": []
    }

이 응답을 파일로 저장하거나 Postman 내에서 예제로 저장하여 테스트를 생성하거나 자체 애플리케이션을 구축하는 데 도움이 됩니다.

다음 단계로 넘어가기는?

이 튜토리얼에서는 다음을 배웠습니다:

  • Postman에 API 컬렉션을 가져오는 방법.

  • 컬렉션에서 환경 변수를 정의하는 방법.

  • 사용자 정의 변수 정의를 사용하여 API 요청을 보내는 방법.

  • API의 응답을 검사하고 저장하는 방법.

이제 Postman에서 sidecar 엔드포인트를 사용하는 데 좋은 기초를 갖추었으며, 자체 목적으로 sidecar API를 사용하는 애플리케이션을 구축하기 시작할 수 있습니다. 자체적으로 더 탐색하려면 다음 작업을 고려해 보세요:

  • 미리 정의된 컬렉션에서 다른 엔드포인트를 사용하여 요청을 보냅니다.

  • 디버깅 목적으로 Postman에서 테스트를 작성합니다.

  • API REST 요청의 일련의 연결을 수행할 수 있는 Postman 플로우를 설정합니다.

브라우저에서 미리 정의된 API 컬렉션을 엽니다.

간단한 요청을 수행하는 방법을 알게 되었으므로, 이번에는 환경 변수 중 하나의 값을 수정하여 다른 GET 요청을 수행해 보겠습니다. 이 요청에서는 체인 상의 특정 계정의 잔액을 요청합니다. 작업 블록체인으로 을 사용하여 이 요청은 Alice 사용자의 계정 잔액을 쿼리합니다.

사이드카
미리 정의된 API 컬렉션
빠른 시작
Postman
Substrate API Sidecar
substrate node template
Postman에서 API 컬렉션 실행
GET Endpoints 요청 선택
요청에 대한 매개변수 설정
요청에 대한 URL 지정
Postman 환경에서 계정 변수
Account Balance Info 요청 선택
요청에 대한 엔드포인트 지정