Account

Représente l'état d'un compte dans le grand livre.

Représentation JSON
{
  "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.
}
Champs
sequenceNumber

string (int64 format)

Uniquement en sortie. Numéro de séquence de ce compte. Ce nombre augmente à chaque transaction envoyée par ce compte.

publicKey

string (bytes format)

Uniquement en sortie. Clé publique principale associée à ce compte, utilisée pour la validation de la signature.

Chaîne encodée en base64.

roundId

string (int64 format)

Uniquement en sortie. ID du tour d'exécution (semblable à la "hauteur" du bloc) auquel les informations de compte fournies sont exactes.

comment

string

Uniquement en sortie. Commentaire sur le compte enregistré lors de sa création.

Champ d'union account_details. des informations spécifiques en fonction du type de compte. account_details ne peut être qu'un des éléments suivants :
userDetails

object (UserDetails)

Uniquement en sortie. Informations sur un compte utilisateur standard.

accountManagerDetails

object (AccountManagerDetails)

Uniquement en sortie. Informations sur un compte de responsable de compte.

tokenManagerDetails

object (TokenManagerDetails)

Uniquement en sortie. Informations sur un compte administrateur de jetons.

contractTokenManagerDetails

object (ContractTokenManagerDetails)

Uniquement en sortie. Informations sur un compte administrateur de jetons de contrat.

contractDetails

object (ContractDetails)

Uniquement en sortie. Détails d'un compte de contrat intelligent.

clearinghouseDetails

object (ClearingHouseDetails)

Uniquement en sortie. Informations sur un compte de chambre de compensation.

currencyOperatorDetails

object (CurrencyOperatorDetails)

Uniquement en sortie. Informations sur un compte d'opérateur de devises.

platformOperatorDetails

object (PlatformOperatorDetails)

Uniquement en sortie. Informations sur un compte d'opérateur de plate-forme.

UserDetails

Informations spécifiques à un compte utilisateur.

Représentation JSON
{
  "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)
    },
    ...
  }
}
Champs
accountManager
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt accountManagerId. Gestionnaire de compte pour cet utilisateur.

accountManagerId

string

Uniquement en sortie. ID du responsable de compte pour cet utilisateur.

tokenManager
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt tokenManagerId. Gestionnaire de jetons pour cet utilisateur.

tokenManagerId

string

Uniquement en sortie. ID du gestionnaire de jetons pour cet utilisateur.

roles[]

enum (Role)

Uniquement en sortie. Liste des rôles attribués à ce compte.

accountStatus

enum (AccountStatus)

Uniquement en sortie. État de ce compte.

balance

object (CurrencyValue)

Uniquement en sortie. Solde de jetons de ce compte utilisateur.

accountFields
(deprecated)

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

Uniquement en sortie. Obsolète : utilisez plutôt contractAccountFields. Champs du compte contractuel (ID du contrat → champs) pour cet utilisateur.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

contractAccountFields

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

Uniquement en sortie. Champs du compte contractuel (ID du contrat → champs) pour cet utilisateur.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Entité

Entité du réseau Universal Ledger. Tous les comptes sont associés à une entité. L'ID d'entité, souvent appelé ID de compte, est unique et immuable sur l'ensemble du réseau.

Représentation JSON
{
  "id": string
}
Champs
id

string

Uniquement en sortie. ID attribué à l'entité. Il est attribué par le réseau lors de la création du compte.

Rôle

Ensemble de rôles standard.

Enums
ROLE_UNSPECIFIED Rôle non valide.
ROLE_PAYER Rôle qui permet à un compte de lancer une transaction de paiement.
ROLE_RECEIVER Rôle qui permet à un compte de recevoir des paiements.
ROLE_CONTRACT_CREATOR Rôle qui permet à un compte de déployer des contrats.
ROLE_CONTRACT_PARTICIPANT Rôle qui permet à un compte d'interagir avec les contrats déployés.

AccountStatus

État d'un compte.

Enums
ACCOUNT_STATUS_UNSPECIFIED État non valide.
ACCOUNT_STATUS_ACTIVE État actif dans lequel le compte peut effectuer les opérations autorisées par ses rôles.
ACCOUNT_STATUS_INACTIVE État inactif dans lequel toutes les transactions sur le compte sont interdites. L'administrateur du compte peut toujours envoyer des transactions de gestion de compte.

CurrencyValue

