Package google.cloud.universalledger.v1

Index

UniversalLedger

Ein Dienst für die Interaktion mit dem Google Cloud Universal Ledger. Endpunkte werden von Google vorab erstellt und verwaltet und können von Nutzern nicht geändert werden. Die Namen der verfügbaren Endpunkte werden in der öffentlichen Dokumentation angegeben. Ein Endpunkt ist eine regionale Ressource in einem Universal Ledger-Netzwerk. Anfragen, die an einen Endpunkt gesendet werden, können innerhalb der angegebenen Region an verschiedene Validatoren im angegebenen Netzwerk weitergeleitet werden.

GetEndpoint

rpc GetEndpoint(GetEndpointRequest) returns (Endpoint)

Ruft die Details eines bestimmten Endpunkts ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

ListEndpoints

rpc ListEndpoints(ListEndpointsRequest) returns (ListEndpointsResponse)

Listet alle Endpunkte für ein bestimmtes Projekt und einen bestimmten Standort auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

QueryAccount

rpc QueryAccount(QueryAccountRequest) returns (QueryAccountResponse)

Fragt alle im Netzwerk gespeicherten Informationen zu einem Konto ab. Die zurückgegebenen Kontodetails können sich zwischen den Aufrufen unterscheiden, da ein Endpunkt Anfragen an verschiedene Validatoren im Netzwerk und in der Region weiterleiten kann und die Validatoren zu einem bestimmten Zeitpunkt möglicherweise nicht dieselbe Round-ID haben.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

QueryData

rpc QueryData(QueryDataRequest) returns (QueryDataResponse)

Fragt das Netzwerk nach Informationen ab, die im Ledger gespeichert sind, z. B. Konten und Transaktionen.

Der Zugriff auf bestimmte vertrauliche Felder wie Kontostände kann basierend auf der Identität des Absenders eingeschränkt werden, die aus der Signatur in der Anfrage abgeleitet wird. Wenn der Absender keine Berechtigung hat, werden vertrauliche Felder in der Antwort unkenntlich gemacht und im Feld redacted_fields gemeldet.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

QueryTransactionState

rpc QueryTransactionState(QueryTransactionStateRequest) returns (QueryTransactionStateResponse)

Fragt den Status einer Transaktion ab. Diese Methode kann für jede Transaktion aufgerufen werden, die an das Netzwerk gesendet wird. Die zurückgegebenen Transaktionsdetails können sich zwischen den Aufrufen unterscheiden, da ein Endpunkt Anfragen an verschiedene Validatoren im Netzwerk und in der Region weiterleiten kann und die Validatoren zu einem bestimmten Zeitpunkt möglicherweise nicht dieselbe Round-ID haben.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

SubmitOperationalTransaction

rpc SubmitOperationalTransaction(SubmitOperationalTransactionRequest) returns (SubmitOperationalTransactionResponse)

Sendet eine operative Transaktion an das Netzwerk. Diese Methode wird erst zurückgegeben, wenn die Transaktion auf die Mehrheit der Validatoren im Netzwerk repliziert wurde oder wenn die Transaktion fehlschlägt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

SubmitTransaction

rpc SubmitTransaction(SubmitTransactionRequest) returns (SubmitTransactionResponse)

Sendet eine Transaktion an das Netzwerk. Die Anfrage wird zuerst auf grundlegende Richtigkeit geprüft. Wenn die Validierung fehlschlägt, schlägt die Anfrage sofort fehl. Wenn die Validierung erfolgreich ist, gibt diese Methode erst dann zurück, wenn die Transaktion auf die Mehrheit der Validatoren im Netzwerk repliziert wurde oder die Anfrage fehlschlägt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

Konto

Gibt den Status eines Kontos im Ledger an.

Felder
sequence_number

int64

Nur Ausgabe. Die Sequenznummer dieses Kontos. Diese Zahl wird mit jeder Transaktion, die von diesem Konto gesendet wird, erhöht.

public_key

bytes

Nur Ausgabe. Der primäre öffentliche Schlüssel, der mit diesem Konto verknüpft ist und zur Signaturprüfung verwendet wird.

round_id

int64

Nur Ausgabe. Die ID der Ausführungsrunde (ähnlich der Blockhöhe), in der die angegebenen Kontoinformationen korrekt sind.

comment

string

Nur Ausgabe. Der Kontokommentar, der beim Erstellen dieses Kontos gespeichert wurde.

Union-Feld account_details. Spezifische Details je nach Kontotyp. Für account_details ist nur einer der folgenden Werte zulässig:
user_details

UserDetails

Nur Ausgabe. Details zu einem Standardnutzerkonto.

account_manager_details

AccountManagerDetails

Nur Ausgabe. Details für ein Account Manager-Konto.

token_manager_details

TokenManagerDetails

Nur Ausgabe. Details für ein Token-Verwaltungskonto.

contract_token_manager_details

ContractTokenManagerDetails

Nur Ausgabe. Details für ein Verwaltungskonto für Vertragstokens.

contract_details

ContractDetails

Nur Ausgabe. Details für ein Smart-Contract-Konto.

clearinghouse_details

ClearingHouseDetails

Nur Ausgabe. Details für ein Clearinghouse-Konto.

currency_operator_details

CurrencyOperatorDetails

Nur Ausgabe. Details für ein Konto eines Währungsbetreibers.

platform_operator_details

PlatformOperatorDetails

Nur Ausgabe. Details für ein Konto des Plattformbetreibers.

AccountIdList

Eine Liste der Konto-IDs.

Felder
values[]

string

Optional. Die Konto-ID-Werte.

AccountManagerDetails

Details speziell für Account Manager.

Felder
token_manager
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen token_manager_id. Der Standard-Token-Manager für Konten, die von diesem Kontomanager erstellt wurden.

num_accounts

int32

Nur Ausgabe. Die Anzahl der Konten, die von diesem Kontomanager erstellt wurden.

token_manager_id

string

Nur Ausgabe. Die ID des Standard-Token-Managers für Konten, die von diesem Kontomanager erstellt wurden.

AccountStatus

Der Status eines Kontos.

Enums
ACCOUNT_STATUS_UNSPECIFIED Ungültiger Status.
ACCOUNT_STATUS_ACTIVE Aktiver Status, in dem das Konto die durch seine Rollen zulässigen Vorgänge ausführen kann.
ACCOUNT_STATUS_INACTIVE Inaktiver Status, in dem alle Transaktionen im Konto verboten sind. Der Kontomanager kann weiterhin Transaktionen zur Kontoverwaltung senden.

ActivateAccount

Markiert ein Konto als ACCOUNT_STATUS_ACTIVE. Der Absender muss der Kontomanager des zu aktivierenden Kontos sein.

Der Kontoinhaber kann den normalen Betrieb wieder aufnehmen, der durch die Rollen im Konto zulässig ist.

Felder
account
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen account_id. Die ID des zu aktivierenden Kontos.

account_id

string

Optional. Die ID des zu aktivierenden Kontos. Es muss entweder account oder account_id angegeben werden. Der Wert ist auf 60 Zeichen begrenzt.

AddRoles

Fügt dem Konto die angegebenen Rollen hinzu. Der Absender muss der Kontomanager des zu ändernden Kontos sein.

Felder
account
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen account_id. Die ID des zu ändernden Kontos.

account_id

string

Optional. Die ID des zu ändernden Kontos. Es muss entweder account oder account_id angegeben werden. Der Wert ist auf 60 Zeichen begrenzt.

roles[]

Role

Erforderlich. Die Rollen, die hinzugefügt werden sollen.

AmountValue

Stellt einen Betrag in einer Währung dar.

Felder
currency

QualifiedCurrencyValue

Erforderlich. Die Währung des Betrags.

amount_value

int64

Erforderlich. Die Anzahl der untergeordneten Einheiten der Währung.

BalanceToSettle

Ein Guthaben, das zwischen zwei Token-Managern ausgeglichen werden muss.

Felder
balance_payer
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen balance_payer_id. Das Konto, auf dem der auszugleichende Betrag fällig ist.

balance_payer_id

string

Nur Ausgabe. Die ID des Kontos, auf das sich das zu begleichende Guthaben bezieht.

balance_receiver
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen balance_receiver_id. Das Konto, auf das das Guthaben überwiesen werden soll.

balance_receiver_id

string

Nur Ausgabe. Die ID des Kontos, auf das das zu verrechnende Guthaben überwiesen werden soll.

balance

CurrencyValue

Nur Ausgabe. Der auszugleichende Saldo. Muss positiv sein.

BoolList

Eine Liste mit booleschen Werten.

Felder
values[]

bool

Optional. Die booleschen Werte.

Burn

Löst Währungstokens ein. Der Absender muss ein Token-Manager sein und das Konto, das die zu verbrennenden Tokens bereitstellt, muss die Transaktion zusätzlich signieren.

Der Token-Manager hat ein bestimmtes Burn-Konto, an das Kunden die Token übertragen, bevor sie verbrannt werden. Alternativ können die Kunden die Transaktion direkt signieren. In diesem Fall handelt es sich um eine atomare „Transfer-and-Burn“-Transaktion.

Felder
burn_amount

CurrencyValue

Erforderlich. Der zu verbrennende Betrag.

payer
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen payer_id. Das Konto, das die zu verbrauchenden Tokens bereitstellt. Für das Konto muss ROLE_PAYER aktiviert sein.

payer_id

string

Optional. Die ID des Kontos, aus dem die zu verbrauchenden Tokens stammen. Im Konto des Zahlungspflichtigen muss ROLE_PAYER aktiviert sein. Es muss entweder payer oder payer_id angegeben werden.

ChangeAccountManager

