Package google.cloud.universalledger.v1

색인

UniversalLedger

Google Cloud Universal Ledger와 상호작용하기 위한 서비스입니다. 엔드포인트는 Google에서 사전 생성하고 관리하며 사용자가 수정할 수 없습니다. 사용 가능한 엔드포인트의 이름은 공개 문서에 제공됩니다. 엔드포인트는 Universal Ledger 네트워크 내의 리전 리소스입니다. 엔드포인트로 전송된 요청은 지정된 리전 내 지정된 네트워크의 여러 검사기로 라우팅될 수 있습니다.

GetEndpoint

rpc GetEndpoint(GetEndpointRequest) returns (Endpoint)

특정 엔드포인트의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

ListEndpoints

rpc ListEndpoints(ListEndpointsRequest) returns (ListEndpointsResponse)

특정 프로젝트 및 위치의 모든 엔드포인트를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

QueryAccount

rpc QueryAccount(QueryAccountRequest) returns (QueryAccountResponse)

네트워크에 저장된 계정에 관한 모든 정보를 쿼리합니다. 엔드포인트가 네트워크 및 리전 내의 다른 유효성 검사기로 요청을 라우팅할 수 있고 유효성 검사기가 특정 시점에 동일한 라운드 ID에 있지 않을 수 있으므로 반환된 계정 세부정보는 호출 간에 다를 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

QueryData

rpc QueryData(QueryDataRequest) returns (QueryDataResponse)

계정, 거래 등 원장에 저장된 정보를 네트워크에 쿼리합니다.

계정 잔액과 같은 특정 민감한 필드에 대한 액세스는 요청의 서명에서 파생된 발신자의 신원에 따라 제한될 수 있습니다. 발신자에게 권한이 없으면 민감한 필드가 응답에서 수정되고 redacted_fields 필드에 보고됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

QueryTransactionState

rpc QueryTransactionState(QueryTransactionStateRequest) returns (QueryTransactionStateResponse)

트랜잭션의 상태를 쿼리합니다. 이 메서드는 네트워크에 제출된 모든 트랜잭션에 대해 호출할 수 있습니다. 엔드포인트가 네트워크 및 리전 내의 다른 유효성 검사기로 요청을 라우팅할 수 있고 유효성 검사기가 특정 시점에 동일한 라운드 ID에 있지 않을 수 있으므로 반환된 거래 세부정보는 호출 간에 다를 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

SubmitOperationalTransaction

rpc SubmitOperationalTransaction(SubmitOperationalTransactionRequest) returns (SubmitOperationalTransactionResponse)

운영 트랜잭션을 네트워크에 제출합니다. 이 메서드는 트랜잭션이 네트워크의 대부분의 유효성 검사기에 복제된 후에만 반환되거나 트랜잭션이 실패한 경우에만 반환됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

SubmitTransaction

rpc SubmitTransaction(SubmitTransactionRequest) returns (SubmitTransactionResponse)

트랜잭션을 네트워크에 제출합니다. 요청이 먼저 기본적인 정확성에 대해 검증됩니다. 유효성 검사에 실패하면 요청이 즉시 실패합니다. 유효성 검사에 성공하면 이 메서드는 트랜잭션이 네트워크의 대부분의 검사기에 복제된 후에만 반환되거나 요청이 실패할 때까지 반환되지 않습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

계정

원장의 계정 상태를 나타냅니다.

필드
sequence_number

int64

출력 전용입니다. 이 계정의 시퀀스 넘버입니다. 이 숫자는 이 계정에서 전송하는 각 거래에 따라 증가합니다.

public_key

bytes

출력 전용입니다. 이 계정과 연결된 기본 공개 키로, 서명 확인에 사용됩니다.

round_id

int64

출력 전용입니다. 제공된 계정 정보가 정확한 실행 라운드의 ID입니다 (블록 '높이'와 유사).

comment

string

출력 전용입니다. 이 계정이 생성될 때 저장된 계정 댓글입니다.

통합 필드 account_details. 계정 유형에 따른 구체적인 세부정보 account_details은 다음 중 하나여야 합니다.
user_details

UserDetails

출력 전용입니다. 표준 사용자 계정의 세부정보입니다.

account_manager_details

AccountManagerDetails

출력 전용입니다. 계정 관리자 계정의 세부정보입니다.

token_manager_details

TokenManagerDetails

출력 전용입니다. 토큰 관리자 계정의 세부정보입니다.

contract_token_manager_details

ContractTokenManagerDetails

출력 전용입니다. 계약 토큰 관리자 계정의 세부정보입니다.

contract_details

ContractDetails

출력 전용입니다. 스마트 계약 계정의 세부정보입니다.

clearinghouse_details

ClearingHouseDetails

출력 전용입니다. 청산소 계정의 세부정보입니다.

currency_operator_details

CurrencyOperatorDetails

출력 전용입니다. 통화 운영자 계정의 세부정보입니다.

platform_operator_details

PlatformOperatorDetails

출력 전용입니다. 플랫폼 운영자 계정의 세부정보입니다.

AccountIdList

계정 ID 목록입니다.

필드
values[]

string

선택사항입니다. 계정 ID 값입니다.

AccountManagerDetails

계정 관리자에게만 해당하는 세부정보입니다.

필드
token_manager
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 token_manager_id을 사용하세요. 이 계정 관리자가 만든 계정의 기본 토큰 관리자입니다.

num_accounts

int32

출력 전용입니다. 이 계정 관리자가 만든 계정 수입니다.

token_manager_id

string

출력 전용입니다. 이 계정 관리자가 만든 계정의 기본 토큰 관리자의 ID입니다.

AccountStatus

계정의 상태입니다.

열거형
ACCOUNT_STATUS_UNSPECIFIED 상태가 잘못되었습니다.
ACCOUNT_STATUS_ACTIVE 계정이 역할에서 허용하는 작업을 수행할 수 있는 활성 상태입니다.
ACCOUNT_STATUS_INACTIVE 계정의 모든 거래가 금지된 비활성 상태입니다. 계정 관리자는 계정 관리 거래를 계속 보낼 수 있습니다.

ActivateAccount

계정을 ACCOUNT_STATUS_ACTIVE로 표시합니다. 활성화할 계정의 계정 관리자가 발신자여야 합니다.

계정 소유자는 계정의 역할에 따라 허용되는 일반 작업을 재개할 수 있습니다.

필드
account
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 account_id을 사용하세요. 활성화할 계정의 ID입니다.

account_id

string

선택사항입니다. 활성화할 계정의 ID입니다. account 또는 account_id 중 하나를 지정해야 합니다. 값은 60자로 제한됩니다.

AddRoles

계정에 지정된 역할을 추가합니다. 수정할 계정의 계정 관리자여야 합니다.

필드
account
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 account_id을 사용하세요. 수정할 계정의 ID입니다.

account_id

string

선택사항입니다. 수정할 계정의 ID입니다. account 또는 account_id 중 하나를 지정해야 합니다. 값은 60자로 제한됩니다.

roles[]

Role

필수 항목입니다. 추가할 역할입니다.

AmountValue

통화로 표시된 금액을 나타냅니다.

필드
currency

QualifiedCurrencyValue

필수 항목입니다. 금액의 통화입니다.

amount_value

int64

필수 항목입니다. 통화의 소수 단위 수입니다.

BalanceToSettle

두 토큰 관리자 간에 결제할 잔액입니다.

필드
balance_payer
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 balance_payer_id을 사용하세요. 정산할 잔액을 보유한 계정입니다.

balance_payer_id

string

출력 전용입니다. 정산할 잔액을 보유한 계정의 ID입니다.

balance_receiver
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 balance_receiver_id을 사용하세요. 정산할 잔액을 받을 계정입니다.

balance_receiver_id

string

출력 전용입니다. 정산할 잔액이 있는 계정의 ID입니다.

balance

CurrencyValue

출력 전용입니다. 정산할 잔액입니다. 양수여야 합니다.

BoolList

불리언 목록입니다.

필드
values[]

bool

선택사항입니다. 불리언 값입니다.

소모량

통화 토큰을 소각합니다. 전송자는 토큰 관리자여야 하며, 소각할 토큰을 제공하는 계정은 트랜잭션에 추가로 서명해야 합니다.