Représente un montant de devise (c'est-à-dire de l'argent). Notez que la devise de facturation n'est pas incluse dans ce message. La devise appropriée est déterminée par le compte qui envoie la transaction. Chaque compte est associé à une devise unique et immuable.

Représentation JSON
{
  "value": string
}
Champs
value

string (int64 format)

Obligatoire. Nombre de sous-unités de la devise.

Cette plus petite dénomination valide est appelée "unité mineure" et est spécifiée dans la norme ISO 4217. Par exemple, pour l'USD, la valeur correspondra au nombre de cents, et pour la GBP, au nombre de pence. Pour le yen japonais, qui n'a pas de sous-unité, il s'agit du nombre de yens.

Champs

Map des champs (nom du champ -> valeur) d'un contrat utilisé pour représenter les champs du contrat ou du compte.

Représentation JSON
{
  "fields": {
    string: {
      object (Value)
    },
    ...
  }
}
Champs
fields

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

Uniquement en sortie. Mappage des noms de champs à leurs valeurs.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Valeur

Valeur concrète d'un type donné.

Représentation JSON
{

  // 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.
}
Champs
Champ d'union value. Valeur réelle. value ne peut être qu'un des éléments suivants :
noneValue

enum (NoneValue)

Facultatif. Représente une valeur "None".

boolValue

boolean

Facultatif. Une valeur booléenne.

int64Value

string (int64 format)

Facultatif. Valeur int64.

stringValue

string

Facultatif. Valeur de chaîne.

accountId

string

Facultatif. ID de compte.

dictValue

object (DictValue)

Facultatif. Valeur de dictionnaire.

qualifiedCurrencyValue

object (QualifiedCurrencyValue)

Facultatif. Valeur monétaire qualifiée.

amountValue

object (AmountValue)

Facultatif. Valeur du montant.

NoneValue

Énumération singleton pour représenter la valeur "None".

Enums
NONE_VALUE_UNSPECIFIED Valeur "None".

DictValue

Les index mappent la clé à la valeur. Par exemple, la clé keys[0] correspond à values[0].

Représentation JSON
{

  // 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.
}
Champs
Champ d'union keys. Chaque clé ne peut être qu'un seul type. keys ne peut être qu'un des éléments suivants :
boolKeys

object (BoolList)

Facultatif. Liste de clés booléennes.

stringKeys

object (StringList)

Facultatif. Liste de clés de chaîne.

int64Keys

object (Int64List)

Facultatif. Liste de clés int64.

accountIdKeys

object (AccountIdList)

Facultatif. Liste des clés d'ID de compte.

Champ d'union values. Chaque valeur ne peut être qu'un seul type. values ne peut être qu'un des éléments suivants :
boolValues

object (BoolList)

Facultatif. Liste de valeurs booléennes.

stringValues

object (StringList)

Facultatif. Liste de valeurs de chaîne.

int64Values

object (Int64List)

Facultatif. Liste de valeurs int64.

dictValues

object (DictList)

Facultatif. Les valeurs sont une liste de dictionnaires imbriqués.

BoolList

Liste de valeurs booléennes.

Représentation JSON
{
  "values": [
    boolean
  ]
}
Champs
values[]

boolean

Facultatif. Valeurs booléennes.

StringList

Liste de chaînes.

Représentation JSON
{
  "values": [
    string
  ]
}
Champs
values[]

string

Facultatif. Valeurs de chaîne.

Int64List

Liste d'entiers int64.

Représentation JSON
{
  "values": [
    string
  ]
}
Champs
values[]

string (int64 format)

Facultatif. Valeurs int64.

AccountIdList

Liste des ID de compte.

Représentation JSON
{
  "values": [
    string
  ]
}
Champs
values[]

string

Facultatif. Valeurs des ID de compte.

DictList

Liste de dictionnaires.

Représentation JSON
{
  "values": [
    {
      object (DictValue)
    }
  ]
}
Champs
values[]

object (DictValue)

Facultatif. Valeurs DictValue. Tous les dictionnaires imbriqués doivent avoir le même type concret.

QualifiedCurrencyValue

Représente une devise dans le grand livre, qualifiée par son opérateur de devise.

Représentation JSON
{
  "operatorId": string
}
Champs
operatorId

string

Obligatoire. ID de l'opérateur de devises qui gère la devise.

AmountValue

Représente un montant libellé dans une devise.