Überträgt die Verantwortung für die Verwaltung eines bestimmten Kontos auf einen anderen Administrator. Der Absender muss der aktuelle Kontomanager des Kontos sein. Um die Einwilligung zu erteilen, muss der neue Manager diese Transaktion ebenfalls unterzeichnen.

Felder
account
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen account_id. Die ID des Kontos, dessen Verwaltungskonto geändert werden soll.

account_id

string

Optional. Die ID des Kontos, dessen Verwaltungskonto geändert werden soll. Es muss entweder account oder account_id angegeben werden. Der Wert ist auf 60 Zeichen begrenzt.

next_manager
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen next_manager_id. Die ID des neuen vorgeschlagenen Account-Managers. Für die Validierung ist es erforderlich, dass der neue Administrator diese Transaktion ebenfalls unterzeichnet hat.

next_manager_id

string

Optional. Die ID des neuen vorgeschlagenen Account-Managers. Für die Validierung ist es erforderlich, dass der neue Administrator diese Transaktion ebenfalls unterzeichnet hat. Es muss entweder next_manager oder next_manager_id angegeben werden. Der Wert ist auf 60 Zeichen begrenzt.

ClearingHouseDetails

Details zu einem bestimmten Clearinghouse.

Felder
account_status

AccountStatus

Nur Ausgabe. Der Status dieses Kontos.

balances[]

BalanceToSettle

Nur Ausgabe. Die Salden, die dieses Clearinghouse derzeit für die Abrechnung erfasst.

settlement_mode

SettlementMode

Nur Ausgabe. Der Abrechnungsmodus dieser Abrechnungsstelle.

ClientTransaction

Stellt eine vom Client initiierte Transaktion dar.

Felder
source
(deprecated)

Entity

Optional. Der Absender der Transaktion. Nicht mehr unterstützt: Verwenden Sie stattdessen sender_id.

sender_id

string

Optional. Die ID des Kontos, von dem diese Transaktion gesendet wird. Es muss entweder source oder sender_id festgelegt sein.

signatories[]
(deprecated)

Entity

Optional. Konten, die diese Transaktion zusätzlich zum Absender unterzeichnet haben. Nicht mehr unterstützt: Verwenden Sie stattdessen other_signatory_ids.

other_signatory_ids[]

string

Optional. Die IDs der Konten, die diese Transaktion zusätzlich zum Absender unterzeichnet haben.

sequence_number

int64

Erforderlich. Eine eindeutige, monoton steigende Zahl, die mit 0 beginnt.

Diese Zahl muss für jede Transaktion, die zuvor vom selben Transaktionssender an das Netzwerk gesendet wurde, um eins erhöht werden.

Hinweis: Dies gilt nicht für Transaktionseinheiten, die möglicherweise als Teil einer Kette eingereicht wurden. Für diese darf keine Sequenznummer festgelegt werden. Der Absender der Transaktionskette ist jedoch enthalten.

chained_unit

bool

Muss auf „true“ gesetzt werden, wenn diese Client-Transaktion Teil einer Transaktionskette ist. Andernfalls muss sie auf „false“ gesetzt werden.

Dies ist erforderlich, um zu verhindern, dass eine signierte Transaktion, die Teil einer Kette sein soll, einzeln gesendet wird.

Union-Feld kind. Die transaktionsspezifische Nachricht des Clients. Für kind ist nur einer der folgenden Werte zulässig:
app
(deprecated)

Any

Optional. Eingestellt: Verwenden Sie stattdessen eines der nachrichtenspezifischen Felder. Eine transaktionsspezifische Nachricht für einen Client. Muss einer der folgenden Werte sein:

operational

Any

Optional. Eine betriebliche Transaktionsnachricht. Hinweis: Diese E-Mail kann nur vom Plattformbetreiber gesendet werden. Muss einer der folgenden Werte sein:

transfer_platform_operator_transaction

TransferPlatformOperator

Optional. Nachricht zum Übertragen der Rolle des Plattformbetreibers auf ein neues Konto.

create_currency_operator_transaction

CreateCurrencyOperator

Optional. Meldung zum Erstellen eines neuen Währungsoperators.

transfer_currency_operator_transaction

TransferCurrencyOperator

Optional. Mitteilung zum Übertragen der Rolle des Währungsbetreibers auf ein neues Konto.

create_clearinghouse_transaction

CreateClearinghouse

Optional. Meldung zum Erstellen eines neuen Clearinghouse.

create_account_manager_transaction

CreateAccountManager

Optional. Meldung zum Erstellen eines neuen Account-Managers

create_token_manager_transaction

CreateTokenManager

Optional. Mitteilung zum Erstellen eines neuen Token-Managers, der der Währung des Betreibers zugeordnet ist, der die Anfrage sendet.

increase_token_issuance_limit_transaction

IncreaseTokenIssuanceLimit

Optional. Benachrichtigt das Netzwerk, dass das Zielkonto Reservemittel eingezahlt hat, und erhöht das Limit für die Tokenausgabe.

decrease_token_issuance_limit_transaction

DecreaseTokenIssuanceLimit

Optional. Benachrichtigt das Netzwerk, dass das Zielkonto Reservemittel abheben möchte, und verringert das Token-Ausgabelimit.

settlement_request_transaction

SettlementRequest

Optional. Nachricht zum Einleiten eines Abrechnungsvorgangs.

mint_transaction

Mint

Optional. Nachricht zum Erstellen von Währungstokens und Übertragen auf ein Konto.

burn_transaction

Burn

Optional. Nachricht zum Einlösen von Währungstokens aus einem Konto.

create_account_transaction

CreateAccount

Optional. Meldung zum Erstellen eines neuen Nutzerkontos.

deactivate_account_transaction

DeactivateAccount

Optional. Nachricht zum Deaktivieren eines Nutzerkontos.

activate_account_transaction

ActivateAccount

Optional. Nachricht zum Aktivieren eines Nutzerkontos.

add_roles_transaction

AddRoles

Optional. Meldung zum Hinzufügen von Rollen zu einem Konto.

remove_roles_transaction

RemoveRoles

Optional. Nachricht zum Entfernen von Rollen aus einem Konto.

change_account_manager_transaction

ChangeAccountManager

Optional. Nachricht zum Ändern des Kontomanagers eines Kontos

transfer_transaction

Transfer

Optional. Mitteilung zum Übertragen von Tokens von einem Nutzerkonto auf ein anderes.

create_contract_transaction

CreateContract

Optional. Nachricht zum Erstellen eines neuen Vertrags im Ledger.

grant_contract_permissions_transaction

GrantContractPermissions

Optional. Nachricht zum Erteilen von Berechtigungen für einen Vertrag.

invoke_contract_method_transaction

InvokeContractMethod

Optional. Nachricht zum Aufrufen der Ausführung einer Vertragsmethode.

create_contract_token_manager_transaction

CreateContractTokenManager

Optional. Mitteilung zum Erstellen eines neuen Token-Managers, der der Währung des Betreibers zugeordnet ist, der die Anfrage sendet.

transfer_contract_token_manager_transaction

TransferContractTokenManager

Optional. Meldung für die Übertragung der Token-Manager-Rolle für eine Währung von einem Konto auf ein anderes.

remove_signing_public_key_transaction

RemoveSigningPublicKey

Optional. Meldung zum Entfernen eines Kontosignaturschlüssels.

replace_signing_public_key_transaction

ReplaceSigningPublicKey

Optional. Meldung zum Ersetzen eines Kontosignaturschlüssels

chain

TransactionChain

Optional. Nachricht für eine Transaktionskette mit mehreren Transaktionseinheiten, die nacheinander ausgeführt werden sollen.

ContractDetails

Details zu einem bestimmten Smart Contract.

Felder
owner
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen owner_id. Der Inhaber des Vertrags.

owner_id

string

Nur Ausgabe. Die ID des Inhabers des Vertrags.

code

bytes

Nur Ausgabe. Der serialisierte Vertragscode.

contract_fields

Fields

Nur Ausgabe. Die Vertragsfelder (Feldname –> Wert) für diesen Vertrag.

currency_balances

map<string, CurrencyValue>

Nur Ausgabe. Die im Vertrag enthaltenen Währungsguthaben (Währungsoperator -> Guthaben).

ContractPermission

Die Berechtigungen, die einem Vertrag erteilt werden können. Es wird erwartet, dass in Zukunft weitere Werte hinzukommen werden.

Enums
CONTRACT_PERMISSION_UNSPECIFIED Ungültige Berechtigung.
CONTRACT_PERMISSION_STORAGE

Ermöglicht einem Vertrag, in den Speicher zu lesen und zu schreiben, der dem Konto gehört, das die Berechtigung erteilt hat. Der Vertrag kann nur die Eigenschaften lesen und schreiben, die er zuvor geschrieben hat.

Der Vertrag kann dadurch jedoch nicht auf Daten zugreifen, die von anderen Verträgen verwaltet werden, und er kann auch nicht direkt andere Kontoattribute aktualisieren, z. B. den Kontostand in der Landeswährung.

ContractTokenManagerDetails

Details speziell für einen Contract Token Manager.

Felder
issuance_limit

CurrencyValue

Nur Ausgabe. Die Anzahl der Tokens, für die dieser Vertrags-Token-Manager eine Sicherung bereitstellen darf.

Da Manager von Vertragstokens das Ausgabelimit nicht erhöhen oder verringern können, sollte es dem issued_tokens entsprechen.

issued_tokens

CurrencyValue

Nur Ausgabe. Die Anzahl der Tokens, für die dieser Vertrags-Token-Manager eine Sicherung bereitstellt (d. h. seine Gesamtschuld).

Das entspricht der Summe aller Guthaben in Verträgen für die Währung plus der Nettoposition in der Abrechnungsmatrix.