예상되는 흐름은 토큰 관리자에게 지정된 소각 계정이 있으며 고객이 소각되기 전에 토큰을 이 계정으로 이전한다는 것입니다. 또는 고객이 트랜잭션에 직접 서명할 수 있으며, 이 경우 원자적 '전송 및 소각' 트랜잭션으로 작동합니다.

필드
burn_amount

CurrencyValue

필수 항목입니다. 소각할 금액입니다.

payer
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 payer_id을 사용하세요. 소각할 토큰을 제공하는 계정입니다. 계정에 ROLE_PAYER가 사용 설정되어 있어야 합니다.

payer_id

string

선택사항입니다. 소각할 토큰을 제공하는 계정의 ID입니다. 지불인 계정에 ROLE_PAYER가 사용 설정되어 있어야 합니다. payer 또는 payer_id 중 하나를 지정해야 합니다.

ChangeAccountManager

특정 계정 관리 책임을 다른 관리자에게 이전합니다. 발신자는 계정의 현재 계정 관리자여야 하며, 동의를 제공하려면 새 관리자도 이 거래에 서명해야 합니다.

필드
account
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 account_id을 사용하세요. 관리자를 변경할 계정의 ID입니다.

account_id

string

선택사항입니다. 관리자를 변경할 계정의 ID입니다. account 또는 account_id 중 하나를 지정해야 합니다. 값은 60자로 제한됩니다.

next_manager
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 next_manager_id을 사용하세요. 새로 제안된 계정 관리자의 ID입니다. 유효성 검사를 위해서는 새 관리자도 이 거래에 서명해야 합니다.

next_manager_id

string

선택사항입니다. 새로 제안된 계정 관리자의 ID입니다. 유효성 검사를 위해서는 새 관리자도 이 거래에 서명해야 합니다. next_manager 또는 next_manager_id 중 하나를 지정해야 합니다. 값은 60자로 제한됩니다.

ClearingHouseDetails

클리어링하우스와 관련된 세부정보입니다.

필드
account_status

AccountStatus

출력 전용입니다. 이 계정의 상태입니다.

balances[]

BalanceToSettle

출력 전용입니다. 이 결제 대행업체에서 현재 추적하여 결제하는 잔액입니다.

settlement_mode

SettlementMode

출력 전용입니다. 이 결제 대행업체의 결제 모드입니다.

ClientTransaction

클라이언트가 시작한 거래를 나타냅니다.

필드
source
(deprecated)

Entity

선택사항입니다. 트랜잭션 발신자입니다. 지원 중단됨: 대신 sender_id을 사용하세요.

sender_id

string

선택사항입니다. 이 거래를 전송하는 계정의 ID입니다. source 또는 sender_id 중 하나를 설정해야 합니다.

signatories[]
(deprecated)

Entity

선택사항입니다. 발신자 외에 이 거래에 서명한 계정입니다. 지원 중단됨: 대신 other_signatory_ids을 사용하세요.

other_signatory_ids[]

string

선택사항입니다. 발신자 외에 이 거래에 서명한 계정의 ID입니다.

sequence_number

int64

필수 항목입니다. 0부터 시작하는 고유한 단조 증가 숫자입니다.

이 숫자는 동일한 거래 발신자가 이전에 네트워크에 제출한 각 거래에 대해 1씩 증가해야 합니다.

여기에는 체인의 일부로 제출되었을 수 있는 거래 단위가 포함되지 않으며, 체인에는 순서 번호를 설정하면 안 됩니다. 하지만 트랜잭션 체인의 발신자는 포함됩니다.

chained_unit

bool

이 클라이언트 트랜잭션이 트랜잭션 체인의 일부인 경우 true로 설정해야 합니다. 그렇지 않으면 false로 설정해야 합니다.

이는 체인의 일부로 의도된 서명된 트랜잭션이 단독으로 제출되는 것을 방지하는 데 필요합니다.

통합 필드 kind. 클라이언트 거래 관련 메시지입니다. kind은 다음 중 하나여야 합니다.
app
(deprecated)

Any

선택사항입니다. 지원 중단됨: 대신 메시지별 필드 중 하나를 사용하세요. 클라이언트 거래 관련 메시지입니다. 다음 중 하나여야 합니다.

operational

Any

선택사항입니다. 운영 거래 메시지입니다. 이 이메일은 플랫폼 운영자만 보낼 수 있습니다. 다음 중 하나여야 합니다.

transfer_platform_operator_transaction

TransferPlatformOperator

선택사항입니다. 새 계정으로 플랫폼 운영자 역할을 이전하기 위한 메시지입니다.

create_currency_operator_transaction

CreateCurrencyOperator

선택사항입니다. 새 통화 연산자를 만드는 메시지입니다.

transfer_currency_operator_transaction

TransferCurrencyOperator

선택사항입니다. 통화 운영자 역할을 새 계정으로 이전하기 위한 메시지입니다.

create_clearinghouse_transaction

CreateClearinghouse

선택사항입니다. 새 결제 대행사를 만드는 메시지입니다.

create_account_manager_transaction

CreateAccountManager

선택사항입니다. 새 계정 관리자를 만드는 메시지입니다.

create_token_manager_transaction

CreateTokenManager

선택사항입니다. 요청을 전송하는 운영자의 통화와 연결된 새 토큰 관리자를 만드는 메시지입니다.

increase_token_issuance_limit_transaction

IncreaseTokenIssuanceLimit

선택사항입니다. 타겟 계정이 예비 자금을 입금했으며 토큰 발행 한도가 증가했음을 네트워크에 알립니다.

decrease_token_issuance_limit_transaction

DecreaseTokenIssuanceLimit

선택사항입니다. 타겟 계정이 예비 자금을 인출하고 토큰 발행 한도를 줄이기를 원한다고 네트워크에 알립니다.

settlement_request_transaction

SettlementRequest

선택사항입니다. 정산 작업을 시작하기 위한 메시지입니다.

mint_transaction

Mint

선택사항입니다. 통화 토큰을 발행하고 계정으로 전송하는 메시지입니다.

burn_transaction

Burn

선택사항입니다. 계정에서 통화 토큰을 소각하기 위한 메시지입니다.

create_account_transaction

CreateAccount

선택사항입니다. 신규 사용자 계정을 만들기 위한 메시지입니다.

deactivate_account_transaction

DeactivateAccount

선택사항입니다. 사용자 계정을 비활성화하기 위한 메시지입니다.

activate_account_transaction

ActivateAccount

선택사항입니다. 사용자 계정 활성화 메시지입니다.

add_roles_transaction

AddRoles

선택사항입니다. 계정에 역할을 추가하기 위한 메시지입니다.

remove_roles_transaction

RemoveRoles

선택사항입니다. 계정에서 역할을 삭제하는 메시지입니다.

change_account_manager_transaction

ChangeAccountManager

선택사항입니다. 계정의 계정 관리자를 변경하는 메시지입니다.

transfer_transaction

Transfer

선택사항입니다. 한 사용자 계정에서 다른 사용자 계정으로 토큰을 전송하기 위한 메시지입니다.

create_contract_transaction

CreateContract

선택사항입니다. 원장에서 새 계약을 생성하기 위한 메시지입니다.

grant_contract_permissions_transaction

GrantContractPermissions

선택사항입니다. 계약에 권한을 부여하는 메시지입니다.

invoke_contract_method_transaction

InvokeContractMethod

선택사항입니다. 계약 메서드의 실행을 호출하는 메시지입니다.

create_contract_token_manager_transaction

CreateContractTokenManager

선택사항입니다. 요청을 전송하는 운영자의 통화와 연결된 새 토큰 관리자를 만드는 메시지입니다.

transfer_contract_token_manager_transaction

TransferContractTokenManager

선택사항입니다. 한 계정에서 다른 계정으로 통화의 토큰 관리자 역할을 이전하기 위한 메시지입니다.

remove_signing_public_key_transaction

RemoveSigningPublicKey

선택사항입니다. 계정 서명 키 삭제 메시지

replace_signing_public_key_transaction

ReplaceSigningPublicKey

선택사항입니다. 계정 서명 키를 대체하기 위한 메시지입니다.

