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
  • 안전한 및 안전하지 않은 RPC 방법
  • Remote_externalities를 위한 RPC
  • 엔드포인트
  • 예제
  • 다음 단계로 넘어가기
  1. 인프라블록체인
  2. 배우기
  3. Substrate
  4. 빌드하기

RPC

RPC 및 RPC 방법을 사용하여 Substrate 노드와 상호 작용하는 방법을 설명합니다.

Previous애플리케이션 개발Next문제 해결

Last updated 1 year ago

원격 프로시저 호출(RPC) 또는 RPC 방법은 외부 프로그램(예: 브라우저 또는 프론트엔드 애플리케이션)이 Substrate 노드와 통신하는 방법입니다. 일반적으로 이러한 방법은 RPC 클라이언트가 RPC 서버 엔드포인트에 연결하여 특정 유형의 서비스를 요청할 수 있도록 합니다. 예를 들어, 저장된 값을 읽거나 트랜잭션을 제출하거나 노드가 연결된 체인에 대한 정보를 요청하는 데 RPC 방법을 사용할 수 있습니다.

Substrate 노드의 기본 에 가장 편리하게 액세스하는 방법은 를 사용하는 것입니다.

안전한 및 안전하지 않은 RPC 방법

RPC 방법은 합의 및 저장소를 포함한 핵심 노드 작업에 액세스할 수 있으며, 블록체인에 대한 트랜잭션 제출 또는 정보 검색을 허용하기 위해 공개 인터페이스로 노출될 수도 있습니다. 따라서 블록체인의 보안을 위해 다른 RPC 방법이 노출하는 내용과 로컬 노드에서 실행되는 것으로 제한할지 또는 공개적으로 사용할 수 있도록 할지를 고려하는 것이 중요합니다.

공개 RPC 인터페이스

Substrate 노드는 다음과 같은 명령줄 옵션을 제공하여 RPC 인터페이스를 공개적으로 노출할 수 있도록 합니다:

--ws-external
--rpc-external
--unsafe-ws-external
--unsafe-rpc-external

기본적으로 노드는 RPC 인터페이스를 노출하려고 시도하고 동시에 검증자 노드를 실행하려고 하면 시작을 거부합니다. --unsafe-* 플래그를 사용하면 이러한 보안 조치를 무시할 수 있습니다. RPC 인터페이스를 노출하면 많은 공격 가능성이 열리므로 신중하게 검토해야 합니다.

노출해야 하는 RPC 방법은 상당히 많지만, 다음과 같은 RPC 방법은 노출해서는 안 됩니다:

  • - 로컬 풀에 트랜잭션 제출을 허용합니다.

  • - 로컬 키스토어에 개인 키를 삽입할 수 있습니다.

  • - 세션 키 회전을 수행합니다.

  • - 풀에서 트랜잭션을 제거하고 차단합니다.

  • - 예약된 노드를 추가합니다.

  • - 예약된 노드를 제거합니다.

또한 실행에 오랜 시간이 걸릴 수 있는 RPC 방법도 노출해서는 안 됩니다. 이러한 RPC 방법을 사용하는 것은 클라이언트의 동기화를 차단할 수 있습니다. 예를 들어, 다음과 같은 RPC 방법을 사용하는 것을 피해야 합니다:

이러한 RPC는 #[rpc(name = "rpc_method")] 매크로를 사용하여 선언됩니다. 여기서 rpc_method는 함수의 이름이 됩니다. 예를 들어, submit_extrinsic입니다.

Remote_externalities를 위한 RPC

엔드포인트

로컬에서 Substrate 노드를 시작하면 기본적으로 다음과 같은 엔드포인트가 제공됩니다:

  • HTTP 및 WebSocket 엔드포인트: ws://localhost:9944/

Substrate 프론트엔드 라이브러리 및 도구 대부분은 이 엔드포인트를 사용하여 블록체인과 상호 작용합니다. 예를 들어, 로컬 노드 또는 공개 체인에 연결하기 위해 Polkadot-JS 애플리케이션을 사용하는 경우 일반적으로 HTTP 및 WebSocket 엔드포인트에 연결합니다. WebSocket 연결은 프론트엔드 애플리케이션과 요청에 응답하는 백엔드 노드 간에 양방향 통신을 가능하게 합니다. 그러나 curl 명령을 사용하여 통신 채널을 유지하지 않고 개별적으로 RPC 방법을 호출할 수도 있습니다. 예를 들어, 시스템 정보를 가져오거나 특정 유형의 블록 상태 변경이 발생할 때 알림을 받기 위해 체인에 구독하는 등의 작업을 수행하기 위해 curl 명령을 사용할 수 있습니다.