previous_contract_token_manager_id

string

Nur Ausgabe. Die Konto-ID des vorherigen Vertrags-Token-Managers für diese Währung. So entsteht ein Audit-Trail, über den alle vorherigen Administratoren ermittelt werden können. Wenn dies der erste Contract Token Manager für die Währung ist, ist dieses Feld leer.

account_status

AccountStatus

Nur Ausgabe. Der Status dieses Kontos.

CreateAccount

Erstellt ein neues Nutzerkonto. Der Absender muss ein Account Manager sein.

Wenn die Transaktion erfolgreich ist, wird die ID des neu erstellten Kontos als Ereignis im TransactionCertificate der abgeschlossenen Transaktion zurückgegeben.

Felder
public_key

bytes

Erforderlich. Den öffentlichen Schlüssel des Kontoinhabers. Das ist nicht der öffentliche Schlüssel des Absenders. Dies ist der öffentliche Schlüssel des neuen Kontoinhabers, der im Ledger gespeichert wird. Damit wird die Signatur der Transaktionen, die vom erstellten Konto ausgehen, validiert.

Das Format des öffentlichen Schlüssels wird durch das Feld key_format definiert. Als öffentliche Informationen betrachtet.

key_format

KeyFormat

Optional. Nicht veränderbar. Das Schlüsselformat des öffentlichen Schlüssels. Wenn nichts angegeben ist, wird standardmäßig ein binär serialisiertes Keyset im Tink-Wire-Format verwendet. Als öffentliche Informationen betrachtet.

roles[]

Role

Optional. Die Liste der Rollen, die diesem Konto zugewiesen werden sollen.

account_status

AccountStatus

Optional. Der Status des zu erstellenden Kontos. Der Kontostatus eines neu erstellten Kontos ist standardmäßig ACCOUNT_STATUS_ACTIVE.

account_comment

string

Optional. Nicht veränderbar. Ein undurchsichtiges Kommentarfeld, das vom System nicht interpretiert, sondern im Konto im Ledger gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

token_manager
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen token_manager_id. Der Token-Manager für dieses Konto. Dieses Feld ist optional. Wenn es nicht angegeben wird, wird der Standard-Token-Manager verwendet, der dem Kontoverwalter (dem Absender dieser Transaktion) zugeordnet ist.

token_manager_id

string

Optional. Die ID des Token-Managers für dieses Konto. Dieses Feld ist optional. Wenn es nicht angegeben wird, wird der Standard-Token-Manager verwendet, der dem Kontoverwalter (dem Absender dieser Transaktion) zugeordnet ist. Der Wert ist auf 60 Zeichen begrenzt.

CreateAccountManager

Erstellt einen neuen Account Manager. Der Absender muss ein Währungsbetreiber sein.

Wenn die Transaktion erfolgreich ist, wird die ID des neu erstellten Kontos als Ereignis im TransactionCertificate der abgeschlossenen Transaktion zurückgegeben.

Felder
public_key

bytes

Erforderlich. Der öffentliche Schlüssel des neuen Kontomanagers. Dies ist nicht der öffentliche Schlüssel des Betreibers. Dieser öffentliche Schlüssel wird dem Kontomanager zugeordnet und im Ledger gespeichert. Sie wird verwendet, um die Signatur der Transaktionen zu validieren, die vom Konto des Kontomanagers stammen.

Das Format des öffentlichen Schlüssels wird durch das Feld key_format definiert. Als öffentliche Informationen betrachtet.

key_format

KeyFormat

Optional. Nicht veränderbar. Das Schlüsselformat des öffentlichen Schlüssels. Wenn nichts angegeben ist, wird standardmäßig ein binär serialisiertes Keyset im Tink-Wire-Format verwendet. Als öffentliche Informationen betrachtet.

default_token_manager
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen default_token_manager_id. Der Standard-Token-Manager für die Konten, die von diesem Verwaltungskonto erstellt werden.

default_token_manager_id

string

Optional. Die ID des Standard-Token-Managers für die Konten, die von diesem Verwaltungskonto erstellt werden. Der Wert ist auf 60 Zeichen begrenzt.

account_comment

string

Optional. Nicht veränderbar. Ein undurchsichtiges Kommentarfeld, das vom System nicht interpretiert, sondern im Konto im Ledger gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

CreateClearinghouse

Erstellt ein neues Clearinghouse. Der Absender muss ein Währungsbetreiber sein.

Wenn die Transaktion erfolgreich ist, wird die ID des neu erstellten Kontos als Ereignis im TransactionCertificate der abgeschlossenen Transaktion zurückgegeben.

Felder
public_key

bytes

Erforderlich. Der öffentliche Schlüssel des neuen Clearinghouse. Dies ist nicht der öffentliche Schlüssel des Betreibers. Dieser öffentliche Schlüssel wird mit dem Clearinghouse verknüpft und im Ledger gespeichert. Damit wird die Signatur der Transaktionen aus dem Konto des Abrechnungszentrums validiert.

Das Format des öffentlichen Schlüssels wird durch das Feld key_format definiert. Als öffentliche Informationen betrachtet.

key_format

KeyFormat

Optional. Nicht veränderbar. Das Schlüsselformat des öffentlichen Schlüssels. Wenn nichts angegeben ist, wird standardmäßig ein binär serialisiertes Keyset im Tink-Wire-Format verwendet. Als öffentliche Informationen betrachtet.

account_comment

string

Optional. Nicht veränderbar. Ein nicht transparentes Kommentarfeld, das vom System nicht interpretiert, sondern im Konto im Ledger gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

settlement_mode

SettlementMode

Erforderlich. Der Abrechnungsmodus für dieses Clearinghouse. Erforderlich. Als öffentliche Informationen betrachtet.

CreateContract

Speichert einen Vertrag im Ledger.

Felder
contract_bytes

bytes

Serialisierte Vertrags-Bytes.

arguments
(deprecated)

map<string, Value>

Optional. Nicht veränderbar. Nicht mehr unterstützt: Verwenden Sie stattdessen init_arguments. Argumente für die Methode __init__.

init_arguments

map<string, Value>

Optional. Nicht veränderbar. Enthält Argumente für die Methode __init__.

contract_comment

string

Optional. Nicht veränderbar. Ein undurchsichtiges Kommentarfeld, das nicht vom System interpretiert, sondern im Ledger im Vertrag gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

CreateContractTokenManager

Erstellt einen neuen ContractTokenManager, der der Währung des Betreibers zugeordnet ist, der die Anfrage sendet. Der Absender muss ein Währungsbetreiber sein. Der neu erstellte Vertragstoken-Manager ist standardmäßig aktiv. Wenn der Vertrags-Token-Manager ersetzt werden muss, sollte stattdessen die Transaktion „TransferContractTokenManager“ gesendet werden. Wenn ein anderer Vertragstoken-Manager mit derselben Währung vorhanden ist, schlägt diese Transaktion fehl.

Im Gegensatz zu regulären Token-Managern dürfen Contract-Token-Manager keine Transaktionen wie das Prägen oder Verbrennen ausführen. Sie können jedoch an Vergleichsverhandlungen teilnehmen.

Wenn die Transaktion erfolgreich ist, wird die ID des neu erstellten Kontos als Ereignis im TransactionCertificate der abgeschlossenen Transaktion zurückgegeben.

Felder
public_key

bytes

Erforderlich. Der öffentliche Schlüssel des neuen Contract Token Manager. Dies ist nicht der öffentliche Schlüssel des Betreibers. Dieser öffentliche Schlüssel wird dem Contract Token Manager zugeordnet und im Ledger gespeichert. Damit wird die Signatur der Transaktionen validiert, die vom Konto des Vertrags-Token-Managers stammen.

Das Format des öffentlichen Schlüssels wird durch das Feld key_format definiert. Als öffentliche Informationen betrachtet.

account_comment

string

Optional. Nicht veränderbar. Ein undurchsichtiges Kommentarfeld, das vom System nicht interpretiert, sondern im Konto im Ledger gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

key_format

KeyFormat

Optional. Nicht veränderbar. Das Schlüsselformat des öffentlichen Schlüssels. Wenn nichts angegeben ist, wird standardmäßig ein binär serialisiertes Keyset im Tink-Wire-Format verwendet. Als öffentliche Informationen betrachtet.

CreateCurrencyOperator

Erstellt einen neuen Währungsoperator. Der Absender muss der Plattformbetreiber sein.

Wenn die Transaktion erfolgreich ist, wird die ID des neu erstellten Kontos als Ereignis im TransactionCertificate der abgeschlossenen Transaktion zurückgegeben.

Bei dieser Transaktion muss eine neue Währung in das System eingeführt werden. Wenn die angegebene Währung bereits vorhanden ist, schlägt diese Transaktion fehl. Wenn der Währungsoperator ersetzt werden muss, sollte stattdessen die Transaktion „TransferCurrencyOperator“ gesendet werden.

Felder
public_key

bytes

Erforderlich. Der öffentliche Schlüssel des neuen Währungsoperators. Dieser öffentliche Schlüssel wird dem Währungsbetreiber zugeordnet und im Ledger gespeichert. Damit wird die Signatur der Transaktionen aus dem Konto des Betreibers validiert.

Das Format des öffentlichen Schlüssels wird durch das Feld key_format definiert. Als öffentliche Informationen betrachtet.

key_format

KeyFormat

Optional. Nicht veränderbar. Das Schlüsselformat des öffentlichen Schlüssels. Wenn nichts angegeben ist, wird standardmäßig ein binär serialisiertes Keyset im Tink-Wire-Format verwendet. Als öffentliche Informationen betrachtet.

account_comment

string

