Esegue query su tutte le informazioni memorizzate su un account nella rete. I dettagli dell'account restituiti possono variare tra le chiamate, perché un endpoint può indirizzare le richieste a diversi validatori all'interno della rete e della regione e i validatori potrebbero non avere lo stesso ID round in un determinato momento.
Richiesta HTTP
GET https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:queryAccount Gli URL utilizzano la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri | |
|---|---|
endpoint |
Obbligatorio. L'endpoint per gestire la richiesta. Formato: |
Parametri di query
| Parametri | |
|---|---|
accountId |
Obbligatorio. L'ID account di cui ottenere informazioni. Il valore è limitato a 60 caratteri. |
roundId |
Facoltativo. L'ID del round di esecuzione (simile all'"altezza" del blocco) in cui richiedere i dati. Le informazioni sull'account restituite saranno accurate per lo stato del mondo in questo round di esecuzione. Se non specificato, utilizza l'ultimo round finalizzato noto al validatore di pubblicazione. Lo stato in un determinato ID round è sempre coerente e canonico. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta per endpoints.queryAccount.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
|---|
{
"account": {
object ( |
| Campi | |
|---|---|
account |
Le informazioni dell'account, insieme all'altezza a cui sono state ottenute. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
Per saperne di più, consulta la Authentication Overview.
Account
Rappresenta lo stato di un account nel libro mastro.
| Rappresentazione JSON |
|---|
{ "sequenceNumber": string, "publicKey": string, "roundId": string, "comment": string, // Union field |
| Campi | |
|---|---|
sequenceNumber |
Solo output. Il numero di sequenza di questo account. Questo numero aumenta a ogni transazione inviata da questo account. |
publicKey |
Solo output. La chiave pubblica principale associata a questo account, utilizzata per la verifica della firma. Una stringa con codifica in base64. |
roundId |
Solo output. L'ID del round di esecuzione (simile all'"altezza" del blocco) in cui le informazioni dell'account fornite sono accurate. |
comment |
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 |
Solo output. Dettagli di un account utente standard. |
accountManagerDetails |
Solo output. Dettagli di un account account manager. |
tokenManagerDetails |
Solo output. Dettagli per un account amministratore dei token. |
contractTokenManagerDetails |
Solo output. Dettagli di un account amministratore token contratto. |
contractDetails |
Solo output. Dettagli di un account smart contract. |
clearinghouseDetails |
Solo output. Dettagli di un account di compensazione. |
currencyOperatorDetails |
Solo output. Dettagli di un account operatore valutario. |
platformOperatorDetails |
Solo output. Dettagli di un account operatore della piattaforma. |
UserDetails
Dettagli specifici di un account utente.
| Rappresentazione JSON |
|---|
{ "accountManager": { object ( |
| Campi | |
|---|---|
accountManager |
Solo output. Deprecato: utilizza |
accountManagerId |
Solo output. L'ID del responsabile dell'account per questo utente. |
tokenManager |
Solo output. Deprecato: utilizza |
tokenManagerId |
Solo output. L'ID del gestore dei token per questo utente. |
roles[] |
Solo output. L'elenco dei ruoli concessi a questo account. |
accountStatus |
Solo output. Lo stato di questo account. |
balance |
Solo output. Il saldo dei token di questo account utente. |
accountFields |
Solo output. Deprecato: utilizza Un oggetto contenente un elenco di coppie |
contractAccountFields |
Solo output. I campi dell'account contratto (ID contratto -> campi) per questo utente. Un oggetto contenente un elenco di coppie |
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 nella rete.
| Rappresentazione JSON |
|---|
{ "id": string } |
| Campi | |
|---|---|
id |
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 |
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à minore, 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 ( |
| Campi | |
|---|---|
fields |
Solo output. La mappa dei nomi dei campi e dei relativi valori. Un oggetto contenente un elenco di coppie |
Valore
Un valore concreto di un determinato tipo.
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione value. Il valore effettivo. value può essere solo uno dei seguenti tipi: |
|
noneValue |
Facoltativo. Rappresenta un valore None. |
boolValue |
Facoltativo. Un valore booleano. |
int64Value |
Facoltativo. Un valore int64. |
stringValue |
Facoltativo. Un valore stringa. |
accountId |
Facoltativo. Un ID account. |
dictValue |
Facoltativo. Un valore del dizionario. |
qualifiedCurrencyValue |
Facoltativo. Un valore di valuta qualificato. |
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 |
| Campi | |
|---|---|
Campo unione keys. Ogni chiave può essere di un solo tipo. keys può essere solo uno dei seguenti tipi: |
|
boolKeys |
Facoltativo. Un elenco di chiavi booleane. |
stringKeys |
Facoltativo. Un elenco di chiavi stringa. |
int64Keys |
Facoltativo. Un elenco di chiavi int64. |
accountIdKeys |
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 |
Facoltativo. Un elenco di valori booleani. |
stringValues |
Facoltativo. Un elenco di valori stringa. |
int64Values |
Facoltativo. Un elenco di valori int64. |
dictValues |
Facoltativo. I valori sono un elenco di dizionari nidificati. |
BoolList
Un elenco di valori booleani.
| Rappresentazione JSON |
|---|
{ "values": [ boolean ] } |
| Campi | |
|---|---|
values[] |
Facoltativo. I valori booleani. |
StringList
Un elenco di stringhe.
| Rappresentazione JSON |
|---|
{ "values": [ string ] } |
| Campi | |
|---|---|
values[] |
Facoltativo. I valori stringa. |
Int64List
Un elenco di numeri interi a 64 bit.
| Rappresentazione JSON |
|---|
{ "values": [ string ] } |
| Campi | |
|---|---|
values[] |
Facoltativo. I valori int64. |
AccountIdList
Un elenco di ID account.
| Rappresentazione JSON |
|---|
{ "values": [ string ] } |
| Campi | |
|---|---|
values[] |
Facoltativo. I valori dell'ID account. |
DictList
Un elenco di dizionari.
| Rappresentazione JSON |
|---|
{
"values": [
{
object ( |
| Campi | |
|---|---|
values[] |
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 |
Obbligatorio. L'ID operatore valuta che amministra la valuta. |
AmountValue
Rappresenta un importo denominato in una valuta.
| Rappresentazione JSON |
|---|
{
"currency": {
object ( |
| Campi | |
|---|---|
currency |
Obbligatorio. La valuta dell'importo. |
amountValue |
Obbligatorio. Il numero di unità minori della valuta. |
AccountManagerDetails
Dettagli specifici per un account manager.
| Rappresentazione JSON |
|---|
{
"tokenManager": {
object ( |
| Campi | |
|---|---|
tokenManager |
Solo output. Deprecato: utilizza |
numAccounts |
Solo output. Il numero di account creati da questo account manager. |
tokenManagerId |
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 ( |
| Campi | |
|---|---|
issuanceLimit |
Solo output. La quantità di token che questo gestore di token può generare. |
issuedTokens |
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 ( |
| Campi | |
|---|---|
issuanceLimit |
Solo output. La quantità di token per cui questo gestore di token di contratto è autorizzato a fornire garanzia. Poiché i gestori dei token contrattuali non possono aumentare o diminuire il limite di emissione, questo valore deve essere uguale a |
issuedTokens |
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 |
Solo output. L'ID account del precedente amministratore dei token di contratto per questa valuta. In questo modo si forma 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 |
Solo output. Lo stato di questo account. |
ContractDetails
Dettagli specifici di uno smart contract.
| Rappresentazione JSON |
|---|
{ "owner": { object ( |
| Campi | |
|---|---|
owner |
Solo output. Deprecato: utilizza |
ownerId |
Solo output. L'ID del proprietario del contratto. |
code |
Solo output. Il codice del contratto serializzato. Una stringa con codifica in base64. |
contractFields |
Solo output. I campi del contratto (nome campo -> valore) per questo contratto. |
currencyBalances |
Solo output. I saldi in valuta detenuti dal contratto (operatore di valuta -> saldo). Un oggetto contenente un elenco di coppie |
ClearingHouseDetails
Dettagli specifici di una Clearinghouse.
| Rappresentazione JSON |
|---|
{ "accountStatus": enum ( |
| Campi | |
|---|---|
accountStatus |
Solo output. Lo stato di questo account. |
balances[] |
Solo output. I saldi che questa camera di compensazione sta attualmente monitorando per il regolamento. |
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 ( |
| Campi | |
|---|---|
balancePayer |
Solo output. Deprecato: utilizza |
balancePayerId |
Solo output. L'ID dell'account che deve saldare il saldo. |
balanceReceiver |
Solo output. Deprecato: utilizza |
balanceReceiverId |
Solo output. L'ID dell'account a cui è dovuto il saldo da saldare. |
balance |
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 mantiene 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 ( |
| Campi | |
|---|---|
currency |
Solo output. Deprecato: utilizza |
currencyCode |
Solo output. L'ID della valuta associata a questo account, rappresentato dal codice ISO 4217 di 3 lettere. |
accountStatus |
Solo output. Lo stato di questo account. |
previousEntityId |
Solo output. Deprecato: utilizza |
previousCurrencyOperatorId |
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 |
Solo output. Deprecato: utilizza |
platformOperatorId |
Solo output. L'ID dell'operatore della piattaforma che ha creato questo operatore di valuta. |
contractTokenManager |
Solo output. Deprecato: utilizza |
contractTokenManagerId |
Solo output. L'ID del gestore dei token di contratto associato a questo operatore di valuta. |
clearinghouseId |
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 ( |
| Campi | |
|---|---|
accountStatus |
Solo output. Lo stato di questo account. |
previousEntityId |
Solo output. Deprecato: utilizza |
previousPlatformOperatorId |
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. |