ClientTransaction

Rappresenta una transazione avviata da un cliente.

Rappresentazione JSON
{
  "source": {
    object (Entity)
  },
  "senderId": string,
  "signatories": [
    {
      object (Entity)
    }
  ],
  "otherSignatoryIds": [
    string
  ],
  "sequenceNumber": string,
  "chainedUnit": boolean,

  // Union field kind can be only one of the following:
  "app": {
    "@type": string,
    field1: ...,
    ...
  },
  "operational": {
    "@type": string,
    field1: ...,
    ...
  },
  "transferPlatformOperatorTransaction": {
    object (TransferPlatformOperator)
  },
  "createCurrencyOperatorTransaction": {
    object (CreateCurrencyOperator)
  },
  "transferCurrencyOperatorTransaction": {
    object (TransferCurrencyOperator)
  },
  "createClearinghouseTransaction": {
    object (CreateClearinghouse)
  },
  "createAccountManagerTransaction": {
    object (CreateAccountManager)
  },
  "createTokenManagerTransaction": {
    object (CreateTokenManager)
  },
  "increaseTokenIssuanceLimitTransaction": {
    object (IncreaseTokenIssuanceLimit)
  },
  "decreaseTokenIssuanceLimitTransaction": {
    object (DecreaseTokenIssuanceLimit)
  },
  "settlementRequestTransaction": {
    object (SettlementRequest)
  },
  "mintTransaction": {
    object (Mint)
  },
  "burnTransaction": {
    object (Burn)
  },
  "createAccountTransaction": {
    object (CreateAccount)
  },
  "deactivateAccountTransaction": {
    object (DeactivateAccount)
  },
  "activateAccountTransaction": {
    object (ActivateAccount)
  },
  "addRolesTransaction": {
    object (AddRoles)
  },
  "removeRolesTransaction": {
    object (RemoveRoles)
  },
  "changeAccountManagerTransaction": {
    object (ChangeAccountManager)
  },
  "transferTransaction": {
    object (Transfer)
  },
  "createContractTransaction": {
    object (CreateContract)
  },
  "grantContractPermissionsTransaction": {
    object (GrantContractPermissions)
  },
  "invokeContractMethodTransaction": {
    object (InvokeContractMethod)
  },
  "createContractTokenManagerTransaction": {
    object (CreateContractTokenManager)
  },
  "transferContractTokenManagerTransaction": {
    object (TransferContractTokenManager)
  },
  "removeSigningPublicKeyTransaction": {
    object (RemoveSigningPublicKey)
  },
  "replaceSigningPublicKeyTransaction": {
    object (ReplaceSigningPublicKey)
  },
  "chain": {
    object (TransactionChain)
  }
  // End of list of possible types for union field kind.
}
Campi
source
(deprecated)

object (Entity)

Facoltativo. Il mittente della transazione. Deprecato: utilizza senderId.

senderId

string

Facoltativo. L'ID dell'account che invia questa transazione. È necessario impostare source o senderId.

signatories[]
(deprecated)

object (Entity)

Facoltativo. Gli account che, oltre al mittente, hanno firmato questa transazione. Deprecato: utilizza otherSignatoryIds.

otherSignatoryIds[]

string

Facoltativo. Gli ID degli account che, oltre al mittente, hanno firmato questa transazione.

sequenceNumber

string (int64 format)

Obbligatorio. Un numero univoco che aumenta monotonicamente, a partire da 0.

Questo numero deve essere aumentato di uno per ogni transazione inviata in precedenza alla rete dallo stesso mittente della transazione.

Tieni presente che non sono incluse le unità di transazione che potrebbero essere state inviate nell'ambito di una catena, che non deve impostare un numero di sequenza. ma include il mittente della catena di transazioni.

chainedUnit

boolean

Deve essere impostato su true se questa transazione client fa parte di una catena di transazioni. In caso contrario, deve essere impostato su false.

Ciò è necessario per evitare che una transazione firmata destinata a far parte di una catena venga inviata da sola.

Campo unione kind. Il messaggio specifico per la transazione del cliente. kind può essere solo uno dei seguenti tipi:
app
(deprecated)

object

Facoltativo. Deprecato: utilizza uno dei campi specifici del messaggio. Un messaggio specifico per la transazione del cliente. Deve essere uno dei seguenti:

Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo "@type" contenente un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.