Optional. Nicht veränderbar. Ein undurchsichtiges Kommentarfeld, das vom System nicht interpretiert, sondern im Konto im Ledger gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

currency
(deprecated)

string

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen currency_code. Die diesem Operator zugeordnete Fiat-Währung, dargestellt als dreistelliger ISO 4217-Code in Großbuchstaben. Als öffentliche Informationen betrachtet.

currency_code

string

Optional. Die diesem Operator zugeordnete Fiat-Währung, dargestellt als dreistelliger ISO 4217-Code in Großbuchstaben. Als öffentliche Informationen betrachtet.

CreateSnapshot

Dieser Typ hat keine Felder.

Löst das Erstellen eines Snapshots des Netzwerks aus. Der Absender muss der Plattformbetreiber sein.

CreateTokenManager

Erstellt einen neuen Token-Manager, der der Währung des Betreibers zugeordnet ist, der die Anfrage sendet. Der Absender muss ein Währungsbetreiber sein.

Wenn die Transaktion erfolgreich ist, wird die ID des neu erstellten Kontos als Ereignis im TransactionCertificate der abgeschlossenen Transaktion zurückgegeben.

Felder
public_key

bytes

Erforderlich. Der öffentliche Schlüssel des neuen Token-Managers. Dies ist nicht der öffentliche Schlüssel des Betreibers. Dieser öffentliche Schlüssel wird dem Token-Manager zugeordnet und im Ledger gespeichert. Damit wird die Signatur der Transaktionen aus dem Konto des Token-Managers validiert.

Das Format des öffentlichen Schlüssels wird durch das Feld key_format definiert. Als öffentliche Informationen betrachtet.

key_format

KeyFormat

Optional. Nicht veränderbar. Das Schlüsselformat des öffentlichen Schlüssels. Wenn nichts angegeben ist, wird standardmäßig ein binär serialisiertes Keyset im Tink-Wire-Format verwendet. Als öffentliche Informationen betrachtet.

account_comment

string

Optional. Nicht veränderbar. Ein nicht transparentes Kommentarfeld, das vom System nicht interpretiert, sondern im Konto im Ledger gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

CurrencyOperatorDetails

Details zu einem Währungsbetreiber.

Felder
currency
(deprecated)

string

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen currency_code. Die Währung, die diesem Konto zugeordnet ist, dargestellt durch den dreistelligen ISO 4217-Code.

currency_code

string

Nur Ausgabe. Die ID der Währung, die diesem Konto zugeordnet ist, dargestellt durch den dreistelligen ISO 4217-Code.

account_status

AccountStatus

Nur Ausgabe. Der Status dieses Kontos.

previous_entity_id
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen previous_currency_operator_id. Der vorherige Währungsbetreiber, der die Inhaberschaft der Währungsbetreiberrolle auf dieses Konto übertragen hat. Wenn dies der erste Währungsoperator für die Währung ist, ist dieses Feld leer.

previous_currency_operator_id

string

Nur Ausgabe. Die ID des vorherigen Währungsoperators, der die Inhaberschaft der Währungsoperatorrolle an dieses Konto übertragen hat. Wenn dies der erste Währungsoperator für die Währung ist, ist dieses Feld leer.

platform_operator_entity_id
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen platform_operator_id. Der Plattformbetreiber, der diesen Währungsoperator erstellt hat.

platform_operator_id

string

Nur Ausgabe. Die ID des Plattformbetreibers, der diesen Währungsbetreiber erstellt hat.

contract_token_manager
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen contract_token_manager_id. Der mit diesem Währungsoperator verknüpfte Vertrags-Token-Manager.

contract_token_manager_id

string

Nur Ausgabe. Die ID des mit diesem Währungsoperator verknüpften Vertrags-Token-Managers.

clearinghouse_id

string

Nur Ausgabe. Die ID des Clearinghouse, das mit diesem Währungsoperator verknüpft ist.

CurrencyValue

Stellt einen Währungsbetrag (d.h. Geld) dar. Die Währung ist in dieser Nachricht nicht enthalten. Die entsprechende Währung wird durch das Konto bestimmt, von dem die Transaktion gesendet wird. Jedem Konto ist eine eindeutige, unveränderliche Währung zugeordnet.

Felder
value

int64

Erforderlich. Die Anzahl der untergeordneten Einheiten der Währung.

Diese kleinste gültige Stückelung wird als „untergeordnete Einheiten“ bezeichnet und ist in ISO 4217 angegeben. Bei US-Dollar ist der Wert beispielsweise die Anzahl der Cent und bei britischen Pfund die Anzahl der Pence. Beim japanischen Yen, der keine Untereinheit hat, ist es die Anzahl der Yen.

DeactivateAccount

Markiert ein Konto als ACCOUNT_STATUS_INACTIVE. Der Absender muss der Kontomanager des zu deaktivierenden Kontos sein.

Das bedeutet, dass der Kontoinhaber unabhängig von den Rollen keine Transaktionen im Konto ausführen kann.

Felder
account
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen account_id. Die ID des zu deaktivierenden Kontos.

account_id

string

Optional. Die ID des zu deaktivierenden Kontos. Es muss entweder account oder account_id angegeben werden. Der Wert ist auf 60 Zeichen begrenzt.

DecreaseTokenIssuanceLimit

Benachrichtigt das Netzwerk, dass das Zielkonto Reservemittel abheben möchte, und verringert das Token-Ausgabelimit. Der Absender muss ein Clearinghouse-Konto sein.

Beachten Sie, dass diese Transaktion erfolgreich abgeschlossen werden muss, bevor die Reservemittel abgehoben werden können. Das ist erforderlich, da die Transaktion fehlschlagen kann, z. B. wenn der geprägte Betrag bereits über dem angeforderten reduzierten Limit liegt.

Felder
token_manager
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen token_manager_id. Die ID des institutionellen Kontos, dessen Prägelimit gesenkt werden soll. Dieses Konto muss ein Token-Manager sein, damit die Transaktion gültig ist.

token_manager_id

string

Optional. Die ID des institutionellen Kontos, dessen Prägelimit gesenkt werden soll. Dieses Konto muss ein Token-Manager sein, damit die Transaktion gültig ist. Es muss entweder token_manager_id (bevorzugt) oder token_manager (verworfen) angegeben werden.

amount

CurrencyValue

Erforderlich. Der Betrag, um den das Limit gesenkt werden soll. Der Betrag muss positiv sein. Die Transaktion schlägt fehl, wenn das reduzierte Limit unter die aktuell ausgegebenen Tokens fällt.

DictList

Eine Liste von Wörterbüchern.

Felder
values[]

DictValue

Optional. Die DictValue-Werte. Alle verschachtelten Dictionaries müssen denselben konkreten Typ haben.

DictValue

Indizes ordnen Schlüssel Werten zu. Beispiel: Der keys[0]-Schlüssel wird values[0] zugeordnet.

Felder
Union-Feld keys. Jeder Schlüssel kann nur einen Typ haben. Für keys ist nur einer der folgenden Werte zulässig:
bool_keys

BoolList

Optional. Eine Liste mit booleschen Schlüsseln.

string_keys

StringList

Optional. Eine Liste von String-Schlüsseln.

int64_keys

Int64List

Optional. Eine Liste von int64-Schlüsseln.

account_id_keys

AccountIdList

Optional. Eine Liste der Schlüssel für Konto-IDs.

Union-Feld values. Jeder Wert kann genau eine Art sein. Für values ist nur einer der folgenden Werte zulässig:
bool_values

BoolList

Optional. Eine Liste mit booleschen Werten.

string_values

StringList

Optional. Eine Liste von Stringwerten.

int64_values

Int64List

Optional. Eine Liste mit int64-Werten.

dict_values

DictList

Optional. Die Werte sind eine Liste verschachtelter Dictionarys.

Endpunkt

Stellt einen Universal Ledger-Endpunkt dar.

Felder
name

string

ID. Der Ressourcenname des Endpunkts. Format: projects/{project}/locations/{location}/endpoints/{endpoint}

Entität

Eine Entität im Universal Ledger-Netzwerk. Alle Konten sind mit einer Rechtspersönlichkeit verknüpft. Die Entitäts-ID, die oft auch als Konto-ID bezeichnet wird, ist im gesamten Netzwerk eindeutig und unveränderlich.

Felder
id

string

Nur Ausgabe. Die ID, die der Entität zugewiesen wurde. Diese wird vom Netzwerk bei der Kontoerstellung zugewiesen.

EventDetails

Stellt zusätzliche Details eines Statusereignisses dar.

Felder
Union-Feld event_details. Details zum Ereignis. Für event_details ist nur einer der folgenden Werte zulässig:
execution_details

ExecutionDetails

Nur Ausgabe. Zusätzliche Details zu einem Ausführungsereignis.

EventType

Stellt den Typ eines Ereignisses bei der Verarbeitung einer Transaktion dar, wie er vom Validator beobachtet wird, an den die Anfrage weitergeleitet wurde.

Enums
EVENT_TYPE_UNSPECIFIED Unbekanntes oder nicht angegebenes Ereignis.
EVENT_TYPE_RECEIVED Die Transaktion wurde von diesem Validator direkt von einem Client empfangen.
EVENT_TYPE_BROADCASTED Die Transaktion wurde von diesem an andere Validierer übertragen.
EVENT_TYPE_ORDERED Die Transaktion wurde von diesem Validator angeordnet und zur Ausführung geplant.
EVENT_TYPE_EXECUTION_STARTED Die Ausführung der Transaktion hat begonnen.
EVENT_TYPE_EXECUTION_COMPLETED Die Ausführung der Transaktion wurde abgeschlossen.
EVENT_TYPE_FINALIZED Die Transaktion wurde von diesem Validator abgeschlossen.

ExecutionDetails