Représentation JSON
{
  "currency": {
    object (QualifiedCurrencyValue)
  },
  "amountValue": string
}
Champs
currency

object (QualifiedCurrencyValue)

Obligatoire. Devise du montant.

amountValue

string (int64 format)

Obligatoire. Nombre de sous-unités de la devise.

AccountManagerDetails

Informations spécifiques à un responsable de compte.

Représentation JSON
{
  "tokenManager": {
    object (Entity)
  },
  "numAccounts": integer,
  "tokenManagerId": string
}
Champs
tokenManager
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt tokenManagerId. Gestionnaire de jetons par défaut pour les comptes créés par ce gestionnaire de comptes.

numAccounts

integer

Uniquement en sortie. Nombre de comptes créés par ce responsable de compte.

tokenManagerId

string

Uniquement en sortie. ID du gestionnaire de jetons par défaut pour les comptes créés par ce gestionnaire de compte.

TokenManagerDetails

Informations spécifiques à un gestionnaire de jetons.

Représentation JSON
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  }
}
Champs
issuanceLimit

object (CurrencyValue)

Uniquement en sortie. Nombre de jetons que ce gestionnaire de jetons est autorisé à générer.

issuedTokens

object (CurrencyValue)

Uniquement en sortie. Nombre de jetons créés par ce gestionnaire de jetons. Ce nombre augmente lors de la frappe et diminue lors de la destruction.

ContractTokenManagerDetails

Informations spécifiques à un gestionnaire de jetons de contrat.

Représentation JSON
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  },
  "previousContractTokenManagerId": string,
  "accountStatus": enum (AccountStatus)
}
Champs
issuanceLimit

object (CurrencyValue)

Uniquement en sortie. Nombre de jetons pour lesquels ce gestionnaire de jetons de contrat est autorisé à fournir une garantie.

Étant donné que les gestionnaires de jetons de contrat ne peuvent pas augmenter ni diminuer leur limite d'émission, celle-ci doit être égale à issuedTokens.

issuedTokens

object (CurrencyValue)