operational

object

Facoltativo. Un messaggio Transaction operativo. Tieni presente che questa operazione può essere eseguita solo dall'operatore della piattaforma. Deve essere uno dei seguenti:

Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo "@type" contenente un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.

transferPlatformOperatorTransaction

object (TransferPlatformOperator)

Facoltativo. Messaggio per il trasferimento del ruolo di operatore della piattaforma a un nuovo account.

createCurrencyOperatorTransaction

object (CreateCurrencyOperator)

Facoltativo. Messaggio per la creazione di un nuovo operatore di valuta.

transferCurrencyOperatorTransaction

object (TransferCurrencyOperator)

Facoltativo. Messaggio per il trasferimento del ruolo di operatore valutario a un nuovo account.

createClearinghouseTransaction

object (CreateClearinghouse)

Facoltativo. Messaggio per la creazione di un nuovo centro di compensazione.

createAccountManagerTransaction

object (CreateAccountManager)

Facoltativo. Messaggio per la creazione di un nuovo account manager.

createTokenManagerTransaction

object (CreateTokenManager)

Facoltativo. Messaggio per la creazione di un nuovo gestore dei token associato alla valuta dell'operatore che invia la richiesta.

increaseTokenIssuanceLimitTransaction

object (IncreaseTokenIssuanceLimit)

Facoltativo. Comunica alla rete che l'account di destinazione ha depositato fondi di riserva e aumenta il limite di emissione dei token.

decreaseTokenIssuanceLimitTransaction

object (DecreaseTokenIssuanceLimit)

Facoltativo. Notifica alla rete che l'account di destinazione vuole ritirare i fondi di riserva e riduce il limite di emissione di token.

settlementRequestTransaction

object (SettlementRequest)

Facoltativo. Messaggio per l'avvio di un'operazione di compensazione.

mintTransaction

object (Mint)

Facoltativo. Messaggio per la creazione di token di valuta e il loro trasferimento a un account.

burnTransaction

object (Burn)

Facoltativo. Messaggio per l'utilizzo dei token di valuta da un account.

createAccountTransaction

object (CreateAccount)

Facoltativo. Messaggio per la creazione di un nuovo account utente.

deactivateAccountTransaction

object (DeactivateAccount)

Facoltativo. Messaggio per la disattivazione di un account utente.

activateAccountTransaction

object (ActivateAccount)

Facoltativo. Messaggio per l'attivazione di un account utente.

addRolesTransaction

object (AddRoles)

Facoltativo. Messaggio per l'aggiunta di ruoli a un account.

removeRolesTransaction

object (RemoveRoles)

Facoltativo. Messaggio per la rimozione dei ruoli da un account.

changeAccountManagerTransaction

object (ChangeAccountManager)

Facoltativo. Messaggio per la modifica del responsabile dell'account di un account.

transferTransaction

object (Transfer)

Facoltativo. Messaggio per il trasferimento di token da un account utente a un altro.

createContractTransaction

object (CreateContract)

Facoltativo. Messaggio per la creazione di un nuovo contratto nel registro.

grantContractPermissionsTransaction

object (GrantContractPermissions)

Facoltativo. Messaggio per la concessione delle autorizzazioni a un contratto.

invokeContractMethodTransaction

object (InvokeContractMethod)

Facoltativo. Messaggio per richiamare l'esecuzione di un metodo di contratto.

createContractTokenManagerTransaction

object (CreateContractTokenManager)

Facoltativo. Messaggio per la creazione di un nuovo gestore dei token associato alla valuta dell'operatore che invia la richiesta.

transferContractTokenManagerTransaction

object (TransferContractTokenManager)

Facoltativo. Messaggio per il trasferimento del ruolo di gestore dei token per una valuta da un account a un altro.

removeSigningPublicKeyTransaction

object (RemoveSigningPublicKey)

Facoltativo. Messaggio per la rimozione di una chiave di firma dell'account.

replaceSigningPublicKeyTransaction

object (ReplaceSigningPublicKey)

Facoltativo. Messaggio per la sostituzione di una chiave di firma dell'account.

chain

object (TransactionChain)

Facoltativo. Messaggio per una catena di transazioni che include più unità di transazione da eseguire in sequenza.

TransferPlatformOperator