chain

TransactionChain

선택사항입니다. 순차적으로 실행할 여러 거래 단위를 포함하는 거래 체인의 메시지입니다.

ContractDetails

스마트 계약에 관한 세부정보입니다.

필드
owner
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 owner_id을 사용하세요. 계약의 소유자입니다.

owner_id

string

출력 전용입니다. 계약 소유자의 ID입니다.

code

bytes

출력 전용입니다. 직렬화된 계약 코드입니다.

contract_fields

Fields

출력 전용입니다. 이 계약의 계약 필드 (필드 이름 -> 값)입니다.

currency_balances

map<string, CurrencyValue>

출력 전용입니다. 계약에서 보유한 통화 잔액 (통화 연산자 -> 잔액)입니다.

ContractPermission

계약에 부여할 수 있는 권한 집합입니다. 향후 더 많은 값이 추가될 예정입니다.

열거형
CONTRACT_PERMISSION_UNSPECIFIED 잘못된 권한입니다.
CONTRACT_PERMISSION_STORAGE

계정에서 권한을 부여한 저장소에 계약이 읽고 쓸 수 있도록 허용합니다. 계약은 이전에 작성한 속성만 읽고 쓸 수 있습니다.

이 권한은 계약이 다른 계약에서 관리하는 데이터를 읽거나 쓰는 것을 허용하지 않으며, 계약이 다른 계정 속성 (예: 기본 통화의 계정 잔액)을 직접 업데이트하는 것도 허용하지 않습니다.

ContractTokenManagerDetails

계약 토큰 관리자와 관련된 세부정보입니다.

필드
issuance_limit

CurrencyValue

출력 전용입니다. 이 계약 토큰 관리자가 지원할 수 있는 토큰의 양입니다.

계약 토큰 관리자는 발급 한도를 늘리거나 줄일 수 없으므로 이 값은 issued_tokens와 같아야 합니다.

issued_tokens

CurrencyValue

출력 전용입니다. 이 계약 토큰 관리자가 지원하는 토큰의 양입니다 (즉, 총 책임).

이는 통화의 계약에 보유된 모든 잔액의 합계에 정산 매트릭스의 순 포지션을 더한 값과 같습니다.

previous_contract_token_manager_id

string

출력 전용입니다. 이 통화의 이전 계약 토큰 관리자의 계정 ID입니다. 이렇게 하면 이전 관리자를 모두 찾기 위해 탐색할 수 있는 감사 추적이 형성됩니다. 이 통화의 첫 번째 계약 토큰 관리자인 경우 비어 있습니다.

account_status

AccountStatus

출력 전용입니다. 이 계정의 상태입니다.

CreateAccount

신규 사용자 계정을 만듭니다. 발신자는 계정 관리자여야 합니다.

거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.

필드
public_key

bytes

필수 항목입니다. 계정 소유자의 공개 키입니다. 이는 발신자의 공개 키가 아닙니다. 계정 소유자의 공개 키이며 원장에 저장됩니다. 생성된 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다.

공개 키의 형식은 key_format 필드에 정의되어 있습니다. 공개 정보로 간주됩니다.

key_format

KeyFormat

선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다.

roles[]

Role

선택사항입니다. 이 계정에 부여할 역할 목록입니다.

account_status

AccountStatus

선택사항입니다. 생성할 계정의 상태입니다. 새로 생성된 계정의 계정 상태는 기본적으로 ACCOUNT_STATUS_ACTIVE입니다.

account_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

token_manager
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 token_manager_id을 사용하세요. 이 계정의 토큰 관리자입니다. 이 필드는 선택사항이며 제공되지 않으면 계정 관리자 (즉, 이 거래의 발신자)와 연결된 기본 토큰 관리자가 사용됩니다.

token_manager_id

string

선택사항입니다. 이 계정의 토큰 관리자 ID입니다. 이 필드는 선택사항이며 제공되지 않으면 계정 관리자 (즉, 이 거래의 발신자)와 연결된 기본 토큰 관리자가 사용됩니다. 값은 60자로 제한됩니다.

CreateAccountManager

새 계정 관리자를 만듭니다. 발신자는 통화 운영자여야 합니다.

거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.

필드
public_key

bytes

필수 항목입니다. 새 계정 관리자의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 이 공개 키는 계정 관리자와 연결되고 원장에 저장됩니다. 계정 관리자 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다.

공개 키의 형식은 key_format 필드에 정의되어 있습니다. 공개 정보로 간주됩니다.

key_format

KeyFormat

선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다.

default_token_manager
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 default_token_manager_id을 사용하세요. 이 관리자가 생성할 계정의 기본 토큰 관리자입니다.

default_token_manager_id

string

선택사항입니다. 이 관리자가 생성할 계정의 기본 토큰 관리자의 ID입니다. 값은 60자로 제한됩니다.

account_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

CreateClearinghouse

새 결제 대행사를 만듭니다. 발신자는 통화 운영자여야 합니다.

거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.

필드
public_key

bytes

필수 항목입니다. 새 정산소의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 이 공개 키는 중앙 기관과 연결되고 원장에 저장됩니다. 이는 정산소 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다.

공개 키의 형식은 key_format 필드에 정의되어 있습니다. 공개 정보로 간주됩니다.

key_format

KeyFormat

선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다.

account_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

settlement_mode

SettlementMode

필수 항목입니다. 이 결제 대행사의 정산 모드입니다. 필수 항목입니다. 공개 정보로 간주됩니다.

CreateContract

원장에 계약을 저장합니다.

필드
contract_bytes

bytes

직렬화된 계약 바이트입니다.

arguments
(deprecated)

map<string, Value>

선택사항입니다. 변경할 수 없습니다. 지원 중단됨: 대신 init_arguments을 사용하세요. __init__ 메서드의 인수입니다.

init_arguments

map<string, Value>

선택사항입니다. 변경할 수 없습니다. __init__ 메서드의 인수를 포함합니다.

contract_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계약의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

CreateContractTokenManager

요청을 전송하는 운영자의 통화와 연결된 새 계약 토큰 관리자를 만듭니다. 발신자는 통화 운영자여야 합니다. 새로 생성된 계약 토큰 관리자는 기본적으로 활성 상태입니다. 계약 토큰 관리자를 교체해야 하는 경우 TransferContractTokenManager 트랜잭션을 대신 전송해야 합니다. 동일한 통화와 연결된 다른 계약 토큰 관리자가 있는 경우 이 거래는 실패합니다.

일반 토큰 관리자와 달리 계약 토큰 관리자는 발행 또는 소각과 같은 거래를 실행할 수 없습니다. 하지만 정산 작업에는 참여할 수 있습니다.

거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.

필드
public_key

bytes

필수 항목입니다. 새 계약 토큰 관리자의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 이 공개 키는 계약 토큰 관리자와 연결되고 원장에 저장됩니다. 계약 토큰 관리자의 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다.

공개 키의 형식은 key_format 필드에 정의되어 있습니다. 공개 정보로 간주됩니다.

account_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

key_format

KeyFormat

선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다.

CreateCurrencyOperator

새 통화 연산자를 만듭니다. 발신자는 플랫폼 운영자여야 합니다.

거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.

이 거래는 시스템에 새로운 통화를 도입해야 합니다. 지정된 통화가 이미 있으면 이 거래는 실패합니다. 통화 운영자를 교체해야 하는 경우 TransferCurrencyOperator 거래를 대신 전송해야 합니다.

필드
public_key

bytes

필수 항목입니다. 새 통화 운영자의 공개 키입니다. 이 공개 키는 통화 운영자와 연결되어 원장에 저장됩니다. 운영자 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다.

공개 키의 형식은 key_format 필드에 정의되어 있습니다. 공개 정보로 간주됩니다.

key_format

KeyFormat

선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다.

account_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

currency
(deprecated)

string

선택사항입니다. 지원 중단됨: 대신 currency_code을 사용하세요. 이 운영자와 연결된 법정 통화로, 3개의 대문자로 된 ISO 4217 코드로 표시됩니다. 공개 정보로 간주됩니다.

currency_code

string

선택사항입니다. 이 운영자와 연결된 법정 통화로, 3개의 대문자로 된 ISO 4217 코드로 표시됩니다. 공개 정보로 간주됩니다.

