Account

Gibt den Status eines Kontos im Ledger an.

JSON-Darstellung 
{
  "sequenceNumber": string,
  "publicKey": string,
  "roundId": string,
  "comment": string,

  // Union field account_details can be only one of the following:
  "userDetails": {
    object (UserDetails)
  },
  "accountManagerDetails": {
    object (AccountManagerDetails)
  },
  "tokenManagerDetails": {
    object (TokenManagerDetails)
  },
  "contractTokenManagerDetails": {
    object (ContractTokenManagerDetails)
  },
  "contractDetails": {
    object (ContractDetails)
  },
  "clearinghouseDetails": {
    object (ClearingHouseDetails)
  },
  "currencyOperatorDetails": {
    object (CurrencyOperatorDetails)
  },
  "platformOperatorDetails": {
    object (PlatformOperatorDetails)
  }
  // End of list of possible types for union field account_details.
}
Felder
sequenceNumber

string (int64 format)

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

string (bytes format)

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

Ein base64-codierter String.
roundId

string (int64 format)

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:
userDetails

object (UserDetails)

Nur Ausgabe. Details zu einem Standardnutzerkonto.
accountManagerDetails

object (AccountManagerDetails)

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

object (TokenManagerDetails)

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

object (ContractTokenManagerDetails)

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

object (ContractDetails)

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

object (ClearingHouseDetails)

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

object (CurrencyOperatorDetails)

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

object (PlatformOperatorDetails)

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

UserDetails

Details zu einem bestimmten Nutzerkonto.

JSON-Darstellung 
{
  "accountManager": {
    object (Entity)
  },
  "accountManagerId": string,
  "tokenManager": {
    object (Entity)
  },
  "tokenManagerId": string,
  "roles": [
    enum (Role)
  ],
  "accountStatus": enum (AccountStatus),
  "balance": {
    object (CurrencyValue)
  },
  "accountFields": {
    string: {
      object (Fields)
    },
    ...
  },
  "contractAccountFields": {
    string: {
      object (Fields)
    },
    ...
  }
}
Felder
accountManager
(deprecated)

object (Entity)

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

string

Nur Ausgabe. Die ID des Accountmanagers für diesen Nutzer.
tokenManager
(deprecated)

object (Entity)

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

string

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

enum (Role)

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

enum (AccountStatus)

Nur Ausgabe. Der Status dieses Kontos.
balance

object (CurrencyValue)

Nur Ausgabe. Der Token-Saldo dieses Nutzerkontos.
accountFields
(deprecated)

map (key: string, value: object (Fields))

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

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contractAccountFields

map (key: string, value: object (Fields))

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

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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.

JSON-Darstellung 
{
  "id": string
}
Felder
id

string

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

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.

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.

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.

JSON-Darstellung 
{
  "value": string
}
Felder
value

string (int64 format)

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.

Felder

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

JSON-Darstellung 
{
  "fields": {
    string: {
      object (Value)
    },
    ...
  }
}
Felder
fields

map (key: string, value: object (Value))

Nur Ausgabe. Die Zuordnung von Feldnamen zu ihren Werten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Wert

Ein konkreter Wert eines bestimmten Typs.

JSON-Darstellung 
{

  // Union field value can be only one of the following:
  "noneValue": enum (NoneValue),
  "boolValue": boolean,
  "int64Value": string,
  "stringValue": string,
  "accountId": string,
  "dictValue": {
    object (DictValue)
  },
  "qualifiedCurrencyValue": {
    object (QualifiedCurrencyValue)
  },
  "amountValue": {
    object (AmountValue)
  }
  // End of list of possible types for union field value.
}
Felder
Union-Feld value. Der tatsächliche Wert. Für value ist nur einer der folgenden Werte zulässig:
noneValue

enum (NoneValue)

Optional. Stellt einen „None“-Wert dar.
boolValue

boolean

Optional. Ein boolescher Wert.
int64Value