Trasferisce la proprietà dell'operatore della piattaforma a un nuovo account. Il mittente deve essere l'operatore della piattaforma attuale.

Se la transazione va a buon fine, l'operatore della piattaforma corrente viene disattivato e l'ID dell'account appena creato viene restituito come evento nel TransactionCertificate della transazione finalizzata.

Rappresentazione JSON
{
  "publicKey": string,
  "keyFormat": enum (KeyFormat),
  "accountComment": string
}
Campi
publicKey

string (bytes format)

Obbligatorio. La chiave pubblica del nuovo operatore della piattaforma. Questa chiave pubblica verrà associata all'operatore della piattaforma e memorizzata nel ledger. Verrà utilizzato per convalidare la firma delle transazioni provenienti dall'account dell'operatore della piattaforma.

Il formato della chiave pubblica è definito dal campo keyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

keyFormat

enum (KeyFormat)

Facoltativo. Immutabile. Il formato della chiave pubblica. Se non specificato, il valore predefinito è un keyset serializzato binario nel formato wire di Tink. Considerate informazioni pubbliche.

accountComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro dell'account. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

CreateCurrencyOperator

Crea un nuovo operatore di valuta. Il mittente deve essere l'operatore della piattaforma.

Se la transazione va a buon fine, l'ID dell'account appena creato viene restituito come evento nel TransactionCertificate della transazione finalizzata.

Questa transazione deve introdurre una nuova valuta nel sistema. Se la valuta specificata esiste già, questa transazione non andrà a buon fine. Se l'operatore di valuta deve essere sostituito, deve essere inviata la transazione TransferCurrencyOperator.

Rappresentazione JSON
{
  "publicKey": string,
  "keyFormat": enum (KeyFormat),
  "accountComment": string,
  "currency": string,
  "currencyCode": string
}
Campi
publicKey

string (bytes format)

Obbligatorio. La chiave pubblica del nuovo operatore di valuta. Questa chiave pubblica verrà associata all'operatore di valuta e memorizzata nel ledger. Verrà utilizzato per convalidare la firma delle transazioni provenienti dall'account dell'operatore.

Il formato della chiave pubblica è definito dal campo keyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

keyFormat

enum (KeyFormat)

Facoltativo. Immutabile. Il formato della chiave pubblica. Se non specificato, il valore predefinito è un keyset serializzato binario nel formato wire di Tink. Considerate informazioni pubbliche.

accountComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro dell'account. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

currency
(deprecated)

string

Facoltativo. Deprecato: utilizza currencyCode. La valuta fiat associata a questo operatore, rappresentata come codice ISO 4217 di tre lettere maiuscole. Considerate informazioni pubbliche.

currencyCode

string

Facoltativo. La valuta fiat associata a questo operatore, rappresentata come codice ISO 4217 di tre lettere maiuscole. Considerate informazioni pubbliche.

TransferCurrencyOperator

Trasferisce la proprietà dell'operatore di valuta specificato a un nuovo account. Il mittente deve essere l'operatore della piattaforma.

Se la transazione va a buon fine, disattiva l'operatore di valuta specificato e l'ID del conto appena creato viene restituito come evento nel TransactionCertificate della transazione finalizzata.

Rappresentazione JSON
{
  "publicKey": string,
  "keyFormat": enum (KeyFormat),
  "accountComment": string,
  "currencyOperator": {
    object (Entity)
  },
  "currencyOperatorId": string
}
Campi
publicKey

string (bytes format)

Obbligatorio. La chiave pubblica del nuovo operatore di valuta. Questa chiave pubblica verrà associata all'operatore di valuta e memorizzata nel ledger. Verrà utilizzato per convalidare la firma delle transazioni provenienti dall'account dell'operatore valutario.

Il formato della chiave pubblica è definito dal campo keyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

keyFormat

enum (KeyFormat)

Facoltativo. Immutabile. Il formato della chiave pubblica. Se non specificato, il valore predefinito è un keyset serializzato binario nel formato wire di Tink. Considerate informazioni pubbliche.

accountComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro dell'account. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

currencyOperator
(deprecated)

object (Entity)

Facoltativo. Deprecato: utilizza currencyOperatorId. L'operatore di valuta da sostituire. Deve essere attivo.

currencyOperatorId

