Account

Rappresenta lo stato di un account nel libro mastro.

Rappresentazione 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.
}
Campi
sequenceNumber

string (int64 format)

Solo output. Il numero di sequenza di questo account. Questo numero aumenta a ogni transazione inviata da questo account.
publicKey

string (bytes format)

Solo output. La chiave pubblica principale associata a questo account, utilizzata per la verifica della firma.

Una stringa con codifica in base64.
roundId

string (int64 format)

Solo output. L'ID del round di esecuzione (simile all'"altezza" del blocco) in cui le informazioni dell'account fornite sono accurate.
comment

string

Solo output. Il commento dell'account memorizzato al momento della creazione.
Campo unione account_details. Dettagli specifici in base al tipo di account. account_details può essere solo uno dei seguenti tipi:
userDetails

object (UserDetails)

Solo output. Dettagli di un account utente standard.
accountManagerDetails

object (AccountManagerDetails)

Solo output. Dettagli di un account account manager.
tokenManagerDetails

object (TokenManagerDetails)

Solo output. Dettagli per un account amministratore dei token.
contractTokenManagerDetails

object (ContractTokenManagerDetails)

Solo output. Dettagli di un account amministratore token contratto.
contractDetails

object (ContractDetails)

Solo output. Dettagli di un account smart contract.
clearinghouseDetails

object (ClearingHouseDetails)

Solo output. Dettagli di un account di compensazione.
currencyOperatorDetails

object (CurrencyOperatorDetails)

Solo output. Dettagli di un account operatore valutario.
platformOperatorDetails

object (PlatformOperatorDetails)

Solo output. Dettagli di un account operatore della piattaforma.

UserDetails

Dettagli specifici di un account utente.

Rappresentazione 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)
    },
    ...
  }
}
Campi
accountManager
(deprecated)

object (Entity)

Solo output. Deprecato: utilizza accountManagerId. Il responsabile dell'account per questo utente.
accountManagerId

string

Solo output. L'ID del responsabile dell'account per questo utente.
tokenManager
(deprecated)

object (Entity)

Solo output. Deprecato: utilizza tokenManagerId. Il gestore dei token per questo utente.
tokenManagerId

string

Solo output. L'ID del gestore dei token per questo utente.
roles[]

enum (Role)

Solo output. L'elenco dei ruoli concessi a questo account.
accountStatus

enum (AccountStatus)

Solo output. Lo stato di questo account.
balance

object (CurrencyValue)

Solo output. Il saldo dei token di questo account utente.
accountFields
(deprecated)

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

Solo output. Deprecato: utilizza contractAccountFields. I campi dell'account contratto (ID contratto -> campi) per questo utente.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contractAccountFields

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

Solo output. I campi dell'account contratto (ID contratto -> campi) per questo utente.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Entità

Un'entità nella rete Universal Ledger. Tutti gli account sono collegati a un'entità. L'ID entità, spesso chiamato anche ID account, è univoco e immutabile in tutta la rete.

Rappresentazione JSON 
{
  "id": string
}
Campi
id

string

Solo output. L'ID assegnato all'entità. Viene assegnato dall'emittente al momento della creazione dell'account.

Ruolo

Il set di ruoli standard.

Enum
ROLE_UNSPECIFIED Ruolo non valido.
ROLE_PAYER Il ruolo che consente a un account di avviare una transazione di pagamento.
ROLE_RECEIVER Il ruolo che consente a un account di ricevere pagamenti.
ROLE_CONTRACT_CREATOR Il ruolo che consente a un account di eseguire il deployment dei contratti.
ROLE_CONTRACT_PARTICIPANT Il ruolo che consente a un account di interagire con i contratti di cui è stato eseguito il deployment.

AccountStatus

Lo stato di un account.

Enum
ACCOUNT_STATUS_UNSPECIFIED Stato non valido.
ACCOUNT_STATUS_ACTIVE Stato attivo in cui l'account può eseguire le operazioni consentite dai suoi ruoli.
ACCOUNT_STATUS_INACTIVE Stato inattivo in cui tutte le transazioni sull'account sono vietate. Il gestore dell'account può comunque inviare transazioni di gestione dell'account.

CurrencyValue