Uniquement en sortie. Nombre de jetons pour lesquels ce gestionnaire de jetons de contrat fournit une garantie (c'est-à-dire sa responsabilité totale).

Cela correspond à la somme de tous les soldes détenus dans les contrats pour sa devise, plus sa position nette dans la matrice de règlement.

previousContractTokenManagerId

string

Uniquement en sortie. ID de compte de l'ancien gestionnaire de jetons de contrat pour cette devise. Cela forme une piste d'audit qui peut être parcourue pour découvrir tous les gestionnaires précédents. Si ce gestionnaire de jetons de contrat est le premier pour la devise, ce champ sera vide.

accountStatus

enum (AccountStatus)

Uniquement en sortie. État de ce compte.

ContractDetails

Informations spécifiques à un contrat intelligent.

Représentation JSON
{
  "owner": {
    object (Entity)
  },
  "ownerId": string,
  "code": string,
  "contractFields": {
    object (Fields)
  },
  "currencyBalances": {
    string: {
      object (CurrencyValue)
    },
    ...
  }
}
Champs
owner
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt ownerId. Propriétaire du contrat.

ownerId

string

Uniquement en sortie. ID du propriétaire du contrat.

code

string (bytes format)

Uniquement en sortie. Code de contrat sérialisé.

Chaîne encodée en base64.

contractFields

object (Fields)

Uniquement en sortie. Champs du contrat (nom du champ -> valeur) pour ce contrat.

currencyBalances

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

Uniquement en sortie. Soldes de devises détenus par le contrat (opérateur de devise → solde).

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ClearingHouseDetails

Informations spécifiques à une chambre de compensation.

Représentation JSON
{
  "accountStatus": enum (AccountStatus),
  "balances": [
    {
      object (BalanceToSettle)
    }
  ],
  "settlementMode": enum (SettlementMode)
}
Champs
accountStatus

enum (AccountStatus)

Uniquement en sortie. État de ce compte.

balances[]

object (BalanceToSettle)

Uniquement en sortie. Soldes que cette chambre de compensation suit actuellement pour le règlement.

settlementMode

enum (SettlementMode)

Uniquement en sortie. Mode de règlement de cette chambre de compensation.

BalanceToSettle

Solde à régler entre deux gestionnaires de jetons.

Représentation JSON
{
  "balancePayer": {
    object (Entity)
  },
  "balancePayerId": string,
  "balanceReceiver": {
    object (Entity)
  },
  "balanceReceiverId": string,
  "balance": {
    object (CurrencyValue)
  }
}
Champs
balancePayer
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt balancePayerId. Compte auquel le solde à régler est dû.

balancePayerId

string

Uniquement en sortie. ID du compte qui doit régler le solde.

balanceReceiver
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt balanceReceiverId. Compte auquel le solde à régler est dû.

balanceReceiverId

string

Uniquement en sortie. ID du compte auquel le solde à régler est dû.

balance

object (CurrencyValue)

Uniquement en sortie. Solde à régler. Doit être positive.

SettlementMode

Mode de règlement d'une chambre de compensation.

Enums
SETTLEMENT_MODE_UNSPECIFIED Le mode de règlement n'est pas spécifié. Cette valeur n'est pas valide et ne doit pas être utilisée.
SETTLEMENT_MODE_DEFERRED La chambre de compensation est chargée de suivre la propriété des fonds hors chaîne et d'émettre périodiquement des transactions SettlementRequest pour maintenir la synchronisation des soldes correspondants dans le grand livre.
SETTLEMENT_MODE_INSTANT La chambre de compensation gère un pool de fonds unique, et le grand livre sert de source de référence pour l'allocation de ces fonds entre les gestionnaires de jetons. Ce mode de règlement peut également être décrit comme un "règlement brut instantané".

CurrencyOperatorDetails

Détails spécifiques à un opérateur de devises.

Représentation JSON
{
  "currency": string,
  "currencyCode": string,
  "accountStatus": enum (AccountStatus),
  "previousEntityId": {
    object (Entity)
  },
  "previousCurrencyOperatorId": string,
  "platformOperatorEntityId": {
    object (Entity)
  },
  "platformOperatorId": string,
  "contractTokenManager": {
    object (Entity)
  },
  "contractTokenManagerId": string,
  "clearinghouseId": string
}
Champs
currency
(deprecated)

string

Uniquement en sortie. Obsolète : utilisez plutôt currencyCode. Devise associée à ce compte, représentée par le code ISO 4217 à trois lettres.

currencyCode

string

Uniquement en sortie. ID de la devise associée à ce compte, représenté par le code ISO 4217 à trois lettres.

accountStatus

enum (AccountStatus)

Uniquement en sortie. État de ce compte.

previousEntityId
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt previousCurrencyOperatorId. L'opérateur de devise précédent qui a transféré la propriété du rôle d'opérateur de devise à ce compte. Si c'est le premier opérateur de devise pour la devise, ce champ sera vide.

previousCurrencyOperatorId

string

Uniquement en sortie. ID de l'opérateur de devises précédent qui a transféré la propriété du rôle d'opérateur de devises à ce compte. Si c'est le premier opérateur de devise pour la devise, ce champ sera vide.

platformOperatorEntityId
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt platformOperatorId. Opérateur de plate-forme qui a créé cet opérateur de devise.

platformOperatorId

string

Uniquement en sortie. ID de l'opérateur de plate-forme qui a créé cet opérateur de devise.

contractTokenManager
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt contractTokenManagerId. Gestionnaire de jetons de contrat associé à cet opérateur de devise.

contractTokenManagerId

string

Uniquement en sortie. ID du gestionnaire de jetons de contrat associé à cet opérateur de devise.

clearinghouseId

string

Uniquement en sortie. ID de la chambre de compensation associée à cet opérateur de devise.

PlatformOperatorDetails

Informations spécifiques à un opérateur de plate-forme.

Représentation JSON
{
  "accountStatus": enum (AccountStatus),
  "previousEntityId": {
    object (Entity)
  },
  "previousPlatformOperatorId": string
}
Champs
accountStatus

enum (AccountStatus)

Uniquement en sortie. État de ce compte.

previousEntityId
(deprecated)

object (Entity)

Uniquement en sortie. Obsolète : utilisez plutôt previousPlatformOperatorId. Opérateur de plate-forme précédent qui a transféré la propriété du rôle d'opérateur de plate-forme à ce compte. Si c'est le premier opérateur de plate-forme, ce champ sera vide.

previousPlatformOperatorId

string

Uniquement en sortie. ID de l'opérateur de plate-forme précédent qui a transféré la propriété du rôle d'opérateur de plate-forme à ce compte. Si c'est le premier opérateur de plate-forme, ce champ sera vide.