CreateSnapshot

이 유형에는 필드가 없습니다.

네트워크의 스냅샷 생성을 트리거합니다. 발신자는 플랫폼 운영자여야 합니다.

CreateTokenManager

요청을 보내는 운영자의 통화와 연결된 새 토큰 관리자를 만듭니다. 발신자는 통화 운영자여야 합니다.

거래가 성공하면 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.

필드
public_key

bytes

필수 항목입니다. 새 토큰 관리자의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 이 공개 키는 토큰 관리자와 연결되고 원장에 저장됩니다. 토큰 관리자의 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다.

공개 키의 형식은 key_format 필드에 정의되어 있습니다. 공개 정보로 간주됩니다.

key_format

KeyFormat

선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다.

account_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

CurrencyOperatorDetails

통화 운영자와 관련된 세부정보입니다.

필드
currency
(deprecated)

string

출력 전용입니다. 지원 중단됨: 대신 currency_code을 사용하세요. 이 계정과 연결된 통화로, 3자리 ISO 4217 코드로 표시됩니다.

currency_code

string

출력 전용입니다. 이 계정과 연결된 통화의 ID입니다. 3자리 ISO 4217 코드로 표시됩니다.

account_status

AccountStatus

출력 전용입니다. 이 계정의 상태입니다.

previous_entity_id
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 previous_currency_operator_id을 사용하세요. 이 계정에 통화 운영자 역할의 소유권을 이전한 이전 통화 운영자입니다. 통화의 첫 번째 통화 연산자인 경우 비어 있습니다.

previous_currency_operator_id

string

출력 전용입니다. 이 계정으로 통화 운영자 역할의 소유권을 이전한 이전 통화 운영자의 ID입니다. 통화의 첫 번째 통화 연산자인 경우 비어 있습니다.

platform_operator_entity_id
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 platform_operator_id을 사용하세요. 이 통화 연산자를 만든 플랫폼 운영자입니다.

platform_operator_id

string

출력 전용입니다. 이 통화 운영자를 만든 플랫폼 운영자의 ID입니다.

contract_token_manager
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 contract_token_manager_id을 사용하세요. 이 통화 연산자와 연결된 계약 토큰 관리자입니다.

contract_token_manager_id

string

출력 전용입니다. 이 통화 연산자와 연결된 계약 토큰 관리자의 ID입니다.

clearinghouse_id

string

출력 전용입니다. 이 통화 운영자와 연결된 결제 대행사의 ID입니다.

CurrencyValue

통화 (즉, 돈) 금액을 나타냅니다. 지정된 통화는 이 메시지에 포함되지 않습니다. 관련 통화는 거래를 전송하는 계정에 따라 결정됩니다. 각 계정에는 변경할 수 없는 고유한 통화가 연결되어 있습니다.

필드
value

int64

필수 항목입니다. 통화의 소수 단위 수입니다.

이 최소 유효 단위는 '소수 단위'라고 하며 ISO 4217에 지정되어 있습니다. 예를 들어 USD의 경우 값은 센트 수이고 GBP의 경우 값은 펜스 수입니다. 소수가 없는 일본 엔화의 경우 엔화 금액입니다.

DeactivateAccount

계정을 ACCOUNT_STATUS_INACTIVE로 표시합니다. 보낸 사람은 비활성화할 계정의 계정 관리자여야 합니다.

즉, 계정 소유자는 역할과 관계없이 계정에서 거래를 할 수 없습니다.

필드
account
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 account_id을 사용하세요. 비활성화할 계정의 ID입니다.

account_id

string

선택사항입니다. 비활성화할 계정의 ID입니다. account 또는 account_id 중 하나를 지정해야 합니다. 값은 60자로 제한됩니다.

DecreaseTokenIssuanceLimit

타겟 계정이 예비 자금을 인출하고 토큰 발행 한도를 줄이기를 원한다고 네트워크에 알립니다. 발신자는 클리어링하우스 계정이어야 합니다.

예비 자금을 인출하려면 이 거래가 먼저 성공적으로 완료되어야 합니다. 발급된 금액이 이미 요청된 감소된 한도를 초과하는 경우와 같이 거래가 실패할 수 있으므로 이 작업이 필요합니다.

필드
token_manager
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 token_manager_id을 사용하세요. 발행 한도를 낮출 기관 계정의 ID입니다. 거래가 유효하려면 이 계정이 토큰 관리자여야 합니다.

token_manager_id

string

선택사항입니다. 발행 한도를 낮출 기관 계정의 ID입니다. 거래가 유효하려면 이 계정이 토큰 관리자여야 합니다. token_manager_id (권장) 또는 token_manager (지원 중단됨) 중 하나를 지정해야 합니다.

amount

CurrencyValue

필수 항목입니다. 한도를 낮출 금액입니다. 금액은 양수여야 합니다. 감소된 한도가 현재 발급된 토큰보다 낮으면 거래가 실패합니다.

DictList

사전 목록입니다.

필드
values[]

DictValue

선택사항입니다. DictValue 값입니다. 모든 중첩된 dict는 동일한 구체적인 유형을 가져야 합니다.

DictValue

색인은 키를 값에 매핑합니다. 예를 들어 keys[0] 키는 values[0]에 매핑됩니다.

필드
통합 필드 keys. 각 키는 정확히 한 종류일 수 있습니다. keys은 다음 중 하나여야 합니다.
bool_keys

BoolList

선택사항입니다. 불리언 키 목록입니다.

string_keys

StringList

선택사항입니다. 문자열 키 목록입니다.

int64_keys

Int64List

선택사항입니다. int64 키 목록입니다.

account_id_keys

AccountIdList

선택사항입니다. 계정 ID 키 목록입니다.

통합 필드 values. 각 값은 정확히 한 종류일 수 있습니다. values은 다음 중 하나여야 합니다.
bool_values

BoolList

선택사항입니다. 불리언 값 목록입니다.

string_values

StringList

선택사항입니다. 문자열 값의 목록입니다.

int64_values

Int64List

선택사항입니다. int64 값의 목록입니다.

dict_values

DictList

선택사항입니다. 값은 중첩된 사전 목록입니다.

엔드포인트

Universal Ledger 엔드포인트를 나타냅니다.

필드
name

string

식별자. 엔드포인트의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint}

항목

Universal Ledger 네트워크의 항목입니다. 모든 계정은 법인에 연결됩니다. 엔티티 ID는 계정 ID라고도 하며, 네트워크 전체에서 고유하고 변경할 수 없습니다.

필드
id

string

출력 전용입니다. 엔티티에 할당된 ID입니다. 계정 생성 시 네트워크에서 할당합니다.

EventDetails

상태 이벤트의 추가 세부정보를 나타냅니다.

필드
통합 필드 event_details. 이벤트 세부정보입니다. event_details은 다음 중 하나여야 합니다.
execution_details

ExecutionDetails

출력 전용입니다. 실행 이벤트의 추가 세부정보입니다.

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

int64

출력 전용입니다. 실행 이벤트가 발생한 라운드 ID입니다.

필드

계약 필드 또는 계정 필드를 나타내는 데 사용되는 계약의 필드 (필드 이름 -> 값) 맵입니다.

필드
fields

map<string, Value>

출력 전용입니다. 필드 이름과 값의 맵입니다.

GetEndpointRequest

GetEndpoint 요청 메시지입니다.

필드
name

string

필수 항목입니다. 가져올 엔드포인트의 이름입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint}

GrantContractPermissions

트랜잭션 발신자가 계약에 권한을 부여합니다. delegate_contract_id가 지정되면 권한과 해당 스토리지는 발신자가 아닌 delegate_contract_id 계약에만 부여됩니다.

권한 취소는 지원되지 않습니다.

필드
contract
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 contract_id을 사용하세요. 권한이 부여되는 계약의 ID입니다.

contract_id

string

선택사항입니다. 권한이 부여되는 계약의 ID입니다. contract 또는 contract_id 중 하나를 지정해야 합니다.

permissions[]

ContractPermission

부여할 권한입니다.

delegate_contract_id

string

선택사항입니다. 권한이 부여되는 계약 ID입니다. 거래 발신자는 이 계약의 소유자여야 합니다.