string

Facoltativo. L'ID dell'operatore di valuta da sostituire. Deve essere attivo. È necessario specificare currencyOperator o currencyOperatorId. Il valore è limitato a 60 caratteri.

CreateClearinghouse

Crea una nuova camera di compensazione. Il mittente deve essere un operatore valutario.

Se la transazione va a buon fine, l'ID dell'account appena creato viene restituito come evento nel TransactionCertificate della transazione finalizzata.

Rappresentazione JSON
{
  "publicKey": string,
  "keyFormat": enum (KeyFormat),
  "accountComment": string,
  "settlementMode": enum (SettlementMode)
}
Campi
publicKey

string (bytes format)

Obbligatorio. La chiave pubblica del nuovo clearing house. Tieni presente che non si tratta della chiave pubblica dell'operatore. Questa chiave pubblica verrà associata alla clearing house e memorizzata nel ledger. Verrà utilizzato per convalidare la firma delle transazioni provenienti dall'account della camera di compensazione.

Il formato della chiave pubblica è definito dal campo keyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

keyFormat

enum (KeyFormat)

Facoltativo. Immutabile. Il formato della chiave pubblica. Se non specificato, il valore predefinito è un keyset serializzato binario nel formato wire di Tink. Considerate informazioni pubbliche.

accountComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro dell'account. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

settlementMode

enum (SettlementMode)

Obbligatorio. La modalità di pagamento per questa camera di compensazione. Obbligatorio. Considerate informazioni pubbliche.

CreateAccountManager

Crea un nuovo account manager. Il mittente deve essere un operatore valutario.

Se la transazione va a buon fine, l'ID dell'account appena creato viene restituito come evento nel TransactionCertificate della transazione finalizzata.

Rappresentazione JSON
{
  "publicKey": string,
  "keyFormat": enum (KeyFormat),
  "defaultTokenManager": {
    object (Entity)
  },
  "defaultTokenManagerId": string,
  "accountComment": string
}
Campi
publicKey

string (bytes format)

Obbligatorio. La chiave pubblica del nuovo account manager. Tieni presente che non si tratta della chiave pubblica dell'operatore. Questa chiave pubblica verrà associata al gestore dell'account e archiviata nel ledger. Verrà utilizzato per convalidare la firma delle transazioni provenienti dall'account del responsabile dell'account.

Il formato della chiave pubblica è definito dal campo keyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

keyFormat

enum (KeyFormat)

Facoltativo. Immutabile. Il formato della chiave pubblica. Se non specificato, il valore predefinito è un keyset serializzato binario nel formato wire di Tink. Considerate informazioni pubbliche.

defaultTokenManager
(deprecated)

object (Entity)

Facoltativo. Deprecato: utilizza defaultTokenManagerId. Il gestore dei token predefinito per gli account che verranno creati da questo amministratore.

defaultTokenManagerId

string

Facoltativo. L'ID del gestore dei token predefinito per gli account che verranno creati da questo amministratore. Il valore è limitato a 60 caratteri.

accountComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro dell'account. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

CreateTokenManager

Crea un nuovo gestore dei token associato alla valuta dell'operatore che invia la richiesta. Il mittente deve essere un operatore valutario.

Se la transazione va a buon fine, l'ID dell'account appena creato viene restituito come evento nel TransactionCertificate della transazione finalizzata.

Rappresentazione JSON
{
  "publicKey": string,
  "keyFormat": enum (KeyFormat),
  "accountComment": string
}
Campi
publicKey

string (bytes format)

Obbligatorio. La chiave pubblica del nuovo gestore dei token. Tieni presente che non si tratta della chiave pubblica dell'operatore. Questa chiave pubblica verrà associata al gestore dei token e memorizzata nel ledger. Verrà utilizzato per convalidare la firma delle transazioni provenienti dall'account del gestore dei token.

Il formato della chiave pubblica è definito dal campo keyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

keyFormat

enum (KeyFormat)

Facoltativo. Immutabile. Il formato della chiave pubblica. Se non specificato, il valore predefinito è un keyset serializzato binario nel formato wire di Tink. Considerate informazioni pubbliche.

accountComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro dell'account. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

IncreaseTokenIssuanceLimit