string (int64 format)

Optional. Ein int64-Wert.
stringValue

string

Optional. Ein Stringwert.
accountId

string

Optional. Eine Konto-ID.
dictValue

object (DictValue)

Optional. Ein Dictionary-Wert.
qualifiedCurrencyValue

object (QualifiedCurrencyValue)

Optional. Ein qualifizierter Währungswert.
amountValue

object (AmountValue)

Optional. Ein Betragswert.

NoneValue

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

Enums
NONE_VALUE_UNSPECIFIED Der Wert „None“.

DictValue

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

JSON-Darstellung 
{

  // Union field keys can be only one of the following:
  "boolKeys": {
    object (BoolList)
  },
  "stringKeys": {
    object (StringList)
  },
  "int64Keys": {
    object (Int64List)
  },
  "accountIdKeys": {
    object (AccountIdList)
  }
  // End of list of possible types for union field keys.

  // Union field values can be only one of the following:
  "boolValues": {
    object (BoolList)
  },
  "stringValues": {
    object (StringList)
  },
  "int64Values": {
    object (Int64List)
  },
  "dictValues": {
    object (DictList)
  }
  // End of list of possible types for union field values.
}
Felder
Union-Feld keys. Jeder Schlüssel kann nur einen Typ haben. Für keys ist nur einer der folgenden Werte zulässig:
boolKeys

object (BoolList)

Optional. Eine Liste mit booleschen Schlüsseln.
stringKeys

object (StringList)

Optional. Eine Liste von String-Schlüsseln.
int64Keys

object (Int64List)

Optional. Eine Liste von int64-Schlüsseln.
accountIdKeys

object (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:
boolValues

object (BoolList)

Optional. Eine Liste mit booleschen Werten.
stringValues

object (StringList)

Optional. Eine Liste von Stringwerten.
int64Values

object (Int64List)

Optional. Eine Liste mit int64-Werten.
dictValues

object (DictList)

Optional. Die Werte sind eine Liste verschachtelter Dictionarys.

BoolList

Eine Liste mit booleschen Werten.

JSON-Darstellung 
{
  "values": [
    boolean
  ]
}
Felder
values[]

boolean

Optional. Die booleschen Werte.

StringList

Eine Liste von Strings.

JSON-Darstellung 
{
  "values": [
    string
  ]
}
Felder
values[]

string

Optional. Die Stringwerte.

Int64List

Eine Liste von int64-Werten.

JSON-Darstellung 
{
  "values": [
    string
  ]
}
Felder
values[]

string (int64 format)

Optional. Die int64-Werte.

AccountIdList

Eine Liste der Konto-IDs.

JSON-Darstellung 
{
  "values": [
    string
  ]
}
Felder
values[]

string

Optional. Die Konto-ID-Werte.

DictList

Eine Liste von Wörterbüchern.

JSON-Darstellung 
{
  "values": [
    {
      object (DictValue)
    }
  ]
}
Felder
values[]

object (DictValue)

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

QualifiedCurrencyValue

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

JSON-Darstellung 
{
  "operatorId": string
}
Felder
operatorId

string

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

AmountValue

Stellt einen Betrag in einer Währung dar.

JSON-Darstellung 
{
  "currency": {
    object (QualifiedCurrencyValue)
  },
  "amountValue": string
}
Felder
currency

object (QualifiedCurrencyValue)

Erforderlich. Die Währung des Betrags.
amountValue

string (int64 format)

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

AccountManagerDetails

Details speziell für Account Manager.

JSON-Darstellung 
{
  "tokenManager": {
    object (Entity)
  },
  "numAccounts": integer,
  "tokenManagerId": string
}
Felder
tokenManager
(deprecated)

object (Entity)

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

integer

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

string

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

TokenManagerDetails

Details zu einem bestimmten Token Manager.

JSON-Darstellung 
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  }
}
Felder
issuanceLimit

object (CurrencyValue)

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