Zusätzliche Details zu einem Ausführungsereignis.

Felder
round_id

int64

Nur Ausgabe. Die ID der Runde, in der das Ausführungsereignis aufgetreten ist.

Felder

Eine Zuordnung von Feldern (Feldname –> Wert) aus einem Vertrag, die zur Darstellung von Vertrags- oder Kontofeldern verwendet wird.

Felder
fields

map<string, Value>

Nur Ausgabe. Die Zuordnung von Feldnamen zu ihren Werten.

GetEndpointRequest

Anfragenachricht für GetEndpoint.

Felder
name

string

Erforderlich. Der Name des abzurufenden Endpunkts. Format: projects/{project}/locations/{location}/endpoints/{endpoint}

GrantContractPermissions

Gewährt Berechtigungen für den Vertrag durch den Transaktionssender. Wenn delegate_contract_id angegeben ist, werden die Berechtigungen und der entsprechende Speicherplatz ausschließlich dem delegate_contract_id-Vertrag und nicht dem Absender gewährt.

Hinweis: Das Widerrufen von Berechtigungen wird nicht unterstützt.

Felder
contract
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen contract_id. ID des Vertrags, für den Berechtigungen gewährt werden.

contract_id

string

Optional. Die ID des Vertrags, für den Berechtigungen gewährt werden. Es muss entweder contract oder contract_id angegeben werden.

permissions[]

ContractPermission

Die zu gewährenden Berechtigungen.

delegate_contract_id

string

Optional. Die Vertrags-ID, für die Berechtigungen gewährt werden. Der Absender der Transaktion muss der Inhaber dieses Vertrags sein.

IncreaseTokenIssuanceLimit

Transaktionen für die Tokenausgabe und das Token-Minting. Benachrichtigt das Netzwerk, dass das Zielkonto Reservemittel eingezahlt hat, und erhöht das Limit für die Tokenausgabe. Der Absender muss ein Clearinghouse-Konto sein.

Felder
token_manager
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen token_manager_id. Die ID des institutionellen Kontos, dessen Minting-Limit erhöht werden soll. Dieses Konto muss ein Token-Manager sein, damit die Transaktion gültig ist.

token_manager_id

string

Optional. Die ID des institutionellen Kontos, dessen Minting-Limit erhöht werden soll. Dieses Konto muss ein Token-Manager sein, damit die Transaktion gültig ist. Es muss entweder token_manager oder token_manager_id angegeben werden.

amount

CurrencyValue

Erforderlich. Der Betrag, um den das Limit erhöht werden soll. Der Betrag muss positiv sein.

Int64List

Eine Liste von int64-Werten.

Felder
values[]

int64

Optional. Die int64-Werte.

InvokeContractMethod

Ruft die Ausführung einer Vertragsmethode auf.

Felder
contract
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen contract_id. ID des auszuführenden Vertrags.

contract_id

string

Optional. Die ID des auszuführenden Vertrags. Es muss entweder contract oder contract_id angegeben werden.

method_name

string

Name der auszuführenden Methode.

arguments
(deprecated)

map<string, Value>

Optional. Nicht veränderbar. Nicht mehr unterstützt: Verwenden Sie stattdessen method_arguments. Argumente für die Methode.

method_arguments

map<string, Value>

Optional. Nicht veränderbar. Enthält Argumente, die an die Methode übergeben werden sollen.

payment

CurrencyValue

Der zu zahlende Betrag. Muss beim Aufrufen von zahlungspflichtigen Methoden größer als null und bei nicht zahlungspflichtigen Methoden null sein.

KeyFormat

Gibt das Format an, in dem ein öffentlicher Schlüssel bereitgestellt wird. Dieser Enum können in Zukunft neue Werte hinzugefügt werden.

Enums
KEY_FORMAT_UNSPECIFIED Das Schlüsselformat ist nicht angegeben. Dieser Wert ist ungültig und sollte nicht verwendet werden.
KEY_FORMAT_TINK_WIRE_FORMAT Ein binär serialisiertes Keyset im Tink-Wire-Format.
KEY_FORMAT_PEM_EC_P256_SHA256 Ein PEM-codierter Signierschlüssel für elliptische Kurven, der die P-256-Kurve mit SHA256-Digest verwendet. Signaturen müssen im DER-Format vorliegen.

KeySlot

Eine Kennung der Slots, die Schlüssel für ein Konto enthalten können.

Enums
KEY_SLOT_UNSPECIFIED Der Schlüsselslot ist nicht angegeben.
KEY_SLOT_PRIMARY Der Primärschlüssel-Slot.
KEY_SLOT_ALTERNATE Der alternative Schlüsselschlitz.

ListEndpointsRequest

Anfragenachricht für ListEndpoints

Felder
parent

string

Erforderlich. Das übergeordnete Element, das diese Sammlung von Endpunkten besitzt. Format: projects/{project}/locations/{location}

page_size

int32

Optional. Die maximale Anzahl der zurückzugebenden Endpunkte. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Endpunkte zurückgegeben. Der Höchstwert liegt bei 1.000. Alle Werte darüber werden implizit in 1.000 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListEndpoints-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

ListEndpointsResponse

Antwortnachricht für ListEndpoints.

Felder
endpoints[]

Endpoint

Die Endpunkte für das angegebene Projekt und den angegebenen Standort.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

MerkleTree

Ein Merkle-Baum mit einem kryptografischen Digest des Stammknotens.

Felder
root_hash_hex
(deprecated)

string

Nur Ausgabe. Der kryptografische Digest des Root-Knotens. Nicht mehr unterstützt: Verwenden Sie stattdessen root_digest_hex.

root_digest_hex

string

Nur Ausgabe. Die hexadezimale Darstellung des Digests des Stammknotens. Format: Ein 64‑stelliger Hexadezimalstring.

num_transactions

int64

Nur Ausgabe. Die Anzahl der Transaktionen im Baum.

Mint

Erstellt Währungstokens und überträgt sie auf ein angegebenes Konto. Der Absender muss ein Token-Manager sein.

Felder
mint_amount

CurrencyValue

Erforderlich. Die zu erstellende Menge. Der Betrag muss so hoch sein, dass die Gesamtzahl der vom Token-Manager geprägten Tokens das Prägelimit nicht überschreitet. Wenn der Betrag höher ist, muss die Transaktion abgelehnt werden.

beneficiary
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen beneficiary_id. Das Konto, auf das der geprägte Betrag überwiesen werden soll. Für das Empfängerkonto muss ROLE_RECEIVER aktiviert sein.

beneficiary_id

string

Optional. Die ID des Kontos, auf das der geprägte Betrag übertragen werden soll. Für das empfangende Konto muss ROLE_RECEIVER aktiviert sein. Es muss entweder beneficiary oder beneficiary_id angegeben werden.

NoneValue

Eine Singleton-Enumeration, die den Wert „None“ darstellt.

Enums
NONE_VALUE_UNSPECIFIED Der Wert „None“.

PlatformOperatorDetails

Details speziell für einen Plattformbetreiber.

Felder
account_status

AccountStatus

Nur Ausgabe. Der Status dieses Kontos.

previous_entity_id
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen previous_platform_operator_id. Der bisherige Plattformbetreiber, der die Inhaberschaft der Rolle „Plattformbetreiber“ auf dieses Konto übertragen hat. Wenn dies der erste Plattformbetreiber ist, ist dieses Feld leer.

previous_platform_operator_id

string

Nur Ausgabe. Die ID des vorherigen Plattformbetreibers, der die Inhaberschaft der Rolle „Plattformbetreiber“ auf dieses Konto übertragen hat. Wenn dies der erste Plattformbetreiber ist, ist dieses Feld leer.

ProofOfInclusion

Zertifikat für die Einbeziehung der Auswirkungen einer Transaktion in den Weltstatus.

Felder
transaction_certificate

TransactionCertificate

Nur Ausgabe. Bescheinigung über die Berücksichtigung der Transaktionseffekte in einer bestimmten Runde.

round_certificate

RoundCertificate

Nur Ausgabe. Zertifikat für die Ausführung der Runde.

path_to_round_root[]

MerkleTreeNode

Nur Ausgabe. Kryptografischer Nachweis für die Einbeziehung der Transaktionseffekte in die Ausführungsrunde.

Sie wird als Pfad von einem bestimmten Blatt (einem Transaktions-Digest) zum Stamm der Ausführungsrunde angegeben. Der Pfad wird als Liste von Paaren aus linkem und rechtem untergeordneten Element dargestellt. Das erste Paar sind die linken und rechten untergeordneten Elemente des übergeordneten Knotens des angegebenen Blatts. Angenommen, der Merkle-Baum wurde mit acht Blatt-Digests [t0, t1, t2, t3, t4, t5, t6, t7] mit der folgenden Struktur erstellt:

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

path_to_round_root für t0 enthält: [(t0, t1), (h10, h11), (h20, h21)].

Man kann nacheinander SHA-256-Digests für jeden Pfadknoten berechnen, um zu prüfen, ob der Digest des Pfads denselben Wert wie round_certificate.merkle_tree.root_digest_hex ergibt. So wird überprüft, ob das Blatt im Merkle-Baum der Runde enthalten war.

MerkleTreeNode

Stellt einen Knoten in einem Merkle-Baumpfad dar.

Felder
left_child_hash_hex
(deprecated)

string

Nur Ausgabe. Die hexadezimale Darstellung des Digests des linken untergeordneten Elements eines Knotens. Nicht mehr unterstützt: Verwenden Sie stattdessen left_child_digest_hex.

right_child_hash_hex
(deprecated)

string

Nur Ausgabe. Die hexadezimale Darstellung des Digests des rechten untergeordneten Elements eines Knotens. Nicht mehr unterstützt: Verwenden Sie stattdessen right_child_digest_hex.

