색인
UniversalLedger(인터페이스)Account(메시지)AccountIdList(메시지)AccountManagerDetails(메시지)AccountStatus(열거형)ActivateAccount(메시지)AddRoles(메시지)AmountValue(메시지)BalanceToSettle(메시지)BoolList(메시지)Burn(메시지)ChangeAccountManager(메시지)ClearingHouseDetails(메시지)ClientTransaction(메시지)ContractDetails(메시지)ContractPermission(열거형)ContractTokenManagerDetails(메시지)CreateAccount(메시지)CreateAccountManager(메시지)CreateClearinghouse(메시지)CreateContract(메시지)CreateContractTokenManager(메시지)CreateCurrencyOperator(메시지)CreateSnapshot(메시지)CreateTokenManager(메시지)CurrencyOperatorDetails(메시지)CurrencyValue(메시지)DeactivateAccount(메시지)DecreaseTokenIssuanceLimit(메시지)DictList(메시지)DictValue(메시지)Endpoint(메시지)Entity(메시지)EventDetails(메시지)EventType(열거형)ExecutionDetails(메시지)Fields(메시지)GetEndpointRequest(메시지)GrantContractPermissions(메시지)IncreaseTokenIssuanceLimit(메시지)Int64List(메시지)InvokeContractMethod(메시지)KeyFormat(열거형)KeySlot(열거형)ListEndpointsRequest(메시지)ListEndpointsResponse(메시지)MerkleTree(메시지)Mint(메시지)NoneValue(열거형)PlatformOperatorDetails(메시지)ProofOfInclusion(메시지)ProofOfInclusion.MerkleTreeNode(메시지)QualifiedCurrencyValue(메시지)QueryAccountRequest(메시지)QueryAccountResponse(메시지)QueryDataRequest(메시지)QueryDataResponse(메시지)QueryTransactionStateRequest(메시지)QueryTransactionStateResponse(메시지)RedactedField(메시지)RemoveRoles(메시지)RemoveSigningPublicKey(메시지)ReplaceSigningPublicKey(메시지)Role(열거형)RoundCertificate(메시지)SettlementMode(열거형)SettlementRequest(메시지)SignedTransaction(메시지)StatusEvent(메시지)StringList(메시지)SubmitOperationalTransactionRequest(메시지)SubmitOperationalTransactionResponse(메시지)SubmitTransactionRequest(메시지)SubmitTransactionResponse(메시지)TokenManagerDetails(메시지)TransactionAttempt(메시지)TransactionAttempt.TransactionStatus(열거형)TransactionCertificate(메시지)TransactionChain(메시지)TransactionEffect(메시지)TransactionEffects(메시지)TransactionEvent(메시지)TransactionEvent.EventAttribute(메시지)TransactionState(메시지)TransactionStatus(메시지)Transfer(메시지)TransferContractTokenManager(메시지)TransferCurrencyOperator(메시지)TransferPlatformOperator(메시지)UserDetails(메시지)Value(메시지)
UniversalLedger
Google Cloud Universal Ledger와 상호작용하기 위한 서비스입니다. 엔드포인트는 Google에서 사전 생성하고 관리하며 사용자가 수정할 수 없습니다. 사용 가능한 엔드포인트의 이름은 공개 문서에 제공됩니다. 엔드포인트는 Universal Ledger 네트워크 내의 리전 리소스입니다. 엔드포인트로 전송된 요청은 지정된 리전 내 지정된 네트워크의 여러 검사기로 라우팅될 수 있습니다.
| GetEndpoint |
|---|
|
특정 엔드포인트의 세부정보를 가져옵니다.
|
| ListEndpoints |
|---|
|
특정 프로젝트 및 위치의 모든 엔드포인트를 나열합니다.
|
| QueryAccount |
|---|
|
네트워크에 저장된 계정에 관한 모든 정보를 쿼리합니다. 엔드포인트가 네트워크 및 리전 내의 다른 유효성 검사기로 요청을 라우팅할 수 있고 유효성 검사기가 특정 시점에 동일한 라운드 ID에 있지 않을 수 있으므로 반환된 계정 세부정보는 호출 간에 다를 수 있습니다.
|
| QueryData |
|---|
|
계정, 거래 등 원장에 저장된 정보를 네트워크에 쿼리합니다. 계정 잔액과 같은 특정 민감한 필드에 대한 액세스는 요청의 서명에서 파생된 발신자의 신원에 따라 제한될 수 있습니다. 발신자에게 권한이 없으면 민감한 필드가 응답에서 수정되고
|
| QueryTransactionState |
|---|
|
트랜잭션의 상태를 쿼리합니다. 이 메서드는 네트워크에 제출된 모든 트랜잭션에 대해 호출할 수 있습니다. 엔드포인트가 네트워크 및 리전 내의 다른 유효성 검사기로 요청을 라우팅할 수 있고 유효성 검사기가 특정 시점에 동일한 라운드 ID에 있지 않을 수 있으므로 반환된 거래 세부정보는 호출 간에 다를 수 있습니다.
|
| SubmitOperationalTransaction |
|---|
|
운영 트랜잭션을 네트워크에 제출합니다. 이 메서드는 트랜잭션이 네트워크의 대부분의 유효성 검사기에 복제된 후에만 반환되거나 트랜잭션이 실패한 경우에만 반환됩니다.
|
| SubmitTransaction |
|---|
|
트랜잭션을 네트워크에 제출합니다. 요청이 먼저 기본적인 정확성에 대해 검증됩니다. 유효성 검사에 실패하면 요청이 즉시 실패합니다. 유효성 검사에 성공하면 이 메서드는 트랜잭션이 네트워크의 대부분의 검사기에 복제된 후에만 반환되거나 요청이 실패할 때까지 반환되지 않습니다.
|
계정
원장의 계정 상태를 나타냅니다.
| 필드 | |
|---|---|
sequence_number |
출력 전용입니다. 이 계정의 시퀀스 넘버입니다. 이 숫자는 이 계정에서 전송하는 각 거래에 따라 증가합니다. |
public_key |
출력 전용입니다. 이 계정과 연결된 기본 공개 키로, 서명 확인에 사용됩니다. |
round_id |
출력 전용입니다. 제공된 계정 정보가 정확한 실행 라운드의 ID입니다 (블록 '높이'와 유사). |
comment |
출력 전용입니다. 이 계정이 생성될 때 저장된 계정 댓글입니다. |
통합 필드 account_details. 계정 유형에 따른 구체적인 세부정보 account_details은 다음 중 하나여야 합니다. |
|
user_details |
출력 전용입니다. 표준 사용자 계정의 세부정보입니다. |
account_manager_details |
출력 전용입니다. 계정 관리자 계정의 세부정보입니다. |
token_manager_details |
출력 전용입니다. 토큰 관리자 계정의 세부정보입니다. |
contract_token_manager_details |
출력 전용입니다. 계약 토큰 관리자 계정의 세부정보입니다. |
contract_details |
출력 전용입니다. 스마트 계약 계정의 세부정보입니다. |
clearinghouse_details |
출력 전용입니다. 청산소 계정의 세부정보입니다. |
currency_operator_details |
출력 전용입니다. 통화 운영자 계정의 세부정보입니다. |
platform_operator_details |
출력 전용입니다. 플랫폼 운영자 계정의 세부정보입니다. |
AccountIdList
계정 ID 목록입니다.
| 필드 | |
|---|---|
values[] |
선택사항입니다. 계정 ID 값입니다. |
AccountManagerDetails
계정 관리자에게만 해당하는 세부정보입니다.
| 필드 | |
|---|---|
token_manager |
출력 전용입니다. 지원 중단됨: 대신 |
num_accounts |
출력 전용입니다. 이 계정 관리자가 만든 계정 수입니다. |
token_manager_id |
출력 전용입니다. 이 계정 관리자가 만든 계정의 기본 토큰 관리자의 ID입니다. |
AccountStatus
계정의 상태입니다.
| 열거형 | |
|---|---|
ACCOUNT_STATUS_UNSPECIFIED |
상태가 잘못되었습니다. |
ACCOUNT_STATUS_ACTIVE |
계정이 역할에서 허용하는 작업을 수행할 수 있는 활성 상태입니다. |
ACCOUNT_STATUS_INACTIVE |
계정의 모든 거래가 금지된 비활성 상태입니다. 계정 관리자는 계정 관리 거래를 계속 보낼 수 있습니다. |
ActivateAccount
계정을 ACCOUNT_STATUS_ACTIVE로 표시합니다. 활성화할 계정의 계정 관리자가 발신자여야 합니다.
계정 소유자는 계정의 역할에 따라 허용되는 일반 작업을 재개할 수 있습니다.
| 필드 | |
|---|---|
account |
선택사항입니다. 지원 중단됨: 대신 |
account_id |
선택사항입니다. 활성화할 계정의 ID입니다. |
AddRoles
계정에 지정된 역할을 추가합니다. 수정할 계정의 계정 관리자여야 합니다.
| 필드 | |
|---|---|
account |
선택사항입니다. 지원 중단됨: 대신 |
account_id |
선택사항입니다. 수정할 계정의 ID입니다. |
roles[] |
필수 항목입니다. 추가할 역할입니다. |
AmountValue
통화로 표시된 금액을 나타냅니다.
| 필드 | |
|---|---|
currency |
필수 항목입니다. 금액의 통화입니다. |
amount_value |
필수 항목입니다. 통화의 소수 단위 수입니다. |
BalanceToSettle
두 토큰 관리자 간에 결제할 잔액입니다.
| 필드 | |
|---|---|
balance_payer |
출력 전용입니다. 지원 중단됨: 대신 |
balance_payer_id |
출력 전용입니다. 정산할 잔액을 보유한 계정의 ID입니다. |
balance_receiver |
출력 전용입니다. 지원 중단됨: 대신 |
balance_receiver_id |
출력 전용입니다. 정산할 잔액이 있는 계정의 ID입니다. |
balance |
출력 전용입니다. 정산할 잔액입니다. 양수여야 합니다. |
BoolList
불리언 목록입니다.
| 필드 | |
|---|---|
values[] |
선택사항입니다. 불리언 값입니다. |
소모량
통화 토큰을 소각합니다. 전송자는 토큰 관리자여야 하며, 소각할 토큰을 제공하는 계정은 트랜잭션에 추가로 서명해야 합니다.
예상되는 흐름은 토큰 관리자에게 지정된 소각 계정이 있으며 고객이 소각되기 전에 토큰을 이 계정으로 이전한다는 것입니다. 또는 고객이 트랜잭션에 직접 서명할 수 있으며, 이 경우 원자적 '전송 및 소각' 트랜잭션으로 작동합니다.
| 필드 | |
|---|---|
burn_amount |
필수 항목입니다. 소각할 금액입니다. |
payer |
선택사항입니다. 지원 중단됨: 대신 |
payer_id |
선택사항입니다. 소각할 토큰을 제공하는 계정의 ID입니다. 지불인 계정에 |
ChangeAccountManager
특정 계정 관리 책임을 다른 관리자에게 이전합니다. 발신자는 계정의 현재 계정 관리자여야 하며, 동의를 제공하려면 새 관리자도 이 거래에 서명해야 합니다.
| 필드 | |
|---|---|
account |
선택사항입니다. 지원 중단됨: 대신 |
account_id |
선택사항입니다. 관리자를 변경할 계정의 ID입니다. |
next_manager |
선택사항입니다. 지원 중단됨: 대신 |
next_manager_id |
선택사항입니다. 새로 제안된 계정 관리자의 ID입니다. 유효성 검사를 위해서는 새 관리자도 이 거래에 서명해야 합니다. |
ClearingHouseDetails
클리어링하우스와 관련된 세부정보입니다.
| 필드 | |
|---|---|
account_status |
출력 전용입니다. 이 계정의 상태입니다. |
balances[] |
출력 전용입니다. 이 결제 대행업체에서 현재 추적하여 결제하는 잔액입니다. |
settlement_mode |
출력 전용입니다. 이 결제 대행업체의 결제 모드입니다. |
ClientTransaction
클라이언트가 시작한 거래를 나타냅니다.
| 필드 | |
|---|---|
source |
선택사항입니다. 트랜잭션 발신자입니다. 지원 중단됨: 대신 |
sender_id |
선택사항입니다. 이 거래를 전송하는 계정의 ID입니다. |
signatories[] |
선택사항입니다. 발신자 외에 이 거래에 서명한 계정입니다. 지원 중단됨: 대신 |
other_signatory_ids[] |
선택사항입니다. 발신자 외에 이 거래에 서명한 계정의 ID입니다. |
sequence_number |
필수 항목입니다. 0부터 시작하는 고유한 단조 증가 숫자입니다. 이 숫자는 동일한 거래 발신자가 이전에 네트워크에 제출한 각 거래에 대해 1씩 증가해야 합니다. 여기에는 체인의 일부로 제출되었을 수 있는 거래 단위가 포함되지 않으며, 체인에는 순서 번호를 설정하면 안 됩니다. 하지만 트랜잭션 체인의 발신자는 포함됩니다. |
chained_unit |
이 클라이언트 트랜잭션이 트랜잭션 체인의 일부인 경우 true로 설정해야 합니다. 그렇지 않으면 false로 설정해야 합니다. 이는 체인의 일부로 의도된 서명된 트랜잭션이 단독으로 제출되는 것을 방지하는 데 필요합니다. |
통합 필드 kind. 클라이언트 거래 관련 메시지입니다. kind은 다음 중 하나여야 합니다. |
|
app |
선택사항입니다. 지원 중단됨: 대신 메시지별 필드 중 하나를 사용하세요. 클라이언트 거래 관련 메시지입니다. 다음 중 하나여야 합니다.
|
operational |
선택사항입니다. 운영 거래 메시지입니다. 이 이메일은 플랫폼 운영자만 보낼 수 있습니다. 다음 중 하나여야 합니다. |
transfer_platform_operator_transaction |
선택사항입니다. 새 계정으로 플랫폼 운영자 역할을 이전하기 위한 메시지입니다. |
create_currency_operator_transaction |
선택사항입니다. 새 통화 연산자를 만드는 메시지입니다. |
transfer_currency_operator_transaction |
선택사항입니다. 통화 운영자 역할을 새 계정으로 이전하기 위한 메시지입니다. |
create_clearinghouse_transaction |
선택사항입니다. 새 결제 대행사를 만드는 메시지입니다. |
create_account_manager_transaction |
선택사항입니다. 새 계정 관리자를 만드는 메시지입니다. |
create_token_manager_transaction |
선택사항입니다. 요청을 전송하는 운영자의 통화와 연결된 새 토큰 관리자를 만드는 메시지입니다. |
increase_token_issuance_limit_transaction |
선택사항입니다. 타겟 계정이 예비 자금을 입금했으며 토큰 발행 한도가 증가했음을 네트워크에 알립니다. |
decrease_token_issuance_limit_transaction |
선택사항입니다. 타겟 계정이 예비 자금을 인출하고 토큰 발행 한도를 줄이기를 원한다고 네트워크에 알립니다. |
settlement_request_transaction |
선택사항입니다. 정산 작업을 시작하기 위한 메시지입니다. |
mint_transaction |
선택사항입니다. 통화 토큰을 발행하고 계정으로 전송하는 메시지입니다. |
burn_transaction |
선택사항입니다. 계정에서 통화 토큰을 소각하기 위한 메시지입니다. |
create_account_transaction |
선택사항입니다. 신규 사용자 계정을 만들기 위한 메시지입니다. |
deactivate_account_transaction |
선택사항입니다. 사용자 계정을 비활성화하기 위한 메시지입니다. |
activate_account_transaction |
선택사항입니다. 사용자 계정 활성화 메시지입니다. |
add_roles_transaction |
선택사항입니다. 계정에 역할을 추가하기 위한 메시지입니다. |
remove_roles_transaction |
선택사항입니다. 계정에서 역할을 삭제하는 메시지입니다. |
change_account_manager_transaction |
선택사항입니다. 계정의 계정 관리자를 변경하는 메시지입니다. |
transfer_transaction |
선택사항입니다. 한 사용자 계정에서 다른 사용자 계정으로 토큰을 전송하기 위한 메시지입니다. |
create_contract_transaction |
선택사항입니다. 원장에서 새 계약을 생성하기 위한 메시지입니다. |
grant_contract_permissions_transaction |
선택사항입니다. 계약에 권한을 부여하는 메시지입니다. |
invoke_contract_method_transaction |
선택사항입니다. 계약 메서드의 실행을 호출하는 메시지입니다. |
create_contract_token_manager_transaction |
선택사항입니다. 요청을 전송하는 운영자의 통화와 연결된 새 토큰 관리자를 만드는 메시지입니다. |
transfer_contract_token_manager_transaction |
선택사항입니다. 한 계정에서 다른 계정으로 통화의 토큰 관리자 역할을 이전하기 위한 메시지입니다. |
remove_signing_public_key_transaction |
선택사항입니다. 계정 서명 키 삭제 메시지 |
replace_signing_public_key_transaction |
선택사항입니다. 계정 서명 키를 대체하기 위한 메시지입니다. |
chain |
선택사항입니다. 순차적으로 실행할 여러 거래 단위를 포함하는 거래 체인의 메시지입니다. |
ContractDetails
스마트 계약에 관한 세부정보입니다.
| 필드 | |
|---|---|
owner |
출력 전용입니다. 지원 중단됨: 대신 |
owner_id |
출력 전용입니다. 계약 소유자의 ID입니다. |
code |
출력 전용입니다. 직렬화된 계약 코드입니다. |
contract_fields |
출력 전용입니다. 이 계약의 계약 필드 (필드 이름 -> 값)입니다. |
currency_balances |
출력 전용입니다. 계약에서 보유한 통화 잔액 (통화 연산자 -> 잔액)입니다. |
ContractPermission
계약에 부여할 수 있는 권한 집합입니다. 향후 더 많은 값이 추가될 예정입니다.
| 열거형 | |
|---|---|
CONTRACT_PERMISSION_UNSPECIFIED |
잘못된 권한입니다. |
CONTRACT_PERMISSION_STORAGE |
계정에서 권한을 부여한 저장소에 계약이 읽고 쓸 수 있도록 허용합니다. 계약은 이전에 작성한 속성만 읽고 쓸 수 있습니다. 이 권한은 계약이 다른 계약에서 관리하는 데이터를 읽거나 쓰는 것을 허용하지 않으며, 계약이 다른 계정 속성 (예: 기본 통화의 계정 잔액)을 직접 업데이트하는 것도 허용하지 않습니다. |
ContractTokenManagerDetails
계약 토큰 관리자와 관련된 세부정보입니다.
| 필드 | |
|---|---|
issuance_limit |
출력 전용입니다. 이 계약 토큰 관리자가 지원할 수 있는 토큰의 양입니다. 계약 토큰 관리자는 발급 한도를 늘리거나 줄일 수 없으므로 이 값은 |
issued_tokens |
출력 전용입니다. 이 계약 토큰 관리자가 지원하는 토큰의 양입니다 (즉, 총 책임). 이는 통화의 계약에 보유된 모든 잔액의 합계에 정산 매트릭스의 순 포지션을 더한 값과 같습니다. |
previous_contract_token_manager_id |
출력 전용입니다. 이 통화의 이전 계약 토큰 관리자의 계정 ID입니다. 이렇게 하면 이전 관리자를 모두 찾기 위해 탐색할 수 있는 감사 추적이 형성됩니다. 이 통화의 첫 번째 계약 토큰 관리자인 경우 비어 있습니다. |
account_status |
출력 전용입니다. 이 계정의 상태입니다. |
CreateAccount
신규 사용자 계정을 만듭니다. 발신자는 계정 관리자여야 합니다.
거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.
| 필드 | |
|---|---|
public_key |
필수 항목입니다. 계정 소유자의 공개 키입니다. 이는 발신자의 공개 키가 아닙니다. 새 계정 소유자의 공개 키이며 원장에 저장됩니다. 생성된 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다. 공개 키의 형식은 |
key_format |
선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다. |
roles[] |
선택사항입니다. 이 계정에 부여할 역할 목록입니다. |
account_status |
선택사항입니다. 생성할 계정의 상태입니다. 새로 생성된 계정의 계정 상태는 기본적으로 |
account_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
token_manager |
선택사항입니다. 지원 중단됨: 대신 |
token_manager_id |
선택사항입니다. 이 계정의 토큰 관리자 ID입니다. 이 필드는 선택사항이며 제공되지 않으면 계정 관리자 (즉, 이 거래의 발신자)와 연결된 기본 토큰 관리자가 사용됩니다. 값은 60자로 제한됩니다. |
CreateAccountManager
새 계정 관리자를 만듭니다. 발신자는 통화 운영자여야 합니다.
거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.
| 필드 | |
|---|---|
public_key |
필수 항목입니다. 새 계정 관리자의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 이 공개 키는 계정 관리자와 연결되고 원장에 저장됩니다. 계정 관리자 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다. 공개 키의 형식은 |
key_format |
선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다. |
default_token_manager |
선택사항입니다. 지원 중단됨: 대신 |
default_token_manager_id |
선택사항입니다. 이 관리자가 생성할 계정의 기본 토큰 관리자의 ID입니다. 값은 60자로 제한됩니다. |
account_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
CreateClearinghouse
새 결제 대행사를 만듭니다. 발신자는 통화 운영자여야 합니다.
거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.
| 필드 | |
|---|---|
public_key |
필수 항목입니다. 새 정산소의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 이 공개 키는 중앙 기관과 연결되고 원장에 저장됩니다. 이는 정산소 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다. 공개 키의 형식은 |
key_format |
선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다. |
account_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
settlement_mode |
필수 항목입니다. 이 결제 대행사의 정산 모드입니다. 필수 항목입니다. 공개 정보로 간주됩니다. |
CreateContract
원장에 계약을 저장합니다.
| 필드 | |
|---|---|
contract_bytes |
직렬화된 계약 바이트입니다. |
arguments |
선택사항입니다. 변경할 수 없습니다. 지원 중단됨: 대신 |
init_arguments |
선택사항입니다. 변경할 수 없습니다. |
contract_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계약의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
CreateContractTokenManager
요청을 전송하는 운영자의 통화와 연결된 새 계약 토큰 관리자를 만듭니다. 발신자는 통화 운영자여야 합니다. 새로 생성된 계약 토큰 관리자는 기본적으로 활성 상태입니다. 계약 토큰 관리자를 교체해야 하는 경우 TransferContractTokenManager 트랜잭션을 대신 전송해야 합니다. 동일한 통화와 연결된 다른 계약 토큰 관리자가 있는 경우 이 거래는 실패합니다.
일반 토큰 관리자와 달리 계약 토큰 관리자는 발행 또는 소각과 같은 거래를 실행할 수 없습니다. 하지만 정산 작업에는 참여할 수 있습니다.
거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.
| 필드 | |
|---|---|
public_key |
필수 항목입니다. 새 계약 토큰 관리자의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 이 공개 키는 계약 토큰 관리자와 연결되고 원장에 저장됩니다. 계약 토큰 관리자의 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다. 공개 키의 형식은 |
account_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
key_format |
선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다. |
CreateCurrencyOperator
새 통화 연산자를 만듭니다. 발신자는 플랫폼 운영자여야 합니다.
거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.
이 거래는 시스템에 새로운 통화를 도입해야 합니다. 지정된 통화가 이미 있으면 이 거래는 실패합니다. 통화 운영자를 교체해야 하는 경우 TransferCurrencyOperator 거래를 대신 전송해야 합니다.
| 필드 | |
|---|---|
public_key |
필수 항목입니다. 새 통화 운영자의 공개 키입니다. 이 공개 키는 통화 운영자와 연결되어 원장에 저장됩니다. 운영자 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다. 공개 키의 형식은 |
key_format |
선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다. |
account_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
currency |
선택사항입니다. 지원 중단됨: 대신 |
currency_code |
선택사항입니다. 이 운영자와 연결된 법정 통화로, 3개의 대문자로 된 ISO 4217 코드로 표시됩니다. 공개 정보로 간주됩니다. |
CreateSnapshot
이 유형에는 필드가 없습니다.
네트워크의 스냅샷 생성을 트리거합니다. 발신자는 플랫폼 운영자여야 합니다.
CreateTokenManager
요청을 보내는 운영자의 통화와 연결된 새 토큰 관리자를 만듭니다. 발신자는 통화 운영자여야 합니다.
거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.
| 필드 | |
|---|---|
public_key |
필수 항목입니다. 새 토큰 관리자의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 이 공개 키는 토큰 관리자와 연결되고 원장에 저장됩니다. 토큰 관리자의 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다. 공개 키의 형식은 |
key_format |
선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다. |
account_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
CurrencyOperatorDetails
통화 운영자와 관련된 세부정보입니다.
| 필드 | |
|---|---|
currency |
출력 전용입니다. 지원 중단됨: 대신 |
currency_code |
출력 전용입니다. 이 계정과 연결된 통화의 ID입니다. 3자리 ISO 4217 코드로 표시됩니다. |
account_status |
출력 전용입니다. 이 계정의 상태입니다. |
previous_entity_id |
출력 전용입니다. 지원 중단됨: 대신 |
previous_currency_operator_id |
출력 전용입니다. 이 계정으로 통화 운영자 역할의 소유권을 이전한 이전 통화 운영자의 ID입니다. 통화의 첫 번째 통화 연산자인 경우 비어 있습니다. |
platform_operator_entity_id |
출력 전용입니다. 지원 중단됨: 대신 |
platform_operator_id |
출력 전용입니다. 이 통화 운영자를 만든 플랫폼 운영자의 ID입니다. |
contract_token_manager |
출력 전용입니다. 지원 중단됨: 대신 |
contract_token_manager_id |
출력 전용입니다. 이 통화 연산자와 연결된 계약 토큰 관리자의 ID입니다. |
clearinghouse_id |
출력 전용입니다. 이 통화 운영자와 연결된 결제 대행사의 ID입니다. |
CurrencyValue
통화 (즉, 돈) 금액을 나타냅니다. 지정된 통화는 이 메시지에 포함되지 않습니다. 관련 통화는 거래를 전송하는 계정에 따라 결정됩니다. 각 계정에는 변경할 수 없는 고유한 통화가 연결되어 있습니다.
| 필드 | |
|---|---|
value |
필수 항목입니다. 통화의 소수 단위 수입니다. 이 최소 유효 단위는 '소수 단위'라고 하며 ISO 4217에 지정되어 있습니다. 예를 들어 USD의 경우 값은 센트 수이고 GBP의 경우 값은 펜스 수입니다. 소수가 없는 일본 엔화의 경우 엔화 금액입니다. |
DeactivateAccount
계정을 ACCOUNT_STATUS_INACTIVE로 표시합니다. 보낸 사람은 비활성화할 계정의 계정 관리자여야 합니다.
즉, 계정 소유자는 역할과 관계없이 계정에서 거래를 할 수 없습니다.
| 필드 | |
|---|---|
account |
선택사항입니다. 지원 중단됨: 대신 |
account_id |
선택사항입니다. 비활성화할 계정의 ID입니다. |
DecreaseTokenIssuanceLimit
타겟 계정이 예비 자금을 인출하고 토큰 발행 한도를 줄이기를 원한다고 네트워크에 알립니다. 발신자는 클리어링하우스 계정이어야 합니다.
예비 자금을 인출하려면 이 거래가 먼저 성공적으로 완료되어야 합니다. 발급된 금액이 이미 요청된 감소된 한도를 초과하는 경우와 같이 거래가 실패할 수 있으므로 이 작업이 필요합니다.
| 필드 | |
|---|---|
token_manager |
선택사항입니다. 지원 중단됨: 대신 |
token_manager_id |
선택사항입니다. 발행 한도를 낮출 기관 계정의 ID입니다. 거래가 유효하려면 이 계정이 토큰 관리자여야 합니다. |
amount |
필수 항목입니다. 한도를 낮출 금액입니다. 금액은 양수여야 합니다. 감소된 한도가 현재 발급된 토큰보다 낮으면 거래가 실패합니다. |
DictList
사전 목록입니다.
| 필드 | |
|---|---|
values[] |
선택사항입니다. DictValue 값입니다. 모든 중첩된 dict는 동일한 구체적인 유형을 가져야 합니다. |
DictValue
색인은 키를 값에 매핑합니다. 예를 들어 keys[0] 키는 values[0]에 매핑됩니다.
| 필드 | |
|---|---|
통합 필드 keys. 각 키는 정확히 한 종류일 수 있습니다. keys은 다음 중 하나여야 합니다. |
|
bool_keys |
선택사항입니다. 불리언 키 목록입니다. |
string_keys |
선택사항입니다. 문자열 키 목록입니다. |
int64_keys |
선택사항입니다. int64 키 목록입니다. |
account_id_keys |
선택사항입니다. 계정 ID 키 목록입니다. |
통합 필드 values. 각 값은 정확히 한 종류일 수 있습니다. values은 다음 중 하나여야 합니다. |
|
bool_values |
선택사항입니다. 불리언 값 목록입니다. |
string_values |
선택사항입니다. 문자열 값의 목록입니다. |
int64_values |
선택사항입니다. int64 값의 목록입니다. |
dict_values |
선택사항입니다. 값은 중첩된 사전 목록입니다. |
엔드포인트
Universal Ledger 엔드포인트를 나타냅니다.
| 필드 | |
|---|---|
name |
식별자. 엔드포인트의 리소스 이름입니다. 형식: |
항목
Universal Ledger 네트워크의 항목입니다. 모든 계정은 법인에 연결됩니다. 엔티티 ID는 계정 ID라고도 하며, 네트워크 전체에서 고유하고 변경할 수 없습니다.
| 필드 | |
|---|---|
id |
출력 전용입니다. 엔티티에 할당된 ID입니다. 계정 생성 시 네트워크에서 할당합니다. |
EventDetails
상태 이벤트의 추가 세부정보를 나타냅니다.
| 필드 | |
|---|---|
통합 필드 event_details. 이벤트 세부정보입니다. event_details은 다음 중 하나여야 합니다. |
|
execution_details |
출력 전용입니다. 실행 이벤트의 추가 세부정보입니다. |
EventType
요청이 라우팅된 유효성 검사기에서 관찰한 거래 처리의 이벤트 유형을 나타냅니다.
| 열거형 | |
|---|---|
EVENT_TYPE_UNSPECIFIED |
알 수 없거나 지정되지 않은 이벤트입니다. |
EVENT_TYPE_RECEIVED |
이 유효성 검사기가 클라이언트로부터 직접 수신한 트랜잭션입니다. |
EVENT_TYPE_BROADCASTED |
이 트랜잭션은 다른 유효성 검사기에 의해 브로드캐스트되었습니다. |
EVENT_TYPE_ORDERED |
이 검사기에 의해 거래가 주문되고 실행이 예약되었습니다. |
EVENT_TYPE_EXECUTION_STARTED |
트랜잭션 실행이 시작되었습니다. |
EVENT_TYPE_EXECUTION_COMPLETED |
트랜잭션 실행이 완료되었습니다. |
EVENT_TYPE_FINALIZED |
이 유효성 검사기에 의해 거래가 완료되었습니다. |
ExecutionDetails
실행 이벤트의 추가 세부정보입니다.
| 필드 | |
|---|---|
round_id |
출력 전용입니다. 실행 이벤트가 발생한 라운드 ID입니다. |
필드
계약 필드 또는 계정 필드를 나타내는 데 사용되는 계약의 필드 (필드 이름 -> 값) 맵입니다.
| 필드 | |
|---|---|
fields |
출력 전용입니다. 필드 이름과 값의 맵입니다. |
GetEndpointRequest
GetEndpoint 요청 메시지입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. 가져올 엔드포인트의 이름입니다. 형식: |
GrantContractPermissions
트랜잭션 발신자가 계약에 권한을 부여합니다. delegate_contract_id가 지정되면 권한과 해당 스토리지는 발신자가 아닌 delegate_contract_id 계약에만 부여됩니다.
권한 취소는 지원되지 않습니다.
| 필드 | |
|---|---|
contract |
선택사항입니다. 지원 중단됨: 대신 |
contract_id |
선택사항입니다. 권한이 부여되는 계약의 ID입니다. |
permissions[] |
부여할 권한입니다. |
delegate_contract_id |
선택사항입니다. 권한이 부여되는 계약 ID입니다. 거래 발신자는 이 계약의 소유자여야 합니다. |
IncreaseTokenIssuanceLimit
토큰 발행 및 민팅을 위한 트랜잭션입니다. 타겟 계정이 예비 자금을 입금했으며 토큰 발행 한도가 증가했음을 네트워크에 알립니다. 발신자는 클리어링하우스 계정이어야 합니다.
| 필드 | |
|---|---|
token_manager |
선택사항입니다. 지원 중단됨: 대신 |
token_manager_id |
선택사항입니다. 민트 한도를 늘릴 기관 계정의 ID입니다. 거래가 유효하려면 이 계정이 토큰 관리자여야 합니다. |
amount |
필수 항목입니다. 한도를 늘릴 금액입니다. 금액은 양수여야 합니다. |
Int64List
int64 목록입니다.
| 필드 | |
|---|---|
values[] |
선택사항입니다. int64 값입니다. |
InvokeContractMethod
계약 메서드의 실행을 호출합니다.
| 필드 | |
|---|---|
contract |
선택사항입니다. 지원 중단됨: 대신 |
contract_id |
선택사항입니다. 실행할 계약의 ID입니다. |
method_name |
실행할 메서드의 이름입니다. |
arguments |
선택사항입니다. 변경할 수 없습니다. 지원 중단됨: 대신 |
method_arguments |
선택사항입니다. 변경할 수 없습니다. 메서드에 전달할 인수를 포함합니다. |
payment |
결제 금액입니다. 지급 가능한 메서드를 호출할 때는 0보다 커야 하고 지급 불가능한 메서드의 경우에는 0이어야 합니다. |
KeyFormat
공개 키가 제공되는 형식을 지정합니다. 향후 이 enum에 새 값이 추가될 수 있습니다.
| 열거형 | |
|---|---|
KEY_FORMAT_UNSPECIFIED |
키 형식이 지정되지 않았습니다. 이 값은 잘못되었으므로 사용하면 안 됩니다. |
KEY_FORMAT_TINK_WIRE_FORMAT |
Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. |
KEY_FORMAT_PEM_EC_P256_SHA256 |
SHA256 다이제스트가 있는 P-256 곡선을 사용하는 PEM 인코딩 타원 곡선 서명 키입니다. 서명은 DER 형식으로 제공해야 합니다. |
KeySlot
계정에서 키를 보유할 수 있는 슬롯의 식별자입니다.
| 열거형 | |
|---|---|
KEY_SLOT_UNSPECIFIED |
키 슬롯이 지정되지 않았습니다. |
KEY_SLOT_PRIMARY |
기본 키 슬롯입니다. |
KEY_SLOT_ALTERNATE |
대체 키 슬롯입니다. |
ListEndpointsRequest
ListEndpoints 요청 메시지입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 이 엔드포인트 컬렉션을 소유한 상위 항목입니다. 형식: |
page_size |
선택사항입니다. 반환할 최대 엔드포인트 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 엔드포인트가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. |
page_token |
선택사항입니다. 이전 |
ListEndpointsResponse
ListEndpoints의 응답 메시지입니다.
| 필드 | |
|---|---|
endpoints[] |
지정된 프로젝트 및 위치의 엔드포인트입니다. |
next_page_token |
다음 페이지를 검색하기 위해 |
MerkleTree
루트 노드의 암호화 다이제스트가 있는 Merkle 트리입니다.
| 필드 | |
|---|---|
root_hash_hex |
출력 전용입니다. 루트 노드의 암호화 다이제스트입니다. 지원 중단됨: 대신 |
root_digest_hex |
출력 전용입니다. 루트 노드의 다이제스트의 16진수 표현입니다. 형식: 64자리 16진수 문자열 |
num_transactions |
출력 전용입니다. 트리의 트랜잭션 수입니다. |
Mint
통화 토큰을 발행하고 지정된 계정으로 전송합니다. 발신자는 토큰 관리자여야 합니다.
| 필드 | |
|---|---|
mint_amount |
필수 항목입니다. 발행할 금액입니다. 토큰 관리자가 발행한 총 토큰이 발행 한도를 초과하지 않도록 금액을 설정해야 합니다. 금액이 이보다 높으면 거래가 거부되어야 합니다. |
beneficiary |
선택사항입니다. 지원 중단됨: 대신 |
beneficiary_id |
선택사항입니다. 생성된 금액을 전송할 계정의 ID입니다. 수신 계정에 |
NoneValue
None 값을 나타내는 싱글톤 열거형입니다.
| 열거형 | |
|---|---|
NONE_VALUE_UNSPECIFIED |
None 값입니다. |
PlatformOperatorDetails
플랫폼 운영자와 관련된 세부정보입니다.
| 필드 | |
|---|---|
account_status |
출력 전용입니다. 이 계정의 상태입니다. |
previous_entity_id |
출력 전용입니다. 지원 중단됨: 대신 |
previous_platform_operator_id |
출력 전용입니다. 이 계정에 플랫폼 운영자 역할의 소유권을 이전한 이전 플랫폼 운영자의 ID입니다. 첫 번째 플랫폼 운영자인 경우 비어 있습니다. |
ProofOfInclusion
트랜잭션의 효과가 월드 상태에 포함되었음을 증명하는 인증서입니다.
| 필드 | |
|---|---|
transaction_certificate |
출력 전용입니다. 특정 라운드에 트랜잭션 효과가 포함되었음을 증명하는 인증서입니다. |
round_certificate |
출력 전용입니다. 라운드 실행 인증서입니다. |
path_to_round_root[] |
출력 전용입니다. 실행 라운드에 트랜잭션 효과가 포함되었음을 나타내는 암호화 증명입니다. 주어진 리프 (트랜잭션 다이제스트)에서 실행 라운드의 루트까지의 경로로 제공됩니다. 경로는 (왼쪽 하위 요소, 오른쪽 하위 요소) 쌍의 목록으로 표현되며 첫 번째 쌍은 지정된 리프의 상위 노드의 왼쪽 및 오른쪽 하위 요소입니다. 예를 들어 Merkle 트리가 8개의 리프 다이제스트 여기에서 각 경로 노드의 SHA-256 다이제스트를 연속으로 계산하여 경로의 다이제스트가 |
MerkleTreeNode
Merkle 트리 경로의 노드를 나타냅니다.
| 필드 | |
|---|---|
left_child_hash_hex |
출력 전용입니다. 노드의 왼쪽 하위 요소의 다이제스트를 16진수로 표현한 값입니다. 지원 중단됨: 대신 |
right_child_hash_hex |
출력 전용입니다. 노드의 오른쪽 하위 요소의 다이제스트를 16진수로 표현한 것입니다. 지원 중단됨: 대신 |
left_child_digest_hex |
출력 전용입니다. 노드의 왼쪽 하위 요소의 다이제스트를 16진수로 표현한 값입니다. 형식: 64자리 16진수 문자열 |
right_child_digest_hex |
출력 전용입니다. 노드의 오른쪽 하위 요소의 다이제스트를 16진수로 표현한 것입니다. 형식: 64자리 16진수 문자열 |
QualifiedCurrencyValue
원장상의 통화를 나타내며, 통화 운영자로 한정됩니다.
| 필드 | |
|---|---|
operator_id |
필수 항목입니다. 통화를 관리하는 통화 운영자 ID입니다. |
QueryAccountRequest
QueryAccount 요청 메시지입니다.
| 필드 | |
|---|---|
endpoint |
필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: |
account_id |
필수 항목입니다. 정보를 가져올 계정 ID입니다. 값은 60자로 제한됩니다. |
round_id |
선택사항입니다. 데이터를 요청할 실행 라운드의 ID입니다 (블록 '높이'와 유사). 반환된 계정 정보는 이 실행 라운드의 전역 상태에 대해 정확합니다. 지정하지 않으면 서비스 검사기에서 알고 있는 최신 최종 라운드를 사용합니다. 특정 라운드 ID의 상태는 항상 일관되고 표준입니다. |
QueryAccountResponse
QueryAccount의 응답 메시지입니다.
| 필드 | |
|---|---|
account |
계정 정보와 획득한 고도입니다. |
QueryDataRequest
QueryData 요청 메시지입니다.
| 필드 | |
|---|---|
endpoint |
필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: |
serialized_signed_query_request |
필수 항목입니다. Universal Ledger 네트워크를 쿼리하기 위해 직렬화된 protobuf |
QueryDataResponse
QueryData의 응답 메시지입니다.
| 필드 | |
|---|---|
redacted_fields[] |
권한 제한으로 인해 응답에서 수정된 필드를 나타냅니다. |
통합 필드 kind. 쿼리별 결과입니다. kind은 다음 중 하나여야 합니다. |
|
account |
계정에 대한 쿼리인 경우 계정 정보입니다. |
transaction_state |
쿼리가 거래에 대한 것이라면 거래의 상태입니다. |
QueryTransactionStateRequest
QueryTransactionState 요청 메시지입니다.
| 필드 | |
|---|---|
endpoint |
필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: |
transaction_digest_hex |
필수 항목입니다. 상태를 가져올 거래 ID입니다. |
QueryTransactionStateResponse
QueryTransactionState의 응답 메시지입니다.
| 필드 | |
|---|---|
transaction_attempts[] |
요청을 처리하는 유효성 검사기에 알려진 트랜잭션 제출당 하나의 항목입니다. |
RedactedField
응답에서 수정된 필드에 관한 정보입니다.
| 필드 | |
|---|---|
redacted_path |
출력 전용입니다. 페이로드에서 수정된 정규화된 필드 경로입니다. |
reason |
출력 전용입니다. 필드가 수정된 이유에 대한 사람이 읽을 수 있는 설명입니다. |
reason_code |
출력 전용입니다. 필드가 수정된 이유를 나타내는 머신이 읽을 수 있는 코드입니다. |
RemoveRoles
계정에서 지정된 역할을 삭제합니다. 수정할 계정의 계정 관리자여야 합니다.
| 필드 | |
|---|---|
account |
선택사항입니다. 지원 중단됨: 대신 |
account_id |
선택사항입니다. 수정할 계정의 ID입니다. |
roles[] |
필수 항목입니다. 삭제할 역할입니다. |
RemoveSigningPublicKey
지정된 슬롯에서 계정 서명 키를 삭제합니다. 다른 슬롯은 비어 있으면 안 되며 ClientTransaction에 서명하는 데 사용된 키를 보유해야 합니다.
| 필드 | |
|---|---|
key_slot |
필수 항목입니다. 키를 삭제할 키 슬롯입니다. 이미 비어 있으면 트랜잭션이 실패합니다. |
ReplaceSigningPublicKey
지정된 슬롯의 계정 서명 키를 바꿉니다. 다른 슬롯은 비어 있으면 안 되며 ClientTransaction에 서명하는 데 사용된 키를 보유해야 합니다.
| 필드 | |
|---|---|
key_slot |
필수 항목입니다. 키를 대체할 키 슬롯입니다. |
new_public_key |
필수 항목입니다. 지정된 슬롯의 공개 키를 대체할 새 공개 키입니다. 공개 키의 형식은 new_key_format 필드에 의해 정의됩니다. 공개 정보로 간주됩니다. |
new_key_format |
필수 항목입니다. 새 공개 키의 키 형식입니다. 지원되는 형식 목록은 KeyFormat 정의를 참고하세요. 공개 정보로 간주됩니다. |
역할
일반적인 역할 집합입니다.
| 열거형 | |
|---|---|
ROLE_UNSPECIFIED |
역할이 잘못되었습니다. |
ROLE_PAYER |
계정에서 결제 거래를 시작할 수 있는 역할입니다. |
ROLE_RECEIVER |
계정에서 지급을 받을 수 있도록 허용하는 역할입니다. |
ROLE_CONTRACT_CREATOR |
계정이 계약을 배포할 수 있도록 허용하는 역할입니다. |
ROLE_CONTRACT_PARTICIPANT |
계정이 배포된 계약과 상호작용할 수 있도록 허용하는 역할입니다. |
RoundCertificate
특정 검사자가 라운드를 실행했음을 증명하는 인증서입니다.
| 필드 | |
|---|---|
round_id |
출력 전용입니다. 인증서가 적용되는 라운드의 ID입니다. |
validator_id |
출력 전용입니다. 사람이 읽을 수 있는 유효성 검사기 식별자입니다. 이는 |
round_state_checksum_hex |
출력 전용입니다. 이 라운드의 효과가 적용된 후의 세계 상태에 대한 동형 다이제스트의 16진수 표현입니다. |
round_delta_checksum_hex |
출력 전용입니다. 이 라운드의 집계된 트랜잭션 효과에 대한 동형 다이제스트의 16진수 표현입니다. |
merkle_tree |
출력 전용입니다. 이 라운드를 루트 노드로 하고 트랜잭션 배치 (라운드에서 실행됨)를 리프로 하는 머클 트리 |
validator_signatures[] |
선택사항입니다. 검사기의 서명입니다. 이는 이 레코드의 이전 페이로드의 다이제스트를 통해 서명됩니다. |
is_finalized |
출력 전용입니다. 라운드가 완료되었는지, 즉 충분한 수의 검사자가 동일한 인증서로 이 라운드를 인증했는지 나타내는 불리언입니다. |
SettlementMode
클리어링 하우스의 정산 모드입니다.
| 열거형 | |
|---|---|
SETTLEMENT_MODE_UNSPECIFIED |
정산 모드가 지정되지 않았습니다. 이 값은 잘못되었으므로 사용하면 안 됩니다. |
SETTLEMENT_MODE_DEFERRED |
청산소는 장부 외 자금의 소유권을 추적하고 장부의 해당 잔액을 동기화된 상태로 유지하기 위해 주기적으로 SettlementRequest 트랜잭션을 발행합니다. |
SETTLEMENT_MODE_INSTANT |
지급 기관은 단일 자금 풀을 유지하고 원장은 토큰 관리자 간의 자금 할당을 위한 골든 소스 역할을 합니다. 이 결제 모드는 '즉시 총액 결제'라고도 할 수 있습니다. |
SettlementRequest
두 토큰 관리자 간의 정산 작업을 시작합니다. 발신자는 클리어링하우스 계정이어야 합니다.
정산 기관이 토큰 관리자 자금을 보관하는 지연된 SettlementMode에서는 두 토큰 관리자 간의 정산을 실행하기 위해 전송해야 하는 유일한 트랜잭션입니다.
| 필드 | |
|---|---|
payer |
선택사항입니다. 변경할 수 없습니다. 지원 중단됨: 대신 |
payer_id |
선택사항입니다. 변경할 수 없습니다. 자금 이체를 해야 하는 당사자의 계정 ID입니다. |
beneficiary |
선택사항입니다. 변경할 수 없습니다. 지원 중단됨: 대신 |
beneficiary_id |
선택사항입니다. 변경할 수 없습니다. 자금을 수령할 당사자의 계정 ID입니다. |
balance |
필수 항목입니다. 변경할 수 없습니다. |
round_id |
필수 항목입니다. 변경할 수 없습니다. 이 정산 금액이 계산된 라운드 ID입니다. |
SignedTransaction
서명이 첨부된 거래입니다. 거래를 제출하려면 이 메시지를 직렬화하여 SubmitTransactionRequest에 포함해야 합니다.
| 필드 | |
|---|---|
serialized_client_transaction |
필수 항목입니다. 거래 세부정보가 포함된 직렬화된 |
sender_signature |
필수 항목입니다. 거래 발신자의 서명입니다. 서명은 자체 비공개 키로 트랜잭션 체인의 경우 서명할 바이트는 다음의 연결로 계산됩니다. - 전체 체인의 직렬화된 클라이언트 트랜잭션의 다이제스트 - 체인에 표시되는 순서대로 체인의 각 단위의 직렬화된 서명된 트랜잭션의 다이제스트 다이제스트는 SHA-256을 사용하여 계산됩니다. |
sender_signing_key_slot |
선택사항입니다. 거래에 서명하는 데 사용된 발신자의 키 슬롯입니다. 지정되지 않은 경우 발신자 계정의 기본 슬롯을 사용합니다. |
other_signatures[] |
선택사항입니다. 추가 거래 서명자로 나열된 계정의 서명입니다. 이러한 서명의 수와 순서는 서명할 바이트는 추가 서명인의 수와 신원은 특정 거래 종류에 따라 다릅니다. 트랜잭션 체인의 경우 체인에 발신자 또는 서명자로 표시되는 각 계정에 하나의 서명이 필요합니다. |
other_signing_key_slots[] |
선택사항입니다. 추가 거래 서명자로 나열된 계정의 키 슬롯입니다. 설정된 경우 이러한 키 슬롯의 수와 순서는 |
StatusEvent
단일 유효성 검사기에서 관찰한 트랜잭션 처리의 이벤트를 나타냅니다.
보고된 모든 값은 요청을 처리하는 검증 도구의 관점에서 나온 것이며 다른 검증 도구의 관점과 다를 수 있습니다.
| 필드 | |
|---|---|
event_time |
출력 전용입니다. 이 유효성 검사기에 의해 이벤트가 기록된 시간입니다. |
event_type |
출력 전용입니다. 이벤트 유형입니다. |
event_details |
출력 전용입니다. 이벤트와 관련된 추가 세부정보입니다. |
StringList
문자열 목록입니다.
| 필드 | |
|---|---|
values[] |
선택사항입니다. 문자열 값입니다. |
SubmitOperationalTransactionRequest
SubmitOperationalTransaction 요청 메시지입니다.
| 필드 | |
|---|---|
endpoint |
필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: |
serialized_signed_operational_transaction |
필수 항목입니다. 원장에 제출할 protobuf 직렬화 |
SubmitOperationalTransactionResponse
SubmitOperationalTransaction의 응답 메시지입니다.
| 필드 | |
|---|---|
transaction_digest_hex |
제출된 운영 거래를 고유하게 나타내는 식별자입니다. |
SubmitTransactionRequest
SubmitTransaction 요청 메시지입니다.
| 필드 | |
|---|---|
endpoint |
필수 항목입니다. 거래를 제출할 엔드포인트입니다. 형식: |
serialized_signed_transaction |
필수 항목입니다. 원장에 제출할 protobuf 직렬화 |
SubmitTransactionResponse
SubmitTransaction의 응답 메시지입니다.
| 필드 | |
|---|---|
transaction_digest_hex |
제출된 거래를 고유하게 나타내는 식별자입니다. |
TokenManagerDetails
토큰 관리자와 관련된 세부정보입니다.
| 필드 | |
|---|---|
issuance_limit |
출력 전용입니다. 이 토큰 관리자가 발행할 수 있는 토큰의 양입니다. |
issued_tokens |
출력 전용입니다. 이 토큰 관리자가 발행한 토큰 수입니다. 이 숫자는 민팅 시 증가하고 소각 시 감소합니다. |
TransactionAttempt
시도된 거래 제출의 상태입니다.
| 필드 | |
|---|---|
status |
출력 전용입니다. 거래 시도의 현재 상태입니다. |
proof_of_inclusion |
출력 전용입니다. 트랜잭션 효과가 월드 상태에 포함되었음을 나타내는 인증서입니다. 상태가 |
status_events[] |
출력 전용입니다. 거래 시도에 대해 기록된 순서가 지정된 상태 이벤트입니다. |
TransactionStatus
거래 시도의 상태입니다.
| 열거형 | |
|---|---|
TRANSACTION_STATUS_UNSPECIFIED |
알 수 없거나 초기화되지 않은 상태입니다. |
PENDING |
이 트랜잭션은 이 유효성 검사기에 알려져 있지만 아직 완료되지 않았습니다. |
FINALIZED |
거래가 완료되었습니다. 이러한 효과는 블록체인에 유지되며 되돌릴 수 없습니다. |
TransactionCertificate
라운드에서 특정 거래의 실행 증명서입니다.
| 필드 | |
|---|---|
transaction_digest_hex |
출력 전용입니다. 이 인증서가 적용되는 거래의 ID입니다. |
round_id |
출력 전용입니다. 이 트랜잭션이 실행된 실행 라운드의 ID입니다. |
transaction_effects |
출력 전용입니다. 트랜잭션 실행의 효과입니다. |
events[] |
출력 전용입니다. 트랜잭션에서 생성된 이벤트입니다. |
transaction_effects_state_checksum_hex |
출력 전용입니다. 효과의 동형 체크섬입니다. 16진수 문자열로 인코딩된 2048바이트 값입니다. |
certification_results_digest_hex |
출력 전용입니다. 이전 필드의 모든 암호화 다이제스트입니다. 포함 증명의 Merkle 트리를 빌드하는 데 사용됩니다. |
TransactionChain
순차적으로 실행할 여러 트랜잭션 단위가 포함된 트랜잭션 체인입니다.
단위는 나열된 순서대로 순차적으로 실행됩니다. 모든 단위가 성공하면 누적 효과가 원자적으로 세계 상태에 커밋됩니다. 그렇지 않고 하나라도 실패하면 전체 체인이 실패하고 효과가 적용되지 않습니다.
| 필드 | |
|---|---|
units[] |
체인의 개별 단위입니다. 각 단위는 직렬화된 직렬화된 바이트는 체인 자체에 서명할 바이트를 결정하는 데 필요합니다. |
TransactionEffect
일부 트랜잭션에 의한 월드 상태 업데이트를 나타냅니다.
delta_val이 있으면 지정된 키에 이전에 저장된 값에 적용된 델타 (정수 오프셋)로 간주됩니다. 이 경우 new_val 및 old_val은 비어 있어야 합니다.
그렇지 않으면 old_val 또는 new_val (또는 둘 다)이 하나 이상 있는 것으로 간주됩니다. 빈 old_val은 값이 삽입되었음을 나타냅니다. 빈 new_val은 값이 삭제되었음을 나타냅니다.
| 필드 | |
|---|---|
key |
출력 전용입니다. 업데이트된 세계 상태의 키입니다. |
old_val |
출력 전용입니다. 거래가 실행되기 전의 키 값입니다. |
new_val |
출력 전용입니다. 거래가 실행된 후의 키 값입니다. |
delta_val |
출력 전용입니다. 이전에 저장된 값에 적용된 정수 오프셋입니다. |
TransactionEffects
트랜잭션 실행의 효과입니다.
| 필드 | |
|---|---|
status |
출력 전용입니다. 트랜잭션 실행의 결과 상태입니다. |
effects[] |
출력 전용입니다. 지원 중단됨: 대신 네트워크 상태를 쿼리하여 세계 상태의 변경사항을 확인하세요. 월드 상태에서 트랜잭션의 효과입니다. |
TransactionEvent
거래에 의해 생성된 이벤트입니다.
| 필드 | |
|---|---|
type |
출력 전용입니다. 이벤트 유형입니다. |
attributes[] |
출력 전용입니다. 임의의 키-값 쌍인 이벤트 속성입니다. |
EventAttribute
개별 속성(키-값 쌍)
| 필드 | |
|---|---|
key |
출력 전용입니다. 속성의 키입니다. |
value |
출력 전용입니다. 속성의 값입니다. |
TransactionState
거래의 상태입니다.
| 필드 | |
|---|---|
transaction_attempts[] |
요청을 처리하는 유효성 검사기에 알려진 트랜잭션 제출당 하나의 항목입니다. |
TransactionStatus
트랜잭션 실행 상태를 나타냅니다.
| 필드 | |
|---|---|
code |
출력 전용입니다. 상태 코드입니다. 의미는 해당하는 gRPC 상태 코드에 의해 정의되는 숫자 값입니다. |
message |
출력 전용입니다. 오류 메시지(있는 경우) 코드가 |
이전
한 사용자 계정에서 다른 사용자 계정으로 토큰을 전송합니다. 발신자는 토큰 관리자나 계정 관리자와 같은 권한이 있는 계정이 아닌 일반 사용자 계정이어야 합니다.
또한 거래 발신자에게는 ROLE_PAYER가 사용 설정되어 있어야 하고 수신자에게는 ROLE_RECEIVER가 사용 설정되어 있어야 합니다.
| 필드 | |
|---|---|
beneficiary |
선택사항입니다. 지원 중단됨: 대신 |
beneficiary_id |
선택사항입니다. 토큰을 수신하는 계정의 ID입니다. |
amount |
필수 항목입니다. 이체할 금액입니다. 금액은 양수여야 합니다. |
TransferContractTokenManager
계약 토큰 관리자의 소유권을 새 계정으로 이전합니다. 발신자는 통화의 현재 통화 운영자여야 합니다.
거래가 성공하면 통화의 현재 계약 토큰 관리자가 비활성화되고 새로 생성된 계정의 ID가 최종 거래의 TransactionCertificate에 이벤트로 반환됩니다.
| 필드 | |
|---|---|
public_key |
필수 항목입니다. 새 계약 토큰 관리자의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 새 계약 토큰 관리자의 공개 키이며 원장에 저장됩니다. 계약 토큰 관리자의 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다. 공개 키의 형식은 |
account_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
key_format |
선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다. |
TransferCurrencyOperator
지정된 통화 운영자의 소유권을 새 계정으로 이전합니다. 발신자는 플랫폼 운영자여야 합니다.
거래가 성공하면 지정된 통화 연산자를 비활성화하고 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.
| 필드 | |
|---|---|
public_key |
필수 항목입니다. 새 통화 운영자의 공개 키입니다. 이 공개 키는 통화 운영자와 연결되어 원장에 저장됩니다. 통화 운영자 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다. 공개 키의 형식은 |
key_format |
선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다. |
account_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
currency_operator |
선택사항입니다. 지원 중단됨: 대신 |
currency_operator_id |
선택사항입니다. 바꿀 통화 연산자의 ID입니다. 활성 상태여야 합니다. |
TransferPlatformOperator
플랫폼 운영자의 소유권을 새 계정으로 이전합니다. 발신자는 현재 플랫폼 운영자여야 합니다.
거래가 성공하면 현재 플랫폼 운영자가 비활성화되고 새로 생성된 계정의 ID가 최종 거래의 TransactionCertificate에 이벤트로 반환됩니다.
| 필드 | |
|---|---|
public_key |
필수 항목입니다. 새 플랫폼 운영자의 공개 키입니다. 이 공개 키는 플랫폼 운영자와 연결되어 원장에 저장됩니다. 플랫폼 운영자 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다. 공개 키의 형식은 |
key_format |
선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다. |
account_comment |
선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다. |
UserDetails
사용자 계정과 관련된 세부정보입니다.
| 필드 | |
|---|---|
account_manager |
출력 전용입니다. 지원 중단됨: 대신 |
account_manager_id |
출력 전용입니다. 이 사용자의 계정 관리자 ID입니다. |
token_manager |
출력 전용입니다. 지원 중단됨: 대신 |
token_manager_id |
출력 전용입니다. 이 사용자의 토큰 관리자 ID입니다. |
roles[] |
출력 전용입니다. 이 계정에 부여된 역할 목록입니다. |
account_status |
출력 전용입니다. 이 계정의 상태입니다. |
balance |
출력 전용입니다. 이 사용자 계정의 토큰 잔액입니다. |
account_fields |
출력 전용입니다. 지원 중단됨: 대신 |
contract_account_fields |
출력 전용입니다. 이 사용자의 계약 계정 필드 (계약 ID -> 필드)입니다. |
값
특정 유형의 구체적인 값입니다.
| 필드 | |
|---|---|
통합 필드 value. 실제 값입니다. value은 다음 중 하나여야 합니다. |
|
none_value |
선택사항입니다. None 값을 나타냅니다. |
bool_value |
선택사항입니다. 부울 값 |
int64_value |
선택사항입니다. int64 값입니다. |
string_value |
선택사항입니다. 문자열 값입니다. |
account_id |
선택사항입니다. 계정 ID입니다. |
dict_value |
선택사항입니다. 사전 값입니다. |
qualified_currency_value |
선택사항입니다. 유효한 통화 값입니다. |
amount_value |
선택사항입니다. 금액 값입니다. |