object (CurrencyValue)

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

ContractTokenManagerDetails

Details speziell für einen Contract Token Manager.

JSON-Darstellung 
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  },
  "previousContractTokenManagerId": string,
  "accountStatus": enum (AccountStatus)
}
Felder
issuanceLimit

object (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 issuedTokens entsprechen.
issuedTokens

object (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.
previousContractTokenManagerId

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.
accountStatus

enum (AccountStatus)

Nur Ausgabe. Der Status dieses Kontos.

ContractDetails

Details zu einem bestimmten Smart Contract.

JSON-Darstellung 
{
  "owner": {
    object (Entity)
  },
  "ownerId": string,
  "code": string,
  "contractFields": {
    object (Fields)
  },
  "currencyBalances": {
    string: {
      object (CurrencyValue)
    },
    ...
  }
}
Felder
owner
(deprecated)

object (Entity)

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

string

Nur Ausgabe. Die ID des Inhabers des Vertrags.
code

string (bytes format)

Nur Ausgabe. Der serialisierte Vertragscode.

Ein base64-codierter String.
contractFields

object (Fields)

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

map (key: string, value: object (CurrencyValue))

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

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ClearingHouseDetails

Details zu einem bestimmten Clearinghouse.

JSON-Darstellung 
{
  "accountStatus": enum (AccountStatus),
  "balances": [
    {
      object (BalanceToSettle)
    }
  ],
  "settlementMode": enum (SettlementMode)
}
Felder
accountStatus

enum (AccountStatus)

Nur Ausgabe. Der Status dieses Kontos.
balances[]

object (BalanceToSettle)

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

enum (SettlementMode)

Nur Ausgabe. Der Abrechnungsmodus dieser Abrechnungsstelle.

BalanceToSettle

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

JSON-Darstellung 
{
  "balancePayer": {
    object (Entity)
  },
  "balancePayerId": string,
  "balanceReceiver": {
    object (Entity)
  },
  "balanceReceiverId": string,
  "balance": {
    object (CurrencyValue)
  }
}
Felder
balancePayer
(deprecated)

object (Entity)

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

string

Nur Ausgabe. Die ID des Kontos, auf das sich das zu begleichende Guthaben bezieht.
balanceReceiver
(deprecated)

object (Entity)

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

string

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

object (CurrencyValue)

Nur Ausgabe. Der auszugleichende Saldo. Muss positiv sein.

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.

CurrencyOperatorDetails

Details zu einem Währungsbetreiber.

JSON-Darstellung 
{
  "currency": string,
  "currencyCode": string,
  "accountStatus": enum (AccountStatus),
  "previousEntityId": {
    object (Entity)
  },
  "previousCurrencyOperatorId": string,
  "platformOperatorEntityId": {
    object (Entity)
  },
  "platformOperatorId": string,
  "contractTokenManager": {
    object (Entity)
  },
  "contractTokenManagerId": string,
  "clearinghouseId": string
}
Felder
currency
(deprecated)

string

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

string

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

enum (AccountStatus)

Nur Ausgabe. Der Status dieses Kontos.
previousEntityId
(deprecated)

object (Entity)

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen previousCurrencyOperatorId. 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.
previousCurrencyOperatorId

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.
platformOperatorEntityId
(deprecated)

object (Entity)

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

string

Nur Ausgabe. Die ID des Plattformbetreibers, der diesen Währungsbetreiber erstellt hat.
contractTokenManager
(deprecated)

object (Entity)

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

string

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

string

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

PlatformOperatorDetails

Details speziell für einen Plattformbetreiber.

JSON-Darstellung 
{
  "accountStatus": enum (AccountStatus),
  "previousEntityId": {
    object (Entity)
  },
  "previousPlatformOperatorId": string
}
Felder
accountStatus

enum (AccountStatus)

Nur Ausgabe. Der Status dieses Kontos.
previousEntityId
(deprecated)

object (Entity)

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

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.