유효성 검증인 목록 메소드

유효성 검증인 목록 메소드는 rippled 서버가 사용 중인 현재 신뢰할 수 있는 유효성 검증인 목록을 가져오는 특수 API 엔드포인트입니다. 이는 종종 서버가 신뢰하는 유효성 검증인의 정확한 목록을 나타냅니다. New in: rippled 1.5.0

피어 크롤러와 마찬가지로 유효성 검증인 목록 메소드는 기본적으로 rippled 서버의 P2P 통신에도 사용되는 피어 프로토콜 포트를 통해 권한 없이 사용할 수 있습니다.

요청 형식

유효성 검증인 목록 정보를 요청하려면 다음 HTTP 요청을 보내세요:

  • 프로토콜: https

  • HTTP 메소드: GET

  • 호스트: (rippled 서버, 호스트 이름 또는 IP 주소 기준)

  • 포트: (rippled 서버가 피어 프로토콜을 사용하는 포트 번호, 일반적으로 51235)

  • 경로: /vl/{public_key} {public_key}는 목록 게시자의 공개 키(16진수)입니다. 이 키는 게시자를 식별하며 목록의 콘텐츠가 진짜인지, 완전한지 확인하는 데에도 사용됩니다.

  • 보안: 대부분의 rippled 서버는 자체 서명된 TLS 인증서를 사용하여 요청에 응답합니다. 기본적으로 대부분의 도구(웹 브라우저 포함)는 이러한 응답을 신뢰할 수 없는 것으로 표시하거나 차단합니다. 이러한 서버의 응답을 표시하려면 인증서 검사를 무시해야 합니다(예: cURL을 사용하는 경우 --insecure 플래그 추가). 유효성 검증인 목록 콘텐츠는 별도의 암호화 키로 서명되므로 사용된 TLS 인증서에 관계없이 무결성을 확인할 수 있습니다.

응답 형식

응답에는 상태 코드 200 OK와 메시지 본문에 JSON 객체가 있습니다. 응답 본문은 https://vl.ripple.com/ 와 같은 유효성 검증인 목록 사이트에 사용되는 형식과 매우 유사합니다.

JSON 객체에는 다음과 같은 필드가 있습니다:

Field

값

설명

manifest

문자열

베이스64 또는 16진수로 된 목록 게시자의 매니페스트 데이터입니다.

blob

문자열

유효성 검사기 목록을 나타내는 Base64로 인코딩된 JSON 데이터입니다.

signature

문자열

blob데이터의 서명(16진수)입니다.

version

숫자

이 객체가 사용하는 유효성 검사기 목록 프로토콜의 버전입니다. 현재 버전은 1입니다. 버전 번호가 높을수록 이전 버전의 유효성 검사기 목록 프로토콜과 하위 호환되지 않는 변경 사항을 나타냅니다.

public_key

문자열

이 유효성 검사기 목록 데이터를 확인하는 데 사용되는 공개 키(16진수)입니다. 이것은 0xED 바이트가 접두사로 붙은 32바이트 Ed25519 공개 키입니다.

매니페스트 데이터

"매니페스트"에는 컨센서스 프로세스에 참여한 사람이나 조직(검증자 또는 목록 게시자)을 고유하게 식별하는 정보가 포함되어 있습니다. 검증자의 매니페스트에는 해당 검증자 토큰의 공개 정보가 포함됩니다. 목록 게시자의 매니페스트는 목록 게시자에 대한 정보를 제공합니다. 두 가지 모두 일반적으로 XRP Ledger의 표준 바이너리 직렬화 형식에 따라 바이너리로 인코딩됩니다. (매니페스트에 대한 표준 JSON 표현은 없습니다.)

매니페스트의 주요 목적 중 하나는 검증자 키 순환과 관련이 있습니다. 유효성 검증인이 임시 키 쌍을 변경하면 유효성 검증인은 새로운 임시 공개 키를 공유하기 위해 새 매니페스트를 게시하고 유효성 검증인의 마스터 키 쌍을 사용하여 매니페스트에 서명하여 진위를 증명합니다. 검증자는 컨센서스 프로세스의 일부로 임시 키 쌍을 사용하여 유효성 검사에 서명하고 마스터 키 쌍은 새 매니페스트에 서명할 때만 사용합니다. (매니페스트는 개인 데이터와 함께 유효성 검증인 토큰에 통합되며, 유효성 검증인 관리자가 rippled.cfg 구성 파일에 추가합니다.)

매니페스트에 인코딩된 데이터는 다음과 같습니다:

필드

내부 유형

설명

sfPublicKey

blob

이 개인 또는 조직을 고유하게 식별하는 마스터 공개 키입니다. 33바이트 secp256k1 공개 키 또는 0xED 바이트가 접두사로 붙은 32바이트 Ed25519 공개 키가 될 수 있습니다.

sfMasterSignature

blob

마스터 키 쌍에서 이 매니페스트 데이터의 서명입니다. 이는 매니페스트의 진위 여부를 증명합니다.

sfSequence

UInt32

이 매니페스트의 시퀀스 번호입니다. 숫자가 높을수록 동일한 마스터 공개 키의 모든 이전 매니페스트를 무효화하는 최신 매니페스트를 나타냅니다.

sfVersion

UInt16

사용된 매니페스트 형식을 나타내는 버전 번호입니다. 숫자가 높을수록 이전 매니페스트 형식과 비교하여 변경된 사항을 포함하여 새로운 매니페스트 형식을 나타냅니다.

sfDomain

blob

(선택 사항) 이 사람 또는 조직이 소유한 도메인 이름(ASCII로 인코딩됨)입니다.

sfSigningPubKey

blob

(선택 사항) 이 사람 또는 조직이 현재 사용 중인 키 쌍의 임시 공개 키입니다. 33바이트 secp256k1 공개 키여야 합니다.

sfSignature

blob

(선택 사항) 임시 키 쌍에서 이 매니페스트 데이터의 서명입니다.

서명 필드(sfMasterSignature 및 sfSignature) 자체를 제외한 매니페스트의 직렬화된 바이너리 데이터에 서명하여 sfMasterSignature 및 sfSignature 서명이 생성됩니다.

Blob 데이터

base64에서 블롭을 디코딩하면 다음과 같은 필드가 있는 JSON 객체가 생성됩니다:

Field

값

설명

sequence

숫자

이 목록의 고유 시퀀스 번호입니다. 시퀀스 번호가 클수록 최신 목록을 나타냅니다. 한 번에 최신 목록만 유효합니다.

expiration

숫자

Ripple 에포크 이후 이 목록이 만료되는 시간(초)입니다 .

validators

배열

권장 검증인 목록입니다.

유효성 검증인 배열의 각 멤버에는 다음과 같은 필드가 있습니다:

Field

값

설명

validation_public_key

문자열

이 유효성 검사기를 고유하게 식별하는 마스터 공개 키입니다.

manifest

문자열

이 유효성 검사기의 매니페스트 데이터 (base64 또는 16진수)입니다.

디코딩된 blob 예시

예시

요청:

응답:

Previous피어 크롤러Nextxrp-ledger.toml File

Last updated