IncreaseTokenIssuanceLimit

토큰 발행 및 민팅을 위한 트랜잭션입니다. 타겟 계정이 예비 자금을 입금했으며 토큰 발행 한도가 증가했음을 네트워크에 알립니다. 발신자는 클리어링하우스 계정이어야 합니다.

필드
token_manager
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 token_manager_id을 사용하세요. 민트 한도를 늘릴 기관 계정의 ID입니다. 거래가 유효하려면 이 계정이 토큰 관리자여야 합니다.

token_manager_id

string

선택사항입니다. 민트 한도를 늘릴 기관 계정의 ID입니다. 거래가 유효하려면 이 계정이 토큰 관리자여야 합니다. token_manager 또는 token_manager_id 중 하나를 지정해야 합니다.

amount

CurrencyValue

필수 항목입니다. 한도를 늘릴 금액입니다. 금액은 양수여야 합니다.

Int64List

int64 목록입니다.

필드
values[]

int64

선택사항입니다. int64 값입니다.

InvokeContractMethod

계약 메서드의 실행을 호출합니다.

필드
contract
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 contract_id을 사용하세요. 실행할 계약의 ID입니다.

contract_id

string

선택사항입니다. 실행할 계약의 ID입니다. contract 또는 contract_id 중 하나를 지정해야 합니다.

method_name

string

실행할 메서드의 이름입니다.

arguments
(deprecated)

map<string, Value>

선택사항입니다. 변경할 수 없습니다. 지원 중단됨: 대신 method_arguments을 사용하세요. 메서드의 인수입니다.

method_arguments

map<string, Value>

선택사항입니다. 변경할 수 없습니다. 메서드에 전달할 인수를 포함합니다.

payment

CurrencyValue

결제 금액입니다. 지급 가능한 메서드를 호출할 때는 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

string

필수 항목입니다. 이 엔드포인트 컬렉션을 소유한 상위 항목입니다. 형식: projects/{project}/locations/{location}

page_size

int32

선택사항입니다. 반환할 최대 엔드포인트 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 엔드포인트가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListEndpoints 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

ListEndpointsResponse

ListEndpoints의 응답 메시지입니다.

필드
endpoints[]

Endpoint

지정된 프로젝트 및 위치의 엔드포인트입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

MerkleTree

루트 노드의 암호화 다이제스트가 있는 Merkle 트리입니다.

필드
root_hash_hex
(deprecated)

string

출력 전용입니다. 루트 노드의 암호화 다이제스트입니다. 지원 중단됨: 대신 root_digest_hex을 사용하세요.

root_digest_hex

string

출력 전용입니다. 루트 노드의 다이제스트의 16진수 표현입니다. 형식: 64자리 16진수 문자열

num_transactions

int64

출력 전용입니다. 트리의 트랜잭션 수입니다.

Mint

통화 토큰을 발행하고 지정된 계정으로 전송합니다. 발신자는 토큰 관리자여야 합니다.

필드
mint_amount

CurrencyValue

필수 항목입니다. 발행할 금액입니다. 토큰 관리자가 발행한 총 토큰이 발행 한도를 초과하지 않도록 금액을 설정해야 합니다. 금액이 이보다 높으면 거래가 거부되어야 합니다.

beneficiary
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 beneficiary_id을 사용하세요. 주조된 금액이 전송되어야 하는 계정입니다. 수혜자 계정에 ROLE_RECEIVER가 사용 설정되어 있어야 합니다.

beneficiary_id

string

선택사항입니다. 생성된 금액을 전송할 계정의 ID입니다. 수신 계정에 ROLE_RECEIVER가 사용 설정되어 있어야 합니다. beneficiary 또는 beneficiary_id 중 하나를 지정해야 합니다.

NoneValue

None 값을 나타내는 싱글톤 열거형입니다.

열거형
NONE_VALUE_UNSPECIFIED None 값입니다.

PlatformOperatorDetails

플랫폼 운영자와 관련된 세부정보입니다.

필드
account_status

AccountStatus

출력 전용입니다. 이 계정의 상태입니다.

previous_entity_id
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 previous_platform_operator_id을 사용하세요. 이 계정에 플랫폼 운영자 역할의 소유권을 이전한 이전 플랫폼 운영자입니다. 첫 번째 플랫폼 운영자인 경우 비어 있습니다.

previous_platform_operator_id

string

출력 전용입니다. 이 계정에 플랫폼 운영자 역할의 소유권을 이전한 이전 플랫폼 운영자의 ID입니다. 첫 번째 플랫폼 운영자인 경우 비어 있습니다.

ProofOfInclusion

트랜잭션의 효과가 월드 상태에 포함되었음을 증명하는 인증서입니다.

필드
transaction_certificate

TransactionCertificate

출력 전용입니다. 특정 라운드에 트랜잭션 효과가 포함되었음을 증명하는 인증서입니다.

round_certificate

RoundCertificate

출력 전용입니다. 라운드 실행 인증서입니다.

path_to_round_root[]

MerkleTreeNode

출력 전용입니다. 실행 라운드에 트랜잭션 효과가 포함되었음을 나타내는 암호화 증명입니다.

주어진 리프 (트랜잭션 다이제스트)에서 실행 라운드의 루트까지의 경로로 제공됩니다. 경로는 (왼쪽 하위 요소, 오른쪽 하위 요소) 쌍의 목록으로 표현되며 첫 번째 쌍은 지정된 리프의 상위 노드의 왼쪽 및 오른쪽 하위 요소입니다. 예를 들어 Merkle 트리가 8개의 리프 다이제스트 [t0, t1, t2, t3, t4, t5, t6, t7]로 빌드되었고 구조가 다음과 같다고 가정해 보겠습니다.

       _____root_digest____
      |                    |
   __ h20__             __h21__
  |        |           |       |
 h10     h11          h12     h13
 | |     | |          | |     | |
t0 t1   t2 t3        t4 t5   t6 t7

여기에서 t0path_to_round_root에는 [(t0, t1), (h10, h11), (h20, h21)]이 포함됩니다.

각 경로 노드의 SHA-256 다이제스트를 연속으로 계산하여 경로의 다이제스트가 round_certificate.merkle_tree.root_digest_hex와 동일한 값을 생성하는지 확인할 수 있습니다. 따라서 리프가 라운드의 Merkle 트리에 포함되었는지 확인합니다.

MerkleTreeNode

Merkle 트리 경로의 노드를 나타냅니다.

필드
left_child_hash_hex
(deprecated)

string

출력 전용입니다. 노드의 왼쪽 하위 요소의 다이제스트를 16진수로 표현한 값입니다. 지원 중단됨: 대신 left_child_digest_hex을 사용하세요.

right_child_hash_hex
(deprecated)

string

출력 전용입니다. 노드의 오른쪽 하위 요소의 다이제스트를 16진수로 표현한 것입니다. 지원 중단됨: 대신 right_child_digest_hex을 사용하세요.

left_child_digest_hex

string

출력 전용입니다. 노드의 왼쪽 하위 요소의 다이제스트를 16진수로 표현한 값입니다. 형식: 64자리 16진수 문자열

right_child_digest_hex

string

출력 전용입니다. 노드의 오른쪽 하위 요소의 다이제스트를 16진수로 표현한 것입니다. 형식: 64자리 16진수 문자열

QualifiedCurrencyValue

원장상의 통화를 나타내며, 통화 운영자로 한정됩니다.

필드
operator_id

string

필수 항목입니다. 통화를 관리하는 통화 운영자 ID입니다.

QueryAccountRequest

QueryAccount 요청 메시지입니다.

필드
endpoint

string

필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint} 위치는 리전입니다.

account_id

string

필수 항목입니다. 정보를 가져올 계정 ID입니다. 값은 60자로 제한됩니다.

round_id

int64

선택사항입니다. 데이터를 요청할 실행 라운드의 ID입니다 (블록 '높이'와 유사). 반환된 계정 정보는 이 실행 라운드의 전역 상태에 대해 정확합니다. 지정하지 않으면 서비스 검사기에서 알고 있는 최신 최종 라운드를 사용합니다. 특정 라운드 ID의 상태는 항상 일관되고 표준입니다.