엔드포인트를 사용하여 RPC 방법을 호출하려면 다음 단계를 따릅니다:

  1. 터미널 쉘을 열고 Substrate 노드 템플릿의 루트 디렉토리로 이동합니다.

  2. 다음 명령을 실행하여 개발 모드에서 로컬 노드를 시작합니다:

    ./target/release/node-template --dev
  3. 다음 명령을 실행하여 로컬 노드에 연결하고 rpc_methods 엔드포인트를 호출합니다:

    curl -H "Content-Type: application/json" -d '{"id":1, "jsonrpc":"2.0", "method": "rpc_methods"}' http://localhost:9944/

    이 명령은 로컬 노드에 노출된 JSON-RPC 방법 목록을 반환합니다.

  4. 적절한 메서드 이름을 사용하여 추가적인 메서드를 호출합니다.

    예를 들어, 다음 명령을 실행하여 로컬 노드에 대한 버전 정보를 가져올 수 있습니다:

    curl -H "Content-Type: application/json" -d '{"id":1, "jsonrpc":"2.0", "method": "system_version"}' http://localhost:9944/

    대부분의 경우, RPC 엔드포인트에 직접 연결하면 JSON 형식의 결과가 반환됩니다. 예를 들어:

    {"jsonrpc":"2.0","result":"4.0.0-dev-de262935ede","id":1}

예제

state_getMetadata

로컬 노드의 메타데이터를 가져오려면 다음 명령을 실행할 수 있습니다:

curl -H "Content-Type: application/json" -d '{"id":1, "jsonrpc":"2.0", "method": "state_getMetadata"}' http://localhost:9944/

이 명령은 메타데이터를 인코딩된 바이트 형식으로 반환합니다. 이를 사람이 읽을 수 있는 형식으로 디코딩하려면 다음과 같은 JavaScript 코드를 사용할 수 있습니다:

function get_metadata_request(endpoint) {
  let request = new Request(endpoint, {
    method: "POST",
    body: JSON.stringify({
      id: 1,
      jsonrpc: "2.0",
      method: "state_getMetadata",
    }),
    headers: { "Content-Type": "application/json" },
  });
  return request;
}

간단한 텍스트 디코딩:

function decode_metadata(metadata) {
  return new TextDecoder().decode(util.hexToU8a(metadata));
}

state_getStorage

RPC 요청:

Request:   {"id":1,"jsonrpc":"2.0","method":"state_getStorage",["{storage_key}"]}

여기서 storage_key는 팔레트, 함수 및 키의 이름을 기반으로 생성된 매개변수입니다:

function get_runtime_storage_parameter_with_key(module_name, function_name, key) {
  // We use xxhash 128 for strings the runtime developer can control
  let module_hash = util_crypto.xxhashAsU8a(module_name, 128);
  let function_hash = util_crypto.xxhashAsU8a(function_name, 128);

  // We use blake2 256 for strings the end user can control
  let key_hash = util_crypto.blake2AsU8a(keyToBytes(key));

  // Special syntax to concatenate Uint8Array
  let final_key = new Uint8Array([...module_hash, ...function_hash, ...key_hash]);

  // Return a hex string
  return util.u8aToHex(final_key);
}

다음 단계로 넘어가기

- 특정 접두사를 가진 상태의 모든 키와 페이지네이션 지원을 가져옵니다.

- 특정 접두사를 가진 상태의 모든 키와 해당 값들을 가져옵니다.

이러한 종류의 호출은 신뢰할 수 없는 사용자로부터 요청이 오는 경우에는 반드시 필터링해야 합니다. 이를 위해 호출을 검사하고 허용된 API 호출 세트만 전달할 수 있는 프록시를 사용해야 합니다.

Substrate 노드에 대해 를 호출하기 위한 몇 가지 특수화된 RPC 방법을 제공합니다. 원격 externalities를 위한 이러한 특수화된 방법을 사용하면 Substrate 노드에 일회성 RPC 호출을 수행하여 블록 및 헤더에 대한 정보를 얻을 수 있습니다. 이러한 호출로 반환되는 정보는 과 같은 도구를 사용하여 테스트 목적으로 유용할 수 있습니다.

반환된 값을 사람이 읽을 수 있도록 하려면 SCALE 코덱을 사용하여 디코딩할 수 있습니다. 인코딩 및 디코딩에 대한 자세한 내용은 을 참조하십시오.

각 저장소 항목에는 해당하는 상대적인 저장소 키가 있으며, 이를 사용하여 를 수행합니다. 이것이 RPC 엔드포인트가 어디에서 찾아야 하는지를 알 수 있는 방법입니다.

JSON-RPC 방법
Polkadot-JS API
submit_extrinsic
insert_key
rotate_keys
remove_extrinsic
add_reserved_peer
remove_reserved_peer
storage_keys_paged
storage_pairs
JSON-RPC
remote_externalities
try-runtime
타입 인코딩 (SCALE)
JSON-RPC의 Rust 구현
유형 인코딩 (SCALE)
런타임 저장소
저장소 쿼리