Transazioni per l'emissione e la creazione di token. Comunica alla rete che l'account di destinazione ha depositato fondi di riserva e aumenta il limite di emissione dei token. Il mittente deve essere un account di compensazione.

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

object (Entity)

Facoltativo. Deprecato: utilizza tokenManagerId. L'ID dell'account istituzionale il cui limite di conio deve essere aumentato. Perché la transazione sia valida, questo account deve essere un gestore di token.

tokenManagerId

string

Facoltativo. L'ID dell'account istituzionale il cui limite di conio deve essere aumentato. Perché la transazione sia valida, questo account deve essere un gestore di token. È necessario specificare tokenManager o tokenManagerId.

amount

object (CurrencyValue)

Obbligatorio. L'importo di cui aumentare il limite. L'importo deve essere positivo.

DecreaseTokenIssuanceLimit

Notifica alla rete che l'account di destinazione vuole ritirare i fondi di riserva e riduce il limite di emissione di token. Il mittente deve essere un account di compensazione.

Tieni presente che questa transazione deve essere finalizzata correttamente prima che i fondi di riserva possano essere prelevati. Ciò è necessario perché è possibile che la transazione non vada a buon fine (ad esempio, se l'importo coniato è già superiore al limite ridotto richiesto).

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

object (Entity)

Facoltativo. Deprecato: utilizza tokenManagerId. L'ID dell'account istituzionale il cui limite di conio deve essere ridotto. Perché la transazione sia valida, questo account deve essere un gestore di token.

tokenManagerId

string

Facoltativo. L'ID dell'account istituzionale il cui limite di conio deve essere ridotto. Perché la transazione sia valida, questo account deve essere un gestore di token. È necessario specificare tokenManagerId (preferito) o tokenManager (obsoleto).

amount

object (CurrencyValue)

Obbligatorio. L'importo di cui ridurre il limite. L'importo deve essere positivo. La transazione non andrà a buon fine se il limite ridotto sarà inferiore ai token attualmente emessi.

SettlementRequest

Avvia un'operazione di compensazione tra due gestori di token. Il mittente deve essere un account di compensazione.

Nel SettlementMode differito in cui la camera di compensazione ha la custodia dei fondi del gestore dei token, questa è l'unica transazione che deve essere inviata per eseguire un regolamento tra i due gestori dei token.

Rappresentazione JSON
{
  "payer": {
    object (Entity)
  },
  "payerId": string,
  "beneficiary": {
    object (Entity)
  },
  "beneficiaryId": string,
  "balance": {
    object (CurrencyValue)
  },
  "roundId": string
}
Campi
payer
(deprecated)

object (Entity)

Facoltativo. Immutabile. Deprecato: utilizza payerId. L'ID account della parte che deve effettuare il trasferimento di fondi.

payerId

string

Facoltativo. Immutabile. L'ID account della parte che deve effettuare il trasferimento di fondi. È necessario specificare payer o payerId.

beneficiary
(deprecated)

object (Entity)

Facoltativo. Immutabile. Deprecato: utilizza beneficiaryId. L'ID account della parte che deve essere pagata.

beneficiaryId

string

Facoltativo. Immutabile. L'ID account della parte che riceverà i fondi. È necessario specificare beneficiary o beneficiaryId.

balance

object (CurrencyValue)

Obbligatorio. Immutabile. Il saldo dei token emessi che devono essere trasferiti dall'account payer all'account beneficiary nel ledger.

roundId

string (int64 format)

Obbligatorio. Immutabile. L'ID del round in cui è stato calcolato questo importo del pagamento.

Menta

Crea token di valuta e li trasferisce a un account specificato. Il mittente deve essere un gestore dei token.

Rappresentazione JSON
{
  "mintAmount": {
    object (CurrencyValue)
  },
  "beneficiary": {
    object (Entity)
  },
  "beneficiaryId": string
}
Campi
mintAmount

object (CurrencyValue)

Obbligatorio. L'importo da coniare. L'importo deve essere tale che il numero totale di token creati dal gestore di token non superi il limite di creazione. Se l'importo è superiore, la transazione deve essere rifiutata

beneficiary
(deprecated)

object (Entity)

Facoltativo. Deprecato: utilizza beneficiaryId. L'account a cui deve essere trasferito l'importo coniato. L'account beneficiario deve avere ROLE_RECEIVER abilitato.

beneficiaryId

string

Facoltativo. L'ID dell'account a cui deve essere trasferito l'importo coniato. L'account di destinazione deve avere ROLE_RECEIVER abilitato. È necessario specificare beneficiary o beneficiaryId.

CreateAccount

Crea un nuovo account utente. Il mittente deve essere un account manager.

Se la transazione va a buon fine, l'ID dell'account appena creato viene restituito come evento nel TransactionCertificate della transazione finalizzata.

Rappresentazione JSON
{
  "publicKey": string,
  "keyFormat": enum (KeyFormat),
  "roles": [
    enum (Role)
  ],
  "accountStatus": enum (AccountStatus),
  "accountComment": string,
  "tokenManager": {
    object (Entity)
  },
  "tokenManagerId": string
}
Campi
publicKey

string (bytes format)

Obbligatorio. La chiave pubblica del proprietario dell'account. Tieni presente che non si tratta della chiave pubblica del mittente. Questa è la chiave pubblica del nuovo proprietario dell'account e verrà archiviata nel ledger. Verrà utilizzato per convalidare la firma delle transazioni provenienti dall'account creato.

Il formato della chiave pubblica è definito dal campo keyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

keyFormat

enum (KeyFormat)

Facoltativo. Immutabile. Il formato della chiave pubblica. Se non specificato, il valore predefinito è un keyset serializzato binario nel formato wire di Tink. Considerate informazioni pubbliche.

roles[]

enum (Role)

Facoltativo. L'elenco dei ruoli da concedere a questo account.

accountStatus

enum (AccountStatus)

Facoltativo. Lo stato dell'account da creare. Per impostazione predefinita, lo stato dell'account di un account appena creato sarà ACCOUNT_STATUS_ACTIVE.

accountComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro dell'account. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

tokenManager
(deprecated)

object (Entity)

Facoltativo. Deprecato: utilizza tokenManagerId. Il gestore dei token per questo account. Questo campo è facoltativo e, se non viene fornito, verrà utilizzato il gestore dei token predefinito associato all'account manager (ovvero il mittente di questa transazione).

tokenManagerId

string

Facoltativo. L'ID del gestore dei token per questo account. Questo campo è facoltativo e, se non viene fornito, verrà utilizzato il gestore dei token predefinito associato all'account manager (ovvero il mittente di questa transazione). Il valore è limitato a 60 caratteri.

DeactivateAccount

Contrassegna un account come ACCOUNT_STATUS_INACTIVE. Il mittente deve essere il responsabile dell'account da disattivare.

Ciò implica che il proprietario dell'account non potrà effettuare transazioni sull'account indipendentemente dai ruoli.

Rappresentazione JSON
{
  "account": {
    object (Entity)
  },
  "accountId": string
}
Campi
account
(deprecated)

object (Entity)

Facoltativo. Deprecato: utilizza accountId. L'ID dell'account da disattivare.

accountId

string

Facoltativo. L'ID dell'account da disattivare. È necessario specificare account o accountId. Il valore è limitato a 60 caratteri.

RemoveRoles

Rimuove i ruoli specificati dall'account. Il mittente deve essere l'account manager dell'account da modificare.

Rappresentazione JSON
{
  "account": {
    object (Entity)
  },
  "accountId": string,
  "roles": [
    enum (Role)
  ]
}
Campi
account
(deprecated)

object (Entity)

Facoltativo. Deprecato: utilizza accountId. L'ID dell'account da modificare.

accountId

string

Facoltativo. L'ID dell'account da modificare. È necessario specificare account o accountId. Il valore è limitato a 60 caratteri.

roles[]

enum (Role)

Obbligatorio. I ruoli da rimuovere.

Trasferisci

Trasferisce i token da un account utente a un altro. Il mittente deve essere un account utente normale, non un account con privilegi come un gestore token o un account manager.

Inoltre, il mittente della transazione deve avere ROLE_PAYER abilitato, mentre il destinatario deve avere ROLE_RECEIVER abilitato.

Rappresentazione JSON
{
  "beneficiary": {
    object (Entity)
  },
  "beneficiaryId": string,
  "amount": {
    object (CurrencyValue)
  }
}
Campi
beneficiary
(deprecated)

object (Entity)

Facoltativo. Deprecato: utilizza beneficiaryId. L'account che riceve i token.

beneficiaryId

string

Facoltativo. L'ID dell'account che riceve i token. È necessario specificare beneficiary o beneficiaryId.

amount

object (CurrencyValue)

Obbligatorio. L'importo da trasferire. L'importo deve essere positivo.

CreateContract

Memorizza un contratto nel registro.

Rappresentazione JSON
{
  "contractBytes": string,
  "arguments": {
    string: {
      object (Value)
    },
    ...
  },
  "initArguments": {
    string: {
      object (Value)
    },
    ...
  },
  "contractComment": string
}
Campi
contractBytes

string (bytes format)

Byte del contratto serializzati.

Una stringa con codifica in base64.

arguments
(deprecated)

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

Facoltativo. Immutabile. Deprecato: utilizza initArguments. Argomenti per il metodo __init__.

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

initArguments

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

Facoltativo. Immutabile. Contiene gli argomenti per il metodo __init__.

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

contractComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro contabile del contratto. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

GrantContractPermissions

Concede le autorizzazioni al contratto da parte del mittente della transazione. Se è specificato delegateContractId, le autorizzazioni e lo spazio di archiviazione corrispondente vengono concessi esclusivamente al contratto delegateContractId, non al mittente.

Tieni presente che non è supportata la revoca delle autorizzazioni.

Rappresentazione JSON
{
  "contract": {
    object (Entity)
  },
  "contractId": string,
  "permissions": [
    enum (ContractPermission)
  ],
  "delegateContractId": string
}
Campi
contract
(deprecated)

object (Entity)

Facoltativo. Deprecato: utilizza contractId. ID del contratto a cui vengono concesse le autorizzazioni.

contractId

string

Facoltativo. L'ID del contratto a cui vengono concesse le autorizzazioni. È necessario specificare contract o contractId.

permissions[]

enum (ContractPermission)

Le autorizzazioni da concedere.

delegateContractId

string

Facoltativo. L'ID contratto per cui vengono concesse le autorizzazioni. Il mittente della transazione deve essere il proprietario di questo contratto.

InvokeContractMethod

Richiama l'esecuzione di un metodo di contratto.

Rappresentazione JSON
{
  "contract": {
    object (Entity)
  },
  "contractId": string,
  "methodName": string,
  "arguments": {
    string: {
      object (Value)
    },
    ...
  },
  "methodArguments": {
    string: {
      object (Value)
    },
    ...
  },
  "payment": {
    object (CurrencyValue)
  }
}
Campi
contract
(deprecated)

object (Entity)

Facoltativo. Deprecato: utilizza contractId. L'ID del contratto da eseguire.

contractId

string

Facoltativo. L'ID del contratto da eseguire. È necessario specificare contract o contractId.

methodName

string

Nome del metodo da eseguire.

arguments
(deprecated)

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

Facoltativo. Immutabile. Deprecato: utilizza methodArguments. Argomenti per il metodo.

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

methodArguments

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

Facoltativo. Immutabile. Contiene gli argomenti da passare al metodo.

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

payment

object (CurrencyValue)

L'importo da pagare. Deve essere maggiore di zero quando vengono richiamati metodi pagabili e zero per quelli non pagabili.

CreateContractTokenManager

Crea un nuovo gestore di token di contratto associato alla valuta dell'operatore che invia la richiesta. Il mittente deve essere un operatore valutario. Il nuovo gestore dei token di contratto è attivo per impostazione predefinita. Se il gestore dei token del contratto deve essere sostituito, deve essere inviata la transazione TransferContractTokenManager. Se esiste un altro gestore di token contratto associato alla stessa valuta, questa transazione non andrà a buon fine.

A differenza dei normali gestori di token, i gestori di token di contratto non sono autorizzati a eseguire transazioni come la creazione o l'eliminazione. Tuttavia, possono partecipare alle operazioni di compensazione.

Se la transazione va a buon fine, l'ID dell'account appena creato viene restituito come evento nel TransactionCertificate della transazione finalizzata.

Rappresentazione JSON
{
  "publicKey": string,
  "accountComment": string,
  "keyFormat": enum (KeyFormat)
}
Campi
publicKey

string (bytes format)

Obbligatorio. La chiave pubblica del nuovo gestore dei token del contratto. Tieni presente che non si tratta della chiave pubblica dell'operatore. Questa chiave pubblica verrà associata al gestore dei token di contratto e memorizzata nel ledger. Verrà utilizzato per convalidare la firma delle transazioni provenienti dall'account del gestore dei token di contratto.

Il formato della chiave pubblica è definito dal campo keyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

accountComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro dell'account. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

keyFormat

enum (KeyFormat)

Facoltativo. Immutabile. Il formato della chiave pubblica. Se non specificato, il valore predefinito è un keyset serializzato binario nel formato wire di Tink. Considerate informazioni pubbliche.

TransferContractTokenManager

Trasferisce la proprietà del gestore dei token di contratto a un nuovo account. Il mittente deve essere l'operatore valutario attuale per la valuta.

Se la transazione va a buon fine, il gestore dei token di contratto corrente per la valuta viene disattivato e l'ID dell'account appena creato viene restituito come evento nel TransactionCertificate della transazione finalizzata.

Rappresentazione JSON
{
  "publicKey": string,
  "accountComment": string,
  "keyFormat": enum (KeyFormat)
}
Campi
publicKey

string (bytes format)

Obbligatorio. La chiave pubblica del nuovo gestore dei token del contratto. Tieni presente che non si tratta della chiave pubblica dell'operatore. Questa è la chiave pubblica del gestore dei token del nuovo contratto e verrà archiviata nel ledger. Verrà utilizzato per convalidare la firma delle transazioni provenienti dall'account del gestore dei token di contratto.

Il formato della chiave pubblica è definito dal campo keyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

accountComment

string

Facoltativo. Immutabile. Un campo per i commenti opaco che non viene interpretato dal sistema, ma memorizzato nel registro dell'account. Considerate informazioni pubbliche. La lunghezza massima è di 128 caratteri. Può essere lasciato vuoto. Una volta creato, il campo è immutabile.

keyFormat

enum (KeyFormat)

Facoltativo. Immutabile. Il formato della chiave pubblica. Se non specificato, il valore predefinito è un keyset serializzato binario nel formato wire di Tink. Considerate informazioni pubbliche.

RemoveSigningPublicKey

Rimuove la chiave di firma dell'account dallo slot specificato. L'altro slot non deve essere vuoto e deve contenere la chiave utilizzata per firmare ClientTransaction.

Rappresentazione JSON
{
  "keySlot": enum (KeySlot)
}
Campi
keySlot

enum (KeySlot)

Obbligatorio. Lo slot della chiave da cui la stiamo rimuovendo. Se è già vuoto, la transazione non andrà a buon fine.

ReplaceSigningPublicKey

Sostituisce la chiave di firma dell'account nello slot specificato. L'altro slot non deve essere vuoto e deve contenere la chiave utilizzata per firmare ClientTransaction.

Rappresentazione JSON
{
  "keySlot": enum (KeySlot),
  "newPublicKey": string,
  "newKeyFormat": enum (KeyFormat)
}
Campi
keySlot

enum (KeySlot)

Obbligatorio. Lo slot della chiave in cui stiamo sostituendo la chiave.

newPublicKey

string (bytes format)

Obbligatorio. La nuova chiave pubblica, che sostituirà la chiave pubblica nello slot specificato.

Il formato della chiave pubblica è definito dal campo newKeyFormat. Considerate informazioni pubbliche.

Una stringa con codifica in base64.

newKeyFormat

enum (KeyFormat)

Obbligatorio. Il formato della nuova chiave pubblica. Consulta la definizione di KeyFormat per un elenco dei formati supportati. Considerate informazioni pubbliche.

TransactionChain

Una catena di transazioni che include più unità di transazione da eseguire in sequenza.

Le unità verranno eseguite in sequenza, nell'ordine in cui sono elencate. Se tutte le unità hanno esito positivo, i loro effetti cumulativi vengono registrati in modo atomico nello stato del mondo. In caso contrario, se una delle condizioni non viene soddisfatta, l'intera catena non verrà eseguita e nessuno dei suoi effetti verrà applicato.

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

string (bytes format)

Le singole unità della catena. Ogni unità deve essere un SignedTransaction serializzato.

Tieni presente che i byte serializzati sono necessari per determinare i byte da firmare per la catena stessa.

Una stringa con codifica in base64.