Rappresenta un importo di valuta (ovvero denaro). Tieni presente che la valuta denominata non è inclusa in questo messaggio. La valuta pertinente viene decisa dall'account che invia la transazione. Ogni account ha una valuta univoca e immutabile associata.

Rappresentazione JSON 
{
  "value": string
}
Campi
value

string (int64 format)

Obbligatorio. Il numero di unità minori della valuta.

Questa denominazione valida più piccola è denominata "unità minori" ed è specificata nello standard ISO 4217. Ad esempio, per i dollari statunitensi, il valore sarà il numero di centesimi e per le sterline britanniche il numero di pence. Per lo yen giapponese, che non ha un'unità secondaria, sarà il numero di yen.

Campi

Una mappa dei campi (nome campo -> valore) di un contratto utilizzata per rappresentare i campi del contratto o dell'account.

Rappresentazione JSON 
{
  "fields": {
    string: {
      object (Value)
    },
    ...
  }
}
Campi
fields

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

Solo output. La mappa dei nomi dei campi e dei relativi valori.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Valore

Un valore concreto di un determinato tipo.

Rappresentazione 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.
}
Campi
Campo unione value. Il valore effettivo. value può essere solo uno dei seguenti tipi:
noneValue

enum (NoneValue)

Facoltativo. Rappresenta un valore None.
boolValue

boolean

Facoltativo. Un valore booleano.
int64Value

string (int64 format)

Facoltativo. Un valore int64.
stringValue

string

Facoltativo. Un valore stringa.
accountId

string

Facoltativo. Un ID account.
dictValue

object (DictValue)

Facoltativo. Un valore del dizionario.
qualifiedCurrencyValue

object (QualifiedCurrencyValue)

Facoltativo. Un valore di valuta qualificato.
amountValue

object (AmountValue)

Facoltativo. Un valore di importo.

NoneValue

Un'enumerazione singleton per rappresentare il valore None.

Enum
NONE_VALUE_UNSPECIFIED Il valore Nessuno.

DictValue

Gli indici mappano la chiave al valore. Ad esempio, il tasto keys[0] corrisponde a values[0].

Rappresentazione 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.
}
Campi
Campo unione keys. Ogni chiave può essere di un solo tipo. keys può essere solo uno dei seguenti tipi:
boolKeys

object (BoolList)

Facoltativo. Un elenco di chiavi booleane.
stringKeys

object (StringList)

Facoltativo. Un elenco di chiavi stringa.
int64Keys

object (Int64List)

Facoltativo. Un elenco di chiavi int64.
accountIdKeys

object (AccountIdList)

Facoltativo. Un elenco di chiavi ID account.
Campo unione values. Ogni valore può essere di un solo tipo. values può essere solo uno dei seguenti tipi:
boolValues

object (BoolList)

Facoltativo. Un elenco di valori booleani.
stringValues

object (StringList)

Facoltativo. Un elenco di valori stringa.
int64Values

object (Int64List)

Facoltativo. Un elenco di valori int64.
dictValues

object (DictList)

Facoltativo. I valori sono un elenco di dizionari nidificati.

BoolList

Un elenco di valori booleani.

Rappresentazione JSON 
{
  "values": [
    boolean
  ]
}
Campi
values[]

boolean

Facoltativo. I valori booleani.

StringList

Un elenco di stringhe.

Rappresentazione JSON 
{
  "values": [
    string
  ]
}
Campi
values[]

string

Facoltativo. I valori stringa.

Int64List

Un elenco di numeri interi a 64 bit.

Rappresentazione JSON 
{
  "values": [
    string
  ]
}
Campi
values[]

string (int64 format)

Facoltativo. I valori int64.

AccountIdList

Un elenco di ID account.

Rappresentazione JSON 
{
  "values": [
    string
  ]
}
Campi
values[]

string

Facoltativo. I valori dell'ID account.

DictList

Un elenco di dizionari.

Rappresentazione JSON 
{
  "values": [
    {
      object (DictValue)
    }
  ]
}
Campi
values[]

object (DictValue)

Facoltativo. I valori DictValue. Tutti i dizionari nidificati devono avere lo stesso tipo concreto.

QualifiedCurrencyValue

Rappresenta una valuta nel registro, qualificata dal relativo operatore di valuta.