left_child_digest_hex

string

Nur Ausgabe. Die hexadezimale Darstellung des Digests des linken untergeordneten Elements eines Knotens. Format: Ein 64‑stelliger Hexadezimalstring.

right_child_digest_hex

string

Nur Ausgabe. Die hexadezimale Darstellung des Digests des rechten untergeordneten Elements eines Knotens. Format: Ein 64‑stelliger Hexadezimalstring.

QualifiedCurrencyValue

Stellt eine Währung im Ledger dar, die durch den Währungsoperator qualifiziert wird.

Felder
operator_id

string

Erforderlich. Die ID des Währungsbetreibers, der die Währung verwaltet.

QueryAccountRequest

Anfragenachricht für QueryAccount

Felder
endpoint

string

Erforderlich. Der Endpunkt, über den die Anfrage bereitgestellt wird. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Der Ort ist eine Region.

account_id

string

Erforderlich. Die Konto-ID, zu der Informationen abgerufen werden sollen. Der Wert ist auf 60 Zeichen begrenzt.

round_id

int64

Optional. Die ID der Ausführungsrunde (ähnlich der Block-„Höhe“), für die Daten angefordert werden sollen. Die zurückgegebenen Kontoinformationen sind für den Weltstatus in dieser Ausführungsrunde korrekt. Wenn nicht angegeben, wird die letzte abgeschlossene Runde verwendet, die dem Serving-Validator bekannt ist. Der Status für eine bestimmte Runde ist immer konsistent und kanonisch.

QueryAccountResponse

Antwortnachricht für QueryAccount.

Felder
account

Account

Die Kontoinformationen sowie die Höhe, in der sie erfasst wurden.

QueryDataRequest

Anfragenachricht für QueryData.

Felder
endpoint

string

Erforderlich. Der Endpunkt, über den die Anfrage bereitgestellt wird. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Der Ort ist eine Region.

serialized_signed_query_request

bytes

Erforderlich. Ein in Protobuf serialisiertes SignedQueryRequest zum Abfragen des Universal Ledger Network.

QueryDataResponse

Antwortnachricht für QueryData.

Felder
redacted_fields[]

RedactedField

Gibt an, welche Felder aufgrund von Berechtigungseinschränkungen aus der Antwort entfernt wurden.

Union-Feld kind. Das abfragespezifische Ergebnis. Für kind ist nur einer der folgenden Werte zulässig:
account

Account

Die Kontoinformationen, wenn sich die Anfrage auf ein Konto bezog.

transaction_state

TransactionState

Der Status einer Transaktion, wenn die Anfrage für eine Transaktion gestellt wurde.

QueryTransactionStateRequest

Anfragenachricht für QueryTransactionState

Felder
endpoint

string

Erforderlich. Der Endpunkt, über den die Anfrage bereitgestellt wird. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Der Ort ist eine Region.

transaction_digest_hex

string

Erforderlich. Die Transaktions-ID, für die der Status abgerufen werden soll.

QueryTransactionStateResponse

Antwortnachricht für QueryTransactionState

Felder
transaction_attempts[]

TransactionAttempt

Ein Eintrag für jede bekannte Übermittlung der Transaktion an den Validator, der die Anfrage bearbeitet.

RedactedField

Informationen zu einem vertraulichen Feld in der Antwort.

Felder
redacted_path

FieldMask

Nur Ausgabe. Die vollständig qualifizierten Feldpfade, die aus der Nutzlast entfernt wurden.

reason

string

Nur Ausgabe. Eine menschenlesbare Erklärung, warum die Felder entfernt wurden.

reason_code

Code

Nur Ausgabe. Ein maschinenlesbarer Code, der angibt, warum die Felder entfernt wurden.

RemoveRoles

Entfernt die angegebenen Rollen aus dem Konto. Der Absender muss der Kontomanager des zu ändernden Kontos sein.

Felder
account
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen account_id. Die ID des zu ändernden Kontos.

account_id

string

Optional. Die ID des zu ändernden Kontos. Es muss entweder account oder account_id angegeben werden. Der Wert ist auf 60 Zeichen begrenzt.

roles[]

Role

Erforderlich. Die zu entfernenden Rollen.

RemoveSigningPublicKey

Entfernt den Signierschlüssel für das Konto aus dem angegebenen Slot. Der andere Slot darf nicht leer sein und muss den Schlüssel enthalten, mit dem die ClientTransaction signiert wurde.

Felder
key_slot

KeySlot

Erforderlich. Der Schlüssel-Slot, aus dem der Schlüssel entfernt wird. Wenn dieses Feld bereits leer ist, schlägt die Transaktion fehl.

ReplaceSigningPublicKey

Ersetzt den Konto-Signaturschlüssel im angegebenen Slot. Der andere Slot darf nicht leer sein und muss den Schlüssel enthalten, mit dem die ClientTransaction signiert wurde.

Felder
key_slot

KeySlot

Erforderlich. Der Schlüssel-Slot, in dem der Schlüssel ersetzt wird.

new_public_key

bytes

Erforderlich. Der neue öffentliche Schlüssel, der den öffentlichen Schlüssel im angegebenen Slot ersetzt.

Das Format des öffentlichen Schlüssels wird durch das Feld „new_key_format“ definiert. Als öffentliche Informationen betrachtet.

new_key_format

KeyFormat

Erforderlich. Das Schlüsselformat des neuen öffentlichen Schlüssels. Eine Liste der unterstützten Formate finden Sie in der Definition von KeyFormat. Als öffentliche Informationen betrachtet.

Rolle

Die regulären Rollen.

Enums
ROLE_UNSPECIFIED Ungültige Rolle.
ROLE_PAYER Die Rolle, mit der ein Konto eine Zahlungstransaktion starten kann.
ROLE_RECEIVER Die Rolle, mit der ein Konto Zahlungen empfangen kann.
ROLE_CONTRACT_CREATOR Die Rolle, mit der ein Konto Verträge bereitstellen kann.
ROLE_CONTRACT_PARTICIPANT Die Rolle, mit der ein Konto mit bereitgestellten Verträgen interagieren kann.

RoundCertificate

Zertifikat für die Ausführung einer Runde durch einen bestimmten Validator.

Felder
round_id

int64

Nur Ausgabe. Die ID der Runde, für die das Zertifikat gilt.

validator_id

string

Nur Ausgabe. Die für Menschen lesbare Validator-ID. Damit wird der öffentliche Schlüssel gesucht, mit dem die validator_signatures überprüft wird.

round_state_checksum_hex

string

Nur Ausgabe. Die hexadezimale Darstellung des homomorphen Digests für den Weltstatus nach Anwendung der Auswirkungen dieser Runde.

round_delta_checksum_hex

string

Nur Ausgabe. Die hexadezimale Darstellung des homomorphen Digests für die aggregierten Transaktionseffekte dieser Runde.

merkle_tree

MerkleTree

Nur Ausgabe. Merkle-Baum mit dieser Runde als Stammknoten und Transaktions-Batches (die in der Runde ausgeführt werden) als Blätter.

validator_signatures[]

bytes

Optional. Die Signatur des Validators. Die Signatur wird über den Digest der vorherigen Nutzlast dieses Datensatzes erstellt.

is_finalized

bool

Nur Ausgabe. Boolescher Wert, der angibt, ob die Runde abgeschlossen ist, d.h., ob ein ausreichendes Quorum von Validatoren diese Runde mit demselben Zertifikat zertifiziert hat.

SettlementMode

Der Abrechnungsmodus für ein Clearinghouse.

Enums
SETTLEMENT_MODE_UNSPECIFIED Der Abrechnungsmodus ist nicht angegeben. Dieser Wert ist ungültig und sollte nicht verwendet werden.
SETTLEMENT_MODE_DEFERRED Das Clearinghouse ist für die Nachverfolgung der Inhaberschaft der Off-Ledger-Guthaben verantwortlich und gibt regelmäßig SettlementRequest-Transaktionen aus, um die entsprechenden Salden im Ledger synchron zu halten.
SETTLEMENT_MODE_INSTANT Das Clearinghouse verwaltet einen einzelnen Pool von Geldern und das Ledger dient als zentrale Quelle für die Zuweisung dieser Gelder zwischen den Token-Managern. Diese Abrechnungsart kann auch als „sofortige Bruttoabrechnung“ bezeichnet werden.

SettlementRequest

Leitet einen Abrechnungsvorgang zwischen zwei Token-Managern ein. Der Absender muss ein Clearinghouse-Konto sein.

Im Aufschub SettlementMode, in dem das Clearinghaus die Gelder des Token-Managers verwahrt, ist dies die einzige Transaktion, die gesendet werden muss, um eine Abrechnung zwischen den beiden Token-Managern auszuführen.

Felder
payer
(deprecated)

Entity

Optional. Nicht veränderbar. Nicht mehr unterstützt: Verwenden Sie stattdessen payer_id. Die Konto-ID der Partei, die die Überweisung vornehmen muss.

payer_id

string

Optional. Nicht veränderbar. Die Konto-ID der Partei, die die Überweisung vornehmen muss. Es muss entweder payer oder payer_id angegeben werden.

beneficiary
(deprecated)

Entity

Optional. Nicht veränderbar. Nicht mehr unterstützt: Verwenden Sie stattdessen beneficiary_id. Die Konto-ID der Partei, die bezahlt werden muss.

beneficiary_id

string

Optional. Nicht veränderbar. Die Konto-ID des Zahlungsempfängers. Es muss entweder beneficiary oder beneficiary_id angegeben werden.

balance

CurrencyValue