QueryAccountResponse

QueryAccount의 응답 메시지입니다.

필드
account

Account

계정 정보와 획득한 고도입니다.

QueryDataRequest

QueryData 요청 메시지입니다.

필드
endpoint

string

필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint} 위치는 리전입니다.

serialized_signed_query_request

bytes

필수 항목입니다. Universal Ledger 네트워크를 쿼리하기 위해 직렬화된 protobuf SignedQueryRequest입니다.

QueryDataResponse

QueryData의 응답 메시지입니다.

필드
redacted_fields[]

RedactedField

권한 제한으로 인해 응답에서 수정된 필드를 나타냅니다.

통합 필드 kind. 쿼리별 결과입니다. kind은 다음 중 하나여야 합니다.
account

Account

계정에 대한 쿼리인 경우 계정 정보입니다.

transaction_state

TransactionState

쿼리가 거래에 대한 것이라면 거래의 상태입니다.

QueryTransactionStateRequest

QueryTransactionState 요청 메시지입니다.

필드
endpoint

string

필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint} 위치는 리전입니다.

transaction_digest_hex

string

필수 항목입니다. 상태를 가져올 거래 ID입니다.

QueryTransactionStateResponse

QueryTransactionState의 응답 메시지입니다.

필드
transaction_attempts[]

TransactionAttempt

요청을 처리하는 유효성 검사기에 알려진 트랜잭션 제출당 하나의 항목입니다.

RedactedField

응답에서 수정된 필드에 관한 정보입니다.

필드
redacted_path

FieldMask

출력 전용입니다. 페이로드에서 수정된 정규화된 필드 경로입니다.

reason

string

출력 전용입니다. 필드가 수정된 이유에 대한 사람이 읽을 수 있는 설명입니다.

reason_code

Code

출력 전용입니다. 필드가 수정된 이유를 나타내는 머신이 읽을 수 있는 코드입니다.

RemoveRoles

계정에서 지정된 역할을 삭제합니다. 수정할 계정의 계정 관리자여야 합니다.

필드
account
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 account_id을 사용하세요. 수정할 계정의 ID입니다.

account_id

string

선택사항입니다. 수정할 계정의 ID입니다. account 또는 account_id 중 하나를 지정해야 합니다. 값은 60자로 제한됩니다.

roles[]

Role

필수 항목입니다. 삭제할 역할입니다.

RemoveSigningPublicKey

지정된 슬롯에서 계정 서명 키를 삭제합니다. 다른 슬롯은 비어 있으면 안 되며 ClientTransaction에 서명하는 데 사용된 키를 보유해야 합니다.

필드
key_slot

KeySlot

필수 항목입니다. 키를 삭제할 키 슬롯입니다. 이미 비어 있으면 트랜잭션이 실패합니다.

ReplaceSigningPublicKey

지정된 슬롯의 계정 서명 키를 바꿉니다. 다른 슬롯은 비어 있으면 안 되며 ClientTransaction에 서명하는 데 사용된 키를 보유해야 합니다.

필드
key_slot

KeySlot

필수 항목입니다. 키를 대체할 키 슬롯입니다.

new_public_key

bytes

필수 항목입니다. 지정된 슬롯의 공개 키를 대체할 새 공개 키입니다.

공개 키의 형식은 new_key_format 필드에 의해 정의됩니다. 공개 정보로 간주됩니다.

new_key_format

KeyFormat

필수 항목입니다. 새 공개 키의 키 형식입니다. 지원되는 형식 목록은 KeyFormat 정의를 참고하세요. 공개 정보로 간주됩니다.

역할

일반적인 역할 집합입니다.

열거형
ROLE_UNSPECIFIED 역할이 잘못되었습니다.
ROLE_PAYER 계정에서 결제 거래를 시작할 수 있는 역할입니다.
ROLE_RECEIVER 계정에서 지급을 받을 수 있도록 허용하는 역할입니다.
ROLE_CONTRACT_CREATOR 계정이 계약을 배포할 수 있도록 허용하는 역할입니다.
ROLE_CONTRACT_PARTICIPANT 계정이 배포된 계약과 상호작용할 수 있도록 허용하는 역할입니다.

RoundCertificate

특정 검사자가 라운드를 실행했음을 증명하는 인증서입니다.

필드
round_id

int64

출력 전용입니다. 인증서가 적용되는 라운드의 ID입니다.

validator_id

string

출력 전용입니다. 사람이 읽을 수 있는 유효성 검사기 식별자입니다. 이는 validator_signatures이 확인되는 공개 키를 조회하는 데 사용됩니다.

round_state_checksum_hex

string

출력 전용입니다. 이 라운드의 효과가 적용된 후의 세계 상태에 대한 동형 다이제스트의 16진수 표현입니다.

round_delta_checksum_hex

string

출력 전용입니다. 이 라운드의 집계된 트랜잭션 효과에 대한 동형 다이제스트의 16진수 표현입니다.

merkle_tree

MerkleTree

출력 전용입니다. 이 라운드를 루트 노드로 하고 트랜잭션 배치 (라운드에서 실행됨)를 리프로 하는 머클 트리

validator_signatures[]

bytes

선택사항입니다. 검사기의 서명입니다. 이는 이 레코드의 이전 페이로드의 다이제스트를 통해 서명됩니다.

is_finalized

bool

출력 전용입니다. 라운드가 완료되었는지, 즉 충분한 수의 검사자가 동일한 인증서로 이 라운드를 인증했는지 나타내는 불리언입니다.

SettlementMode

클리어링 하우스의 정산 모드입니다.

열거형
SETTLEMENT_MODE_UNSPECIFIED 정산 모드가 지정되지 않았습니다. 이 값은 잘못되었으므로 사용하면 안 됩니다.
SETTLEMENT_MODE_DEFERRED 청산소는 장부 외 자금의 소유권을 추적하고 장부의 해당 잔액을 동기화된 상태로 유지하기 위해 주기적으로 SettlementRequest 트랜잭션을 발행합니다.
SETTLEMENT_MODE_INSTANT 지급 기관은 단일 자금 풀을 유지하고 원장은 토큰 관리자 간의 자금 할당을 위한 골든 소스 역할을 합니다. 이 결제 모드는 '즉시 총액 결제'라고도 할 수 있습니다.

SettlementRequest

두 토큰 관리자 간의 정산 작업을 시작합니다. 발신자는 클리어링하우스 계정이어야 합니다.

정산 기관이 토큰 관리자 자금을 보관하는 지연된 SettlementMode에서는 두 토큰 관리자 간의 정산을 실행하기 위해 전송해야 하는 유일한 트랜잭션입니다.

필드
payer
(deprecated)

Entity

선택사항입니다. 변경할 수 없습니다. 지원 중단됨: 대신 payer_id을 사용하세요. 자금 이체를 해야 하는 당사자의 계정 ID입니다.

payer_id

string

선택사항입니다. 변경할 수 없습니다. 자금 이체를 해야 하는 당사자의 계정 ID입니다. payer 또는 payer_id 중 하나를 지정해야 합니다.

beneficiary
(deprecated)

Entity

선택사항입니다. 변경할 수 없습니다. 지원 중단됨: 대신 beneficiary_id을 사용하세요. 지급을 받아야 하는 당사자의 계정 ID입니다.

beneficiary_id

string

선택사항입니다. 변경할 수 없습니다. 자금을 수령할 당사자의 계정 ID입니다. beneficiary 또는 beneficiary_id 중 하나를 지정해야 합니다.

balance

CurrencyValue

필수 항목입니다. 변경할 수 없습니다. payer 계정에서 장부의 beneficiary 계정으로 이전해야 하는 발급된 토큰의 잔액입니다.

round_id

int64

필수 항목입니다. 변경할 수 없습니다. 이 정산 금액이 계산된 라운드 ID입니다.

SignedTransaction

서명이 첨부된 거래입니다. 거래를 제출하려면 이 메시지를 직렬화하여 SubmitTransactionRequest에 포함해야 합니다.

필드
serialized_client_transaction

bytes

필수 항목입니다. 거래 세부정보가 포함된 직렬화된 ClientTransaction입니다.

sender_signature

bytes

필수 항목입니다. 거래 발신자의 서명입니다.