Rappresentazione JSON 
{
  "operatorId": string
}
Campi
operatorId

string

Obbligatorio. L'ID operatore valuta che amministra la valuta.

AmountValue

Rappresenta un importo denominato in una valuta.

Rappresentazione JSON 
{
  "currency": {
    object (QualifiedCurrencyValue)
  },
  "amountValue": string
}
Campi
currency

object (QualifiedCurrencyValue)

Obbligatorio. La valuta dell'importo.
amountValue

string (int64 format)

Obbligatorio. Il numero di unità minori della valuta.

AccountManagerDetails

Dettagli specifici per un account manager.

Rappresentazione JSON 
{
  "tokenManager": {
    object (Entity)
  },
  "numAccounts": integer,
  "tokenManagerId": string
}
Campi
tokenManager
(deprecated)

object (Entity)

Solo output. Deprecato: utilizza tokenManagerId. Il gestore dei token predefinito per gli account creati da questo account amministratore.
numAccounts

integer

Solo output. Il numero di account creati da questo account manager.
tokenManagerId

string

Solo output. L'ID del gestore dei token predefinito per gli account creati da questo account amministratore.

TokenManagerDetails

Dettagli specifici di un Token Manager.

Rappresentazione JSON 
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  }
}
Campi
issuanceLimit

object (CurrencyValue)

Solo output. La quantità di token che questo gestore di token può generare.
issuedTokens

object (CurrencyValue)

Solo output. La quantità di token creati da questo gestore di token. Questo numero aumenterà durante il minting e diminuirà durante il burning.

ContractTokenManagerDetails

Dettagli specifici di un gestore dei token di contratto.

Rappresentazione JSON 
{
  "issuanceLimit": {
    object (CurrencyValue)
  },
  "issuedTokens": {
    object (CurrencyValue)
  },
  "previousContractTokenManagerId": string,
  "accountStatus": enum (AccountStatus)
}
Campi
issuanceLimit

object (CurrencyValue)

Solo output. La quantità di token per cui questo gestore di token del contratto è autorizzato a fornire garanzia.

Poiché i gestori di token contrattuali non possono aumentare o diminuire il limite di emissione, questo valore deve essere uguale a issuedTokens.
issuedTokens

object (CurrencyValue)

Solo output. Il numero di token per cui questo gestore di token del contratto fornisce la garanzia (ovvero la sua responsabilità totale).

È pari alla somma di tutti i saldi detenuti nei contratti per la valuta, più la posizione netta nella matrice di compensazione.
previousContractTokenManagerId

string

Solo output. L'ID account del precedente amministratore dei token di contratto per questa valuta. In questo modo si crea una traccia di audit che può essere attraversata per scoprire tutti i gestori precedenti. Se questo è il primo gestore di token di contratto per la valuta, il campo sarà vuoto.
accountStatus

enum (AccountStatus)

Solo output. Lo stato di questo account.

ContractDetails

Dettagli specifici di uno smart contract.

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

object (Entity)

Solo output. Deprecato: utilizza ownerId. Il proprietario del contratto.
ownerId

string

Solo output. L'ID del proprietario del contratto.
code

string (bytes format)

Solo output. Il codice del contratto serializzato.

Una stringa con codifica in base64.
contractFields

object (Fields)

Solo output. I campi del contratto (nome campo -> valore) per questo contratto.
currencyBalances

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

Solo output. I saldi in valuta detenuti dal contratto (operatore di valuta -> saldo).

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ClearingHouseDetails

Dettagli specifici di una Clearinghouse.

Rappresentazione JSON 
{
  "accountStatus": enum (AccountStatus),
  "balances": [
    {
      object (BalanceToSettle)
    }
  ],
  "settlementMode": enum (SettlementMode)
}
Campi
accountStatus

enum (AccountStatus)

Solo output. Lo stato di questo account.
balances[]

object (BalanceToSettle)

Solo output. I saldi che questa camera di compensazione sta attualmente monitorando per il regolamento.
settlementMode

enum (SettlementMode)

Solo output. La modalità di compensazione di questa camera di compensazione.

BalanceToSettle

Un saldo da regolare tra due gestori di token.