Erforderlich. Nicht veränderbar. Der Saldo der ausgegebenen Tokens, die vom payer-Konto auf das beneficiary-Konto im Ledger übertragen werden müssen.

round_id

int64

Erforderlich. Nicht veränderbar. Die ID der Runde, in der dieser Abrechnungsbetrag berechnet wurde.

SignedTransaction

Eine Transaktion mit angehängten Signaturen. Damit eine Transaktion gesendet werden kann, muss diese Nachricht serialisiert und in ein SubmitTransactionRequest aufgenommen werden.

Felder
serialized_client_transaction

bytes

Erforderlich. Eine serialisierte ClientTransaction mit den Transaktionsdetails.

sender_signature

bytes

Erforderlich. Die Signatur des Transaktionssenders.

Die Signatur sollte durch Signieren der serialized_client_transaction Bytes mit dem eigenen privaten Schlüssel berechnet werden.

Bei einer Transaktionskette werden die zu signierenden Bytes als Verkettung der folgenden Elemente berechnet: - Ein Digest der serialisierten Client-Transaktion der gesamten Kette. – Eine Zusammenfassung der serialisierten signierten Transaktion jeder Einheit in der Kette in der Reihenfolge, in der sie in der Kette erscheinen. Die Digests werden mit SHA-256 berechnet.

sender_signing_key_slot

KeySlot

Optional. Der Schlüsselslot des Absenders, der zum Signieren der Transaktion verwendet wurde. Wenn nicht angegeben, wird der primäre Slot des Absenderkontos verwendet.

other_signatures[]

bytes

Optional. Die Unterschriften von Konten, die als zusätzliche Unterzeichner von Transaktionen aufgeführt sind. Anzahl und Reihenfolge dieser Signaturen müssen mit dem Feld signatories im ClientTransaction übereinstimmen.

Die zu signierenden Bytes sind dieselben wie für die sender_signature, die jeder Unterzeichner mit seinem eigenen privaten Schlüssel signieren sollte.

Die Anzahl und Identität der zusätzlichen Unterzeichner hängt von der jeweiligen Transaktionsart ab. Für eine Transaktionskette ist eine Signatur für jedes Konto erforderlich, das entweder als Absender oder als Unterzeichner einer Einheit in der Kette erscheint.

other_signing_key_slots[]

KeySlot

Optional. Die Schlüssel-Slots der Konten, die als zusätzliche Transaktionsunterzeichner aufgeführt sind. Wenn diese festgelegt sind, müssen die Anzahl und Reihenfolge dieser Schlüssel-Slots mit dem Feld other_signatures im SignedTransaction übereinstimmen. Wenn nicht angegeben, wird standardmäßig der primäre Slot jedes Kontos verwendet.

StatusEvent

Stellt ein Ereignis bei der Verarbeitung einer Transaktion dar, das von einem einzelnen Validator beobachtet wird.

Alle gemeldeten Werte werden aus der Perspektive des Validators angegeben, der die Anfrage bearbeitet, und können sich von der Ansicht anderer Validatoren unterscheiden.

Felder
event_time

Timestamp

Nur Ausgabe. Die Zeit, zu der das Ereignis von diesem Validator aufgezeichnet wurde.

event_type

EventType

Nur Ausgabe. Der Typ des Ereignisses.

event_details

EventDetails

Nur Ausgabe. Zusätzliche Details zum Ereignis.

StringList

Eine Liste von Strings.

Felder
values[]

string

Optional. Die Stringwerte.

SubmitOperationalTransactionRequest

Anfragenachricht für SubmitOperationalTransaction

Felder
endpoint

string

Erforderlich. Der Endpunkt, über den die Anfrage bereitgestellt wird. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Der Ort ist eine Region.

serialized_signed_operational_transaction

bytes

Erforderlich. Ein protobuf-serialisiertes SignedTransaction, das an das Ledger gesendet werden soll. Die beigefügte Client-Transaktion muss eine operative Transaktion sein und der Absender muss der Plattformbetreiber sein. Durch die Verwendung eines serialisierten Formats wird sichergestellt, dass alle Validatoren dieselbe Transaktions-ID als SHA-256-Digest der serialisierten Bytes berechnen.

SubmitOperationalTransactionResponse

Antwortnachricht für SubmitOperationalTransaction

Felder
transaction_digest_hex

string

Kennung, die die eingereichte operative Transaktion eindeutig repräsentiert. Es ist die hexadezimale Darstellung des SHA‑256-Hashwerts von serialized_signed_operational_transaction. Diese Transaktions-ID wird bereitgestellt, damit ein Client die Transaktion verfolgen kann, ohne die Hashing-Logik selbst implementieren zu müssen. Die Kennung kann direkt in nachfolgenden API-Aufrufen verwendet werden, z. B. um den Transaktionsstatus abzufragen.

SubmitTransactionRequest

Anfragenachricht für SubmitTransaction

Felder
endpoint

string

Erforderlich. Der Endpunkt, an den die Transaktion gesendet werden soll. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Der Ort ist eine Region.

serialized_signed_transaction

bytes

Erforderlich. Ein protobuf-serialisiertes SignedTransaction, das an das Ledger gesendet werden soll. Durch die Verwendung eines serialisierten Formats wird sichergestellt, dass alle Validatoren dieselbe Transaktions-ID als SHA-256-Digest der serialisierten Bytes berechnen.

SubmitTransactionResponse

Antwortnachricht für SubmitTransaction.

Felder
transaction_digest_hex

string

Kennung, die die eingereichte Transaktion eindeutig repräsentiert. Es ist die hexadezimale Darstellung des SHA‑256-Hashwerts von serialized_signed_transaction. Diese Transaktions-ID wird bereitgestellt, damit ein Client die Transaktion verfolgen kann, ohne die Hashing-Logik selbst implementieren zu müssen. Die Kennung kann direkt in nachfolgenden API-Aufrufen verwendet werden, z. B. um den Transaktionsstatus abzufragen.

TokenManagerDetails

Details zu einem bestimmten Token Manager.

Felder
issuance_limit

CurrencyValue

Nur Ausgabe. Die Anzahl der Tokens, die mit diesem Token-Manager erstellt werden dürfen.

issued_tokens

CurrencyValue

Nur Ausgabe. Die Anzahl der von diesem Token-Manager erstellten Tokens. Diese Zahl steigt beim Prägen und sinkt beim Verbrennen.

TransactionAttempt

Der Status eines versuchten Transaktionsvorgangs.

Felder
status

TransactionStatus

Nur Ausgabe. Der aktuelle Status des Transaktionsversuchs.

proof_of_inclusion

ProofOfInclusion

Nur Ausgabe. Zertifikat für die Einbeziehung der Transaktionseffekte in den Weltstatus. Wird nur angegeben, wenn der Status FINALIZED ist.

status_events[]

StatusEvent

Nur Ausgabe. Die für den Transaktionsversuch aufgezeichneten Statusereignisse in der Reihenfolge, in der sie aufgetreten sind.

TransactionStatus

Der Status des Transaktionsversuchs.

Enums
TRANSACTION_STATUS_UNSPECIFIED Unbekannter oder nicht initialisierter Status.
PENDING Die Transaktion ist diesem Validator bekannt, wurde aber noch nicht abgeschlossen.
FINALIZED Die Transaktion wird abgeschlossen. Die Auswirkungen wurden in der Blockchain gespeichert und können nicht rückgängig gemacht werden.

TransactionCertificate

Bescheinigung über die Ausführung einer bestimmten Transaktion in einer Runde.

Felder
transaction_digest_hex

string

Nur Ausgabe. Die ID der Transaktion, für die dieses Zertifikat gilt.

round_id

int64

Nur Ausgabe. Die ID der Ausführungsrunde, in der diese Transaktion ausgeführt wurde.

transaction_effects

TransactionEffects

Nur Ausgabe. Die Auswirkungen der Transaktionsausführung.

events[]

TransactionEvent

Nur Ausgabe. Durch die Transaktion erzeugte Ereignisse.

transaction_effects_state_checksum_hex

string

Nur Ausgabe. Homomorpher Prüfsumme der Effekte. Ein als hexadezimaler String codierter 2.048-Byte-Wert.

certification_results_digest_hex

string

Nur Ausgabe. Der kryptografische Digest aller vorherigen Felder in der Reihenfolge. Wird zum Erstellen eines Merkle-Baums für den Einschlussnachweis verwendet.

TransactionChain

Eine Transaktionskette mit mehreren Transaktionseinheiten, die nacheinander ausgeführt werden sollen.

Die Einheiten werden nacheinander in der angegebenen Reihenfolge ausgeführt. Wenn alle Einheiten erfolgreich sind, werden ihre kumulativen Auswirkungen atomar auf den Weltstatus angewendet. Andernfalls schlägt die gesamte Kette fehl und es werden keine Auswirkungen angewendet.

Felder
units[]

bytes

Die einzelnen Einheiten der Kette. Jede Einheit muss ein serialisiertes SignedTransaction sein.

Die serialisierten Byte sind erforderlich, um die zu signierenden Byte für die Kette selbst zu bestimmen.

TransactionEffect

Stellt eine Aktualisierung des Weltstatus durch eine Transaktion dar.

Wenn es ein delta_val enthält, wird davon ausgegangen, dass es sich um ein Delta (einen ganzzahligen Offset) handelt, das auf den zuvor gespeicherten Wert für einen bestimmten Schlüssel angewendet wird. In diesem Fall sollten new_val und old_val leer sein.

Andernfalls wird davon ausgegangen, dass mindestens old_val oder new_val (oder beides) vorhanden ist. Ein leerer old_val-Wert gibt an, dass der Wert eingefügt wurde. Ein leerer new_val-Wert gibt an, dass der Wert gelöscht wurde.