서명은 자체 비공개 키로 serialized_client_transaction 바이트에 서명하여 계산해야 합니다.

트랜잭션 체인의 경우 서명할 바이트는 다음의 연결로 계산됩니다. - 전체 체인의 직렬화된 클라이언트 트랜잭션의 다이제스트 - 체인에 표시되는 순서대로 체인의 각 단위의 직렬화된 서명된 트랜잭션의 다이제스트 다이제스트는 SHA-256을 사용하여 계산됩니다.

sender_signing_key_slot

KeySlot

선택사항입니다. 거래에 서명하는 데 사용된 발신자의 키 슬롯입니다. 지정되지 않은 경우 발신자 계정의 기본 슬롯을 사용합니다.

other_signatures[]

bytes

선택사항입니다. 추가 거래 서명자로 나열된 계정의 서명입니다. 이러한 서명의 수와 순서는 ClientTransactionsignatories 필드와 일치해야 합니다.

서명할 바이트는 sender_signature의 바이트와 동일하며 각 서명자는 자신의 비공개 키로 서명해야 합니다.

추가 서명인의 수와 신원은 특정 거래 종류에 따라 다릅니다. 트랜잭션 체인의 경우 체인에 발신자 또는 서명자로 표시되는 각 계정에 하나의 서명이 필요합니다.

other_signing_key_slots[]

KeySlot

선택사항입니다. 추가 거래 서명자로 나열된 계정의 키 슬롯입니다. 설정된 경우 이러한 키 슬롯의 수와 순서는 SignedTransactionother_signatures 필드와 일치해야 합니다. 지정하지 않으면 각 계정의 기본 슬롯이 기본값입니다.

StatusEvent

단일 유효성 검사기에서 관찰한 트랜잭션 처리의 이벤트를 나타냅니다.

보고된 모든 값은 요청을 처리하는 검증 도구의 관점에서 나온 것이며 다른 검증 도구의 관점과 다를 수 있습니다.

필드
event_time

Timestamp

출력 전용입니다. 이 유효성 검사기에 의해 이벤트가 기록된 시간입니다.

event_type

EventType

출력 전용입니다. 이벤트 유형입니다.

event_details

EventDetails

출력 전용입니다. 이벤트와 관련된 추가 세부정보입니다.

StringList

문자열 목록입니다.

필드
values[]

string

선택사항입니다. 문자열 값입니다.

SubmitOperationalTransactionRequest

SubmitOperationalTransaction 요청 메시지입니다.

필드
endpoint

string

필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint} 위치는 리전입니다.

serialized_signed_operational_transaction

bytes

필수 항목입니다. 원장에 제출할 protobuf 직렬화 SignedTransaction입니다. 동봉된 클라이언트 거래는 운영 거래여야 하며 발신자는 플랫폼 운영자여야 합니다. 직렬화된 형식을 사용하면 모든 유효성 검사기가 직렬화된 바이트의 SHA-256 다이제스트와 동일한 트랜잭션 ID를 계산합니다.

SubmitOperationalTransactionResponse

SubmitOperationalTransaction의 응답 메시지입니다.

필드
transaction_digest_hex

string

제출된 운영 거래를 고유하게 나타내는 식별자입니다. serialized_signed_operational_transaction의 SHA-256 다이제스트의 16진수 표현입니다. 이 거래 ID는 클라이언트가 해싱 로직을 직접 구현하지 않고도 거래를 추적할 수 있도록 제공됩니다. 식별자는 후속 API 호출에서 직접 사용할 수 있습니다(예: 거래 상태를 쿼리하는 경우).

SubmitTransactionRequest

SubmitTransaction 요청 메시지입니다.

필드
endpoint

string

필수 항목입니다. 거래를 제출할 엔드포인트입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint} 위치는 리전입니다.

serialized_signed_transaction

bytes

필수 항목입니다. 원장에 제출할 protobuf 직렬화 SignedTransaction입니다. 직렬화된 형식을 사용하면 모든 유효성 검사기가 직렬화된 바이트의 SHA-256 다이제스트와 동일한 트랜잭션 ID를 계산합니다.

SubmitTransactionResponse

SubmitTransaction의 응답 메시지입니다.

필드
transaction_digest_hex

string

제출된 거래를 고유하게 나타내는 식별자입니다. serialized_signed_transaction의 SHA-256 다이제스트의 16진수 표현입니다. 이 거래 ID는 클라이언트가 해싱 로직을 직접 구현하지 않고도 거래를 추적할 수 있도록 제공됩니다. 식별자는 후속 API 호출에서 직접 사용할 수 있습니다(예: 거래 상태를 쿼리하는 경우).

TokenManagerDetails

토큰 관리자와 관련된 세부정보입니다.

필드
issuance_limit

CurrencyValue

출력 전용입니다. 이 토큰 관리자가 발행할 수 있는 토큰의 양입니다.

issued_tokens

CurrencyValue

출력 전용입니다. 이 토큰 관리자가 발행한 토큰 수입니다. 이 숫자는 민팅 시 증가하고 소각 시 감소합니다.

TransactionAttempt

시도된 거래 제출의 상태입니다.

필드
status

TransactionStatus

출력 전용입니다. 거래 시도의 현재 상태입니다.

proof_of_inclusion

ProofOfInclusion

출력 전용입니다. 트랜잭션 효과가 월드 상태에 포함되었음을 나타내는 인증서입니다. 상태가 FINALIZED인 경우에만 제공됩니다.

status_events[]

StatusEvent

출력 전용입니다. 거래 시도에 대해 기록된 순서가 지정된 상태 이벤트입니다.

TransactionStatus

거래 시도의 상태입니다.

열거형
TRANSACTION_STATUS_UNSPECIFIED 알 수 없거나 초기화되지 않은 상태입니다.
PENDING 이 트랜잭션은 이 유효성 검사기에 알려져 있지만 아직 완료되지 않았습니다.
FINALIZED 거래가 완료되었습니다. 이러한 효과는 블록체인에 유지되며 되돌릴 수 없습니다.

TransactionCertificate

라운드에서 특정 거래의 실행 증명서입니다.

필드
transaction_digest_hex

string

출력 전용입니다. 이 인증서가 적용되는 거래의 ID입니다.

round_id

int64

출력 전용입니다. 이 트랜잭션이 실행된 실행 라운드의 ID입니다.

transaction_effects

TransactionEffects

출력 전용입니다. 트랜잭션 실행의 효과입니다.

events[]

TransactionEvent

출력 전용입니다. 트랜잭션에서 생성된 이벤트입니다.

transaction_effects_state_checksum_hex

string

출력 전용입니다. 효과의 동형 체크섬입니다. 16진수 문자열로 인코딩된 2048바이트 값입니다.

certification_results_digest_hex

string

출력 전용입니다. 이전 필드의 모든 암호화 다이제스트입니다. 포함 증명의 Merkle 트리를 빌드하는 데 사용됩니다.

TransactionChain

순차적으로 실행할 여러 트랜잭션 단위가 포함된 트랜잭션 체인입니다.

단위는 나열된 순서대로 순차적으로 실행됩니다. 모든 단위가 성공하면 누적 효과가 원자적으로 세계 상태에 커밋됩니다. 그렇지 않고 하나라도 실패하면 전체 체인이 실패하고 효과가 적용되지 않습니다.

필드
units[]

bytes

체인의 개별 단위입니다. 각 단위는 직렬화된 SignedTransaction여야 합니다.

직렬화된 바이트는 체인 자체에 서명할 바이트를 결정하는 데 필요합니다.

TransactionEffect

일부 트랜잭션에 의한 월드 상태 업데이트를 나타냅니다.

delta_val이 있으면 지정된 키에 이전에 저장된 값에 적용된 델타 (정수 오프셋)로 간주됩니다. 이 경우 new_valold_val은 비어 있어야 합니다.

그렇지 않으면 old_val 또는 new_val (또는 둘 다)이 하나 이상 있는 것으로 간주됩니다. 빈 old_val은 값이 삽입되었음을 나타냅니다. 빈 new_val은 값이 삭제되었음을 나타냅니다.

필드
key

bytes

출력 전용입니다. 업데이트된 세계 상태의 키입니다.