Rappresentazione JSON 
{
  "balancePayer": {
    object (Entity)
  },
  "balancePayerId": string,
  "balanceReceiver": {
    object (Entity)
  },
  "balanceReceiverId": string,
  "balance": {
    object (CurrencyValue)
  }
}
Campi
balancePayer
(deprecated)

object (Entity)

Solo output. Deprecato: utilizza balancePayerId. L'account che deve saldare il saldo.
balancePayerId

string

Solo output. L'ID dell'account che deve saldare il saldo.
balanceReceiver
(deprecated)

object (Entity)

Solo output. Deprecato: utilizza balanceReceiverId. L'account a cui è dovuto il saldo da saldare.
balanceReceiverId

string

Solo output. L'ID dell'account a cui è dovuto il saldo da saldare.
balance

object (CurrencyValue)

Solo output. Il saldo da saldare. Deve essere positivo.

SettlementMode

La modalità di compensazione per una camera di compensazione.

Enum
SETTLEMENT_MODE_UNSPECIFIED La modalità di pagamento non è specificata. Questo valore non è valido e non deve essere utilizzato.
SETTLEMENT_MODE_DEFERRED La camera di compensazione è responsabile del monitoraggio della proprietà dei fondi fuori dal ledger e dell'emissione periodica di transazioni SettlementRequest per mantenere sincronizzati i saldi corrispondenti nel ledger.
SETTLEMENT_MODE_INSTANT La camera di compensazione gestisce un unico pool di fondi e il registro funge da fonte principale per la distribuzione di questi fondi tra i gestori dei token. Questa modalità di pagamento può essere descritta anche come "pagamento lordo istantaneo".

CurrencyOperatorDetails

Dettagli specifici di un operatore valutario.

Rappresentazione 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
}
Campi
currency
(deprecated)

string

Solo output. Deprecato: utilizza currencyCode. La valuta associata a questo account, rappresentata dal codice ISO 4217 di 3 lettere.
currencyCode

string

Solo output. L'ID della valuta associata a questo account, rappresentato dal codice ISO 4217 di 3 lettere.
accountStatus

enum (AccountStatus)

Solo output. Lo stato di questo account.
previousEntityId
(deprecated)

object (Entity)

Solo output. Deprecato: utilizza previousCurrencyOperatorId. L'operatore di valuta precedente che ha trasferito la proprietà del ruolo di operatore di valuta a questo account. Se questo è il primo operatore di valuta per la valuta, il campo sarà vuoto.
previousCurrencyOperatorId

string

Solo output. L'ID dell'operatore di valuta precedente che ha trasferito la proprietà del ruolo di operatore di valuta a questo account. Se questo è il primo operatore di valuta per la valuta, il campo sarà vuoto.
platformOperatorEntityId
(deprecated)

object (Entity)

Solo output. Deprecato: utilizza platformOperatorId. L'operatore della piattaforma che ha creato questo operatore di valuta.
platformOperatorId

string

Solo output. L'ID dell'operatore della piattaforma che ha creato questo operatore di valuta.
contractTokenManager
(deprecated)

object (Entity)

Solo output. Deprecato: utilizza contractTokenManagerId. Il gestore dei token di contratto associato a questo operatore di valuta.
contractTokenManagerId

string

Solo output. L'ID del gestore dei token di contratto associato a questo operatore di valuta.
clearinghouseId

string

Solo output. L'ID della camera di compensazione associata a questo operatore valutario.

PlatformOperatorDetails

Dettagli specifici di un operatore della piattaforma.

Rappresentazione JSON 
{
  "accountStatus": enum (AccountStatus),
  "previousEntityId": {
    object (Entity)
  },
  "previousPlatformOperatorId": string
}
Campi
accountStatus

enum (AccountStatus)

Solo output. Lo stato di questo account.
previousEntityId
(deprecated)

object (Entity)

Solo output. Deprecato: utilizza previousPlatformOperatorId. L'operatore della piattaforma precedente che ha trasferito la proprietà del ruolo di operatore della piattaforma a questo account. Se questo è il primo operatore della piattaforma, il campo sarà vuoto.
previousPlatformOperatorId

string

Solo output. L'ID dell'operatore della piattaforma precedente che ha trasferito la proprietà del ruolo di operatore della piattaforma a questo account. Se questo è il primo operatore della piattaforma, il campo sarà vuoto.