Felder
key

bytes

Nur Ausgabe. Der Schlüssel im Weltstatus, der aktualisiert wurde.

old_val

bytes

Nur Ausgabe. Der Wert des Schlüssels vor der Ausführung der Transaktion.

new_val

bytes

Nur Ausgabe. Der Wert des Schlüssels nach Ausführung der Transaktion.

delta_val

int64

Nur Ausgabe. Ein ganzzahliger Offset, der auf den zuvor gespeicherten Wert angewendet wurde.

TransactionEffects

Auswirkungen der Ausführung einer Transaktion.

Felder
status

TransactionStatus

Nur Ausgabe. Der resultierende Status der Transaktionsausführung.

effects[]
(deprecated)

TransactionEffect

Nur Ausgabe. Verworfen: Fragen Sie stattdessen den Netzwerkstatus ab, um Änderungen am Weltstatus zu ermitteln. Die Auswirkungen der Transaktion auf den Weltstatus.

TransactionEvent

Ein Ereignis, das durch eine Transaktion ausgelöst wird.

Felder
type

string

Nur Ausgabe. Art des Ereignisses. Ein besonderes Ereignis vom Typ transaction_output enthält die Ausgaben, die durch die Transaktion generiert wurden, z. B. die Konto-ID eines neu erstellten Kontos.

attributes[]

EventAttribute

Nur Ausgabe. Die Ereignisattribute als beliebige Schlüssel/Wert-Paare.

EventAttribute

Ein einzelnes Attribut als Schlüssel/Wert-Paar.

Felder
key

string

Nur Ausgabe. Der Schlüssel des Attributs.

value

string

Nur Ausgabe. Der Wert des Attributs.

TransactionState

Der Status einer Transaktion.

Felder
transaction_attempts[]

TransactionAttempt

Ein Eintrag für jede bekannte Übermittlung der Transaktion an den Validator, der die Anfrage bearbeitet.

TransactionStatus

Stellt den Status einer Transaktionsausführung dar.

Felder
code

int32

Nur Ausgabe. Der Statuscode, ein numerischer Wert, dessen Bedeutung durch den entsprechenden gRPC-Statuscode definiert wird.

message

bytes

Nur Ausgabe. Die Fehlermeldung, falls vorhanden. Wird nur festgelegt, wenn der Code nicht OK ist. Dies ist ein als UTF-8-Byte codierter String. Als Byte gespeichert, um Probleme mit der Deterministik der Codierung zu vermeiden.

Übertragen

Überträgt Tokens von einem Nutzerkonto auf ein anderes. Der Absender muss ein reguläres Nutzerkonto sein, nicht ein Konto mit Berechtigungen wie ein Token-Manager oder ein Account Manager.

Außerdem muss der Absender der Transaktion ROLE_PAYER aktiviert haben, während der Empfänger ROLE_RECEIVER aktiviert haben muss.

Felder
beneficiary
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen beneficiary_id. Das Konto, das die Tokens erhält.

beneficiary_id

string

Optional. Die ID des Kontos, das die Tokens erhält. Es muss entweder beneficiary oder beneficiary_id angegeben werden.

amount

CurrencyValue

Erforderlich. Der zu überweisende Betrag. Der Betrag muss positiv sein.

TransferContractTokenManager

Überträgt die Inhaberschaft des Vertrags-Token-Managers auf ein neues Konto. Der Absender muss der aktuelle Währungsbetreiber für die Währung sein.

Wenn die Transaktion erfolgreich ist, wird der aktuelle Vertrags-Token-Manager für die Währung deaktiviert und die ID des neu erstellten Kontos wird als Ereignis im TransactionCertificate der abgeschlossenen Transaktion zurückgegeben.

Felder
public_key

bytes

Erforderlich. Der öffentliche Schlüssel des neuen Contract Token Manager. Dies ist nicht der öffentliche Schlüssel des Betreibers. Dies ist der öffentliche Schlüssel des neuen Vertrags-Token-Managers. Er wird im Ledger gespeichert. Damit wird die Signatur der Transaktionen validiert, die vom Konto des Vertrags-Token-Managers stammen.

Das Format des öffentlichen Schlüssels wird durch das Feld key_format definiert. Als öffentliche Informationen betrachtet.

account_comment

string

Optional. Nicht veränderbar. Ein undurchsichtiges Kommentarfeld, das vom System nicht interpretiert, sondern im Konto im Ledger gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

key_format

KeyFormat

Optional. Nicht veränderbar. Das Schlüsselformat des öffentlichen Schlüssels. Wenn nichts angegeben ist, wird standardmäßig ein binär serialisiertes Keyset im Tink-Wire-Format verwendet. Als öffentliche Informationen betrachtet.

TransferCurrencyOperator

Überträgt die Inhaberschaft des angegebenen Währungsoperators auf ein neues Konto. Der Absender muss der Plattformbetreiber sein.

Wenn die Transaktion erfolgreich ist, wird der angegebene Währungsoperator deaktiviert und die ID des neu erstellten Kontos wird als Ereignis in der TransactionCertificate der abgeschlossenen Transaktion zurückgegeben.

Felder
public_key

bytes

Erforderlich. Der öffentliche Schlüssel des neuen Währungsoperators. Dieser öffentliche Schlüssel wird dem Währungsbetreiber zugeordnet und im Ledger gespeichert. Damit wird die Signatur der Transaktionen aus dem Konto des Währungsbetreibers validiert.

Das Format des öffentlichen Schlüssels wird durch das Feld key_format definiert. Als öffentliche Informationen betrachtet.

key_format

KeyFormat

Optional. Nicht veränderbar. Das Schlüsselformat des öffentlichen Schlüssels. Wenn nichts angegeben ist, wird standardmäßig ein binär serialisiertes Keyset im Tink-Wire-Format verwendet. Als öffentliche Informationen betrachtet.

account_comment

string

Optional. Nicht veränderbar. Ein undurchsichtiges Kommentarfeld, das vom System nicht interpretiert, sondern im Konto im Ledger gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

currency_operator
(deprecated)

Entity

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen currency_operator_id. Der zu ersetzende Währungsoperator. Muss aktiv sein.

currency_operator_id

string

Optional. Die ID des zu ersetzenden Währungsoperators. Muss aktiv sein. Es muss entweder currency_operator oder currency_operator_id angegeben werden. Der Wert ist auf 60 Zeichen begrenzt.

TransferPlatformOperator

Überträgt die Inhaberschaft des Plattformbetreibers auf ein neues Konto. Der Absender muss der aktuelle Plattformbetreiber sein.

Wenn die Transaktion erfolgreich ist, wird der aktuelle Plattformbetreiber deaktiviert und die ID des neu erstellten Kontos wird als Ereignis im TransactionCertificate der abgeschlossenen Transaktion zurückgegeben.

Felder
public_key

bytes

Erforderlich. Der öffentliche Schlüssel des neuen Plattformbetreibers. Dieser öffentliche Schlüssel wird dem Plattformbetreiber zugeordnet und im Ledger gespeichert. Damit wird die Signatur der Transaktionen aus dem Konto des Plattformbetreibers validiert.

Das Format des öffentlichen Schlüssels wird durch das Feld key_format definiert. Als öffentliche Informationen betrachtet.

key_format

KeyFormat

Optional. Nicht veränderbar. Das Schlüsselformat des öffentlichen Schlüssels. Wenn nichts angegeben ist, wird standardmäßig ein binär serialisiertes Keyset im Tink-Wire-Format verwendet. Als öffentliche Informationen betrachtet.

account_comment

string

Optional. Nicht veränderbar. Ein undurchsichtiges Kommentarfeld, das vom System nicht interpretiert, sondern im Konto im Ledger gespeichert wird. Als öffentliche Informationen betrachtet. Sie darf maximal 128 Zeichen lang sein. Kann leer gelassen werden. Nachdem das Feld erstellt wurde, kann es nicht mehr geändert werden.

UserDetails

Details zu einem bestimmten Nutzerkonto.

Felder
account_manager
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen account_manager_id. Der Account Manager für diesen Nutzer.

account_manager_id

string

Nur Ausgabe. Die ID des Accountmanagers für diesen Nutzer.

token_manager
(deprecated)

Entity

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen token_manager_id. Der Token-Manager für diesen Nutzer.

token_manager_id

string

Nur Ausgabe. Die ID des Token-Managers für diesen Nutzer.

roles[]

Role

Nur Ausgabe. Die Liste der Rollen, die diesem Konto zugewiesen wurden.

account_status

AccountStatus

Nur Ausgabe. Der Status dieses Kontos.

balance

CurrencyValue

Nur Ausgabe. Der Token-Saldo dieses Nutzerkontos.

account_fields
(deprecated)

map<string, Fields>

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen contract_account_fields. Die Felder des Vertragskontos (Vertrags-ID –> Felder) für diesen Nutzer.

contract_account_fields

map<string, Fields>

Nur Ausgabe. Die Felder des Vertragskontos (Vertrags-ID –> Felder) für diesen Nutzer.

Wert

Ein konkreter Wert eines bestimmten Typs.

Felder
Union-Feld value. Der tatsächliche Wert. Für value ist nur einer der folgenden Werte zulässig:
none_value

NoneValue

Optional. Stellt einen „None“-Wert dar.

bool_value

bool

Optional. Ein boolescher Wert.

int64_value

int64

Optional. Ein int64-Wert.

string_value

string

Optional. Ein Stringwert.

account_id

string

Optional. Eine Konto-ID.

dict_value

DictValue

Optional. Ein Dictionary-Wert.

qualified_currency_value

QualifiedCurrencyValue

Optional. Ein qualifizierter Währungswert.

amount_value

AmountValue

Optional. Ein Betragswert.