old_val

bytes

출력 전용입니다. 거래가 실행되기 전의 키 값입니다.

new_val

bytes

출력 전용입니다. 거래가 실행된 후의 키 값입니다.

delta_val

int64

출력 전용입니다. 이전에 저장된 값에 적용된 정수 오프셋입니다.

TransactionEffects

트랜잭션 실행의 효과입니다.

필드
status

TransactionStatus

출력 전용입니다. 트랜잭션 실행의 결과 상태입니다.

effects[]
(deprecated)

TransactionEffect

출력 전용입니다. 지원 중단됨: 대신 네트워크 상태를 쿼리하여 세계 상태의 변경사항을 확인하세요. 월드 상태에서 트랜잭션의 효과입니다.

TransactionEvent

거래에 의해 생성된 이벤트입니다.

필드
type

string

출력 전용입니다. 이벤트 유형입니다. transaction_output 유형의 특수 이벤트에는 트랜잭션에서 생성된 출력이 포함됩니다(예: 새로 생성된 계정의 계정 ID).

attributes[]

EventAttribute

출력 전용입니다. 임의의 키-값 쌍인 이벤트 속성입니다.

EventAttribute

개별 속성(키-값 쌍)

필드
key

string

출력 전용입니다. 속성의 키입니다.

value

string

출력 전용입니다. 속성의 값입니다.

TransactionState

거래의 상태입니다.

필드
transaction_attempts[]

TransactionAttempt

요청을 처리하는 유효성 검사기에 알려진 트랜잭션 제출당 하나의 항목입니다.

TransactionStatus

트랜잭션 실행 상태를 나타냅니다.

필드
code

int32

출력 전용입니다. 상태 코드입니다. 의미는 해당하는 gRPC 상태 코드에 의해 정의되는 숫자 값입니다.

message

bytes

출력 전용입니다. 오류 메시지(있는 경우) 코드가 OK이 아닌 경우에만 설정됩니다. utf-8 바이트로 인코딩된 문자열입니다. 인코딩의 결정성과 관련된 문제를 방지하기 위해 바이트로 저장됩니다.

이전

한 사용자 계정에서 다른 사용자 계정으로 토큰을 전송합니다. 발신자는 토큰 관리자나 계정 관리자와 같은 권한이 있는 계정이 아닌 일반 사용자 계정이어야 합니다.

또한 거래 발신자에게는 ROLE_PAYER가 사용 설정되어 있어야 하고 수신자에게는 ROLE_RECEIVER가 사용 설정되어 있어야 합니다.

필드
beneficiary
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 beneficiary_id을 사용하세요. 토큰을 수신하는 계정입니다.

beneficiary_id

string

선택사항입니다. 토큰을 수신하는 계정의 ID입니다. beneficiary 또는 beneficiary_id 중 하나를 지정해야 합니다.

amount

CurrencyValue

필수 항목입니다. 이체할 금액입니다. 금액은 양수여야 합니다.

TransferContractTokenManager

계약 토큰 관리자의 소유권을 새 계정으로 이전합니다. 발신자는 통화의 현재 통화 운영자여야 합니다.

거래가 성공하면 통화의 현재 계약 토큰 관리자가 비활성화되고 새로 생성된 계정의 ID가 최종 거래의 TransactionCertificate에 이벤트로 반환됩니다.

필드
public_key

bytes

필수 항목입니다. 새 계약 토큰 관리자의 공개 키입니다. 이는 운영자의 공개 키가 아닙니다. 계약 토큰 관리자의 공개 키이며 원장에 저장됩니다. 계약 토큰 관리자의 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다.

공개 키의 형식은 key_format 필드에 정의되어 있습니다. 공개 정보로 간주됩니다.

account_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

key_format

KeyFormat

선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다.

TransferCurrencyOperator

지정된 통화 운영자의 소유권을 새 계정으로 이전합니다. 발신자는 플랫폼 운영자여야 합니다.

거래가 성공하면 지정된 통화 연산자를 비활성화하고 새로 생성된 계정의 ID가 완료된 거래의 TransactionCertificate에 이벤트로 반환됩니다.

필드
public_key

bytes

필수 항목입니다. 새 통화 운영자의 공개 키입니다. 이 공개 키는 통화 운영자와 연결되어 원장에 저장됩니다. 통화 운영자 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다.

공개 키의 형식은 key_format 필드에 정의되어 있습니다. 공개 정보로 간주됩니다.

key_format

KeyFormat

선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다.

account_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

currency_operator
(deprecated)

Entity

선택사항입니다. 지원 중단됨: 대신 currency_operator_id을 사용하세요. 바꿀 통화 연산자입니다. 활성 상태여야 합니다.

currency_operator_id

string

선택사항입니다. 바꿀 통화 연산자의 ID입니다. 활성 상태여야 합니다. currency_operator 또는 currency_operator_id 중 하나를 지정해야 합니다. 값은 60자로 제한됩니다.

TransferPlatformOperator

플랫폼 운영자의 소유권을 새 계정으로 이전합니다. 발신자는 현재 플랫폼 운영자여야 합니다.

거래가 성공하면 현재 플랫폼 운영자가 비활성화되고 새로 생성된 계정의 ID가 최종 거래의 TransactionCertificate에 이벤트로 반환됩니다.

필드
public_key

bytes

필수 항목입니다. 새 플랫폼 운영자의 공개 키입니다. 이 공개 키는 플랫폼 운영자와 연결되어 원장에 저장됩니다. 플랫폼 운영자 계정에서 발생하는 거래의 서명을 검증하는 데 사용됩니다.

공개 키의 형식은 key_format 필드에 정의되어 있습니다. 공개 정보로 간주됩니다.

key_format

KeyFormat

선택사항입니다. 변경할 수 없습니다. 공개 키의 키 형식입니다. 지정되지 않은 경우 기본값은 Tink 와이어 형식의 바이너리 직렬화 키 세트입니다. 공개 정보로 간주됩니다.

account_comment

string

선택사항입니다. 변경할 수 없습니다. 시스템에서 해석하지 않지만 계정의 원장에 저장되는 불투명 댓글 필드입니다. 공개 정보로 간주됩니다. 최대 길이는 128자(영문 기준)입니다. 비워 둘 수 있습니다. 한 번 생성된 필드는 변경할 수 없습니다.

UserDetails

사용자 계정과 관련된 세부정보입니다.

필드
account_manager
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 account_manager_id을 사용하세요. 이 사용자의 계정 관리자입니다.

account_manager_id

string

출력 전용입니다. 이 사용자의 계정 관리자 ID입니다.

token_manager
(deprecated)

Entity

출력 전용입니다. 지원 중단됨: 대신 token_manager_id을 사용하세요. 이 사용자의 토큰 관리자입니다.

token_manager_id

string

출력 전용입니다. 이 사용자의 토큰 관리자 ID입니다.

roles[]

Role

출력 전용입니다. 이 계정에 부여된 역할 목록입니다.

account_status

AccountStatus

출력 전용입니다. 이 계정의 상태입니다.

balance

CurrencyValue

출력 전용입니다. 이 사용자 계정의 토큰 잔액입니다.

account_fields
(deprecated)

map<string, Fields>

출력 전용입니다. 지원 중단됨: 대신 contract_account_fields을 사용하세요. 이 사용자의 계약 계정 필드 (계약 ID -> 필드)입니다.

contract_account_fields

map<string, Fields>

출력 전용입니다. 이 사용자의 계약 계정 필드 (계약 ID -> 필드)입니다.

특정 유형의 구체적인 값입니다.

필드
통합 필드 value. 실제 값입니다. value은 다음 중 하나여야 합니다.
none_value

NoneValue

선택사항입니다. None 값을 나타냅니다.

bool_value

bool

선택사항입니다. 부울 값

int64_value

int64

선택사항입니다. int64 값입니다.

string_value

string

선택사항입니다. 문자열 값입니다.

account_id

string

선택사항입니다. 계정 ID입니다.

dict_value

DictValue

선택사항입니다. 사전 값입니다.

qualified_currency_value

QualifiedCurrencyValue

선택사항입니다. 유효한 통화 값입니다.

amount_value

AmountValue

선택사항입니다. 금액 값입니다.