RippleState
RippleState 객체 유형은 단일 화폐로 두 개의 계정을 연결합니다. 개념적으로 RippleState 객체는 양쪽 계정 사이에 있는 두 개의 신뢰선을 나타냅니다. 각 계정은 RippleState 객체의 해당 쪽 설정을 변경할 수 있지만 잔액은 하나의 공유 값입니다. 완전히 기본 상태인 신뢰선은 존재하지 않는 신뢰선과 동일하게 간주되므로 rippled은 RippleState 객체의 속성이 완전히 기본값일 때 RippleState 객체를 삭제합니다.
높은 계정과 낮은 계정
특정 계정 쌍에 대해 화폐당 하나의 RippleState 객체만 있을 수 있습니다. XRP Ledger에 권한이 있는 계정은 없으므로, RippleState 객체는 계정 주소를 숫자순으로 정렬하여 표준 형식을 보장합니다. 디코딩할 때 숫자로 더 낮은 주소는 "낮은 계정"으로 간주되고 다른 하나는 "높은 계정"으로 간주됩니다. 신뢰선의 순 잔액은 낮은 계좌의 관점에서 저장됩니다.
신뢰선의 잔액에 대한 "발행자"는 잔액이 양수인지 음수인지에 따라 달라집니다. RippleState 객체에 양수 잔액이 표시되면 높은 계정이 발행자입니다. 잔액이 마이너스인 경우, 낮은 계정이 발행자입니다. 발행자는 한도를 0으로 설정하고 다른 계정은 양수 한도를 설정하는 경우가 많지만, 한도는 기존 잔액에 영향을 주지 않고 변경될 수 있으므로 신뢰할 수 없습니다.
RippleState JSON 예시
RippleState 필드
RippleState 객체에는 다음과 같은 필드가 있습니다:
이름
JSON 유형
내부 유형
필수 여부
설명
Balance
객체
금액
예
낮은 계정의 관점에서 본 신뢰선의 잔액입니다. 잔액이 마이너스이면 높은 계정이 낮은 계정에서 발행한 토큰을 보유하고 있음을 나타냅니다. 여기서 발행자는 항상 중립 값인 ACCOUNT_ONE으로 설정됩니다.
Flags
숫자
UInt32
예
이 객체에 대해 활성화된 boolean 옵션의 비트맵입니다.
HighLimit
물체
금액
예
계좌가 신뢰선에 설정한 한도입니다. 발행자는 이 한도를 설정한 고액 계정의 주소입니다.
HighNode
문자열
UInt64
예
(일부 기록 ledger에서는 생략) 디렉터리가 여러 페이지로 구성된 경우 높은 계정 소유자 디렉터리의 어느 페이지가 이 개체에 연결되는지 나타내는 힌트입니다.
HighQualityIn
숫자
UInt32
아니요
높은 계정에 의해 설정된 인바운드 품질로, 암시된 비율 HighQualityIn:1,000,000,000의 정수입니다. 특별한 경우로 0은 액면가인 10억에 해당합니다.
HighQualityOut
숫자
UInt32
아니요
높은 계정에서 설정한 아웃바운드 품질로, 내재 비율 HighQualityOut:1,000,000,000의 정수입니다. 특수한 경우로, 값 0은 10억 또는 액면가에 해당합니다
LedgerEntryType
문자열
UInt16
예
0x0072 값은 RippleState 문자열에 매핑되어 이 객체가 RippleState 객체임을 나타냅니다.
LowLimit
물체
금액
예
낮은 계정이 신뢰선에 설정한 한도입니다. 발행자는 이 한도를 설정한 낮은 계정의 주소입니다.
LowNode
문자열
UInt64
예
(일부 기록 ledger에서는 생략) 디렉터리가 여러 페이지로 구성된 경우 낮은 계정의 소유자 디렉토리의 어느 페이지가 이 객체에 연결되는지 나타내는 힌트입니다.
LowQualityIn
숫자
UInt32
아니요
낮은 계정에 의해 설정된 인바운드 품질로, 암시된 비율 LowQualityIn:1,000,000,000의 정수입니다. 특수한 경우로, 값 0은 10억 또는 액면가에 해당합니다.
LowQualityOut
숫자
UInt32
아니요
낮은 계정에서 설정한 아웃바운드 품질로, 내재 비율 LowQualityOut:1,000,000,000의 정수입니다. 특수한 경우로 0은 액면가인 10억에 해당합니다.
PreviousTxnID
문자열
해시256
예
이 개체를 가장 최근에 수정한 트랜잭션의 식별 해시입니다.
PreviousTxnLgrSeq
숫자
UInt32
예
이 객체를 가장 최근에 수정한 트랜잭션이 포함된 ledger의 인덱스입니다.
RippleState 플래그
RippleState 객체는 다음과 같은 플래그 값을 가질 수 있습니다:
플래그 이름
16진수 값
소수값
설명
lsfLowReserve
0x00010000
65536
(없음)
이 RippleState 객체는 낮은 계정의 소유자 보유액에 기여합니다.
lsfHighReserve
0x00020000
131072
(없음)
이 RippleState 개체는 높은 계정의 소유자 보유액에 기여합니다.
lsfLowAuth
0x00040000
262144
tfSetAuth
낮은 계정은 낮은 계정에서 발행한 토큰을 보유하도록 높은 계정을 승인했습니다.
lsfHighAuth
0x00080000
524288
tfSetAuth
상위 계정은 상위 계정에서 발행한 토큰을 보유하도록 하위 계정을 승인했습니다.
lsfLowNoRipple
0x00100000
1048576
tfSetNoRipple
낮은 계정은 이 신뢰 라인에서 rippling을 비활성화했습니다.
lsfHighNoRipple
0x00200000
2097152
tfSetNoRipple
높은 계정은 이 신뢰 라인에서 rippling을 비활성화했습니다.
lsfLowFreeze
0x00400000
4194304
tfSetFreeze
낮은 계좌는 신뢰 한도를 동결시켜 높은 계좌가 자산을 이전할 수 없도록 했습니다.
lsfHighFreeze
0x00800000
8388608
tfSetFreeze
높은 계정은 신뢰 한도를 동결하여 낮은 계정의 자산 이전을 방지했습니다.
소유자 Reserve에 기여
계정이 신뢰선을 수정해 기본값이 아닌 상태로 만들면, 해당 신뢰선은 계정의 소유자 reserve에 포함됩니다. RippleState 오브젝트에서 lsfLowReserve와 lsfHighReserve 플래그는 어떤 계정이 소유자 reserve을 책임지는지를 나타냅니다. rippled 서버는 신뢰선을 수정할 때 이 플래그를 자동으로 설정합니다.
신뢰선의 기본값이 아닌 상태에 포함되는 값은 다음과 같습니다:
높은 계정 책임이 있는 경우...
낮은 계정 책임이 있는 경우...
Balance음수(높은 계정에 통화 보유)
Balance양수(낮은 계정에 통화 보유)
HighLimit 0이 아니다.
LowLimit 0이 아니다.
LowQualityIn은 0이 아니며 그리고 1000000000이 아닙니다.
HighQualityIn은 0이 아니며 그리고 1000000000이 아닙니다.
LowQualityOut0은 0이 아니며 그리고 1000000000이 아닙니다.
HighQualityOut은 0이 아니며 그리고 1000000000이 아닙니다.
lsfHighNoRipple플래그가 기본 상태가 아닙니다.
lsfLowNoRipple플래그가 기본 상태가 아닙니다.
lsfHighFreeze플래그가 활성화됨.
lsfLowFreeze플래그가 활성화됨.
lsfLowAuth 및 lsfHighAuth 플래그는 비활성화할 수 없으므로 기본 상태에 포함되지 않습니다.
두 Ripple 없음 플래그의 기본 상태는 해당 AccountRoot 객체에 있는 lsfDefaultRipple 플래그의 상태에 따라 달라집니다. 기본 Ripple이 비활성화되어 있으면(기본값) 계정의 모든 신뢰선에 대해 lsfNoRipple 플래그의 기본 상태가 활성화됩니다. 계정에서 기본 Ripple을 사용하도록 설정한 경우에는 기본적으로 계정의 신뢰 관계에 대해 lsfNoRipple 플래그가 비활성화됩니다(rippling이 활성화됨).
다행히도 rippled은 지연 평가를 사용하여 소유자 reserve 계산합니다. 즉, 계정이 기본 rippled 플래그를 변경하여 모든 신뢰선의 기본 상태를 변경하더라도 해당 계정의 reserve는 처음에 동일하게 유지됩니다. 계정이 신뢰선을 수정하면 rippled는 해당 개별 신뢰선이 기본 상태인지, 소유자 reserve에 기여해야 하는지 다시 평가합니다.
RippleState ID 형식
RippleState 객체의 ID는 다음 값의 절반을 순서대로 연결한 SHA-512입니다:
RippleState 스페이스 키(0x0072)
낮은 계정의 AccountID
상위 계정의 계정ID
신뢰선의 160비트 화폐 코드
Last updated